Documents the /housekeeping skill: purpose, usage, how it works,
and which scripts it orchestrates.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
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>
Creates MEMORY.md index and 10 memory files documenting:
- Scripts: context-load, start-claude, install-hooks, setup-formatters, git-status-report
- Skills: /log, /reflect-logs, /reflect, /distill-best-practices, /linter
Each file covers purpose, usage, how it works, and gotchas.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Every script in claude-foundations and skill in custom-claude-skills must
have a memory file in claude-foundations/memory/ with an index entry in
MEMORY.md, so future sessions can discover tooling without reading sources.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Aligns index files with context-load discovery: BESTPRACTICES.md and CONTEXT.md
now follow the same thin-index pattern as MEMORY.md, auto-loaded at session start.
Adds documentation for both new index types to CLAUDE.md Documentation Standards.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
First use of the CONTEXT.md pattern — thin index pointing to
context/ topic files, loaded by context-load at session start.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
PostToolUse hook auto-formats files after Edit/Write/MultiEdit with
git-blob checkpoints for safe revert. Pre-commit hook for staged files.
Canonical formatter scripts for py, sh, ts, sql, json (+ symlinks for
js, yaml, md). Install and setup scripts for project opt-in.
Includes best-practices/linting.md, HOOKS.md docs, README.md, and
session log.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
context-load walks from cwd upward, loading CLAUDE.md, CONTEXT.md,
MEMORY.md, and BESTPRACTICES.md files with directory trees and git
status. start-claude wraps the claude CLI with --append-system-prompt.
CLAUDE.md: removed Ansible/Helm sections (in best-practices/), folded
Validate Before Deploying into Process Principles, deduped secrets
bullet, fixed best-practices path references.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Hook source of truth now in hooks/, symlinked from ~/.claude/hooks/.
HOOKS.md covers what each hook does and installation steps.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Hook implemented at ~/.claude/hooks/pre-compact-backup.sh, configured
in ~/.claude/settings.json for both auto and manual compaction triggers.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- best-practices/: 11 topic files + INDEX.md extracted from cluster-bootstrap
and custom-claude-skills (validation, k8s, helm, ansible, secrets, debugging, etc.)
- settings.yaml: pipeline config (log retention, tracked projects, max logs per run)
- CLAUDE.md: updated with best-practices loading and pipeline documentation
- memory/log/: first session log demonstrating the format
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Conventions, community best practices research (Sept 2025 - March 2026),
and prioritized improvement backlog for Claude Code workflows.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
