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.