Add best-practices library, knowledge distillation pipeline settings, and first session log
- 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>
This commit is contained in:
42
best-practices/milestones.md
Normal file
42
best-practices/milestones.md
Normal file
@@ -0,0 +1,42 @@
|
||||
# Milestones & Reflections
|
||||
|
||||
## Milestone Structure
|
||||
|
||||
Break projects into numbered milestones (M1, M2, ...). This provides clear checkpoints, measurable progress, and natural reflection points.
|
||||
|
||||
## Milestone Completion Checklist
|
||||
|
||||
Every milestone MUST include:
|
||||
|
||||
### 1. Verification Script
|
||||
|
||||
`scripts/verify-m<N>.sh` — automated checks confirming all milestone outcomes.
|
||||
- Idempotent, non-destructive, returns non-zero on failure
|
||||
- Colour output (green/red) for pass/fail
|
||||
- Environment-resilient (no sudo, test from accessible side)
|
||||
- Check for default/insecure credentials
|
||||
|
||||
### 2. Milestone Reflection
|
||||
|
||||
Write `memory/m<N>-reflection.md` by reviewing the **entire conversation** from milestone start. Cover:
|
||||
|
||||
- **Process improvements:** What slowed us down? Wrong assumptions? Where did we go in circles? What would make this faster if redone from scratch?
|
||||
- **Key knowledge for reproduction:** Critical facts, gotchas, non-obvious config details, version-specific quirks, debugging detours
|
||||
- **Scripts and automation:** Existing tools that proved valuable, new scripts to build, patterns to extract into reusable automation
|
||||
- **Future improvements:** Ideas that surfaced but don't belong in current scope — add to FUTURE.md
|
||||
|
||||
### 3. Updated README.md
|
||||
|
||||
Ensure the scripts section, milestone table, and setup steps are current.
|
||||
|
||||
### 4. Updated CLAUDE.md
|
||||
|
||||
Reflect new repo structure, conventions, and patterns discovered during the milestone.
|
||||
|
||||
## Reflection Quality
|
||||
|
||||
Good reflections capture:
|
||||
- Commit stats (total commits, fix percentage) to measure validation discipline
|
||||
- Longest detour and root cause
|
||||
- Most avoidable waste and what would have prevented it
|
||||
- Concrete checklist items for future similar work
|
||||
Reference in New Issue
Block a user