speckit-converge

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

Updated May 5, 2026
One-click install
npx skills add https://github.com/nikegeorgian-stack/otgruzka-tovara --skill speckit-converge-nikegeorgian-stack
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-converge
Source: https://github.com/nikegeorgian-stack/otgruzka-tovara/tree/main/.cursor/skills/speckit-converge
Command: npx skills add https://github.com/nikegeorgian-stack/otgruzka-tovara --skill speckit-converge-nikegeorgian-stack

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After an implementation pass, it is hard to know whether the code actually satisfies everything the feature's spec, plan, and tasks promised. This Skill closes that gap by auditing the current codebase against those artifacts and appending any unfinished work as new, traceable tasks so nothing falls through the cracks. ## Core Features & Use Cases - Gap Assessment: Reads spec.md, plan.md, and tasks.md as the source of intent and classifies every discrepancy as missing, partial, contradicts, or unrequested, with severity levels from CRITICAL to LOW. - Append-Only Task Generation: Adds a new Convergence phase to tasks.md with zero-padded task IDs traced back to their source requirement, without ever modifying existing tasks, specs, plans, or code. - Constitution Enforcement: Treats violations of project constitution MUST principles as the highest-severity findings and emits remediation tasks first. - Use Case: After running an implementation pass on a feature, invoke this Skill to verify the code covers all functional requirements and acceptance criteria; it either reports the feature as converged or appends the remaining work for the next implement run. ## Quick Start Ask the assistant to run the speckit-converge skill to check the current feature's 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 speckit-converge skill after an implementation pass. It reads spec.md, plan.md, and tasks.md as the source of intent, inspects the current code, and reports any gaps as severity-graded findings before appending them as new tasks.

How do I add remaining work to tasks.md without rewriting existing tasks?▼

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

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

Run it only after speckit-tasks has produced a complete tasks.md and speckit-implement has executed on it. It requires a spec-kit project structure with a .specify directory and the feature's spec, plan, and tasks files present.

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 the appended tasks is the job of speckit-implement.

What happens when the codebase 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 you proceed to review or open a PR.