bmad-os-audit-file-refs

name	bmad-os-audit-file-refs
description	Audit BMAD source files for file-reference convention violations using parallel Haiku subagents. Use when users requests an "audit file references" for a skill, workflow or task.

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

References inside fenced code blocks ( ```) are examples — skip them.