Skip to content

Commit 1037c16

Browse files
brabojclaude
andcommitted
docs: move figure style rules under conventions (2.5)
Figures are content — they belong under conventions, not as a separate top-level section. Renumbers sections 3–4. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent c1ab0fd commit 1037c16

1 file changed

Lines changed: 15 additions & 15 deletions

File tree

CLAUDE.md

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -111,11 +111,11 @@ Every chapter follows this structure:
111111
- ASCII diagrams in markdown serve as fallback and source of truth
112112

113113

114-
## 3. Figure style rules
114+
### 2.5 Figures
115115

116116
Every figure follows these rules. Applies to draw.io XML, PlantUML, and SVG.
117117

118-
### 3.1 Core principles
118+
#### Core principles
119119

120120
- Flat only: no gradients, shadows, glows, or 3D effects
121121
- Sentence case for prose labels — filenames and acronyms keep their casing
@@ -124,7 +124,7 @@ Every figure follows these rules. Applies to draw.io XML, PlantUML, and SVG.
124124
- One visual grammar per figure — if it needs two, split into two figures
125125
- Shapes (circle vs pill vs card) distinguish elements in grayscale
126126

127-
### 3.2 Palettes
127+
#### Palettes
128128

129129
**A — Difficulty** (tier cards):
130130
- Beginner: fill `#EAF3DE`, border `#3B6D11`, text `#27500A`
@@ -155,7 +155,7 @@ for readers who use Git tools.
155155
- Border `#D3D1C7`, primary text `#2C2C2A`, secondary text `#5F5E5A`,
156156
arrow stroke `#444441`, white card `#FFFFFF`.
157157

158-
### 3.3 Typography
158+
#### Typography
159159

160160
| Use | Font | Size | Weight | Style |
161161
|---|---|---|---|---|
@@ -165,7 +165,7 @@ for readers who use Git tools.
165165
| Captions, footnotes | Helvetica | 11–12 px | Regular ||
166166
| Descriptive notes, placeholders | Helvetica | 11 px | Regular | Italic |
167167

168-
### 3.4 Arrow conventions
168+
#### Arrow conventions
169169

170170
- Solid 1 px `#444441`, 6 × 6 px chevron head. Labels in clear space, never
171171
on the line.
@@ -177,7 +177,7 @@ for readers who use Git tools.
177177
- **Italic `#5F5E5A` label** for named relationships (`attached`, `parent`).
178178
- **Self-loop** (small arc above box corner) for recursive references.
179179

180-
### 3.5 Component vocabulary
180+
#### Component vocabulary
181181

182182
- **Card**: rounded rect, rx=5–8, 0.5 px border, 10–12 px inner padding.
183183
- **Pill**: rounded rect with rx = height/2. For branches, tags, short labels.
@@ -188,22 +188,22 @@ for readers who use Git tools.
188188
readability on both light and dark page backgrounds. Export PNGs with
189189
transparent background — the card provides the contrast.
190190

191-
### 3.6 Commit-chain panel variant
191+
#### Commit-chain panel variant
192192

193193
Gray commit circles (diameter 28), branch pills to the right of the
194194
commit they point to, italic "HEAD" label above the active branch pill.
195195
`*main` means HEAD is attached to main. Dashed arrow from pill to commit
196196
shows the reference relationship. Uses Palette C.
197197

198-
### 3.7 draw.io file conventions
198+
#### draw.io file conventions
199199

200200
- Source files: `assets/drawio/<name>.drawio`
201201
- Naming: `git-<topic>-<variant>.drawio` (e.g. `git-branch-merge.drawio`)
202202
- Readable IDs: `card-commit-1`, `pill-main`, `arrow-3-2`
203203
- All cells `parent="1"`
204204
- XML-escape values: `&``&amp;`, `<``&lt;`, `>``&gt;`
205205

206-
### 3.8 draw.io style string templates
206+
#### draw.io style string templates
207207

208208
```
209209
# Commit circle (gray):
@@ -231,7 +231,7 @@ endArrow=classic;html=1;strokeColor=#444441;strokeWidth=1;endFill=1;endSize=6;da
231231
rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#D3D1C7;strokeWidth=0.5;shadow=0;arcSize=5;
232232
```
233233

234-
### 3.9 XML boilerplate
234+
#### XML boilerplate
235235

236236
```xml
237237
<mxfile host="app.diagrams.net">
@@ -249,22 +249,22 @@ rounded=1;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#D3D1C7;strokeWid
249249
```
250250

251251

252-
## 4. Session protocol
252+
## 3. Session protocol
253253

254-
### 4.1 Scope guard
254+
### 3.1 Scope guard
255255

256256
Extends `base/scope.md` with tutorial-specific boundaries:
257257
- One chapter per session is the default scope for content work
258258
- Diagram, exercise, and quiz changes within that chapter are in scope
259259
- Restructuring other chapters, creating new projects, or adding
260260
infrastructure is out of scope unless explicitly requested
261261

262-
### 4.2 Startup
262+
### 3.2 Startup
263263

264264
Read all referenced template documents before starting work. Confirm
265265
session scope with the user.
266266

267-
### 4.3 End of session
267+
### 3.3 End of session
268268

269269
Before ending a session, verify all of the following:
270270

@@ -281,7 +281,7 @@ Before ending a session, verify all of the following:
281281
issues for remaining work
282282

283283

284-
## 5. Commands
284+
## 4. Commands
285285

286286
```bash
287287
# Astro site (from astro-site/)

0 commit comments

Comments
 (0)