speckit-converge

Assess codebase against spec-kit artifacts and append remaining work to tasks.md.

1|Updated Nov 21, 2020
One-click install
npx skills add https://github.com/LuanDopke/persefone --skill speckit-converge-luandopke
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-converge
Source: https://github.com/LuanDopke/persefone/tree/main/.agents/skills/speckit-converge
Command: npx skills add https://github.com/LuanDopke/persefone --skill speckit-converge-luandopke

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After running an implementation pass, teams often cannot tell whether the code actually satisfies the feature's spec, plan, and tasks. This Skill closes that gap by auditing the current codebase against spec-kit artifacts and appending any unbuilt work as new traceable tasks. ## Core Features & Use Cases - Gap Assessment: Reads spec.md, plan.md, and tasks.md as the source of intent, then classifies findings as missing, partial, contradicts, or unrequested with severity levels. - Append-Only Task Generation: Adds a new numbered Convergence phase to tasks.md with zero-padded task IDs, never rewriting or renumbering existing tasks. - Constitution Enforcement: Treats violations of MUST principles in .specify/memory/constitution.md as CRITICAL findings requiring remediation tasks. - Use Case: After /speckit-implement finishes, run this Skill to verify FR-008 is actually implemented; if not, it appends a task like "T042 Add append-only enforcement per FR-008 (missing)" for the next implement pass. ## Quick Start Run the speckit-converge skill to check my current codebase against the feature spec 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 code matches the spec after implementation?▼

Run the converge command after /speckit-implement completes. It reads spec.md, plan.md, and tasks.md, inspects the code in scope, and appends any remaining work as new tasks to tasks.md for another implement pass.

What is spec-kit convergence in a spec-driven workflow?▼

Convergence is the audit step that compares the present state of the code against the feature's specification, plan, and tasks. It produces severity-graded findings and appends traceable remediation tasks without modifying any existing artifacts.

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 does it touch spec.md, plan.md, or application code.

When should I run converge versus implement in spec-kit?▼

Run converge only after /speckit-tasks has produced a complete tasks.md and /speckit-implement has run on it. Converge finds remaining gaps; implement completes the appended tasks. Repeat converge until it reports a clean result.

What happens if 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.