bmad-os-audit-file-refs
Installation
SKILL.md
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