speckit-converge

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

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

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 demanded. 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 Assessment: Compares functional requirements, acceptance scenarios, 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 modifying existing tasks, specs, or code. - 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 discover that FR-008's append-only guard was never built; it appends a new 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 implementation matches the spec in spec-kit?▼

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

How does speckit-converge handle remaining unbuilt work?▼

It appends each gap as a new task under a new Convergence phase at the end of tasks.md, with zero-padded IDs continuing from the highest existing task number. It never rewrites, renumbers, or deletes existing tasks.

What prerequisites does speckit-converge require before running?▼

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

Does speckit-converge modify my code or spec files?▼

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

What happens when the codebase already satisfies the spec?▼

It 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 pull request.