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.
   • Any other failure: read {skill-root}/customize.toml directly and use defaults.