---

name: audit description: Run complete system health audit of DQIII8 — checks DB integrity, agent performance, pipeline connections, error log, and services. Produces a scored Markdown report. command: /audit allowed-tools: [Bash, Read, Grep] user-invocable: true auto-invoke:

• when: "7+ days since last audit OR 3+ unresolved errors detected in session" action: "Run /audit automatically to surface problems"

---

/audit -- System Health Audit

Triggers the auditor agent to analyze database/dqiii8.db and produce a structured health report.

Usage

/audit
/audit --period 30d       # analyze last 30 days instead of default 7
/audit --agent python-specialist   # scope to one agent

What it does

1. Queries all metric tables: agent_actions, error_log, sessions, skill_metrics
2. Uses views agent_performance and error_keywords_freq
3. Computes an overall health score (0-100)
4. Writes a Markdown report to database/audit_reports/audit-YYYY-MM-DD-HH.md
5. Inserts a summary row in the audit_reports table
6. Prints a one-line summary to the terminal

Output

[AUDIT] Score: 87/100 | Actions: 106 | Success: 100.0% | Failures: 0 | Unresolved errors: 0
Report: database/audit_reports/audit-2026-03-11-14.md

Score interpretation

| Score | Status | Cadencia recomendada | |-------|--------|----------------------| | > 80 | HEALTHY | next audit in 7 days | | 60-80 | WARNING | next audit in 3 days | | < 60 | CRITICAL | next audit in 1 day, notify user |

Auto-trigger

The stop.py hook automatically triggers /audit when 7+ days have passed since the last report in audit_reports. Also auto-invoked when errors accumulate during a session.

Agent

Handled by: .claude/agents/auditor.md Model: claude-sonnet-4-6