speckit-converge

Assess codebase against spec, plan, and tasks, then append remaining work to tasks.md.

Updated Sep 9, 2026
One-click install
npx skills add https://github.com/alidotcom2000/RSSFeedReader --skill speckit-converge-alidotcom2000
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-converge
Source: https://github.com/alidotcom2000/RSSFeedReader/tree/main/.github/skills/speckit-converge
Command: npx skills add https://github.com/alidotcom2000/RSSFeedReader --skill speckit-converge-alidotcom2000

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After running an implementation pass, teams often cannot tell whether the code actually satisfies everything the feature's spec, plan, and tasks demanded. This Skill closes that gap by auditing the current codebase against those artifacts and appending any unbuilt or incomplete work as new, traceable tasks to tasks.md. ## Core Features & Use Cases - Gap Assessment: Reads spec.md, plan.md, and tasks.md as the source of intent, inspects the code in scope, and classifies findings as missing, partial, contradicts, or unrequested with severity levels. - Append-Only Task Generation: Adds a new numbered Convergence phase to tasks.md with zero-padded task IDs, never modifying existing tasks, specs, plans, or application code. - Constitution Enforcement: Treats violations of MUST principles in .specify/memory/constitution.md as CRITICAL findings requiring remediation tasks. - Use Case: After /speckit-implement finishes, run this Skill to discover that FR-008's append-only guard was never built; it appends a HIGH-severity task so the next implement pass completes it. ## Quick Start Run the speckit-converge skill to check my current implementation against the feature spec and append any remaining work to tasks.md.

Frequently Asked Questions about speckit-converge

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if my implementation matches the spec in spec-kit?

Run the speckit-converge skill after /speckit-implement. It reads spec.md, plan.md, and tasks.md as the source of intent, inspects the code in scope, and appends any remaining work as new tasks to tasks.md.

How to find missing requirements after running speckit-implement?

Run a convergence pass: it classifies each gap as missing, partial, contradicts, or unrequested, assigns a severity from CRITICAL to LOW, and appends one traceable task per finding under a new Convergence phase in tasks.md.

Does speckit-converge modify my existing tasks or code?

No. It is strictly append-only: it never rewrites, renumbers, or deletes existing tasks, never touches spec.md or plan.md, and never modifies application code. If everything is satisfied, tasks.md is left byte-for-byte unchanged.

What prerequisites does speckit-converge need to run?

It requires a spec-kit project with a .specify directory containing spec.md, plan.md, and a complete tasks.md for the feature. It must run after /speckit-tasks and /speckit-implement; missing artifacts cause it to stop with a message naming the prerequisite command.

When should I not use convergence checking?

Do not use it as a diff or change-tracking tool, since it assesses only the present state of code with no git history or branch comparison. It also cannot complete the work itself; appended tasks must be finished by /speckit-implement.