harness-auditlisted
Install: claude install-skill fmslutions/harness-audit
# Harness audit
Goal: an agent starts each session with a small, stable map and finds everything else on demand, and the project stays that way after you leave.
Evidence to keep in mind (details in `references/principles.md`): more always-loaded instructions degrade adherence and cost; auto-generated or redundant instruction files can lower task success; so this skill **removes and relocates** more than it writes, and **measures** before and after.
`SKILL_DIR` below means the folder containing this file. Scripts need only Python and git.
## Commands
| Command | Writes | Purpose |
|---|---|---|
| `diagnose` (default) | `.harness/reports/` only | Setup interview, inventory, baseline, scorecard, change plan |
| `apply` | project files, on a git branch, after approval | Execute the approved plan, install maintenance layer |
| `verify` | `.harness/reports/` | Re-measure, lock budgets, write the final report |
| `check` | nothing | Fast maintenance lint for periodic use |
If the user gives no argument, run `diagnose`. Never run `apply` without an approved plan from `diagnose` in this project.
Write every report and question in the user's language. Keep code, file names and frontmatter keys in English.
---
## diagnose
### 1. Detect, then confirm with the user
Run `python3 SKILL_DIR/scripts/detect.py --project .` and show a short summary. It scans the repo, parent folders and common locations (Documents, iCloud Obsidian, Dropbox, OneDrive) for Obsidian vaults; if the user