Files

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.4 KiB

Raw Blame History

Session Log — 2026-03-13

Summary

Cleaned up the root CLAUDE.md (removed duplicated Ansible/Helm sections, consolidated validation guidance, fixed best-practices references) and built a context-load / start-claude script pair for automated session context gathering. Introduced the CONTEXT.md pattern for future independent agent work.

Decisions

Decision: Remove Ansible and Helm sections from root CLAUDE.md — Rationale: already covered with more detail in best-practices/ansible.md and best-practices/helm.md; technology-specific practices belong in best-practices, not the root guidelines
Decision: Fold "Validate Before Deploying" into Process Principles — Rationale: was duplicated content; the examples fit naturally in the existing bullet point
Decision: context-load walks upward from cwd collecting CLAUDE.md, CONTEXT.md, MEMORY.md, BESTPRACTICES.md — Rationale: gives hierarchical context inheritance; highest ancestor provides global guidelines, project dir provides specifics
Decision: Tree depth 3 from every CLAUDE.md location — Rationale: deep enough to show project structure without overwhelming output
Decision: Dedup loaded files via readlink -f — Rationale: root CLAUDE.md is a symlink to claude-foundations; without dedup it would load twice
Decision: CONTEXT.md follows MEMORY.md pattern (thin index + context/ folder) — Rationale: consistency; CONTEXT.md focuses on active work for agent orientation, MEMORY.md on accumulated learnings

Key Context

~/dev/claude/CLAUDE.md is a symlink to ~/dev/claude/projects/claude-foundations/CLAUDE.md — this is intentional, claude-foundations is the canonical source
context-load output is passed via --append-system-prompt by the start-claude wrapper
Both scripts symlinked into ~/sbin/
CONTEXT.md is intended for future Docker-based independent agent operation — each agent gets full context load, starting prompt points to relevant CONTEXT.md entry
git-status-report output is ANSI-stripped before inclusion in context
Also committed the previously uncommitted linting system (18 files) from the earlier session

Process Notes

Session was efficient — cleanups and script creation done in parallel with minimal iteration
The context-load smoke tests from different directories caught the symlink dedup working correctly
Previous session's linting work was uncommitted — worth running git-status-report at session start to catch this pattern

2.4 KiB Raw Blame History