speckit-converge

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

Updated Aug 24, 2026
One-click install
npx skills add https://github.com/Fras0/clinics-api --skill speckit-converge-fras0
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-converge
Source: https://github.com/Fras0/clinics-api/tree/main/.cursor/skills/speckit-converge
Command: npx skills add https://github.com/Fras0/clinics-api --skill speckit-converge-fras0

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 those artifacts and appending any unfinished work as new, traceable tasks so the implement step can finish the job. ## 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 numbered Convergence phase to tasks.md with zero-padded task IDs, never rewriting or renumbering existing tasks, and leaves the file untouched when everything is already satisfied. - Constitution Enforcement: Treats violations of MUST principles in the project constitution as critical findings that produce 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 agent 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 skill after /speckit-implement. It reads spec.md, plan.md, and tasks.md as the source of intent, inspects the code in scope, and reports findings classified as missing, partial, contradicts, or unrequested.

How does speckit-converge handle unfinished tasks?▼

It appends a new '## Phase N: Convergence' section to the end of tasks.md with one checklist item per actionable finding, ordered CRITICAL/HIGH first. Existing tasks are never rewritten, renumbered, or deleted, and IDs continue from the highest existing number.

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 spec.md or application code?▼

No. Its only write is appending a Convergence phase to tasks.md. It never modifies spec.md or plan.md, never touches application code, and leaves tasks.md byte-for-byte unchanged when the implementation already satisfies everything.

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

It reports 'Converged — the implementation satisfies the spec, plan, and tasks' with summary counts of what was checked, and recommends proceeding to review or opening a PR. No empty phase header is added to tasks.md.