bmad-generate-project-context

To generate an AI-ready project context document, execute a multi-step workflow that discovers project conventions, generates structured sections with YAML frontmatter, and finalizes the project-context.md file for AI agent consumption.

A project context file is a lean, AI-ready markdown document that codifies technology stacks, patterns, and workflow rules. You need one when AI agents must follow standardized conventions in new codebases or ongoing software engineering projects.

Correct frontmatter metadata is ensured by generating a structured YAML header that defines essential fields like name and description, validating correctness as part of the automated project context generation workflow.

Yes, you can include optional resource directories, scripts, references, and assets as needed. The generated project context supports artifact management and extensibility for optional components required by your workflow.

Yes, this project context generation works for both new codebases and ongoing projects. It discovers existing conventions and encodes standardized technology stacks, patterns, and workflow rules into a lean AI-ready document.

The best way to structure project conventions for LLM optimization is to use a lean, AI-ready markdown format with structured sections, YAML frontmatter, and a clear status workflow, ensuring AI agents can reliably parse and follow operational guidelines.