speckit-converge

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

Updated May 19, 2026
One-click install
npx skills add https://github.com/Nasalciuc/ATS-HERO --skill speckit-converge-nasalciuc
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-converge
Source: https://github.com/Nasalciuc/ATS-HERO/tree/main/.cursor/skills/speckit-converge
Command: npx skills add https://github.com/Nasalciuc/ATS-HERO --skill speckit-converge-nasalciuc

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. - Severity Grading: Ranks findings CRITICAL through LOW, with constitution MUST violations treated as highest severity. - Append-Only Task Generation: Appends a new "Phase N: Convergence" section to tasks.md with zero-padded task IDs, never rewriting or renumbering existing tasks. - Use Case: After /speckit-implement finishes, run converge to discover that FR-008's append-only guard was never built; the Skill appends a HIGH-severity task so the next implement pass completes it. ## 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 speckit-converge skill after /speckit-implement. It reads spec.md, plan.md, and tasks.md, inspects the code in scope, and appends any remaining work as new tasks to tasks.md.

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 is a post-implementation audit, not a planning or diff tool.

Does speckit-converge modify spec.md or existing tasks?▼

No. It is strictly append-only: it never modifies spec.md or plan.md, never rewrites or renumbers existing tasks, and never changes application code. Its only write is appending a new Convergence phase to tasks.md.

What happens if the code already satisfies the spec?▼

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

What are the prerequisites for running speckit-converge?▼

The project needs a .specify directory with spec.md, plan.md, and tasks.md for the current feature. If any artifact is missing, the skill stops and names the prerequisite command to run first.