/audit-knowledge

description: "Scan Antigravity conversation transcript + artifact directory for extractable knowledge. Use when user asks for 'knowledge audit', 'audit knowledge', 'check for extractable knowledge', 'scan transcript', or at session start when audit cadence is exceeded."
argument-hint: "[detailed]"
allowed-tools: Read, Glob, Grep, Write, Edit, Bash

/audit-knowledge — Knowledge Repository Audit

Scan the current Antigravity conversation transcript and artifact directory, compare against what's already in the knowledge folder and project-level docs, and surface anything worth extracting.

Step 0: Resolve Config

Read `~/.gemini/antigravity/aria-knowledge.local.md` and extract:

• `knowledge_folder` — required base path
• `audit_cadence_knowledge` — cadence in days (default 7); safety-net trigger for low-activity periods
• `audit_trigger_threshold` — backlog-entry count (default 20); primary activity-driven trigger. Tier boundaries derived via fixed offsets: `threshold` (suggested), `threshold + 15` (recommended), `threshold + 30` (overdue)
• `projects_enabled` — default `false`; controls whether project tier is audited (Step 5e)
• `projects_list` — default empty; comma-separated `tag:path` pairs; only relevant if `projects_enabled: true`
• `projects_promotion_threshold` — default `2`; minimum projects sharing a similar pattern before Step 5e suggests cross-project promotion

If the config file doesn't exist, stop: "aria-knowledge is not configured. Run /setup to get started."

Use `{knowledge_folder}` as the base path for all file operations in subsequent steps.

Step 1: Read the Audit Log and Determine Mode

Read `{knowledge_folder}/logs/knowledge-audit-log.md`.

Note the "Last Audit" date and calculate days since.

**Compute the current trigger state** with the shared counter — the same one the SessionStart hook uses, so the prompt and the audit's scope can never disagree. It covers the four action-eligible backlogs (insights, decisions, extraction, rules — `intake/ideas/` is excluded, it routes out via the Accept submenu), below the first `---` separator per file:

bash "${CLAUDE_PLUGIN_ROOT}/bin/count-backlog-entries.sh" {knowledge_folder}          # per-file + TOTAL line
bash "${CLAUDE_PLUGIN_ROOT}/bin/count-backlog-entries.sh" {knowledge_folder} --list   # every non-### live block

The TOTAL line reads `canonical=N h2=N h4suspect=N live=N cutoff=YYYY-MM-DD`:

• **canonical** — `### ` entries: the old counter's number, kept as the **control**. If it reads 0 on a backlog you can see has entries, the counter is broken — stop and say so.
• **h2** — a `## ` heading with content under it: an entry written as a group header.
• **h4suspect** — a `#### YYYY-MM-DD` heading dated on or after the last pass whose heading carries **no disposition marker**. It is either an entry born at the wrong level or a past pass's unmarked demotion — nothing on disk separates the two, which is why the Step 7 clearing contract requires the marker.
• **live** = canonical + h2 + h4suspect — **this is the backlog count and the audit's scope.**

Every `--list` line is a real entry and is reviewed with its backlog in Steps 2–2c3 like any `### ` entry. Also report them together in Step 6 as a **Mis-levelled entries (N)** finding — a non-zero N means some writer is not using the `### YYYY-MM-DD — <project> — <title>` contract. ⚠ Known bound: an *undated* `####` born at the wrong level cannot be windowed and stays invisible.

Record both numbers — `live` feeds the prompt message and Step 8's `Trigger:` count; `canonical` is recorded beside it so a later pass can see the gap.

**Determine how this skill was invoked:**

• **User-requested** (user said `/audit-knowledge`, "audit knowledge", "scan transcript", etc.): **Always run the full audit**, regardless of how recently the last audit was. Skip directly to Step 2.
• **Session-start check** (triggered by the session-start ephemeralMessage): Check whether either trigger fired.
• **Entry-count trigger** (primary): if `backlog_count >= audit_trigger_threshold`, prompt per tier:
• `count ≥ threshold + 30` → *"Knowledge audit overdue — N entries, plan for multi-pass. Run /audit-knowledge?"*
• `count ≥ threshold + 15` → *"Knowledge audit recommended — N entries, near one-pass ceiling. Run /audit-knowledge?"*
• `count ≥ threshold` → *"Knowledge audit suggested — N entries ready for review. Run /audit-knowledge?"*
• **Elapsed-days trigger** (safety net): if no entry-count tier fired AND `days_since >= audit_cadence_knowledge`, prompt: *"Knowledge audit due — N days since last audit. Run /audit-knowledge?"*
• **Neither fired**: report the last audit date + current backlog count + days-since, then stop. *"Last knowledge audit was N day(s) ago (YYYY-MM-DD). Backlog at M entries (threshold T). Next trigger at M=T entries or N=C days."*

Step 1b: Check Index Freshness

Read `{knowledge_folder}/index.md` if it exists.

Several audit steps depend on index data (Step 5b entity refs + skill-knowledge drift, Step 5c tag matching, Step 6 stale files). Running against a stale or missing index produces incomplete results.

**Check:** 1. If `index.md` doesn't exist → note: "No index found. Steps 5b (entity/skill checks), 5c (tag matching), and stale file detection will be limited. Consider running `/index` after this audit." 2. If `index.md` exists → read the `Last rebuilt:` date from the header. Compare against today.

• If **older than 7 days** AND there are pending backlog entries (from a quick line count of the 3 backlog files) → prompt: *"Index was last rebuilt N days ago and there are pending backlog items. Run `/index` first for more accurate integrity checks? (y/n)"*
• If user says yes → run the full `/index` logic (Steps 0-10 from the /index skill), then continue with Step 2
• If user says no → continue with degraded checks (note in Step 6 output which checks were limited)
• If **7 days or fewer** → continue normally, index