Skip to content

Commit 71e7ec9

Browse files
brabojclaude
andauthored
docs: make end-of-session checklist explicit in CLAUDE.md (#178)
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) <noreply@anthropic.com>
1 parent 6e74afd commit 71e7ec9

1 file changed

Lines changed: 8 additions & 6 deletions

File tree

CLAUDE.md

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -65,13 +65,15 @@ Extends `base/scope.md` with tutorial-specific boundaries:
6565

6666
Before ending a session, verify all of the following:
6767

68-
1. **Dev journal** — update `docs/dev-journal.md` with a session entry
69-
(date, tool, key changes, decisions, open issues)
70-
2. **ONBOARDING.md** — update `docs/ONBOARDING.md` if prerequisites,
68+
1. **Dev journal** — add a session entry to `docs/dev-journal.md`
69+
(date, tool, key changes, PRs merged, issues closed/created, open issues)
70+
2. **CLAUDE.md** — update if project structure or conventions changed
71+
3. **README.md** — update if chapter list, links, or setup instructions changed
72+
4. **ONBOARDING.md** — update `docs/ONBOARDING.md` if prerequisites,
7173
setup steps, or project structure changed
72-
3. **PLAYBOOK.md** — update `docs/PLAYBOOK.md` if operational
73-
workflows changed (diagram export, chapter review process, etc.)
74-
4. **solid-ai-templates** — check if upstream submodule needs updates
74+
5. **PLAYBOOK.md** — update `docs/PLAYBOOK.md` if operational
75+
workflows or file paths changed
76+
6. **solid-ai-templates** — check if upstream submodule needs updates
7577
based on new patterns or conventions discovered during the session
7678
(e.g. new scope rules, documentation rules, quality conventions)
7779
5. **Open issues** — close resolved GitHub issues, update or create

0 commit comments

Comments
 (0)