speckit-converge

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

5|1|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/theonlytruebigmac/n-central-rest-api-mcp --skill speckit-converge-theonlytruebigmac
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-converge
Source: https://github.com/theonlytruebigmac/n-central-rest-api-mcp/tree/main/.agents/skills/speckit-converge
Command: npx skills add https://github.com/theonlytruebigmac/n-central-rest-api-mcp --skill speckit-converge-theonlytruebigmac

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After an implementation pass, it is hard to know whether the code actually satisfies everything the feature's spec, plan, and tasks promised. This Skill closes that gap by auditing the current codebase against those artifacts and appending any unfinished work as new, traceable tasks so nothing falls through the cracks. ## Core Features & Use Cases - Gap Assessment: Compares the live codebase against functional requirements, acceptance criteria, plan decisions, and constitution principles, classifying findings as missing, partial, contradicts, or unrequested. - Append-Only Task Generation: Adds a new numbered Convergence phase to tasks.md with severity-ordered, source-traceable tasks, never rewriting or renumbering existing tasks. - Constitution Enforcement: Treats violations of project constitution MUST principles as critical findings requiring remediation tasks. - Use Case: After running an implementation pass on a feature, run this Skill to verify the code covers every FR and acceptance scenario; it appends tasks like "T042 Add append-only guard per FR-008 (missing)" for the next implement run. ## 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 code matches the spec after implementation?▼

Run the converge command after an implementation pass. It reads spec.md, plan.md, and tasks.md as the source of intent, inspects the current code, and appends any unmet requirements as new tasks to tasks.md for the next implement run.

How do I find missing requirements in a spec-kit feature?▼

The converge workflow builds an inventory of every functional requirement, acceptance scenario, and plan decision, then classifies gaps as missing, partial, contradicts, or unrequested with severity levels from CRITICAL to LOW.

When should I run speckit-converge in the workflow?▼

Run it only after speckit-tasks has produced a complete tasks.md and speckit-implement has executed on it. It requires a spec-kit project structure with a .specify directory and the feature's spec, plan, and tasks files present.

Does speckit-converge modify my existing tasks or code?▼

No. It is strictly append-only: it adds a new Convergence phase section at the end of tasks.md and never rewrites, renumbers, or deletes existing tasks, nor touches spec.md, plan.md, or application code.

What happens if the code already satisfies the entire spec?▼

The skill leaves tasks.md byte-for-byte unchanged and reports a converged result with counts of requirements, plan decisions, and constitution principles checked, recommending you proceed to review or open a pull request.