bmad-os-audit-file-refs

Audit BMAD source files for file-reference convention violations using parallel Haiku subagents.

Updated Mar 7, 2026

Search Tags:#code quality #audit #file references #haiku #bmad #convention

Ready to run

npx skills add https://github.com/Geargrindadmin/gg-agentic-harness --skill bmad-os-audit-file-refs

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: bmad-os-audit-file-refs
Source: https://github.com/Geargrindadmin/gg-agentic-harness/tree/main/.agent/skills/bmad-os-audit-file-refs
Command: npx skills add https://github.com/Geargrindadmin/gg-agentic-harness --skill bmad-os-audit-file-refs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and scripts (resource) components.

What problem does it solve?

This Skill identifies and flags non-compliant file path references within BMAD source files, ensuring consistency and preventing broken links.

Core Features & Use Cases

Convention Enforcement: Audits files in src/bmm, src/core, and src/utility for correct file path formatting.
Parallel Sub-agents: Utilizes Haiku sub-agents for efficient, parallel processing of file batches.
Detailed Reporting: Generates a report listing all violations with file, line number, and offending text.
Use Case: When developing or maintaining BMAD projects, use this skill to automatically check for any deviations from the established file referencing standards before code is merged.

Quick Start

Run the bmad-os-audit-file-refs skill to audit file references in the project's source code.

Frequently Asked Questions about bmad-os-audit-file-refs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I audit file references in BMAD source files?▼

BMAD file-reference auditing scans source files in `src/bmm`, `src/core`, and `src/utility` using parallel Haiku subagents to identify non-compliant path formats, preventing broken links and ensuring consistency across the project.

What file path formats are flagged as convention violations in BMAD?▼

BMAD file-reference auditing flags relative paths, bare filenames, and absolute system paths that deviate from valid reference forms like `{project-root}/_bmad/path/to/file.ext` and `{installed_path}/relative/path`.

Does the BMAD file reference audit check old-format workflow files?▼

No, the BMAD file reference audit excludes old-format files located in `src/bmm/workflows/4-implementation/`, applying only to new-format BMAD workflow and task files within `src/bmm/`, `src/core/`, and `src/utility/`.

How do I check BMAD source code for broken file links before merging?▼

Run the BMAD audit skill to automatically check for deviations from established file referencing standards, receiving a detailed report of all convention violations with file names, line numbers, and offending text before merging code.

Why use parallel Haiku subagents for file path convention auditing?▼

Parallel Haiku subagents process file batches efficiently during BMAD file-reference auditing, enabling faster scanning of source code to detect formatting violations and generate detailed violation reports.