bmad-project-context
Sets up or audits the AGENTS.md block of agent instructions for a repository, and records observed agent mistakes as pitfalls.
- Kind
- Skill
- Works with
- Claude Code
- Source
- bmad-code-org/BMAD-METHOD @ ec9a46ee2aef
- Path
- skills/bmad-project-context/SKILL.md
- License
- MIT
- Jobs
- Documentation, Guardrails
InstallCopy it from the source repository, or sign in and let the assistant adapt it for your project.
# 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 (`setup` | `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
1. Resolve customization: `uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key workflow`.
- Script not found: BMad is not set up here. Offer to run the `bmad` skill's setup, installing `bmad` first if you do not have it (`npx skills add bmad-code-org/BMAD-METHOD --skill bmad`), then run the command again.
…