speckit-brownfield-bootstrap

Generate Spec-Kit configuration tailored to an existing codebase from a brownfield scan profile.

Updated Mar 16, 2026
One-click install
npx skills add https://github.com/B0yZ4kr14/OrthoPlus-Enterprise --skill speckit-brownfield-bootstrap
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-brownfield-bootstrap
Source: https://github.com/B0yZ4kr14/OrthoPlus-Enterprise/tree/main/.specify-backups/20260518-141826/_agents/skills/speckit-brownfield-bootstrap
Command: npx skills add https://github.com/B0yZ4kr14/OrthoPlus-Enterprise --skill speckit-brownfield-bootstrap

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of setting up Spec-Kit for an existing (brownfield) codebase without guessing conventions, so generated specs and templates match the real architecture and workflow.

Core Features & Use Cases

  • Project-aware bootstrapping: Loads an existing /speckit.brownfield.scan profile (or performs an inline scan) to tailor outputs to the codebase’s actual tech stack and conventions.
  • Constitution + template customization: Creates .specify/memory/constitution.md and updates spec/plan/tasks templates to reflect detected modules, boundaries, tooling, and quality gates.
  • Monorepo agent boundary setup: Generates AGENTS.md to define agent ownership and inter-module communication rules when multiple modules are present.

Quick Start

Run speckit-brownfield-bootstrap in your repository to generate project-specific Spec-Kit configuration for your existing codebase.

Frequently Asked Questions about speckit-brownfield-bootstrap

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

FAQPage Schema
How do I bootstrap Spec-Kit configuration for an existing codebase without guessing conventions?

To bootstrap Spec-Kit for an existing codebase, this tool derives conventions and architecture from a brownfield scan profile or performs an inline scan. It generates constitution rules, customized templates, and task instructions that match your real repository structure.

How do I set up Spec-Kit agent boundaries in a monorepo with multiple modules?

Setting up Spec-Kit agent boundaries in a monorepo involves generating an AGENTS.md file to define agent ownership and inter-module communication rules. This configuration applies specifically when multiple modules like frontend, backend, and shared paths are detected.

Can I generate spec-kit constitution rules that match my detected repository reality?

Yes, you can generate constitution rules that match detected repository reality. The process creates a constitution.md file and updates spec, plan, and task templates to reflect detected modules, tooling, and quality gates without inventing unsupported conventions.

Does the brownfield bootstrap process overwrite my existing .specify/ customizations?

No, the brownfield bootstrap process respects existing .specify/ customizations to avoid overwriting without asking. It confirms requirements before writing changes and derives rules strictly from the detected codebase rather than inventing new ones.

What is the best way to apply spec-kit templates to monorepo frontend, backend, and shared module paths?

The best way to apply spec-kit templates to monorepo module paths is by using a brownfield scan profile. This tailors constitution generation, task instructions, and agent boundaries specifically to the detected frontend, backend, shared, and other module architectures.