speckit-converge

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

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/dperussina/function2agent --skill speckit-converge-dperussina
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-converge
Source: https://github.com/dperussina/function2agent/tree/main/.cursor/skills/speckit-converge
Command: npx skills add https://github.com/dperussina/function2agent --skill speckit-converge-dperussina

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After an implementation pass, teams often cannot tell whether the code actually satisfies the feature's spec, plan, and tasks. This Skill closes that gap by auditing the current codebase against those artifacts and appending any unbuilt work as new, traceable tasks so the implement step can finish it. ## 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 Convergence phase to tasks.md with zero-padded task IDs traced to their source requirement, without modifying any existing tasks or code. - Constitution Enforcement: Treats violations of project constitution MUST principles as critical findings requiring remediation tasks. - Use Case: After running the implement step on a feature, run converge to verify nothing was missed; if gaps exist, it appends tasks like "T042 Add append-only guard per FR-008 (missing)" for the next implement pass. ## Quick Start Ask the agent to run the speckit-converge skill to check the current feature's implementation against its 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 converge command after the implement step. It reads spec.md, plan.md, and tasks.md as the source of intent, inspects the code in scope, and reports findings classified by gap type and severity before appending remaining work to tasks.md.

How do I add missing tasks to tasks.md without rewriting existing ones?▼

Converge is strictly append-only: it adds a new Convergence phase at the end of tasks.md with zero-padded IDs continuing from the highest existing task number. It never renumbers, reorders, or deletes existing tasks, and leaves the file unchanged when nothing remains.

What are the prerequisites for running spec-kit converge?▼

The project needs a spec-kit structure with .specify directory, and the feature must have spec.md, plan.md, and a complete tasks.md. Converge must run only after the implement step has executed on the current tasks.md.

Does converge modify my application code or spec files?▼

No. Converge never modifies spec.md, plan.md, or any application code. Its only write is appending a new Convergence phase to tasks.md; completing those tasks is the job of the implement command.

What happens when converge finds no remaining work?▼

It reports a converged outcome stating the implementation satisfies the spec, plan, and tasks, leaves tasks.md byte-for-byte unchanged, and recommends proceeding to review or opening a pull request.