speckit-converge

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

Updated Jan 28, 2026
One-click install
npx skills add https://github.com/alkampfergit/cisharpai --skill speckit-converge-alkampfergit
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-converge
Source: https://github.com/alkampfergit/cisharpai/tree/main/.claude/skills/speckit-converge
Command: npx skills add https://github.com/alkampfergit/cisharpai --skill speckit-converge-alkampfergit

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 the spec-kit artifacts and appending any unbuilt or incomplete work as new, traceable tasks to tasks.md. ## Core Features & Use Cases - Gap Assessment: Compares the live codebase against spec.md requirements, plan.md decisions, and tasks.md items, 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: Flags violations of project constitution MUST principles as CRITICAL findings with remediation tasks. - Use Case: After running /speckit-implement on a feature, run this Skill to discover that FR-008's validation logic was never built; it appends a task like "T042 Add input validation per FR-008 (missing)" 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 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 to tasks.md.

How does speckit-converge handle gaps it finds in the code?▼

Each gap is classified as missing, partial, contradicts, or unrequested, assigned a severity from CRITICAL to LOW, and appended as a new task under a numbered Convergence phase in tasks.md with a source reference like FR-003 or US1/AC2.

Does speckit-converge modify existing tasks or application 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. Completing appended tasks is the job of /speckit-implement.

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, recommending you proceed to review or open a PR.

What are the prerequisites for running speckit-converge?▼

The project must have a spec-kit structure with a .specify directory, and the feature must have spec.md, plan.md, and a complete tasks.md. It should run only after /speckit-tasks and /speckit-implement have executed.