speckit-converge

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After running an implementation pass, teams often cannot tell whether the code actually satisfies everything the spec, plan, and tasks 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 the job. ## Core Features & Use Cases - Gap Detection and Classification: Finds missing, partial, contradicting, or unrequested work by comparing the intent inventory (requirements, acceptance criteria, plan decisions, constitution principles) against the actual code. - 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. - Extension Hook Support: Executes optional and mandatory before/after convergence hooks defined in .specify/extensions.yml. - Use Case: After running /speckit-implement on a feature, run this Skill to verify nothing from the spec was missed; it either reports a clean converged state or appends the remaining tasks for another implement pass. ## Quick Start Ask the agent to run the speckit-converge skill to check the current feature's implementation against its 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 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 either reports a converged state or appends remaining work as new tasks.

How do I add missing tasks to tasks.md without rewriting existing ones?▼

The converge workflow is append-only: it computes the next task IDs and phase number, then adds a new Convergence phase at the bottom of tasks.md. Existing tasks are never renumbered, reordered, or deleted.

Does speckit-converge require a spec-kit project structure?▼

Yes, it requires a .specify directory with the feature's spec.md, plan.md, and tasks.md already generated by /speckit-specify, /speckit-plan, and /speckit-tasks. It stops with a clear message naming the prerequisite command if any artifact is missing.

Can speckit-converge modify my application code or spec files?▼

No, its only write operation is appending a Convergence phase to tasks.md. It never modifies spec.md, plan.md, or application code; completing the appended tasks is the job of /speckit-implement.

What happens when the code already satisfies the spec?▼

When no gaps are found, 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 review or a pull request.