bmad-os-audit-file-refs
audit-file-refs
Audit new-format BMAD source files for file-reference convention violations using parallel Haiku subagents.
Convention
In new-format BMAD workflow and task files (src/bmm/, src/core/, src/utility/), every file path reference must use one of these valid forms:
{project-root}/_bmad/path/to/file.ext— canonical form, always correct{installed_path}/relative/path— valid in new-format step files (always defined by workflow.md before any step is reached)- Template/runtime variables:
{nextStepFile},{workflowFile},{{mustache}},{output_folder},{communication_language}, etc. — skip these, they are substituted at runtime
Flag any reference that uses:
./step-NN.mdor../something.md— relative pathsstep-NN.md— bare filename with no path prefixsteps/step-NN.md— bare steps-relative path (missing{project-root}/_bmad/...prefix)`_bmad/core/tasks/help.md`— bare_bmad/path (missing{project-root}/)/Users/...,/home/...,C:\...— absolute system paths
More from bmad-code-org/bmad-utility-skills
bmad-os-diataxis
Create, update, fix, or refine documentation using Diataxis framework and BMad Method style guide. Use when user asks to 'create a doc', 'update docs', 'fix docs style', 'refine docs', or 'improve docs writing'.
1bmad-os-review-pr
Dual-layer PR review tool (Raven's Verdict). Runs adversarial cynical review and edge case hunter in parallel, merges and deduplicates findings into professional engineering output. Use when user asks to 'review a PR' and provides a PR url or id.
1bmad-os-gh-triage
Analyze all github issues. Use when the user says 'triage the github issues' or 'analyze open github issues'.
1bmad-os-draft-changelog
Analyzes changes since last release and updates CHANGELOG.md ONLY. Use when users requests 'update the changelog' or 'prepare changelog release notes'
1bmad-os-review-prompt
Review LLM workflow step prompts for known failure modes (silent ignoring, negation fragility, scope creep, etc). Use when user asks to "review a prompt" or "audit a workflow step".
1bmad-os-findings-triage
Orchestrate HITL triage of review findings using parallel agents. Use when the user says 'triage these findings' or 'run findings triage' or has a batch of review findings to process.
1