speckit-converge

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

Updated Aug 19, 2026
One-click install
npx skills add https://github.com/Base-Analitica/mouse-hub --skill speckit-converge-base-analitica
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-converge
Source: https://github.com/Base-Analitica/mouse-hub/tree/main/.jcode/skills/speckit-converge
Command: npx skills add https://github.com/Base-Analitica/mouse-hub --skill speckit-converge-base-analitica

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 promised. This Skill closes that gap by auditing the current codebase against those artifacts and appending any unfinished work as new, traceable tasks to tasks.md. ## Core Features & Use Cases - Gap Assessment: Reads spec.md, plan.md, and tasks.md as the source of intent, inspects the in-scope code, and classifies findings as missing, partial, contradicts, or unrequested. - Severity Grading: Ranks findings CRITICAL through LOW, with constitution MUST violations treated as the highest severity. - Append-Only Task Generation: Adds a new numbered Convergence phase to tasks.md with zero-padded task IDs, never rewriting or renumbering existing tasks. - 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 task like "T042 Add append-only enforcement per FR-008 (missing)" so the next implement pass completes it. ## Quick Start Ask the AI 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 command after speckit-implement. It reads spec.md, plan.md, and tasks.md, inspects the in-scope code, and appends any remaining work as new tasks to tasks.md for the next implement pass.

How to find missing requirements after running speckit-implement?▼

Use speckit-converge, which builds an intent inventory from functional requirements, acceptance scenarios, and plan decisions, then classifies each gap as missing, partial, contradicts, or unrequested with a severity rating.

Does speckit-converge modify spec.md or existing tasks?▼

No. It is strictly append-only: it never modifies spec.md or plan.md, never rewrites or renumbers existing tasks, and only appends a new Convergence phase to tasks.md when actionable findings exist.

What happens when the codebase already satisfies the spec?▼

The command 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 PR.

When should speckit-converge not be run?▼

Do not run it before speckit-tasks has produced a complete tasks.md or before speckit-implement has executed on it. It also requires the spec-kit project structure with a .specify directory and will stop with a clear message if artifacts are missing.