From c1c20ae5c5443edc1b2b9ed56714171756537052 Mon Sep 17 00:00:00 2001 From: Branimir Georgiev Date: Sun, 26 Apr 2026 08:34:42 +0300 Subject: [PATCH] docs: make end-of-session checklist explicit in CLAUDE.md Add CLAUDE.md and README.md to the checklist. Clarify when each doc needs updating and what to include in dev journal entries. Co-Authored-By: Claude Opus 4.6 (1M context) --- CLAUDE.md | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index f4875bf..d2c01db 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -65,13 +65,15 @@ Extends `base/scope.md` with tutorial-specific boundaries: Before ending a session, verify all of the following: -1. **Dev journal** — update `docs/dev-journal.md` with a session entry - (date, tool, key changes, decisions, open issues) -2. **ONBOARDING.md** — update `docs/ONBOARDING.md` if prerequisites, +1. **Dev journal** — add a session entry to `docs/dev-journal.md` + (date, tool, key changes, PRs merged, issues closed/created, open issues) +2. **CLAUDE.md** — update if project structure or conventions changed +3. **README.md** — update if chapter list, links, or setup instructions changed +4. **ONBOARDING.md** — update `docs/ONBOARDING.md` if prerequisites, setup steps, or project structure changed -3. **PLAYBOOK.md** — update `docs/PLAYBOOK.md` if operational - workflows changed (diagram export, chapter review process, etc.) -4. **solid-ai-templates** — check if upstream submodule needs updates +5. **PLAYBOOK.md** — update `docs/PLAYBOOK.md` if operational + workflows or file paths changed +6. **solid-ai-templates** — check if upstream submodule needs updates based on new patterns or conventions discovered during the session (e.g. new scope rules, documentation rules, quality conventions) 5. **Open issues** — close resolved GitHub issues, update or create