Skip to content

gf-audit.md

Latest commit

 

History

History
73 lines (58 loc) · 1.78 KB

gf-audit.md

File metadata and controls

73 lines (58 loc) · 1.78 KB
Raw
name gf-audit
description Audit plugin quality and optionally auto-fix issues
argument-hint [--fix] [--category agents|skills|ip|boards|docs]
allowed-tools
Read
Write
Edit
Bash
Glob
Grep
Task

GateFlow Plugin Audit Command

Scan the entire plugin for gaps, inconsistencies, and missing content.

Usage

/gf-audit                    # Full audit, report only
/gf-audit --fix              # Audit and auto-fix all issues
/gf-audit --category ip      # Audit only IP blocks
/gf-audit --category agents  # Audit only agents
/gf-audit --category docs    # Audit only documentation

Execution

Report Mode (default)

  1. Spawn gf-auditor agent to scan everything
  2. Present prioritized report (Critical → Low)
  3. Ask user which issues to fix

Fix Mode (--fix)

  1. Spawn gf-auditor agent to scan
  2. Spawn gf-pluginfixer agent with findings
  3. Fix all issues automatically
  4. Show summary of changes
  5. Commit fixes

Category Mode

Focus audit on one area:

  • agents — Check agent files, routing, cross-references
  • skills — Check skill files, triggers, return formats
  • ip — Check IP blocks (RTL, TB, formal, metadata, docs)
  • boards — Check board database (yaml, constraints, completeness)
  • docs — Check README, releases, CLAUDE.md, AGENTS.md consistency

Output

GateFlow Plugin Audit Results
━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  Critical:  0
  High:      2
  Medium:    5
  Low:       3
  ─────────────
  Total:     10

[H1] README says 26 skills but 27 SKILL.md files found
     Fix: Update README count to 27

[H2] sv-formal agent not in orchestrator routing table
     Fix: Add to gf/SKILL.md Agent Routing section

...

Fix all issues? [Y/n/select]