speckit-converge

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After an implementation pass, teams often cannot tell 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 the spec-kit 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 sole source of intent, inspects the in-scope code, and classifies findings as missing, partial, contradicts, or unrequested with severity levels. - Append-Only Task Generation: Appends a new numbered Convergence phase to tasks.md with zero-padded task IDs, never rewriting or renumbering existing tasks, and leaves the file untouched when fully converged. - Constitution Enforcement: Treats violations of MUST principles in .specify/memory/constitution.md as CRITICAL findings with remediation tasks. - 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 Run the speckit-converge skill to check my current feature 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 /speckit-implement. It reads spec.md, plan.md, and tasks.md as the source of intent, inspects the in-scope code, and reports findings classified by gap type and severity before appending remediation 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 is a post-implementation audit, not a diff tool, and it assesses the present state of the code without using git history.

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

No. Its only write is appending a new Convergence phase section to the end of tasks.md. It never modifies spec.md, plan.md, existing tasks, or application code, and leaves tasks.md byte-for-byte unchanged when everything is satisfied.

What happens when speckit-converge finds no remaining work?▼

It reports a converged outcome with the message that the implementation satisfies the spec, plan, and tasks, plus counts of what was checked. It does not add an empty phase header and recommends proceeding to review or opening a PR.

How does speckit-converge handle constitution violations?▼

Violations of MUST principles in .specify/memory/constitution.md are the highest-severity findings and produce CRITICAL remediation tasks emitted first. If the constitution is an unfilled template, those checks are skipped gracefully.