bmad-document-project

Document brownfield codebases into AI-ready project documentation artifacts.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/florian-trehaut/bmad-global --skill bmad-document-project-florian-trehaut
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-document-project
Source: https://github.com/florian-trehaut/bmad-global/tree/main/src/bmm-skills/1-analysis/bmad-document-project
Command: npx skills add https://github.com/florian-trehaut/bmad-global --skill bmad-document-project-florian-trehaut

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Document brownfield codebases to produce AI-ready project documentation.

Core Features & Use Cases

  • Detects project type and structure
  • Scans codebase at quick/deep/exhaustive depth
  • Generates documentation artifacts: overview, architecture, source-tree analysis, API contracts, and data models
  • Supports resume from previous scans and multi-part project integration

Quick Start

Run the document-project workflow on a repository to generate a full, resume-enabled documentation package.

Frequently Asked Questions about bmad-document-project

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

FAQPage Schema
How do I generate AI-ready documentation for an existing brownfield codebase?

To generate AI-ready documentation for a brownfield codebase, run the document-project workflow to scan the repository and output artifacts like project overview, architecture, source-tree analysis, API contracts, and data models. It supports quick, deep, and exhaustive scan depths.

What is the best way to document a large multi-part repository for AI context?

Documenting a large multi-part repository for AI context is handled by scanning each part independently and integrating the results. The workflow supports multi-part project integration and uses a project-knowledge store to link the generated documentation artifacts.

Can I resume a codebase documentation scan if it gets interrupted?

Yes, you can resume an interrupted codebase documentation scan. The workflow uses a project-knowledge store and YAML frontmatter in SKILL.md to enable resumable runs, allowing you to continue generating documentation artifacts without starting over.

What specific documentation artifacts are generated when scanning an existing project?

Scanning an existing project generates specific documentation artifacts including a project overview, architecture details, source-tree analysis, API contracts, and data models. These template-driven outputs provide consistent and auditable results for AI context.

Does this workflow require any dependencies to analyze source code structure?

No, this workflow requires no external dependencies to analyze source code structure. It relies on internal mechanisms like YAML frontmatter, a project-knowledge store, and template-driven outputs to detect project type and structure directly.

When should I use exhaustive scans instead of deep scans for project documentation?

You should use exhaustive scans instead of deep scans when your project documentation requires maximum detail for complex AI context. The workflow offers quick, deep, and exhaustive scan depths to balance processing time with the thoroughness of the generated architecture and data model artifacts.