Refinement leaf under #14483 (v13.1 release notes, multi-iteration). Part of #14310.
Problem
The v13.1.0 notes are narratively strong (War Story, Stop Hook, Golden Path v2 — all mined + sourced) but fail the §5 quality bar on the show-don't-tell craft layer. V-B-A against the precedent SET (release-notes-workflow §5 — "the bar is a set, never one file"):
| element |
v13.1.0 (current) |
v13.0.0 (major) |
v12.1.0 (minor) |
| Mermaid diagrams |
0 |
3 |
2 |
| verbatim human-AI moments |
0 |
many |
1 [!NOTE] |
| code-in-action |
0 |
1 |
2 |
The release is the immune system, and its War Story is literally structured as Detect→Diagnose→Heal→Prevent — yet there was no diagram of that loop. Both exemplars diagram their central topology.
This leaf (iteration 3 — the diagram layer)
Two mermaid flowchart LR diagrams, each a structural render of already-sourced, in-document content (zero new claims, no §3 mining debt):
- The immune system — the green-but-gutted inversion (container watch reports healthy while ~60% data-gutted, #13999) → Detect (#14026/#14024) → Diagnose (#14043/#14027) → Heal (#14134/#14133/#14166) → Prevent (#14029/#14036/#14033), loop-closes with no human paged. Placed in the War Story chapter.
- Golden Path v2 route-attribution — semantic candidate → gates → structural components (ADVANCES 1.50, RESOLVES 2.00) → GUIDES write → rendered values (Structural 3.50), the #14454/PR#14458 one-run ledger. Placed in the Golden Path v2 chapter.
Syntax mirrors the shipped-and-rendering v13.0.0.md diagrams; portal render-verification is the review-gate step (no local mmdc).
Out of scope (iteration 4, named not taken)
Verbatim human-AI moments (> [!NOTE] sidebars — the Stop-Hook "mirror caught its maker" operator moment) + code-in-action. These need proper §3 session mining and must not be rushed / fabricated.
Evidence
Evidence: L2 (static — 2 mermaid blocks, balanced fences, no parens-in-labels; syntax mirrors proven v13.0.0 diagrams) → L2 required (docs; portal render at merge gate). Iteration banner stays (still iteration N-of-M, pre-cut).
Authored by Grace (@neo-opus-grace, Claude Opus 4.8).
Refinement leaf under #14483 (v13.1 release notes, multi-iteration). Part of #14310.
Problem
The v13.1.0 notes are narratively strong (War Story, Stop Hook, Golden Path v2 — all mined + sourced) but fail the §5 quality bar on the show-don't-tell craft layer. V-B-A against the precedent SET (release-notes-workflow §5 — "the bar is a set, never one file"):
[!NOTE]The release is the immune system, and its War Story is literally structured as Detect→Diagnose→Heal→Prevent — yet there was no diagram of that loop. Both exemplars diagram their central topology.
This leaf (iteration 3 — the diagram layer)
Two
mermaid flowchart LRdiagrams, each a structural render of already-sourced, in-document content (zero new claims, no §3 mining debt):Syntax mirrors the shipped-and-rendering
v13.0.0.mddiagrams; portal render-verification is the review-gate step (no local mmdc).Out of scope (iteration 4, named not taken)
Verbatim human-AI moments (
> [!NOTE]sidebars — the Stop-Hook "mirror caught its maker" operator moment) + code-in-action. These need proper §3 session mining and must not be rushed / fabricated.Evidence
Evidence: L2 (static — 2 mermaid blocks, balanced fences, no parens-in-labels; syntax mirrors proven v13.0.0 diagrams) → L2 required (docs; portal render at merge gate). Iteration banner stays (still iteration N-of-M, pre-cut).
Authored by Grace (@neo-opus-grace, Claude Opus 4.8).