speckit-converge

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

Updated Apr 18, 2026
One-click install
npx skills add https://github.com/PanyaPrimal/selfHandlerApp --skill speckit-converge-panyaprimal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-converge
Source: https://github.com/PanyaPrimal/selfHandlerApp/tree/main/.agents/skills/speckit-converge
Command: npx skills add https://github.com/PanyaPrimal/selfHandlerApp --skill speckit-converge-panyaprimal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After an implementation pass, teams often cannot tell whether the code actually satisfies everything the spec, plan, and tasks promised. This Skill closes that gap by auditing the current codebase against the feature's spec.md, plan.md, and tasks.md, then appending any unbuilt or incomplete work as new traceable tasks so the implement step can finish it. ## Core Features & Use Cases - Gap Assessment: Classifies every finding as missing, partial, contradicts, or unrequested, with severity levels from CRITICAL to LOW and traceable source references (FR-###, SC-###, US#/AC#, constitution principles). - Append-Only Task Generation: Adds a new numbered Convergence phase to tasks.md with zero-padded task IDs, never rewriting, renumbering, or deleting existing tasks. - Constitution Enforcement: Treats violations of MUST principles in .specify/memory/constitution.md as the highest-severity findings. - Use Case: After running the implement command on a feature, run converge to verify the code covers all acceptance criteria; it either reports a clean converged result or appends the remaining work 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, plan, and tasks 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 implement has finished. It reads spec.md, plan.md, and tasks.md as the source of intent, inspects the code in scope, and either reports a converged result or appends remaining work as new tasks.

What does the converge command write to tasks.md?

It appends a single new 'Phase N: Convergence' section at the end of tasks.md with one checklist item per finding, using the next available zero-padded task IDs. It never rewrites, renumbers, or deletes existing tasks, and leaves the file untouched when nothing remains.

When should I run speckit converge in the workflow?

Run it only after the tasks command has produced a complete tasks.md and the implement command has executed on it. Running it earlier fails with a message naming the prerequisite command to run first.

Does converge modify spec.md, plan.md, or application code?

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

How does converge handle constitution violations?

Violations of MUST principles in .specify/memory/constitution.md are classified as CRITICAL findings and emitted first in the appended task list. If the constitution is an unfilled template, the check is skipped gracefully.