Skip to content

Commit 6dac40e

Browse files
brabojclaude
andauthored
docs: add session 8b entry to dev journal (#183)
Covers work done after the initial session 8 entry: CLAUDE.md restructure, review-before-merge rule, ADRs 007-008, upstream template updates, and Starlight spike ticket. Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent e80e19c commit 6dac40e

1 file changed

Lines changed: 42 additions & 0 deletions

File tree

docs/dev-journal.md

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -378,3 +378,45 @@ recipes/ ← renamed from playbook/ (17 recipe pages)
378378
- P2: #110, #151, #152, #159, #161, #171
379379
- P3: #135, #160
380380
- P4: #106, #109, #113, #114, #116#119, #122, #127, #131#133, #140, #147, #167, #168, #170
381+
382+
### 2026-04-26 — CLAUDE.md restructure, review process, ADRs
383+
384+
**Tool:** Claude Code (Opus 4.6)
385+
386+
**Key changes:**
387+
- Restructured CLAUDE.md with numbered sections (1–4) matching root repo convention
388+
- Moved figure style rules under conventions (2.6) instead of separate top-level section
389+
- Added git conventions (2.1), review section (2.2), session startup (3.2)
390+
- Added cross-reference caveat: markdown links must use URL path, not filesystem path
391+
- Fixed stale domain, docs/ description, duplicate checklist numbering
392+
- Made end-of-session checklist explicit — updated upstream `base/scope.md` and
393+
`formats/agent.md` (both inline and reference models) with numbered checklist
394+
- Added review-before-merge rule to git conventions in three places:
395+
upstream `base/git.md`, root imbra-spikes CLAUDE.md, and tutorial-git CLAUDE.md
396+
- Created ADR-007 (analytics: GSC for tutorials, Plausible for commercial) and
397+
ADR-008 (playbook split rule: command + explanation + gotcha)
398+
- Experimented with Stop hook for session wrap-up reminders — removed in favour
399+
of explicit CLAUDE.md checklist
400+
401+
**PRs merged:**
402+
- #177 — Dev journal session 8 entry
403+
- #178 — Make end-of-session checklist explicit
404+
- #179 — Restructure CLAUDE.md with numbered sections
405+
- #180 — Add review section and review-before-merge rule
406+
- #181 — Add ADR-007 and ADR-008
407+
408+
**Upstream PRs merged (solid-ai-templates):**
409+
- #57 — Make end-of-session checklist explicit in scope.md and agent.md
410+
- #59 — Add review-before-merge rule to base/git.md PR section
411+
412+
**Upstream issues created (solid-ai-templates):**
413+
- #58 — Add 360-degree analysis template (four lenses: user, technical, market, discovery)
414+
415+
**Issues created:**
416+
- #182 — Spike: assess Starlight as UI replacement (P2)
417+
418+
**Open issues:**
419+
- P1: #153, #154, #155, #158, #165, #166, #169, #172
420+
- P2: #110, #151, #152, #159, #161, #171, #182
421+
- P3: #135, #160
422+
- P4: #106, #109, #113, #114, #116#119, #122, #127, #131#133, #140, #147, #167, #168, #170

0 commit comments

Comments
 (0)