speckit-converge

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

Updated Jul 8, 2026
One-click install
npx skills add https://github.com/NarenKarthikBM/specseyal --skill speckit-converge-narenkarthikbm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-converge
Source: https://github.com/NarenKarthikBM/specseyal/tree/main/.claude/skills/speckit-converge
Command: npx skills add https://github.com/NarenKarthikBM/specseyal --skill speckit-converge-narenkarthikbm

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 to tasks.md. ## 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, with severity levels from CRITICAL to LOW. - Append-Only Task Generation: Adds 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 everything is already satisfied. - Constitution Enforcement: Treats violations of MUST principles in .specify/memory/constitution.md as the highest-severity findings. - 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 HIGH-severity task to tasks.md so the next implement pass completes it. ## 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 /speckit-implement. It reads spec.md, plan.md, and tasks.md, inspects the current code, and appends any unmet requirements as new tasks to tasks.md for the next implement pass.

How to find missing requirements after implementing a feature?

Use a convergence pass that compares the code against functional requirements, acceptance criteria, and plan decisions. Findings are classified as missing, partial, contradicts, or unrequested and converted into traceable tasks with severity levels.

Does speckit-converge modify my existing tasks or code?

No. It is strictly append-only: it adds a new Convergence phase at the end of tasks.md and never rewrites, renumbers, or deletes existing tasks, nor touches spec.md, plan.md, or application code.

What happens when the codebase already satisfies the spec?

The skill 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.

When should I run speckit-converge in the workflow?

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