claude-memory/CORE.md

Memory Core (auto-generated)

Last updated: 2026-03-05 | Active memories: 223/712 | Next refresh: daily (systemd timer)

Critical Solutions

• N8N + Claude Code Automated Server Monitoring System - Built automated server health monitoring with N8N and Claude Code headless mode. (n8n, claude-code, automation)
• Claude Scheduled Tasks: headless Claude Code on systemd timers - Built a "Claude Cowork"-style scheduled task system using systemd timers and... (claude-scheduled, systemd, automation)
• Claude Scheduled Tasks: headless Claude Code on systemd timers - Built a "Claude Cowork"-style scheduled task system using systemd timers and... (claude-scheduled, systemd, automation)
• Migration Script: Default-to-Named-Graph Memory Transfer - /mnt/NV2/Development/cognitive-memory/scripts/migrate-memories.py (cognitive-memory, migration, multi-graph)
• Refactor: issue-poller.sh — replaced 5 of 6 Haiku+MCP calls with direct curl+jq Gitea API calls - claude-scheduled / issue-poller automation (issue-poller, gitea-api, curl)
• Docker MCP Gateway secrets workaround for headless Docker Engine (no Docker Desktop) - docker mcp secret set requires Docker Desktop's docker-pass CLI plugin (l... (docker-mcp-gateway, mcp, secrets)
• Expanded health monitoring to 6 servers with per-server SSH user support - Expanded CT 302 health check coverage from 3 to 6 monitored servers. (monitoring, claude-runner-monitoring, homelab)
• Cognitive Memory v3.0: Rich Edges + Hybrid Embeddings + MCP Server - Major upgrade to cognitive-memory skill. (cognitive-memory, mcp, architecture)
• Proxmox 7 to 8 upgrade completed successfully - Successfully upgraded Proxmox from PVE 7.4-20 (kernel 5.13.19) to PVE 8.4.16... (proxmox, homelab, upgrade)
• Agent Swarm Orchestrator: architecture decisions and lessons learned - Built a lightweight orchestration system using Claude Code native primitives. (orchestrator, swarm, claude-code)

Active Decisions

