speckit-converge

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

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

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. ## Core Features & Use Cases - Gap Assessment: Reads spec.md, plan.md, and tasks.md as the source of intent and classifies findings as missing, partial, contradicts, or unrequested work. - Severity Grading: Ranks findings from CRITICAL (constitution violations) to LOW, and enforces the project constitution as a non-negotiable authority. - 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 an acceptance criterion from US2 was never built; it appends a task like "T042 Add retry logic per FR-008 (missing)" so the next implement pass completes it. ## Quick Start Ask the agent 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 code in scope, and reports findings graded by severity before appending 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 ID and phase number, then adds a new "Phase N: Convergence" section at the end of tasks.md. Existing tasks are never renumbered, reordered, or deleted.

What project structure does speckit-converge require?

It requires a spec-kit project with a .specify directory containing spec.md, plan.md, and 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 my application code?

No. It never creates, modifies, or deletes application code. Its only write is appending convergence tasks to tasks.md; completing those tasks is the job of speckit-implement.

What happens when the code already satisfies the spec?

When no gaps are found, it leaves tasks.md byte-for-byte unchanged and reports a converged result with counts of requirements, plan decisions, and constitution principles checked, recommending you proceed to review or open a PR.