Harness Audit Command

Run a deterministic repository harness audit and return a prioritized scorecard.

Usage

/harness-audit [scope] [--format text|json]

scope (optional): repo (default), hooks, skills, commands, agents
--format: output style (text default, json for automation)

Deterministic Engine

Always run:

node scripts/harness-audit.js <scope> --format <text|json>

This script is the source of truth for scoring and checks. Do not invent additional dimensions or ad-hoc points.

Rubric version: 2026-03-16.

The script computes 7 fixed categories (0-10 normalized each):

Tool Coverage
Context Efficiency
Quality Gates
Memory Persistence
Eval Coverage
Security Guardrails
Cost Efficiency

Scores are derived from explicit file/rule checks and are reproducible for the same commit.

Output Contract

Return:

overall_score out of max_score (70 for repo; smaller for scoped audits)
Category scores and concrete findings
Failed checks with exact file paths
Top 3 actions from the deterministic output (top_actions)
Suggested ECC skills to apply next

Checklist

Use script output directly; do not rescore manually.
If --format json is requested, return the script JSON unchanged.
If text is requested, summarize failing checks and top actions.
Include exact file paths from checks[] and top_actions[].

Example Result

Harness Audit (repo): 66/70
- Tool Coverage: 10/10 (10/10 pts)
- Context Efficiency: 9/10 (9/10 pts)
- Quality Gates: 10/10 (10/10 pts)

Top 3 Actions:
1) [Security Guardrails] Add prompt/tool preflight security guards in hooks/hooks.json. (hooks/hooks.json)
2) [Tool Coverage] Sync commands/harness-audit.md and .opencode/commands/harness-audit.md. (.opencode/commands/harness-audit.md)
3) [Eval Coverage] Increase automated test coverage across scripts/hooks/lib. (tests/)

Arguments

$ARGUMENTS:

repo|hooks|skills|commands|agents (optional scope)
--format text|json (optional output format)

2.0 KiB Raw Blame History