speckit-converge

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After running an implementation pass, teams often cannot tell whether the code actually satisfies the feature's specification, plan, and task list. This Skill closes that gap by auditing the current codebase against 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, with severity levels from CRITICAL to LOW tied to requirements, acceptance criteria, plan decisions, and constitution principles. - Append-Only Task Generation: Adds a new numbered Convergence phase to tasks.md with zero-padded task IDs, never rewriting, renumbering, or deleting existing tasks, and never touching application code. - Extension Hooks: Supports before_converge and after_converge hooks declared in .specify/extensions.yml, executing mandatory hooks and surfacing optional ones. - Use Case: After running /speckit-implement on a feature, run this Skill to verify FR-008 is actually enforced in the code; if not, it appends a HIGH-severity task referencing FR-008 so the next implement pass completes it. ## Quick Start Ask the agent to run the speckit-converge skill to check the current codebase against the feature spec 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 code matches the spec after implementation?▼

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 close gaps between specification and implementation in spec-kit?▼

Use the converge workflow: it classifies each gap as missing, partial, contradicts, or unrequested, assigns a severity, and appends one traceable task per finding under a new Convergence phase in tasks.md for /speckit-implement to complete.

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

No. It is strictly append-only: it never rewrites, renumbers, or deletes existing tasks, never modifies spec.md or plan.md, and never changes application code. Its only write is a new Convergence phase at the end of tasks.md.

What prerequisites are required before running speckit-converge?▼

The project needs a spec-kit structure with .specify directory, plus spec.md, plan.md, and a complete tasks.md for the feature. /speckit-implement must have already run on the current tasks.md, and the workflow mode must be set to speckit.

What happens when the codebase already satisfies the spec?▼

The skill leaves tasks.md byte-for-byte unchanged and reports a converged result with counts of requirements, plan decisions, and constitution principles checked. It then recommends proceeding to review or opening a pull request.