Files
northlands-guild-packs/HANDOFF.md
T
rick f69661a1be docs: update HANDOFF.md — Expert tier complete (full editorial cycle)
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
2026-04-19 06:07:46 +02:00

11 KiB
Raw Blame History

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:

  1. Potion RAW cleanup (13 potions): Removed "Action/Bonus Action to drink" and "Single use." Kept non-RAW specifics (timing constraints, administer, multi-dose).
  2. Throwable subheads (10 items): 7 area effects → throwable (range'), 3 attack-roll items → thrown weapon (normal'/far'). Ignition Phial was wrongly subheaded "potion".
  3. Save DCs (13 items): Added rarity-scaled DCs where saves lacked them. 9 Uncommon DC 14, 1 Common DC 12, 3 Rare DC 16.
  4. Bold typography (11 items): Fixed unbold +N bonuses and split-bold dice.
  5. Subhead accuracy (19 items): Corrected salve/poultice, wondrous item, medical supply, consumable variants, ammunition across all flavors.
  6. Spell name italics (5 items): Magic Missile, Feather Fall, See Invisibility, Mage Hand, Detect Magic, Silence, Pass Without Trace — all now italic + Heading Case.
  7. 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:

  1. Human mechanics review. Agent systematic fixes are complete. Human should review against table homebrew.
  2. 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:

  1. Potion RAW cleanup: Remove "Action/Bonus Action to drink" and "Single use" from all potions. The subhead "potion" implies both.
  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, cover, "cannot be surprised", dimension expressions
  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. Common 12, Uncommon 14, Rare 16, Very Rare 19, Legendary 21–25.
  6. Subhead accuracy: Verify subhead matches what the item actually is (coatings→apply, wraps→medical supply, thrown→throwable, etc.)
  7. Spell names: Always italic and Heading Case: Magic Missile, Feather Fall, etc.
  8. Dimension expressions: Use × (U+00D7), not x. Bold the full expression: 5×10×5-foot.
  9. Conditions in italic: frightened, charmed, poisoned, prone, restrained, invisible (when referring to the condition, NOT when used as a plain adjective).
  10. Lore space: Check that lore doesn't clip at bottom of card; extend rect (y-5, h+20) or reduce font if needed.
  11. Duplicate lore closers: Scan for repeated final paragraphs.
  12. Charges not recharges: Consumable items have finite charges. No "recharges at dawn" unless the item is explicitly not consumable.
  13. 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)

  1. ITEMS.md is derived, not authoritative. Edit SVGs, merge, regenerate ITEMS.md from main checkout. Never edit ITEMS.md directly.
  2. generate-source-of-truth.py needs raw materials. Running it in a worktree silently drops consensus negotiation blocks and image references. Always run from main checkout.
  3. PDF filenames need price tags. Format: Card Name (price).pdf. Never generate without the price.
  4. Pack assembly needs cross-flavor search. Use assemble-packs.py which searches all flavors and handles aliases.
  5. Curly apostrophes in filenames. SVGs may use ' (U+2019), PACKS.md uses straight '. The pack assembly script normalizes for matching.
  6. Always run QA before declaring done. Check pack page counts, singles vs SVGs, zero warnings.
  7. rebuild-specialist-pdfs.sh is hardcoded for 0c Specialist. For other tiers, use an inline bash loop.
  8. Borderline items exist. Use judgment on lore rewrites. Document kept-as-is items in commit messages.
  9. PACKS.md names can differ from SVG filenames. Add aliases to assemble-packs.py when mismatches are found.
  10. Clean stale PDFs before QA. Old exports with outdated prices cause false count mismatches.
  11. Lore source tags reflect raw-material provenance, not current authorship. The text content is what matters.
  12. Never restate RAW on cards. Potions don't need "Action to drink" or "Single use." Only state what's new about the item.
  13. Throwable vs thrown weapon distinction. Area effects get throwable (range') with one range number. "On hit" items get thrown weapon (normal'/far').
  14. Bold every numeric bonus and penalty. Also watch for split-bold dice: modifier must be inside the bold.
  15. Use rewrite-mechanics.py for targeted fixes. Accepts -m (mechanics) and -s (subhead) flags. Preserves lore, images, layout.
  16. Lore Cardinal Rule: hook opener, mic-drop closer. First sentence hooks, last sentence is quotable at the table.
  17. Two editorial passes are essential. First from ITEMS.md text, second from All Player Packs PDF. Different media surface different problems.
  18. 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).
  19. 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.
  20. Dimension expressions use × (U+00D7). Not lowercase x. Bold the full expression.
  21. Charges, not recharges, on consumables. "Three charges." not "Three charges; recharges at dawn." unless the item is explicitly durable.
  22. rewrite-mechanics.py MUST use argparse flags (-m/-s). See SKILL.md pitfall #22.
  23. Reprints count = pack appearances, not pack + single. When building replacement PDFs, count PACKS.md occurrences only.
  24. 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.
  25. 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.