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.md or ../something.md — relative paths
  • step-NN.md — bare filename with no path prefix
  • steps/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
Related skills
Installs
1
GitHub Stars
6
First Seen
14 days ago