/harness-audit

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

loulanyue@loulanyue

GitHub

From plugin

awesome-claude-notes

26460 skills29 agents60 commands7 hooks

Install

> /plugin marketplace add loulanyue/awesome-claude-notes
> /plugin install awesome-claude-notes@awesome-claude-notes

How it fires

How this command gets triggered: by you, by Claude, or both.

Fires itselfClaude auto-loads it when your prompt matches the work.
You can call itInvoke it directly when you want it.
Slash command/harness-audit

Context preview

What this command does when you run it.

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

Command definition

harness-audit.md

description: "Run a deterministic repository harness audit and return a prioritized scorecard."

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):

1. Tool Coverage 2. Context Efficiency 3. Quality Gates 4. Memory Persistence 5. Eval Coverage 6. Security Guardrails 7. Cost Efficiency

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

Output Contract

Return:

1. `overall_score` out of `max_score` (70 for `repo`; smaller for scoped audits) 2. Category scores and concrete findings 3. Failed checks with exact file paths 4. Top 3 actions from the deterministic output (`top_actions`) 5. 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/)