speckit-converge

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

9|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/timcsy/semorphe --skill speckit-converge-timcsy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-converge
Source: https://github.com/timcsy/semorphe/tree/main/.claude/skills/speckit-converge
Command: npx skills add https://github.com/timcsy/semorphe --skill speckit-converge-timcsy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After running an implementation pass, teams often cannot tell whether the code actually satisfies everything the spec, plan, and tasks demanded. 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 the job. ## Core Features & Use Cases - Gap Assessment: Compares functional requirements, acceptance criteria, plan decisions, and constitution principles against the actual code, 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-traced tasks, never rewriting or renumbering existing tasks. - Constitution Enforcement: Treats violations of project constitution MUST principles as the highest-severity findings and emits CRITICAL remediation tasks first. - Use Case: After running /speckit-implement on a feature, run this Skill to discover that FR-008's append-only guard was never built; it appends a HIGH-severity task to tasks.md so the next implement pass completes it. ## Quick Start Ask the assistant 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 command after /speckit-implement. It reads spec.md, plan.md, and tasks.md as the source of intent, inspects the current code, and reports gaps classified as missing, partial, contradicts, or unrequested.

What does speckit-converge do with the gaps it finds?

It appends a new Phase N: Convergence section to the end of tasks.md with one checklist task per finding, ordered by severity and traced to its source requirement. It never rewrites, renumbers, or deletes 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 are missing.

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

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

What happens if the code already satisfies everything in the spec?

The command leaves tasks.md byte-for-byte unchanged and reports a converged result with counts of what was checked. It then recommends proceeding to review or opening a pull request.