speckit-converge

Compare codebases against spec.md, plan.md, and tasks.md to append missing tasks.

48|3|Updated Oct 13, 2025
One-click install
npx skills add https://github.com/kalamdb/KalamDB --skill speckit-converge-kalamdb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-converge
Source: https://github.com/kalamdb/KalamDB/tree/main/.agents/skills/speckit-converge
Command: npx skills add https://github.com/kalamdb/KalamDB --skill speckit-converge-kalamdb

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill resolves the drift between a feature's documented intent and its actual implementation by identifying missing or incomplete work.

Core Features & Use Cases

  • Gap Analysis: Automatically compares the current codebase against spec.md, plan.md, and tasks.md to identify missing requirements or contradictions.
  • Task Generation: Appends actionable, traceable tasks to tasks.md for implementation, ensuring no requirement is overlooked.
  • Use Case: After a development sprint, run this skill to ensure all acceptance criteria from your feature specification are fully satisfied in the code before marking the feature as complete.

Quick Start

Run the speckit-converge skill to assess the current directory and append any missing 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
What is codebase and feature spec alignment?

Codebase and feature spec alignment is the process of identifying discrepancies between documented intent and actual implementation. This skill parses project artifacts to find missing requirements and generate actionable tasks, ensuring continuous alignment between design and code.

How do I check if my codebase matches the project plan and tasks?

To check if your codebase matches the project plan, run an automated gap analysis. This skill compares your current codebase against spec.md, plan.md, and tasks.md to identify missing requirements or contradictions, ensuring no criteria are overlooked.

How do I generate traceable tasks from missing feature requirements?

You can generate traceable tasks from missing feature requirements by running an automated gap analysis against your specification files. This skill appends actionable, traceable tasks directly to tasks.md for developers to implement.

Can I use specification files to verify acceptance criteria after a sprint?

Yes, you can use specification files to verify acceptance criteria after a development sprint. Run this skill to assess the current directory and ensure all acceptance criteria from your feature specification are fully satisfied in the code.

What is the best way to prevent drift between feature specs and code implementation?

The best way to prevent drift between feature specs and code implementation is continuous alignment. This skill handles drift resolution by parsing project artifacts to generate append-only tasks, bridging high-level design intent and low-level code state.

Do I need spec.md and plan.md files to run a gap analysis?

Yes, you need spec.md, plan.md, and tasks.md files to run a gap analysis. The skill operates by parsing these specific project artifacts to identify contradictions and generate actionable implementation tasks for developers.