speckit-converge

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

Updated Sep 13, 2026
One-click install
npx skills add https://github.com/secrakib/rag-eval-project --skill speckit-converge-secrakib
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-converge
Source: https://github.com/secrakib/rag-eval-project/tree/main/.agents/skills/speckit-converge
Command: npx skills add https://github.com/secrakib/rag-eval-project --skill speckit-converge-secrakib

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 promised. 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 it. ## Core Features & Use Cases - Gap Assessment: Classifies findings as missing, partial, contradicts, or unrequested, each traced to a source reference like FR-003, US1/AC2, or a constitution principle. - Severity Grading: Ranks findings CRITICAL through LOW, with constitution MUST violations treated as the highest severity. - Append-Only Task Generation: Adds a new numbered Convergence phase to tasks.md with zero-padded task IDs, never rewriting or renumbering existing tasks. - Use Case: After running /speckit-implement on a feature, run converge to discover that FR-008's append-only guard was never built; the Skill appends it as task T042 under a new Convergence phase for the next implement pass. ## Quick Start Ask the agent to 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 speckit-converge skill after /speckit-implement. It reads spec.md, plan.md, and tasks.md as the source of intent, inspects the current code, and appends any remaining work as new tasks under a Convergence phase in tasks.md.

How to find missing requirements after running speckit-implement?▼

Use the converge command, which builds an intent inventory from functional requirements, acceptance scenarios, and plan decisions, then classifies each gap as missing, partial, contradicts, or unrequested with severity levels from CRITICAL to LOW.

When should I run speckit-converge in the workflow?▼

Run it only after /speckit-tasks has produced a complete tasks.md and /speckit-implement has executed on it. It requires the spec-kit project structure with a .specify directory and will stop with guidance if spec.md, plan.md, or tasks.md is missing.

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

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

What happens when 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 pull request.