f41c22d0ac
- CLAUDE.md: add "Question the question" and "One clarifying question" rules to Tone and Interaction — XY problem detection, false premise checks, and explicit reframe pattern before answering - Add claude/ detail-file directory (topic docs referenced from CLAUDE.md) - Add ABOUT.md, FUTURE.md - Update memory/, scripts/, settings.yaml with accumulated session changes Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1.7 KiB
Milestones
Break projects into numbered milestones (M1, M2, ...). Every milestone completion MUST include:
-
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. -
Milestone reflection in
memory/m<N>-reflection.md— review the entire conversation from the start of the milestone (not just the final state) and capture:- Process improvements: what slowed us down, wrong assumptions, backtracking, what could be automated. What would make this milestone faster if we redid it from scratch?
- Key knowledge for reproduction: critical facts, gotchas, non-obvious config details that someone (or a future Claude session) would need to recreate this milestone reliably. Include version-specific quirks, network/subnet constraints, debugging detours.
- Scripts and automation: existing scripts that proved valuable, new scripts that would condense multi-step manual processes, patterns that could be extracted. Look at the conversation history for command sequences run repeatedly — these are scripting candidates.
- Future improvement ideas: things that surfaced but don't belong in current scope. Add to
FUTURE.mdwith the standard Problem/Idea/Open questions/Depends on format.
-
Updated README.md — scripts section, milestone table, any new setup steps.
-
Updated CLAUDE.md — repo structure, conventions, new patterns discovered. (After the split: this may mean updating a
claude/<topic>.mddetail file rather than the root CLAUDE.md.) -
Update affected topic files in
memory/(new gotchas, updated status) and the MEMORY.md index.