Files
claude-foundations/MEMORY.md
Paul O'Reilly e94417b896 Add best practices, hooks, memory files, and scripts from recent sessions
Includes: spec-driven and test-driven development best practices,
reproduce-before-fixing debugging workflow, require-plan-file hook,
find-project-root script, session logs, memory files for decisions/
gotchas/process-lessons, and updates to existing best practice topics.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-17 09:47:47 +13:00

2.2 KiB

claude-foundations — Memory Index

Runbooks

  • New ArgoCD App — Full procedure: manifests, KSOPS secrets, ArgoCD Application, Caddy reverse proxy, DNS, verification, common pitfalls

Scripts

  • context-load — Walks cwd upward collecting CLAUDE.md, CONTEXT.md, MEMORY.md, BESTPRACTICES.md, trees, and git status for system prompt injection
  • start-claude — Wrapper that runs context-load and launches claude with --append-system-prompt
  • install-hooks — Symlinks hooks into ~/.claude/hooks/ and prints settings.json config
  • setup-formatters — Opts a project into auto-formatting by symlinking formatter scripts
  • git-status-report — Scans directories for git repos, reports uncommitted changes and remote sync (lives in small-scripts)
  • require-plan-file — PreToolUse hook: blocks ExitPlanMode unless a *-PLAN.md file exists in the project root

Skills

  • /log — End-of-session logging to memory/log/ for later reflection
  • /reflect-logs — Processes session logs into topic memory files (gotchas, decisions, process lessons)
  • /reflect — Milestone reflection: reviews conversation + git log, produces structured artifacts
  • /distill-best-practices — Cross-project distillation of memory files into best-practices/ topic files
  • /linter — Audit and manage project formatters/linters (scan, run, cleanup modes)
  • /context-load — Reload project context after /clear or mid-session context loss

Topic Files

  • Decisions — Architecture and design decisions: pipeline design, linting system, context-load, CLAUDE.md structure
  • Process Lessons — Working rules: git-status at session start, plan mode for architecture, hook exit codes, ssh-agent
  • Skills Gotchas — Broken symlinks under set -e, mid-session skill discovery limitation