docs(HANDOFF): update after Grandmaster systematic editorial

Grandmaster agent pass complete: 69 SVGs fixed (potion RAW, DCs,
bold typography, throwable/thrown weapon subheads, subhead accuracy).
Lore audit clean — all 30 catalog_back_expanded already in-voice.
Next: human mechanics review, then PDF export + pack build.

Made-with: Cursor
This commit is contained in:
2026-04-17 22:01:55 +02:00
parent 6ff8edea68
commit 456f6870c4
+60 -29
View File
@@ -1,36 +1,51 @@
# Agent Handoff — Lore Rewrites & Editorial Passes
> Updated 2026-04-17 after completing Capable tier editorial passes. Read QUICKSTART.md and SKILL.md first.
> Updated 2026-04-17 after completing Grandmaster systematic editorial. Read QUICKSTART.md and SKILL.md first.
## What was just completed
### Capable tier — COMPLETE (1 Capable)
### Grandmaster tier — systematic editorial (4 Grandmaster)
Full editorial cycle: lore rewrites, systematic fixes, and two human editorial passes.
Applied full systematic fixes checklist to all 140 Grandmaster items. 69 SVGs modified across 7 flavors. All lore audited; no rewrites needed.
**Lore rewrites (29 items):** All OpenClaw lore replaced with Claude Opus voice across Defense (2), Magic (10), Offense (2), Recovery (7), Stealth (5), Strike (1), Utility (2). Six `restored_from_source_tier_md` items evaluated and lightly rewritten (good bones, over-length or weak closers).
**Systematic fixes applied (69 SVGs touched):**
**Systematic fixes applied (generics — apply to ALL tiers going forward):**
- Potion RAW cleanup: removed "Action/Bonus Action to drink" and "Single use" from all potions
- Throwable subheads: `throwable (range')` for area effects, `thrown weapon (range'/range')` for attack rolls
- Bold typography: all numeric bonuses (`+N AC`, `+N to Skill`), dice rolls, ranges, advantage/disadvantage
- Split-bold fixes: `**1d8**+2` → `**1d8+2**`, `20/**60 ft**` → `**20/60 ft**`
- Save DCs: every save now has a rarity-scaled DC (Common 12, Uncommon 14, Rare 16)
- Subhead accuracy: corrected 15+ wrong subheads (coatings→apply, wraps→medical supply, etc.)
1. **Potion RAW cleanup (12 actual potions):** Removed "Action to drink." (7 potions) and "Single use." (12 potions) where implied by subhead. Kept "Action to drink or administer." on Phoenix Draft (meaningful choice), "Action to sip." on Breath of Warmth Flask, and "Bonus Action to drink." where it overrides default action cost.
**Human editorial passes (2 rounds):**
1. First pass from ITEMS.md text: 35 fixes across mechanics wording, bolding, subheads, clarifications
2. Second pass from All Player Packs PDF: 14 fixes including brew times for teas, lore space extensions, paragraph break fixes, missing save mechanics
2. **Non-potion subhead corrections (4 items):** Items with subhead "potion" that aren't drunk — liquids in flasks that are thrown or applied need appropriate subheads, not "potion":
- Thunderburst Phial: potion → `throwable (60')` (thrown area effect)
- Widow's Kiss Tincture: potion → `consumable (apply)` (weapon coating)
- Nightkey Serum: potion → `consumable (apply)` (coated on tools)
- Limb-Knit Serum: potion → `medical supply` (injected)
- "Single use." restored on all 4 (was incorrectly stripped in potion cleanup).
**Tooling:**
- `scripts/rewrite-mechanics.py` — rewrites front-side mechanics and/or subhead in SVG cards. Uses argparse: `-m`/`--mechanics` and `-s`/`--subhead` flags. **CRITICAL: never rewrite to use positional args** (see SKILL.md pitfall #22).
- Lore text field extension technique documented in QUICKSTART.md (adjust shape-inside rect: y-5, h+20)
- "Second Wind Salts" → "Second-Wind Salts" alias added to `assemble-packs.py`
3. **Missing Save DCs (31 items):** Added rarity-scaled DCs where saves lacked them:
- DC 19 (Very Rare): 26 items across all flavors
- DC 16 (Rare): Sentry Circle Chalk, Tempest Lash Cartridge, Widow's Kiss Tincture, Pikebreak Charge, Gale Capsule
4. **Bold typography (23 items):** Fixed split-bold dice (`**4d8**+8` → `**4d8+8**`) on 8 recovery items. Bolded +N bonuses (+2 AC, +5/+10 to Stealth, +2/+4 to spell DC/attack), advantage/disadvantage, resistance. Fixed `**resistance to ranged** **damage**` consolidation.
5. **Throwable subheads (9 items):** Area-effect throws → `throwable (range')`: Bulwark Beads, Tide-Turn Sand, Gravity Bead, Bleakfrost Ampoule, Cyclone Jar, Shattervine Grenado, Blackout Marble, Spiderline Capsule, Gale Capsule.
6. **Thrown weapon subheads (3 items):** Attack-roll throws → `thrown weapon (normal'/far')`: Bloodglass Spike, Flashchain Bolas, Stormreaver Net.
7. **Subhead accuracy (3 items):** Focus Salts → `consumable (inhale)`, Smuggler's Breath → `consumable (inhale)`, Heartstop Ampoule → `consumable (apply)`.
**Lore audit (30 catalog_back_expanded entries):** All 30 already rewritten in Claude Opus voice by prior agent. No boilerplate signals, no repeated closers, no duplicate lore paragraphs, word counts all 99–106 (target 100–120). No rewrites needed. Source tags still say `catalog_back_expanded` but content is in-voice.
**Not needed:** Lore rewrites (already done), mechanics merge (already done by prior session), reprints (pre-print tier).
**ITEMS.md, PACKS.md, BALANCE.md** regenerated from updated SVGs.
**Flashchain Bolas note:** Pre-existing DC 17 on STR save (not the standard DC 19 for Very Rare). May be intentional from consensus — flag for human review.
### Previously completed
- 0b Intermediate + 0c Specialist lore restructuring (49 items) — by prior agent
- 2 Expert lore rewrites + editorial — by parallel agent (in progress)
- **1 Capable** — Full editorial cycle: 29 lore rewrites, systematic fixes, 2 human editorial passes. Complete.
- **3 Master** — Two agent passes: typography, DCs, mechanics, lore closers, potion RAW, duplicate lore. Reprints PDF built.
- **0b Intermediate + 0c Specialist** — Lore restructuring (49 items) by prior agent.
- **2 Expert** — Lore rewrites + editorial by parallel agent (in progress).
- **4 Grandmaster** — Systematic editorial complete (this session). Awaiting human mechanics review.
## Work queue
@@ -41,33 +56,46 @@ Full editorial cycle: lore rewrites, systematic fixes, and two human editorial p
| 0c Specialist | Done | Lore+mechanics done | DC 13 gap remains (printed tier) |
| 1 Capable | Done | **Done** | Complete — 2 editorial passes from PDF |
| 2 Expert | In progress | In progress | Parallel agent working |
| 3 Master | Done | Done | Printed; replacement set done |
| 4 Grandmaster | 110 claude / 30 OpenClaw | Pending | **Next after Expert** — mechanics merged, lore needs rewrite, then editorial |
| 3 Master | Done | **Done (2nd look)** | Reprints PDF built; 57 OpenClaw lore still to rewrite (non-blocking) |
| 4 Grandmaster | All 140 claude-voice | **Agent pass done** | Awaiting human mechanics review; then PDF export + pack build |
| 5 Exit | 21 OpenClaw to rewrite | Pending | After Grandmaster |
### Next agent tasks
### Next tasks
**Grandmaster (4 Grandmaster):** 30 OpenClaw lore entries to rewrite. Same voice guide as Capable/Expert. Then full editorial cycle: systematic fixes (potions, throwables, bolding, DCs, subheads) followed by human editorial passes.
**Grandmaster (4 Grandmaster) — HUMAN REVIEW:**
**Exit (5 Exit):** 21 OpenClaw lore entries to rewrite. Same pattern.
1. **Human mechanics review.** Agent systematic fixes are complete. Human should review mechanics against table homebrew and tone, especially:
- Lingering Damage immunity items (Phoenix Thread Bandage, Spirit-Stitch Lattice)
- Flashchain Bolas DC 17 (non-standard for Very Rare — intentional?)
- Tea items (Surge Tea, Memory Dew) — currently have "Single use." per tea-item rules
- Any homebrew-specific adjustments
2. **Export PDFs and build packs.** After human review is complete, from main checkout:
- Export DM + Player PDFs for all 140 cards
- Run `assemble-packs.py "4 Grandmaster"` for pack assembly + QA
- Build `All Grandmaster Player Packs.pdf`
**Exit (5 Exit):** 21 OpenClaw lore entries to rewrite. Same pattern. After Grandmaster.
### Systematic fixes checklist (apply to every tier)
These were all discovered and applied during the Capable editorial. Apply them to every tier before human editorial passes:
These were discovered during the Capable editorial and confirmed still needed during the Master second-look. Apply them to every tier before human editorial passes:
1. **Potion RAW cleanup**: Remove "Action/Bonus Action to drink" and "Single use" from all potions
1. **Potion RAW cleanup**: Remove "Action/Bonus Action to drink" and "Single use" from all potions. The subhead "potion" implies both per RAW. This was the most common issue in Master (12 of 12 potions affected).
2. **Throwable subheads**: Area effects → `throwable (range')`, attack rolls → `thrown weapon (range'/range')`
3. **Bold typography**: All `+N` bonuses, dice rolls, ranges, advantage/disadvantage, resistance/immunity
4. **Split-bold scan**: Fix `**Xd?**+N` → `**Xd?+N**` and `N/**M ft**` → `**N/M ft**`
5. **Save DCs**: Every save must have rarity-scaled DC. Scan for "save" without "DC"
6. **Subhead accuracy**: Verify subhead matches what the item actually is (coatings, wraps, teas, etc.)
5. **Save DCs**: Every save must have rarity-scaled DC. Scan for "save" without "DC". Standard DCs: Common 12, Uncommon 14, Rare 16, Very Rare 19, Legendary 21–25. This was the second most common issue in Master (8 items missing DCs).
6. **Subhead accuracy**: Verify subhead matches what the item actually is (coatings→apply, wraps→medical supply, etc.)
7. **Lore space**: Check that lore doesn't clip at bottom of card; extend rect if needed
8. **Duplicate lore closers**: Scan for repeated final paragraphs (same thought, slightly different wording). This was a systemic lore-generation artifact found in 10 Master items. Likely affects other tiers too.
### Other outstanding work
- DC standardization for Specialist (DC 13 → DC 12/14 per rarity) — printed tier, needs reprint decision
- 5etools JSON generation for remaining tiers
- Bandage-Seal card missing from Specialist Recovery Pack 1 (no SVG exists)
- Master tier: 57 OpenClaw lore entries still to rewrite (non-blocking for print; can be done in a future pass)
## Lessons learned (cumulative)
@@ -86,3 +114,6 @@ These were all discovered and applied during the Capable editorial. Apply them t
13. **Two editorial passes are essential.** First pass from ITEMS.md text catches mechanics/logic issues. Second pass from the All Player Packs PDF catches visual issues (bolding, clipping, layout). Different media surface different problems.
14. **Lore text field clipping is common.** Extend the shape-inside rect (y-5, h+20) when lore clips at the bottom. See QUICKSTART.md for the technique.
15. **Tea items get special treatment.** Brewed teas: "One minute to brew and drink." + "Single use." Potions in bottles: neither (implied by RAW).
16. **Duplicate lore closers are a systemic generation artifact.** The lore generation process sometimes produces a final paragraph that restates the penultimate thought with slightly different wording. Found in 10/97 Master items. Scan every tier for this pattern — look for the last two paragraphs sharing the same core image or punchline.
17. **Second-look passes catch what first passes miss.** The Master tier had already been through a full agent editorial pass, yet still had 29 items with systemic issues (12 potions, 8 missing DCs, 10 duplicate lore, 1 grammar). A fresh set of eyes applying the same checklist is valuable.
18. **Reprints count = pack appearances, not pack + single.** When building replacement PDFs for printed tiers, count each card's occurrences in PACKS.md only. Singles don't need reprinting — the single PDF was already re-exported in place.