• Docker Tags Composite Action: Three-Channel Branch-Based Tag Resolution - Created docker-tags/action.yml in the cal/gitea-actions shared composite... (gitea-actions, docker, ci-cd)
• Extracted cognitive-memory app from skill dir to standalone project - Moved all application code (~6K lines) from `~/.claude/skills/cognitive-memor... (cognitive-memory, architecture, extraction)
• Cognitive memory data dir moved to XDG-compliant path (~/.local/share/cognitive-memory/) - Moved default data directory from hardcoded ~/.claude/memory/ to XDG Base D... ([\"cognitive-memory\", xdg, architecture)
• Skill organization: scoped user skills over symlinks - When skills need to be shared across multiple projects but not all projects,... (claude-code, skills, organization)
• Auto-edge creation on memory_store in MCP server - Implemented auto-edge creation in mcp_server.py that runs after every `memo... (cognitive-memory, edges, mcp)
• Multi-graph support: named, segregated memory namespaces for cognitive memory - Implemented multi-graph support for cognitive memory (Gitea issue #1). ([\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"cognitive-memory\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\", multi-graph, architecture)
• Removed CORE.md auto-loading from sessions — rely on MCP recall instead - Removed the MEMORY.md symlink mechanism that auto-loaded CORE.md (~3K tokens)... ([\\\"cognitive-memory\\\", core-md, optimization)
• PR Reviewer: Scheduled Poller over Webhook Trigger - Chose Approach C (scheduled poller) over webhook-triggered (Approach A) o... (pr-reviewer, claude-scheduled, architecture)
• PR Reviewer: Review All PRs Including AI-Generated - The PR reviewer agent reviews ALL open PRs, including those created by th... (pr-reviewer, issue-worker, safety)
• Issue Worker Agent: Phased Workflow Architecture - Rewrote the issue-worker agent at ~/.claude/agents/issue-worker.md from a f... (claude-configs, issue-worker, agent-design)

Key Fixes

• Fix: Issue-poller infinite loop — PRs returned as issues by gitea-mcp list_repo_issues - claude-scheduled / issue-poller automation (issue-poller, gitea, gitea-mcp)
• Fix: SteamCMD in LXC - Missing Config and DNS Resolution Failures - Cause:** SteamCMD inside LXC does not auto-detect platform. (steamcmd, lxc, proxmox)
• Fix: N8N MCP partial updates corrupt workflows via typeVersion bumps - Using n8n_update_partial_workflow to bump typeVersion values on nodes (e.... (n8n, mcp, n8n-mcp)
• Fix: Claude Code PostToolUse hook correct JSON format - Claude Code hooks were not firing because the configuration used incorrect fi... (sba-scouting, rust, claude-code)
• Fix: sqlx in-memory SQLite pool requires max_connections=1 - Integration tests using :memory: SQLite failed with "no such table" errors... (sba-scouting, rust, sqlx)
• Fix: N8N Master Loop Discord Summary node missing URL caused silent failures - The "Server Health Monitor - Master Loop" workflow (ID: p7XmW23SgCs3hEkY) w... (n8n, server-diagnostics, discord)
• [gitea-actions] Add shared docker-tags composite action for multi-channel Docker tag resolution - Commits made: 1 (gitea-actions, commit, configuration)
• Fix: Partial UUID prefix matching in cognitive memory client (git-style) - Users had to type full UUIDs when referencing memories or edges via the client. (cognitive-memory, fix, uuid)
• [homelab] Session: automation, configuration, creation, debugging, deployment, fix - Files edited (5): (homelab, automation, configuration)
• [major-domo] Session: deployment, fix, tooling - Work types: deployment, fix, tooling (major-domo, deployment, fix)

Configurations

• CT 302 claude-runner provisioned for server diagnostics - VMID:** 302, IP: 10.10.0.148, Hostname: claude-runner (proxmox, homelab, monitoring)
• n8n-mcp server setup for Claude Code via mcp-manager - Added n8n-mcp (czlonkowski/n8n-mcp v2.35.3) as an on-demand MCP server mana... (n8n, mcp, claude-code)
• PR Reviewer Agent Definition and Dispatcher System - Built a complete automated PR review system using Claude Code. (pr-reviewer, claude-scheduled, gitea)
• MCP servers go in ~/.claude.json, NOT ~/.claude/.mcp.json - Global MCP servers** must be defined in ~/.claude.json under the top-level... (claude-code, mcp, configuration)
• Palworld Dedicated Server on Proxmox LXC 230 - LXC ID: 230 (palworld, proxmox, lxc)
• Shared repos.json for claude-scheduled automations - Moved repos.json from a task-specific location to a shared location so all au... (claude-scheduled, repos, configuration)
• Config: mcp-tui-driver MCP server installed globally - Installed from source via cargo: (mcp, tui-testing, claude-code)
• CT 300 claude-runner: Two-Tier Health Check Architecture - The headless Claude server diagnostics system runs on CT 300 (hostname: `... (ct300, claude-runner, server-diagnostics)
• Path references updated across 6 files after cognitive-memory extraction - After moving app code from ~/.claude/skills/cognitive-memory/ to `/mnt/NV2/... (cognitive-memory, configuration, claude-code)
• Palworld STL Client Configuration (App ID 1623730) - Palworld (App ID 1623730) configured for Linux via SteamTinkerLaunch. (palworld, steamtinkerlaunch, gaming)

Key Procedures

• Self-managing n8n server health monitor with sub-workflows - Master + sub-workflow pattern in n8n for server health monitoring via CT 302... (n8n, homelab, monitoring)
• Add a new server to n8n health monitoring - To add a new server to the automated health monitoring system, only one file... (n8n, monitoring, homelab)
• Cognitive-memory has no test suite — use inline smoke tests - The cognitive-memory project at /mnt/NV2/Development/cognitive-memory/ has... (cognitive-memory, testing, workflow)