claude-projects/.claude/context.md

project_name: claude-config

Claude Config Audit — Context

What this project does

Saturday/Sunday Claude configuration and improvement sessions — behavior_changes review, hook development, memory system upgrades, skills development, and config audit workflow.

Key files

• /opt/appdata/docker/.claude/hooks/: all hooks live here (globally referenced)
• /opt/appdata/docker/.claude/scripts/session_log_insert.sh: validated insert helper for session_log table
• /home/administrator/.claude/settings.json: global settings, hook registration, plugin registration
• /home/administrator/.claude/projects/-opt-appdata-docker/memory/: primary memory directory
• /home/administrator/.claude/projects/-home-administrator-Desktop-claude/memory/: this session's memory
• project_claude_config_workflow.md: Saturday workflow, behavior_changes schema
• AUDIT_CONTEXT.md (Desktop/claude/): handoff file written at start of each audit session

Patterns to follow

• Validate Python hooks with python3 -c "import ast; ast.parse(open('file').read())" before saving
• All new memory files go in both project memory directories if globally accessible
• behavior_changes INSERT: copy template from project_claude_config_workflow.md exactly
• New rules go to behavior_changes DB with status='applied' after being written to memory
• Evolution instructions required on every new rule, playbook, or system
• Coolify API key: Vault secret/coolify → api_key via AppRole — NOT a file
• Always backup hooks before modifying: cp hook.sh hook.sh.bak.YYYYMMDD

Known issues / gotchas

• Semantic memory Phase 1 hooks NOT YET BUILT — Stop hook and SessionStart hook extensions pending
• /recall skill IS built at /opt/appdata/docker/.claude/skills/recall/SKILL.md — registered under homelab-skills plugin; invoke via Skill tool with name "recall" (not "homelab-skills@homelab-skills-local:recall")
• Feedback rule retrofit complete — all 35 files now have evolution instructions
• session_log_insert.sh validates project_id before inserting — use --dry-run to test
• pgvector ivfflat index warns about low recall with little data — normal until table is populated
• N8N work that results from claude-config design decisions is IN SCOPE for Sunday dev session

What NOT to break

• Hook registration in settings.json — all five hooks must remain wired
• Memory file indexing in both MEMORY.md files — every new memory file must be indexed
• Ollama on localhost:11434 (internal-only) — Coolify UUID: mbhuoyt968m23qt4x7lx01pc
• pgvector extension in claude_config DB — required for claude_memories table

Current state

2026-07-29 Wednesday: Voice Chat for Claude Code — preflight/design session (personal_projects id=214, in_progress). Ran full grill-me; locked all decisions. DELIVERABLES (in agent-builder/, committed as files): voice_chat_build_plan.md (locked decisions) + voice_chat_agent_prompts.md (3 bounded server-01 agent prompts A1 Whisper / A2 XTTS+Jarvis / A3 Stop-hook + main-session checklist). New memory: project_voice_chat_claude_code.md (indexed). Design: fully-local PTT voice (faster-whisper + Coqui XTTS-v2 on server-01 GPU, Jarvis voice), laptop audio daemon ⇄ primary Claude-in-tmux ⇄ server-01 GPU. Phase A includes background-agent audio-arbitration queue + pause/resume <agent> voice control + per-agent tmux instances. HARD DEADLINE ~2026-08-14 (Max upgrade). Open user tasks: provide Jarvis reference WAV; A1/A2 answer VRAM coexistence; build WPM listening test. NEXT: switch to infrastructure conversation for Tailscale/Twingate preflight (relevant to voice: transport for laptop↔server audio hops if laptop ever remote), then media_pipeline (personal_projects id=12).

Sunday Dev Plan (13 items)

Hooks:

1. Stop hook — MEMORY_EMBED tag detection + Ollama embed (from prior session)
2. SessionStart hook — semantic query + global handoff file + recent 48h summaries injection
3. UserPromptSubmit hook — add [CURRENT TIME] injection + 60% context checkpoint threshold
4. PostToolUse hook (new) — conflict-detector.py fires on Write/Edit to /memory/.md

Skills: 5. /recall skill — confidence-gated semantic memory query

New files: 6. playbook_checklist_decision.md — merged checklist (grill-me finalized 2026-05-30): DESIGN: old end-of-project + end-of-session checklists MERGED into one. Finishing a project = ending that conversation's session. Trigger table: - Built + verified working (project in DB) → Full merged checklist, all steps - Built + verified working (no DB entry) → Full merged checklist, skip DB steps - Planning/research only, nothing built → Summaries + context.md only - Switching conversations mid-project → Summaries + context.md only - 80% context hit, project mid-flight → Lightweight checkpoint: WIP commit, context.md "stopped at X", log follow-ups, routing "Project finished" = code/config/infra built AND basic functional check passes. "User says done" alone is not sufficient. Also update feedback_end_of_project_checklist.md + feedback_end_of_session_checklist.md to point to new merged playbook. 7. feedback_secrets_lookup_order.md — Vault before Bitwarden for any credential lookup 8. session_handoff.md template + write step added to conversation routing checklist

DB / Schema: 9. schedule_actuals table DDL in claude_config DB 10. proposed_schedule JSON template update (time_estimate_minutes + estimate_basis) + WF1b N8N node

Playbook update: 11. playbook_vault_token_rotation.md — add N8N manual rotation section

Behavior changes entries: 12. Pre-task context estimation rule (flag if >15% remaining context) 13. Per-project time estimation at session start (query completed-today projects)

Update instructions

Update at the end of every config audit session. Keep "Current state" section and pending items current.