speckit-converge

Assess codebase state against specifications, plans, and task lists.

Updated Jul 9, 2026
One-click install
npx skills add https://github.com/GatePass-Security/gatepass --skill speckit-converge-gatepass-security
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-converge
Source: https://github.com/GatePass-Security/gatepass/tree/main/.claude/skills/speckit-converge
Command: npx skills add https://github.com/GatePass-Security/gatepass --skill speckit-converge-gatepass-security

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill bridges the gap between high-level feature specifications and actual code implementation, ensuring that no requirements, plan decisions, or constitution principles are left unaddressed.

Core Features & Use Cases

  • Requirement Verification: Automatically assesses the codebase against spec.md, plan.md, and tasks.md to identify missing or partial work.
  • Traceable Task Generation: Appends new, actionable tasks to tasks.md based on identified gaps, ensuring a clear path to completion.
  • Constitution Enforcement: Validates code against project-wide non-negotiable principles to maintain architectural integrity.

Quick Start

Run the speckit-converge skill to assess the current directory and append any missing implementation tasks to your tasks.md file.

Frequently Asked Questions about speckit-converge

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

FAQPage Schema
How do I verify my codebase against feature specifications and plans?

To verify your codebase against feature specifications, you can run a convergence check that assesses current implementation state against spec.md, plan.md, and tasks.md artifacts to identify missing or partial work.

What does checking for codebase convergence with feature specs involve?

Codebase convergence involves comparing actual implementation against defined requirements and architectural constraints to detect missing, partial, or contradictory implementations, then generating actionable tasks to close those gaps.

How do I generate traceable tasks for missing implementation requirements?

You can generate traceable tasks for missing requirements by assessing the codebase against feature specifications and appending new, actionable items directly to your project's tasks.md task ledger.

How can I enforce project-wide architectural principles during implementation?

To enforce architectural principles during implementation, validate code against project-wide non-negotiable constitution principles to ensure full convergence with the intended design and maintain architectural integrity.

Can I use spec-kit convergence checks for projects with existing task lists?

Yes, you can use convergence checks for projects with existing task lists. The process assesses the current directory and appends newly identified missing implementation tasks directly to your existing tasks.md file.

What happens when a codebase has contradictory implementations relative to requirements?

When contradictory implementations are found relative to defined requirements, the convergence assessment identifies these conflicts and appends actionable, traceable tasks to the project ledger to resolve them.