Files

Paul O'Reilly 22db5514f8 Add memory files, reflection state, and update docs

Memory files for decisions, bash gotchas, and process lessons.
Updated MEMORY.md index and README.md with new scripts.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-03-17 11:14:44 +13:00

1.9 KiB

Raw Blame History

Session Log — 2026-03-17

Summary

Diagnosed why /housekeeping skill wasn't loading in the ~/.claude-octopus profile, fixed the root cause in install.sh, and created a new check-skills script to detect missing/stale skill symlinks. Integrated check-skills into the /housekeeping skill.

Decisions

Decision: Use CLAUDE_CONFIG_DIR env var to detect the active Claude profile — Rationale: Claude Code sets this automatically; falls back to ~/.claude when unset
Decision: Create check-skills as a read-only diagnostic script rather than auto-fixing — Rationale: Keeps it safe for /housekeeping (information-only), users can run install.sh to fix
Decision: Log to small-scripts rather than custom-claude-skills — Rationale: The new script and tests live in small-scripts; custom-claude-skills changes were smaller edits

Gotchas Discovered

[claude-code] Symptom: /housekeeping skill not found when using ~/.claude-octopus profile — Fix: Each Claude profile has its own independent skills/ directory. Skills must be symlinked into every profile, not just ~/.claude. The CLAUDE_CONFIG_DIR env var identifies the active profile.
[claude-code] Symptom: install.sh hardcoded $HOME/.claude/skills so new skills only appeared in the default profile — Fix: Changed to ${CLAUDE_CONFIG_DIR:-$HOME/.claude}/skills

Key Context

CLAUDE_CONFIG_DIR env var is set by Claude Code to the active profile directory (e.g., /home/paul/.claude-octopus)
Multiple Claude profiles maintain completely independent skills/ directories — no cross-profile sharing
The check-skills script classifies skills as: LINKED (correct), MISSING (not in profile), STALE (wrong target), ORPHAN (not in source repo)

Process Notes

Spec-first workflow for check-skills kept implementation focused — spec, script, test, symlink, integrate
All 17 test cases passed on first run

1.9 KiB Raw Blame History