speckit-converge

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

Updated Jul 16, 2026
One-click install
npx skills add https://github.com/Carl-Fabri/TestAngularSpecDriven --skill speckit-converge-carl-fabri
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-converge
Source: https://github.com/Carl-Fabri/TestAngularSpecDriven/tree/main/test-angular/.claude/skills/speckit-converge
Command: npx skills add https://github.com/Carl-Fabri/TestAngularSpecDriven --skill speckit-converge-carl-fabri

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 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. - Severity-Graded Findings: Ranks findings CRITICAL through LOW, treating constitution MUST violations as highest severity, and presents a summary table before writing anything. - Append-Only Task Generation: Appends a new "Phase N: Convergence" section with zero-padded task IDs to tasks.md without modifying spec.md, plan.md, existing tasks, or any application code. - Use Case: After running /speckit-implement on a feature, run converge to verify FR-008 is actually enforced in the code; if not, a new task like "T042 Add append-only enforcement per FR-008 (missing)" is appended for the next implement pass. ## 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 code matches the feature spec in spec-kit?

Run the speckit-converge command after /speckit-implement. It reads spec.md, plan.md, and tasks.md, inspects the code in scope, and reports findings classified as missing, partial, contradicts, or unrequested with severity levels.

How to add remaining implementation work to tasks.md automatically?

Converge appends a new "Phase N: Convergence" section to the end of tasks.md with one checklist item per finding, using zero-padded IDs continuing from the highest existing task ID. It never rewrites or renumbers existing tasks.

When should I run speckit-converge in the spec-kit workflow?

Run it only after /speckit-tasks has produced a complete tasks.md and /speckit-implement has executed on it. It requires spec.md, plan.md, and tasks.md to exist, and stops with a message naming the prerequisite command if any is missing.

Does speckit-converge modify my application code or spec files?

No. Its only write is appending a Convergence phase to tasks.md. It never modifies spec.md, plan.md, existing tasks, or application code; completing appended tasks is the job of /speckit-implement.

What happens when the codebase already satisfies the spec?

Converge leaves tasks.md byte-for-byte unchanged and reports a converged result with summary counts of requirements, plan decisions, and constitution principles checked. It then recommends proceeding to review or opening a PR.