# bmad-project-context

> Claude/Codex skill by [@bmad-code-org](https://omgskills.com/library/bmad-code-org/index.md) · 54k stars · Updated 2026-10-18

Set up, adopt, refresh, or audit a repository's agent instructions (the AGENTS.md block) so AI agents work well in that repo. Also records observed agent mistakes as pitfalls. Use when invoked by name

Tags: agile, ai, context-engineering, sdlc, spec-driven-development

## Install

```sh
git clone https://github.com/bmad-code-org/BMAD-METHOD /tmp/BMAD-METHOD && ln -s /tmp/BMAD-METHOD/skills/bmad-project-context ~/.claude/skills/bmad-project-context
```

## From README

Overview A conversation that produces a repository's agent instructions: a small verified block inside AGENTS.md. The user brings rules they want followed — governance, security, standards — and the repository supplies the rest, verified. Conversational always; the user approves every write. Args: intent ( | adopt | refresh | record | audit); a target repo or path; extra source paths or URLs. Resolution rules Bare paths and {skill-root} (e.g. references/best-practices.md) resolve from this skill's installed directory. {project-root} → the project working directory. Target → the repository being described, defaulting to {project-root}. If it resolves to more than one working tree, or to one the user cannot commit in, ask before writing. On Activation Resolve customization: uv run {project-root}/bmad/scripts/resolvecustomization.py --skill {skill-root} --project-root {project-root} --key workflow. Script not found: BMad is not set up here.

## Links

- HTML page: https://omgskills.com/skills/bmad-code-org/bmad-method/bmad-project-context/
- GitHub: https://github.com/bmad-code-org/BMAD-METHOD
- Author: [@bmad-code-org](https://omgskills.com/library/bmad-code-org/index.md)

## More from this repo

- [bmad](https://omgskills.com/skills/bmad-code-org/bmad-method/bmad/index.md) — Answers BMad questions and recommends the next skill from what is installed.
   - [@bmad-code-org](https://omgskills.com/library/bmad-code-org/index.md) · 54k stars
- [bmad-advanced-elicitation](https://omgskills.com/skills/bmad-code-org/bmad-method/bmad-advanced-elicitation/index.md) — Push the LLM to reconsider, refine, and improve its recent output.
   - [@bmad-code-org](https://omgskills.com/library/bmad-code-org/index.md) · 54k stars
- [bmad-agent-analyst](https://omgskills.com/skills/bmad-code-org/bmad-method/bmad-agent-analyst/index.md) — Business analyst for market research, competitive analysis, and requirements.
   - [@bmad-code-org](https://omgskills.com/library/bmad-code-org/index.md) · 54k stars