@@ -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
116116Every 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
193193Gray commit circles (diameter 28), branch pills to the right of the
194194commit 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
196196shows 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: ` & ` → ` & ` , ` < ` → ` < ` , ` > ` → ` > `
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
231231rounded=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
256256Extends ` 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
264264Read all referenced template documents before starting work. Confirm
265265session scope with the user.
266266
267- ### 4 .3 End of session
267+ ### 3 .3 End of session
268268
269269Before 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