mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-03-30 13:43:26 +08:00
72 lines
2.0 KiB
Markdown
72 lines
2.0 KiB
Markdown
# 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:
|
|
|
|
```bash
|
|
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
|
|
|
|
```text
|
|
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)
|