speckit-converge

Compare code against spec.md, plan.md, and tasks.md to identify implementation gaps.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill resolves the drift between technical specifications, project plans, and the actual codebase by identifying missing or incomplete work and tracking it for implementation.

Core Features & Use Cases

  • Gap Analysis: Automatically compares the current state of the code against requirements defined in spec.md, plan.md, and tasks.md.
  • Traceable Task Generation: Appends missing work as new, actionable tasks to tasks.md, ensuring nothing is overlooked.
  • Use Case: After implementing a new feature, run this Skill to ensure all acceptance criteria and architectural constraints have been met, automatically generating a checklist for any remaining items.

Quick Start

Run the speckit-converge skill to assess the current directory and append any missing tasks to the project task list.

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 codebase aligns with project specifications?

To check codebase alignment with project specifications, assess the current code against feature specs, plans, and task lists to identify implementation gaps. Verifying functional requirements and acceptance criteria ensures the code matches project intent.

What is the best way to track missing implementation tasks from feature specs?

Tracking missing implementation tasks involves appending identified gaps as traceable tasks to tasks.md. This ensures incomplete work from feature specifications is automatically documented and tracked for future implementation.

How do I automate gap analysis between spec.md and my current code?

Automating gap analysis between spec.md and your current code requires comparing the codebase against defined requirements and architectural decisions. This process automatically detects missing functional requirements and acceptance criteria.

Does this codebase convergence work with standard spec-kit project structures?

Codebase convergence operates within a spec-kit project structure to verify functional requirements and acceptance criteria. It requires the directory to contain the standard specification, plan, and task tracking files.

Why does my implementation drift from the original architectural decisions in plan.md?

Implementation drift from architectural decisions in plan.md occurs when development workflow loses alignment with specifications. Running a convergence assessment identifies these gaps and appends missing work as actionable tasks.

When do I need to run a specification compliance check on my development workflow?

A specification compliance check is needed after implementing a new feature to ensure all acceptance criteria and architectural constraints have been met. It generates a checklist for any remaining items requiring completion.