skills.rest
B0yZ4kr14
B0yZ4kr14COMMUNITY
Explore all skills by this author →
WebsiteGitHub

speckit-brownfield-validate

Verifies spec-kit bootstrap output against actual repository structure and conventions.

Updated Mar 16, 2026
Search Tags:#spec-kit#repository structure#agent ownership#configuration auditing#convention checks#template drift#brownfield validation
One-click install
npx skills add https://github.com/B0yZ4kr14/OrthoPlus-Enterprise --skill speckit-brownfield-validate
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-brownfield-validate
Source: https://github.com/B0yZ4kr14/OrthoPlus-Enterprise/tree/main/.specify-backups/20260518-141826/_agents/skills/speckit-brownfield-validate
Command: npx skills add https://github.com/B0yZ4kr14/OrthoPlus-Enterprise --skill speckit-brownfield-validate

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about speckit-brownfield-validate

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

FAQPage Schema
How do I validate spec-kit bootstrap output against my existing repository?▼

To validate spec-kit bootstrap output, run a brownfield validation check that compares generated artifacts like constitution and templates against the actual project structure, detecting mismatches in referenced paths, naming conventions, and dependencies.

How do I check for configuration drift in a brownfield .specify directory?▼

Configuration drift in a brownfield .specify directory is checked by comparing bootstrap artifacts against current repository changes, identifying renamed directories, missing modules, dependency updates, and branch pattern drift to generate actionable correction reports.

Can I verify agent directory ownership and detect overlaps in AGENTS.md?▼

Yes, agent configuration validation confirms directory ownership when AGENTS.md exists, detects overlapping ownership between agents, and flags orphan or uncovered directories to ensure clean separation of responsibilities.

How do I ensure spec-kit customized templates reference real modules and build commands?▼

Template validation checks that customized spec, plan, and tasks templates reference actual modules and directories, while verifying that test and build commands align with real scripts and package configuration files.

Does brownfield validation scan ignored files during constitution checks?▼

No, brownfield validation applies evidence-based, read-only checks to the repository and explicitly avoids scanning ignored files when verifying constitution entries, framework references, and branch patterns against the real codebase.

Related Skills

Explore More Software Engineering Skills→
NUMU-IONUMU-IO
2

speckit-brownfield-validate

Validate spec-kit brownfield bootstrap artifacts against actual repository structure and conventions.

Official
Advanced
vZulinvZulin

speckit-constitution

Automates creation and synchronization of SpecKit constitution documents and dependent templates.

Community
Advanced
aurumorincaurumorinc

write-script-php

Generate PHP scripts with predefined structure and function naming conventions.

Official
Intermediate
B0yZ4kr14B0yZ4kr14

speckit-doctor-check

Run a full health diagnostic of a Spec Kit project to detect setup and configuration issues.

Community
Intermediate