Skip to content

Commit 2cf37ee

Browse files
feat(honcho): add /honcho:audit skill for periodic conclusion pruning
Moves honcho-audit from ~/.claude/skills/ into the plugin so it's namespaced as /honcho:audit alongside the other honcho skills. Adds allowed-tools hint (get_config, chat, query_conclusions, list_conclusions, delete_conclusion, create_conclusion) consistent with the convention used by config and interview skills.
1 parent 3d403cb commit 2cf37ee

1 file changed

Lines changed: 68 additions & 0 deletions

File tree

Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
1+
---
2+
description: Audit Honcho conclusions for staleness, duplicates, and low-signal entries. Use when memory surfaced via UserPromptSubmit feels noisy, contradictory, or outdated, or on a quarterly cadence to keep signal-to-noise high.
3+
allowed-tools: get_config, chat, query_conclusions, list_conclusions, delete_conclusion, create_conclusion
4+
user-invocable: true
5+
---
6+
7+
# Honcho Audit
8+
9+
Periodic review of conclusions stored in Honcho to prune drift, duplicates, and stale entries. Counter-balances `/honcho:interview`, which only ever adds.
10+
11+
## When to run
12+
13+
- **Quarterly** — prevents slow accumulation of contradictory preferences as the user's habits evolve.
14+
- **On demand** — when `UserPromptSubmit`-injected conclusions start feeling noisy, generic, or wrong.
15+
- **After major workflow changes** — new job, new project domain, new tooling stack.
16+
17+
## Procedure
18+
19+
### 1. Fetch the current conclusion set
20+
21+
Use `mcp__plugin_honcho_honcho__search` with a broad query (or `get_config` to confirm the active workspace/peer first), or call `chat` to have Honcho summarize what it "knows" about the peer.
22+
23+
Example chat prompt:
24+
25+
> List every conclusion you currently hold about peer `jonathan` on workspace `airstrip`, grouped by topic. Flag any that contradict each other or that reference specific projects/tools that may have rotated out.
26+
27+
### 2. Classify each conclusion
28+
29+
For each entry, assign one of:
30+
31+
| Category | Action |
32+
|---|---|
33+
| **Stable preference** (e.g. "prefers concise responses") | Keep |
34+
| **Project-specific** that's no longer active | Delete |
35+
| **Contradicts** a newer conclusion | Delete the older |
36+
| **Duplicate / near-duplicate** | Merge into the strongest phrasing |
37+
| **Too generic to steer behavior** (e.g. "likes good code") | Delete |
38+
| **Stale fact** (tool version, team member, schedule) | Delete or refresh |
39+
40+
### 3. Apply changes
41+
42+
Conclusions cannot be edited in place — delete + recreate. Use the Honcho MCP tools:
43+
- Delete via the SDK's `peer.conclusions.delete(id)` (exposed through the plugin's MCP surface)
44+
- Recreate merged/updated entries via `mcp__plugin_honcho_honcho__create_conclusion`
45+
46+
Batch deletions; verify the remaining set with one final `chat` query.
47+
48+
### 4. Record the audit
49+
50+
Append a one-liner to `~/.claude/projects/-Volumes-dev--claude/memory/reference_honcho_audits.md` (create if missing):
51+
52+
```markdown
53+
- YYYY-MM-DD — audited N conclusions, deleted M, merged K. Signal: <short observation about the drift you saw>
54+
```
55+
56+
This lets future audits spot pattern drift (e.g. "always deleting project-X entries — scoping problem").
57+
58+
## Decision heuristics
59+
60+
- **When in doubt, keep.** Honcho's dialectic layer tolerates some redundancy; aggressive pruning can strip context the model uses for dimensional retrieval.
61+
- **Delete aggressively on project-specific noise.** A conclusion like "uses Drizzle on fiftheye-watchtower-v3" is too narrow to live on the global peer.
62+
- **Flag scoping problems.** If >20% of conclusions are project-specific, that's a signal the plugin's `per-directory` session strategy isn't isolating enough — consider proposing per-workspace peers instead of a single global peer.
63+
64+
## Related
65+
66+
- `/honcho:interview` — captures new stable preferences (additive counterpart).
67+
- `/honcho:status` — quick health check; read conclusion count before and after an audit to confirm pruning landed.
68+
- `~/.honcho/config.json` — workspace, peer, and session-naming source of truth.

0 commit comments

Comments
 (0)