speckit-converge

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

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

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 nothing specified is silently dropped. ## Core Features & Use Cases - Gap Assessment: Reads spec.md, plan.md, and tasks.md as the sole source of intent, inspects the in-scope code, and classifies findings as missing, partial, contradicts, or unrequested. - Severity Grading: Ranks findings CRITICAL through LOW, treating constitution MUST violations as the highest severity, and presents a summary table before writing anything. - 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 fully converged. - Use Case: After /speckit-implement finishes 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 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 code matches the spec after implementation?▼

Run the converge command after /speckit-implement. It reads spec.md, plan.md, and tasks.md as the source of intent, inspects the in-scope code, and reports findings classified as missing, partial, contradicts, or unrequested.

How does speckit-converge handle unfinished requirements?▼

It appends each gap as a new task under a numbered Convergence phase at the end of tasks.md, ordered CRITICAL and HIGH first. Existing tasks are never rewritten, renumbered, or deleted, and /speckit-implement completes the appended work.

What prerequisites does speckit-converge require?▼

It requires a spec-kit project with a .specify directory containing spec.md, plan.md, and a complete tasks.md for the current feature. If any artifact is missing, it stops and names the prerequisite command to run first.

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, plan.md, or any application code, and when everything is satisfied it leaves tasks.md byte-for-byte unchanged.

When should I not use speckit-converge?▼

Do not use it as a diff or change-tracking tool, since it assesses only the present code state with no git history or branch comparison. It also cannot run before /speckit-tasks has produced a complete tasks.md.