speckit-converge

Evaluate a codebase against specification and append missing tasks.

Updated Jun 5, 2026
One-click install
npx skills add https://github.com/Elmarbouhe/chez-yema --skill speckit-converge-elmarbouhe
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-converge
Source: https://github.com/Elmarbouhe/chez-yema/tree/main/.agents/skills/speckit-converge
Command: npx skills add https://github.com/Elmarbouhe/chez-yema --skill speckit-converge-elmarbouhe

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill unit solves the problem of closing the gap between codebase implementation and specification, plan, and tasks, by identifying and appending missing work as new tasks.

Core Features & Use Cases

  • Convergence Assessment: Checks codebase against spec, plan, and tasks.
  • Appending Tasks: Adds missing tasks to tasks.md for further implementation.
  • Compatibility: Requires spec-kit project structure with .specify/ directory.

Quick Start

To initiate a convergence check and task addition, use /speckit-converge.

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 matches my specification and find missing work?

You can assess codebase compliance by running a convergence check against your specification, plan, and tasks, which appends any missing work as new tasks to your task list.

What is a Spec Kit project structure and do I need it for codebase convergence?

Spec Kit project structure uses a `.specify/` directory to organize your specification, plan, and tasks. This directory is a mandatory prerequisite to run the convergence check and append missing tasks.

How do I add missing implementation tasks to my tasks.md file?

To add missing implementation tasks, execute a convergence check against your specification. The process identifies gaps and automatically appends the missing work as new tasks to `tasks.md`.

Does the convergence assessment run validation checks before and after appending tasks?

Yes, the convergence assessment executes pre-convergence and post-convergence checks to validate the codebase state and handle missing prerequisites before appending any new tasks.

Can I extend the codebase assessment logic with custom hooks?

Yes, the codebase assessment supports extension hooks, allowing you to customize the convergence checks and task addition logic within the Spec Kit project structure.

What happens if prerequisite files are missing during a specification compliance check?

During a specification compliance check, if prerequisite files are missing, the convergence process handles the missing prerequisites gracefully by executing pre-convergence checks before attempting to append tasks.