Cal Corum e484b2ab35 feat: cognitive-memory multi-graph support, XDG data paths, remove CORE.md auto-load

- Multi-graph: named graph routing in MCP server (graph param on all tools),
  CLI --graph flag, graphs subcommand, resolve_graph_path() in common.py
- XDG compliance: data dir resolves via COGNITIVE_MEMORY_DIR env > XDG_DATA_HOME > ~/.local/share/
- Remove CORE.md auto-loading: drop MEMORY.md symlinks, update CLAUDE.md to MCP-first recall
- Update all scripts (git-sync, ensure-symlinks, edge-proposer) for portable path resolution
- Remove symlinks step from daily systemd service
- Version bump to 3.1.0

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-02-28 14:55:12 -06:00

2.4 KiB

Raw Blame History

🚨 CRITICAL: @ MENTION HANDLING 🚨

When ANY file is mentioned with @ syntax, IMMEDIATELY call Read tool on that file BEFORE responding. Automatic loads are NOT enough — Read loads required CLAUDE.md context along the file path.

Behavior

User's name is Cal (he/him)
If not confident in an answer, say so. Offer hypothesis + options to investigate.
When writing tests, include detailed docstrings explaining "what" and "why"
Launch sub-agents with Sonnet model unless another model is specified by the user

Git Commits

NEVER commit/add/push/tag without explicit user approval ("commit this", "go ahead")
Don't autopilot: find bug → fix → ASK → commit. Silence ≠ approval.
Applies to: git commit, git add, git tag, git push, deploy scripts

Gitea Operations

Prefer the gitea-mcp MCP server for all Gitea operations (PRs, issues, branches, labels, releases, Actions).

MCP tools use owner + repo params (e.g. owner=cal, repo=major-domo-v2)
Common repos: major-domo-v2, major-domo-database, major-domo-bot, paper-dynasty, paper-dynasty-database
Never use gh api --hostname for Gitea

Fallback: If MCP is unavailable, use tea CLI. Always pass --repo owner/name.

Tech Preferences

Python with uv for package/environment management
- Utilize dependency injection pattern whenever possible
Never add lazy imports to middle of file

SSH

ALWAYS use SSH aliases from ~/.ssh/config — NEVER construct manual ssh -i commands.

All homelab and cloud servers have aliases with pre-configured keys/users
Just ssh <alias> (e.g. ssh sba-db, ssh proxmox, ssh manticore)
If unsure of an alias, read ~/.ssh/config to find the right one
Fallback for unlisted homelab hosts: ssh 10.10.0.x (wildcard rule handles key/user)

Memory Protocol (Cognitive Memory)

Skill: ~/.claude/skills/cognitive-memory/ | Data: ~/.local/share/cognitive-memory/
Use MCP memory_recall to search for relevant past solutions, decisions, and fixes before starting unfamiliar work
Use MCP memory_store to persist: bug fixes, git commits (mandatory, --episode), architecture decisions, patterns, configs
Always tag: project name + technology + category
Session end: prompt "Should I store today's learnings?"
claude-memory core and claude-memory reflect available for manual browsing
Full docs: claude-memory --help or ~/.claude/skills/cognitive-memory/SKILL.md

2.4 KiB Raw Blame History