speckit-converge

Compare codebase against specification files and append gap tasks to tasks.md.

2|1|Updated Jul 28, 2026
One-click install
npx skills add https://github.com/0xbillw/dotfiles --skill speckit-converge-0xbillw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-converge
Source: https://github.com/0xbillw/dotfiles/tree/main/.agents/skills/speckit-converge
Command: npx skills add https://github.com/0xbillw/dotfiles --skill speckit-converge-0xbillw

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill bridges the gap between high-level feature specifications and the actual codebase, ensuring that all requirements, architectural plans, and constitution principles are fully implemented without manual tracking.

Core Features & Use Cases

  • Automated Gap Analysis: Compares existing code against spec.md, plan.md, and tasks.md to identify missing or contradictory work.
  • Traceable Task Generation: Automatically appends new, actionable tasks to tasks.md to resolve identified gaps.
  • Constitution Enforcement: Validates code against project-specific memory and constitution principles to ensure compliance.

Quick Start

Run the speckit-converge skill to assess the current project state and append any necessary implementation tasks to your tasks file.

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 feature specifications and plans?

To check if your codebase matches feature specifications, you can run an automated gap analysis that compares existing code against spec.md, plan.md, and tasks.md to identify missing or contradictory implementation work.

How do I automate traceable task generation for missing implementation requirements?

Automating traceable task generation involves analyzing project artifacts to identify implementation gaps and automatically appending new, actionable tasks to your tasks.md file to resolve those specific discrepancies.

How do I enforce project-specific constitution principles and technical requirements during code analysis?

Enforcing constitution principles during code analysis requires validating the codebase against project-specific memory and technical requirements defined in the .specify directory to ensure full compliance.

What is the best way to align a codebase with feature specs without manual tracking?

The best way to align a codebase with feature specs without manual tracking is to use automated convergence tools that assess the current project state and append necessary implementation tasks directly to your task list.

Do I need a .specify directory to perform automated gap analysis on my codebase?

Yes, performing this specific automated gap analysis requires a .specify directory because it contains the constitution principles and technical requirements used to validate codebase compliance and identify implementation gaps.

Why does my codebase convergence check append tasks instead of modifying source code directly?

A codebase convergence check appends tasks instead of modifying source code directly to maintain human control over implementation, ensuring developers manually resolve identified gaps using the newly generated traceable tasks.