speckit-converge

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

Updated Aug 25, 2026
One-click install
npx skills add https://github.com/Sergiotsk/Interstellar --skill speckit-converge-sergiotsk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-converge
Source: https://github.com/Sergiotsk/Interstellar/tree/main/interstellar/.claude/skills/speckit-converge
Command: npx skills add https://github.com/Sergiotsk/Interstellar --skill speckit-converge-sergiotsk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After an implementation pass, teams often cannot tell whether the code actually satisfies everything the specification, plan, and task list 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: Compares functional requirements, acceptance criteria, plan decisions, and constitution principles against the actual code, classifying findings as missing, partial, contradicts, or unrequested. - Append-Only Task Generation: Adds a new numbered Convergence phase to tasks.md with zero-padded task IDs ordered by severity, never rewriting or renumbering existing tasks. - Severity Grading: Ranks findings CRITICAL through LOW, with constitution MUST violations treated as the highest severity. - Use Case: After running /speckit-implement on a feature, run this Skill to verify nothing was missed; it either reports the feature as converged or appends the remaining tasks for another implement pass. ## 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 converge command after /speckit-implement has completed. It reads spec.md, plan.md, and tasks.md as the source of intent, inspects the current code, and reports findings classified by gap type and severity.

What does speckit-converge do when it finds missing work?▼

It appends a new Phase N: Convergence section to the end of tasks.md with one checklist item per finding, ordered CRITICAL and HIGH first. Existing tasks are never rewritten, renumbered, or deleted.

Can converge modify spec.md or application code?▼

No. The command is strictly append-only to tasks.md. It never modifies spec.md, plan.md, or any application code; completing the appended tasks is the job of /speckit-implement.

When should I run the converge command in a spec-kit workflow?▼

Run it only after /speckit-tasks has produced a complete tasks.md and /speckit-implement has run on it. It assesses the present state of the code without using git history or branch comparison.

What happens if the codebase already satisfies everything?▼

The command leaves tasks.md byte-for-byte unchanged and reports a converged result with summary counts of requirements, plan decisions, and constitution principles checked. No empty phase header is added.

Does converge require a project constitution file?▼

It checks .specify/memory/constitution.md if present, treating MUST-principle violations as CRITICAL findings. If the constitution is an unfilled template, those checks are skipped gracefully rather than failing.