gaia-brownfield

Orchestrate brownfield onboarding with discovery and planning artifact generation.

2|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/gaiastudio-ai/gaia-public --skill gaia-brownfield
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gaia-brownfield
Source: https://github.com/gaiastudio-ai/gaia-public/tree/main/plugins/gaia/skills/gaia-brownfield
Command: npx skills add https://github.com/gaiastudio-ai/gaia-public --skill gaia-brownfield

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

The GAIA brownfield onboarding workflow orchestrates end-to-end onboarding of existing codebases by performing deep discovery, parallel documentation, multi-scan gap analysis, NFR assessment, gap consolidation, PRD/architecture generation, and optional ground-truth bootstrap to accelerate migration, governance, and artifact generation.

Core Features & Use Cases

  • Deep project discovery, parallel documentation subagents, multi-scan gap analysis, NFR assessment, gap consolidation, PRD/architecture generation, and optional ground-truth bootstrap. It writes canonical artifact sets to docs/planning-artifacts/ (planning artifacts) and docs/test-artifacts/ as needed to support governance and migration planning.

Quick Start

Use the brownfield onboarding skill to analyze an existing project by providing the target project path.

Frequently Asked Questions about gaia-brownfield

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

FAQPage Schema
How do I onboard a legacy codebase with deep discovery and gap analysis?▼

To onboard a legacy codebase, you can apply a deterministic workflow that performs deep project discovery, parallel documentation, multi-scan gap analysis, and NFR assessment to generate planning artifacts.

What is the best way to generate PRD and architecture documents for an existing monorepo?▼

Generating PRD and architecture documents for an existing monorepo involves orchestrating gap consolidation and non-functional requirement assessments to produce canonical artifact sets for migration planning.

Can I use brownfield onboarding for infrastructure-heavy projects requiring governance planning?▼

Yes, brownfield onboarding specifically targets legacy codebases with infrastructure-heavy setups and historical architectures, providing gating and budget controls to support governance and migration planning.

How do I assess non-functional requirements in an existing project during onboarding?▼

Assessing non-functional requirements in an existing project uses an NFR assessment phase that evaluates historical architectures and consolidates findings into canonical planning artifacts.

What artifacts are generated when discovering and documenting a legacy project?▼

Discovering and documenting a legacy project generates canonical artifact sets written to docs/planning-artifacts/ and docs/test-artifacts/ to support governance and migration planning.

Does this brownfield onboarding workflow support parallel documentation subagents?▼

Yes, the workflow orchestrates parallel documentation subagents during the discovery phase to accelerate the end-to-end onboarding of existing codebases.