/gaia-audit

name: gaia-audit
description: Audit memory, wiki, and auto-loaded files for duplication, conflicting instructions, and stale content. The default path researches, then asks you a single Apply / Discuss / Decline question; on Apply it applies the report, files any out-of-scope problem as a tech-debt issue, then commits, opens a PR, and merges it on a main-branch run like /update-deps. Pass --apply to re-run the apply-and-publish stage against the most recent report.
argument-hint: [--apply] [scope-hint]

Run the GAIA **audit** workflow with these arguments: `$ARGUMENTS`

Pre-flight: Worktree check

This command applies a repo-wide report, opens a pull request, and merges it on a main-branch run. If invoked from a linked worktree, reject hard: `gaia_refuse_if_worktree` (`.gaia/scripts/main-only-lib.sh`) asks the shared resolver which tree this is and refuses out loud, naming the main checkout, when the answer is a worktree.

Detection (run this first, before anything else):

. .gaia/scripts/main-only-lib.sh
gaia_refuse_if_worktree "/gaia-audit" || exit 1

If the detection does not fire, fall through to the workflow dispatch line below.

Read `.claude/skills/gaia/references/audit.md` from the project root and follow it exactly. That reference is written to consume an argument string, treat the arguments above as that input. If no arguments were provided, follow the reference's no-argument (default research-then-gate) path: spawn Stage 1, then **in this conversation** relay Stage 1's summary and either auto-apply (when Stage 1 found 0 actions, a clean audit needs no approval) or, when Stage 1 found ≥1 action, run the recommended-but-optional **classification-verification round** (it hardens Stage 1's classifications against ground truth) and then the `AskUserQuestion` decision gate, both described in the reference's "Branch on `$ARGUMENTS`" section, before branching. The gate (Apply / Discuss / Decline) MUST run here in the main conversation, not in a subagent, because only this layer can prompt the user.