speckit-converge

Compare codebase state against spec-kit plans and append missing tasks to tasks.md.

Updated Mar 3, 2026
One-click install
npx skills add https://github.com/arielybarak/agent-lab --skill speckit-converge-arielybarak
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-converge
Source: https://github.com/arielybarak/agent-lab/tree/main/.claude/skills/speckit-converge
Command: npx skills add https://github.com/arielybarak/agent-lab --skill speckit-converge-arielybarak

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python, yaml, markdown, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the process of ensuring that a codebase aligns with its specifications, plans, and tasks, saving developers time and reducing errors.

Core Features & Use Cases

  • Codebase Assessment: Automatically assess the current codebase against the feature's spec, plan, and tasks.
  • Task Generation: Append any remaining unbuilt work as new tasks to tasks.md for implementation.
  • Compatibility: Requires a spec-kit project structure with a .specify/ directory.
  • Use Case: Use this Skill to ensure that your codebase is up-to-date with the latest specifications and plans, and to catch any gaps or inconsistencies early in the development process.

Quick Start

Run the 'speckit-converge' command to automatically assess your codebase and generate tasks for any missing or incomplete work.

Frequently Asked Questions about speckit-converge

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate codebase alignment with project specifications and plans?

Automating codebase alignment involves comparing your current code against project specifications, plans, and tasks to catch inconsistencies. This process identifies gaps and appends any unbuilt work as new tasks.

What is codebase convergence in software development workflows?

Codebase convergence is the process of ensuring your code matches project specifications, plans, and tasks. It catches gaps early by automatically assessing the code against documentation requirements.

How do I generate tasks for unbuilt work from a specification?

You can generate tasks for unbuilt work by automatically assessing your codebase against your feature's spec and plan. The tool appends any remaining missing work as new tasks to your tasks.md file.

Do I need a specific project structure to compare code against specifications?

Yes, you need a spec-kit project structure containing a .specify/ directory. This structure allows the tool to parse your YAML and Markdown files to assess codebase alignment accurately.

Can I use Python and YAML to automate task management from Markdown specs?

Yes, Python and YAML are used alongside Markdown to automate task management from specs. The tool parses these files to assess the codebase and generates missing tasks automatically.