speckit-converge

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

Updated Dec 12, 2024
One-click install
npx skills add https://github.com/kipariss1/czech_out_auto_bot --skill speckit-converge-kipariss1
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-converge
Source: https://github.com/kipariss1/czech_out_auto_bot/tree/main/.claude/skills/speckit-converge
Command: npx skills add https://github.com/kipariss1/czech_out_auto_bot --skill speckit-converge-kipariss1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After running 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 unfinished work as new, traceable tasks so nothing falls through the cracks. ## 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. - Severity Grading: Ranks findings CRITICAL through LOW, treating constitution MUST violations as the highest severity. - 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. - Use Case: After running /speckit-implement on a feature, run this Skill to verify the implementation covers every functional requirement and acceptance criterion, then hand the appended tasks back to /speckit-implement. ## Quick Start Ask the assistant 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 appends any remaining work as new tasks to tasks.md.

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

Use speckit-converge, which classifies gaps as missing, partial, contradicts, or unrequested and grades them by severity from CRITICAL to LOW. Each actionable finding becomes a new traceable task in a Convergence phase.

Does speckit-converge modify existing tasks or code?▼

No. It is strictly append-only: it only adds a new Phase N Convergence section to tasks.md and never rewrites, renumbers, or deletes existing tasks, nor touches spec.md, plan.md, or application code.

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 PR.

What are the prerequisites for running speckit-converge?▼

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