skills.rest
Geargrindadmin
GeargrindadminCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

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
One-click install
npx skills add https://github.com/Geargrindadmin/gg-agentic-harness --skill bmad-os-audit-file-refs
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
GenEducationGenEducation

bmad-os-audit-file-refs

Audit BMAD markdown and YAML files for file-reference convention violations.

Official
Advanced
transrealtransreal
3

notebook-path-policy

Resolve Mathematica output file paths with NotebookDirectory or $packageDirectory fallback.

Community
Basic
bmad-code-orgbmad-code-org
8

bmad-os-audit-file-refs

Audit markdown and YAML files for BMAD file-reference pathing violations.

Official
Advanced
terrylicaterrylica
62

link-validation

Scan markdown files with lychee to detect broken links and path policy violations.

Community
Intermediate