speckit-converge

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

Updated Sep 12, 2026
One-click install
npx skills add https://github.com/AndyRace/heart-rate-graph --skill speckit-converge-andyrace
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-converge
Source: https://github.com/AndyRace/heart-rate-graph/tree/main/.github/skills/speckit-converge
Command: npx skills add https://github.com/AndyRace/heart-rate-graph --skill speckit-converge-andyrace

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 with severity levels. - 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. - 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 converge to verify FR-008 is actually implemented; if not, a new task like "T042 Add append-only enforcement per FR-008 (missing)" is appended for the next implement pass. ## Quick Start Ask the agent to run the speckit-converge skill to check the current codebase 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 spec after implementation?

Run the speckit-converge skill after /speckit-implement. It reads spec.md, plan.md, and tasks.md as the source of intent, 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 requires a spec-kit project structure with a .specify directory and will stop with a clear message if spec, plan, or tasks files are missing.

Does speckit-converge modify my existing tasks or code?

No. It is strictly append-only: it adds a new Convergence phase section to 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 codebase 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. It then recommends proceeding to review or opening a PR.

How does speckit-converge handle constitution violations?

Code violating a MUST principle in .specify/memory/constitution.md is classified as a CRITICAL finding, and a corresponding remediation task is emitted first in the Convergence phase. If the constitution is an unfilled template, checks are skipped gracefully.