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