Expert is now Done with 2 human editorial passes. Updated work queue, systematic fixes checklist (now 13 items), spell name / dimension cross-tier audit results, and 7 new lessons learned (19-25). Made-with: Cursor
11 KiB
Agent Handoff — Lore Rewrites & Editorial Passes
Updated 2026-04-17 after completing Expert tier (full editorial cycle). Read QUICKSTART.md and SKILL.md first.
What was just completed
Expert tier — full editorial cycle (2 Expert)
110 items across 7 flavors. Lore rewrites, systematic fixes, two human editorial passes (text + PDF visual), all complete.
Lore rewrites (13 items):
- Magic (3): Manaloom Thread, Riftstep Charm, Spirit-Anchor Nail
- Recovery (8): Breath-of-Balm, Hearth-in-a-Cup, Ironstitch Poultice, Knit-Bone Cordial, Muscle-Memory Draught, Tonic of Gentle Stamina, Venom-No-More Phial, Weaver's Restorative Thread
- Stealth (1): Dust of Quiet Boards
- Strike (1): Garrote of Soft Whispers
Boilerplate closer replacements (2): Spellguard Veil, Catstep Powder — "treat it as a dare" removed.
Systematic fixes applied across 110 items:
- Potion RAW cleanup (13 potions): Removed "Action/Bonus Action to drink" and "Single use." Kept non-RAW specifics (timing constraints, administer, multi-dose).
- Throwable subheads (10 items): 7 area effects →
throwable (range'), 3 attack-roll items →thrown weapon (normal'/far'). Ignition Phial was wrongly subheaded "potion". - Save DCs (13 items): Added rarity-scaled DCs where saves lacked them. 9 Uncommon DC 14, 1 Common DC 12, 3 Rare DC 16.
- Bold typography (11 items): Fixed unbold +N bonuses and split-bold dice.
- Subhead accuracy (19 items): Corrected salve/poultice, wondrous item, medical supply, consumable variants, ammunition across all flavors.
- Spell name italics (5 items): Magic Missile, Feather Fall, See Invisibility, Mage Hand, Detect Magic, Silence, Pass Without Trace — all now italic + Heading Case.
- Dimension expressions (1 item): 5x10x5 → 5×10×5-foot with × (U+00D7).
Human editorial pass 1 (text-based, all 7 flavors):
- Frost-Away Unguent: wrong mechanics corrected (was copy of Cinder-to-Soot: burns/fire → frostbite/cold per raw material)
- Smoke Lash Cartridge: clarified as area effect, subhead →
ammunition and throwable (60') - Magebane Flash: "Spell Save DC -2" and "disadvantage to hit" bolded as phrases
- Pulsebreaker Bolt: DC "higher of 14 or half damage dealt" (standard concentration check)
- Hunter's Promise Oathband: removed long rest recharge — three charges, period
- Silence Coin: single use (was 1 charge/recharge at dawn)
- Stone of Sensible Silence: three charges (was 2/day)
- Lantern of Polite Daylight: ships with 3 fuel crystals (dropped vague "replaceable")
- Rag-and-Rum: added 1d4 fire damage, single range throwable (30')
- Catstep Powder: tremor-hearing → tremorsense or similar blindsight
- Whisperhook Grapple: "Two uses." (removed recharging from mechanics and lore)
- Phosphor Scattershot: "negates invisibility", fixed lore paragraph break inside quote
- Plus ~30 additional bold scoping, condition italic, subhead corrections
Human editorial pass 2 (PDF visual):
- Lore space extensions (y-5, h+20) on 6 items: Spellguard Veil, Bottled Quicksand, Magebane Flash, Ironstitch Poultice, Spark-Back Salts, Rope of Cooperative Knots
- Spellguard Veil: additional font size reduction (9.33→8.8px, line-height 1.25→1.20) to fit all lore
- Manaloom Thread: title overflow → split to two lines
- Rope of Cooperative Knots: title overflow → hyphenated "ROPE OF CO-" / "OPERATIVE KNOTS"
- Razorwire Bracelet: mechanics rect height 84→239 (wrong template rect caused text clipping)
SVGs done, ITEMS.md regenerated, PDFs rebuilt, packs assembled, QA passed (0 warnings, all 7 flavors matched).
Previously completed
- 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.
- 4 Grandmaster — Systematic editorial complete. Awaiting human mechanics review.
- 0b Intermediate + 0c Specialist — Lore restructuring (49 items) by prior agent.
Tooling created this session
scripts/rewrite-mechanics.py— edits mechanics text (-m) and/or subhead (-s) in existing SVGs without regenerating the full card.- SKILL.md major additions: Cardinal Rule for lore, spell name italics rule, dimension × rule, bold scoping guidance, "never restate RAW" principle, throwable vs thrown weapon distinction, range notation pitfall.
Work queue
| Tier | Lore status | Editorial status | Notes |
|---|---|---|---|
| 0a Novice | N/A | N/A | Mini items |
| 0b Intermediate | Done | Pending | Short lore acceptable; may need 100-word rewrites eventually |
| 0c Specialist | Done | Lore+mechanics done | DC 13 gap remains (printed tier) |
| 1 Capable | Done | Done | Complete — 2 editorial passes |
| 2 Expert | Done | Done | Complete — 2 editorial passes |
| 3 Master | Done | Done (2nd look) | Reprints PDF built; 57 OpenClaw lore 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 tasks
Grandmaster (4 Grandmaster) — HUMAN REVIEW:
- Human mechanics review. Agent systematic fixes are complete. Human should review against table homebrew.
- Export PDFs and build packs after human review.
Exit (5 Exit): 21 OpenClaw lore entries to rewrite. Same pattern. After Grandmaster.
Systematic fixes checklist (apply to every tier)
Apply before human editorial passes:
- Potion RAW cleanup: Remove "Action/Bonus Action to drink" and "Single use" from all potions. The subhead "potion" implies both.
- Throwable subheads: Area effects →
throwable (range'), attack rolls →thrown weapon (range'/range') - Bold typography: All
+Nbonuses, dice rolls, ranges, advantage/disadvantage, resistance/immunity, cover, "cannot be surprised", dimension expressions - Split-bold scan: Fix
**Xd?**+N→**Xd?+N**andN/**M ft**→**N/M ft** - Save DCs: Every save must have rarity-scaled DC. Common 12, Uncommon 14, Rare 16, Very Rare 19, Legendary 21–25.
- Subhead accuracy: Verify subhead matches what the item actually is (coatings→apply, wraps→medical supply, thrown→throwable, etc.)
- Spell names: Always italic and Heading Case: Magic Missile, Feather Fall, etc.
- Dimension expressions: Use × (U+00D7), not x. Bold the full expression: 5×10×5-foot.
- Conditions in italic: frightened, charmed, poisoned, prone, restrained, invisible (when referring to the condition, NOT when used as a plain adjective).
- Lore space: Check that lore doesn't clip at bottom of card; extend rect (y-5, h+20) or reduce font if needed.
- Duplicate lore closers: Scan for repeated final paragraphs.
- Charges not recharges: Consumable items have finite charges. No "recharges at dawn" unless the item is explicitly not consumable.
- Normal/far ranges: Only for attack rolls. Area effects use a single range number.
Spell name italics needed in other tiers
Discovered during Expert catalog-wide scan:
| Tier | Items |
|---|---|
| 1 Capable | Silence (Silence Kernel), Detect Magic (Witchsight Lens) |
| 3 Master | Detect Magic (1 item) |
| 4 Grandmaster | Dispel Magic (1), Silence (2), Counterspell (lore) |
| 5 Exit | Silence (Godsbane Silence Bell), Counterspell (1) |
Dimension × needed in other tiers
| Tier | Items |
|---|---|
| 3 Master | 1 item ("10x10 ft" → 10×10-foot) |
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)
Lessons learned (cumulative)
- ITEMS.md is derived, not authoritative. Edit SVGs, merge, regenerate ITEMS.md from main checkout. Never edit ITEMS.md directly.
generate-source-of-truth.pyneeds raw materials. Running it in a worktree silently drops consensus negotiation blocks and image references. Always run from main checkout.- PDF filenames need price tags. Format:
Card Name (price).pdf. Never generate without the price. - Pack assembly needs cross-flavor search. Use
assemble-packs.pywhich searches all flavors and handles aliases. - Curly apostrophes in filenames. SVGs may use
'(U+2019), PACKS.md uses straight'. The pack assembly script normalizes for matching. - Always run QA before declaring done. Check pack page counts, singles vs SVGs, zero warnings.
rebuild-specialist-pdfs.shis hardcoded for 0c Specialist. For other tiers, use an inline bash loop.- Borderline items exist. Use judgment on lore rewrites. Document kept-as-is items in commit messages.
- PACKS.md names can differ from SVG filenames. Add aliases to
assemble-packs.pywhen mismatches are found. - Clean stale PDFs before QA. Old exports with outdated prices cause false count mismatches.
- Lore source tags reflect raw-material provenance, not current authorship. The text content is what matters.
- Never restate RAW on cards. Potions don't need "Action to drink" or "Single use." Only state what's new about the item.
- Throwable vs thrown weapon distinction. Area effects get
throwable (range')with one range number. "On hit" items getthrown weapon (normal'/far'). - Bold every numeric bonus and penalty. Also watch for split-bold dice: modifier must be inside the bold.
- Use
rewrite-mechanics.pyfor targeted fixes. Accepts-m(mechanics) and-s(subhead) flags. Preserves lore, images, layout. - Lore Cardinal Rule: hook opener, mic-drop closer. First sentence hooks, last sentence is quotable at the table.
- Two editorial passes are essential. First from ITEMS.md text, second from All Player Packs PDF. Different media surface different problems.
- Lore text field clipping is common. Extend shape-inside rect (y-5, h+20). If still not enough, subtly reduce font size (9.33→8.8px) and line-height (1.25→1.20).
- Spell names in italic + Heading Case. Magic Missile, Feather Fall, Mage Hand, etc. Follows RAW presentation. Do a catalog-wide scan when fixing a tier.
- Dimension expressions use × (U+00D7). Not lowercase x. Bold the full expression.
- Charges, not recharges, on consumables. "Three charges." not "Three charges; recharges at dawn." unless the item is explicitly durable.
rewrite-mechanics.pyMUST use argparse flags (-m/-s). See SKILL.md pitfall #22.- Reprints count = pack appearances, not pack + single. When building replacement PDFs, count PACKS.md occurrences only.
- Concentration save DCs should be "the higher of [rarity DC] or half damage." This prevents the item from nerfing high-damage scenarios where RAW concentration DC would be higher.
- Wrong-mechanics items exist. Frost-Away Unguent had identical mechanics to Cinder-to-Soot Ointment (copy-paste from generation). Always verify mechanics against the raw material and item name.