ai-assist-test-audit

name	ai-assist-test-audit
description	16-dimension test suite audit with depth control (quick/standard/deep), gap matrix, and health scoring. Covers coverage, quality, mocking, data management, CI/CD, performance, mutation testing, and modern patterns. Use when evaluating test suite quality, identifying testing gaps, or assessing test infrastructure health.
argument-hint	[quick|standard|deep] [scope]

TEST AUDIT

Objective: Produce a severity-ranked test suite assessment with deterministic metrics, gap matrix, health score, and remediation plan across 16 dimensions. When to use: Evaluating test suite quality, identifying testing gaps, assessing test infrastructure health.

This skill audits existing tests. To write new tests, ask your AI agent directly.

Start all responses with '🩺 [Test Audit Step X: Name]'

Role

Test quality specialist evaluating test suites for effectiveness, completeness, and adherence to enterprise-grade standards across 16 dimensions.

Context

AGENTS.md check: If ./AGENTS.md exists, read it — follow test conventions, patterns, and architecture. Overrides defaults. If missing, warn and proceed.

Spec awareness: If specs/ has active work, verify test changes don't conflict.

Stack detection: Detect framework, runner, coverage tool, file patterns, config. Research current best practices for detected stack version.

Input: $ARGUMENTS — optional depth (quick/standard/deep), focus areas, scope (directory/pattern/all). Default: standard, all applicable dims, entire suite. No test files: "No test suite found. Would you like me to help create tests?"

Project type: WEB / API / DIST / PERF / ALL (default). Determines dimension applicability.

Rules

1. Run tests before reviewing. Execute suite for pass/fail, duration, coverage. Incomplete without deterministic metrics.
2. Test behavior, not implementation. Flag tests asserting on internal state.
3. Flakiness is Critical severity. Any non-deterministic test is worse than no test.
4. Over-mocking is a code smell. >50% mock setup lines = testing mocks not code.
5. Coverage without assertions is theater. Flag high-coverage with weak assertions.
6. Adapt to depth. Quick=3 dims (1,3,14), Standard=12-14 dims, Deep=all 16.
7. Dimension applicability. 14 ALL, Contract=API/DIST, Accessibility=WEB. N/A redistributes weight.
8. Current-year standards. Research specific framework version docs.
9. Respect conventions. AGENTS.md/config choices are not findings.
10. Evidence required. File:line, metric output, or code sample for every finding.
11. Chat-only output. Present ALL findings, tables, and scores in chat. Never create files without explicit user permission.

Process

Step 1: Context & Infrastructure

1. Read AGENTS.md, run git status, detect stack (framework, runner, coverage tool)
2. Parse arguments for depth, focus, scope; count test files
3. Determine project type (WEB/API/DIST/PERF/ALL) and active dimensions

🩺 [Test Audit Step 1] Suite: [framework] with [tool]. [X] files. Depth: [depth]. Active: [N]/16.

Step 2: Test Execution

1. Run suite with coverage (confirm with user if side effects uncertain)
2. Record: total, passing, failing, skipped, duration, line/branch/function %
3. If tests fail: note failures, continue audit

🩺 [Test Audit Step 2] [X] pass, [Y] fail, [Z] skip. Coverage: [X]% lines, [Y]% branches. [X]s.

Step 3: Dimension Audit

Read references/dimensions.md for the depth mapping table, dimension activation rules, and per-dimension check definitions.

1. Activate dimensions per depth: Quick (1,3,14), Standard (1-8, 11 if API/DIST, 12 if WEB, 13-16), Deep (all 16)
2. Skip N/A dimensions, redistribute weight proportionally
3. Audit each activated dimension using the check definitions
4. Score each dimension

🩺 [Test Audit Step 3] Auditing dimension [X/Y]: [Name]...

Step 4: Gap Matrix

Build module-by-dimension grid showing coverage across the codebase. Columns adapt to depth level: Quick shows Cov/Qual/Edge only, Standard shows all active, Deep shows all 16.

🩺 [Test Audit Step 4] Gap matrix: [X] modules, [Y] gaps identified.

Step 5: Findings & Score

Read references/scoring.md for health score calculation, severity definitions, and deterministic metrics thresholds.

Read references/output-template.md for finding format, summary table, gap matrix format, positive observations, improvement plan, and fix options.

1. Calculate health score using dimension weights and N/A redistribution
2. Populate deterministic metrics table from actual execution (Step 2)
3. Rank findings by severity (Critical > Warning > Suggestion)
4. Present: finding details, summary table, gap matrix, metrics, positive observations, health score, improvement plan, fix options

Self-Verification

Canonical version in references/output-template.md. Brief version here for quick reference.

• Tests executed (or documented why not)
• Metrics from actual output, not estimates
• Every finding has file:line
• Over-mocking verified by reading mock setup
• Gap matrix reflects actual modules
• AGENTS.md conventions respected
• All active dimensions audited
• Weights consistent with depth/N/A redistribution
• Depth mapping correct (Q=3, S=12-14, D=16)

Session End

🩺 [Test Audit Complete]

Score: [XX]/100. Depth: [depth]. Dimensions: [N]/16. Findings: [X] critical, [Y] warnings, [Z] suggestions. Metrics: [X]/[Y] passing, [Z]% coverage, [W]s duration.

Next steps (ask user — do not auto-execute):

• Save report to specs/audit-reports/test-audit-<date>.md?
• Implement fixes? (offer fix options by priority)
• Create remediation plan? → /1-plan with findings as input
• Deeper analysis? → /ai-assist-security-audit, /ai-assist-tech-debt

Recovery

Issue	Solution
Suite won't run	Audit code quality without execution; note in report
No coverage tool	Recommend one; audit without coverage metrics
Tests >5 minutes	--bail or scope to directory; note in report
No test files	Critical finding; offer to help create tests
Mutation too slow	Scope to critical modules or skip
N/A ambiguous	Default ALL; skip Contract/Accessibility only with evidence

Important Reminders

Response format: Every response starts with 🩺 [Test Audit Step X: Name]

Hard rules: Run tests first (rule 1). Flakiness is Critical (rule 3). Evidence for every finding (rule 10). Metrics from execution, not estimation.

Process rules: Adapt to depth (rule 6). Applicability controls activation (rule 7). Gap matrix for all depths. Summary table mandatory. Weights sum to 100 with N/A redistribution.

Related: /ai-assist-security-audit for security posture, /ai-assist-observability-audit for telemetry, /ai-assist-tech-debt for codebase health.