Audit

Audit

⛔ PREREQUISITE - CHECK THIS BEFORE ANYTHING ELSE

Before parsing arguments or doing any work, determine whether an explicit principle spec is present in $ARGUMENTS:

• Explicit spec = $ARGUMENTS contains --with, one or more @-prefixed tokens, or on (space-on-space)

If no explicit spec is present, check whether scout-generated files exist from a previous /dot-scout run:

• read .agents/principles-catalog/active.md; keep if it contains the generated-by marker (<!-- generated by /dot-scout)

• if absent: glob .github/instructions/*.instructions.md and REVIEW.md (at the git root) - Copilot Code Review and Claude Code Review outputs; keep only files containing the generated-by marker

• if none are found → STOP. Do not proceed. Respond only with:

⚠️ /dot-audit requires /dot-scout to have been run first. Run /dot-scout to analyse the project and generate the principle files that this command needs, then retry.

Review a file, directory, or inline code against its activated principles. Core review runs in seven phases (1-7). Three optional gated phases (8-10) handle fix, commit, and PR - each requires explicit user approval before entry.

flowchart TD
    A([Start]) --> PRE{Scout files\npresent?}
    PRE -- No --> HALT([Stop - run /dot-scout first])
    PRE -- Yes --> P1[Phase 1\nParse · Resolve · Detect artifact type]
    P1 --> P2[Phase 2/3\nResolve principles]
    P2 --> P4[Phase 4\nLoad principle content]
    P4 --> P5[Phase 5\nPre-Scan]
    P5 --> P6[Phase 6\nReview]
    P6 --> P7[Phase 7\nOutput findings]
    P7 --> G8{Findings?\n≥1 finding}
    G8 -- No --> DONE([Stop])
    G8 -- Yes --> Q8{Phase 8 gate\nFix findings?}
    Q8 -- No --> DONE
    Q8 -- Yes --> FIX[Phase 8.1-8.2\nBranch · Fix · Summarise]
    FIX --> Q9{Phase 9 gate\nHow to proceed?}
    Q9 -- "0 · Re-run audit\n(if Medium+ found)" --> P5
    Q9 -- "3 · Exit" --> DONE
    Q9 -- "1 · Commit only" --> CMT[Phase 9.1\nCommit]
    Q9 -- "2 · Commit and push" --> CMT
    CMT --> PUSH{Push?}
    PUSH -- No --> DONE
    PUSH -- Yes --> PUSHSTEP[Phase 9.2\nPush branch]