speckit-brownfield-validate

What problem does it solve?

It prevents stale or incorrect spec-kit bootstrap configuration by detecting mismatches between generated artifacts (constitution/templates/agents) and the actual repository structure and conventions.

Core Features & Use Cases

• Constitution validation: Verifies that entries in .specify/memory/constitution.md match the real codebase, including language and framework references, referenced directories/paths, naming conventions, test locations, and branch patterns.
• Template validation: Checks that customized spec/plan/tasks templates reference real modules and directories, and that test/build commands align with actual scripts and package configuration.
• Agent configuration validation: If AGENTS.md exists, confirms directory ownership, detects overlaps between agents, and flags orphan/uncovered directories.
• Drift detection: Identifies repository changes since bootstrap (e.g., renamed directories, added/missing modules, dependency changes, and branch pattern drift) and reports actionable corrections.

Quick Start

Run the speckit-brownfield-validate skill in your repo to generate a validation report that highlights mismatches and drift between your bootstrap output and the current project.