This is free and unencumbered software released into the public domain.
Anyone is free to copy, modify, publish, use, compile, sell, or distribute this software, either in source code form or as a compiled binary, for any purpose, commercial or non-commercial, and by any means.
In jurisdictions that recognize copyright laws, the author or authors of this software dedicate any and all copyright interest in the software to the public domain. We make this dedication for the benefit of the public at large and to the detriment of our heirs and
successors. We intend this dedication to be an overt act of relinquishment in perpetuity of all present and future rights to this software under copyright law.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
For more information, please refer to <http://unlicense.org/>
description:Multi-agent magical-item rarity/price discovery and negotiation workflow for D&D/homebrew catalogs. Use when calibrating item prices, balancing progression, resolving agent disagreement with voting rounds (4/7 consensus), running unresolved-only reconciliation with coalition-first elasticity, preserving dissent rationales, and writing finalized results back into item card files (including filename normalization, lore alternatives, dispatch watchdogs, and post-writeback integrity verification/repair).
---
# Magic Item Price Discovery
## Overview
Run a 7-agent negotiation panel to discover balanced rarity/price outcomes, converge contested items across capped rounds, and write final consensus (plus dissent context) directly into item files.
This skill is designed for repeatable item-balance passes where you want both rigor and practical output files.
## When to use
Use this skill when the request includes one or more of:
- “price these magical items”
- “balance rarity/price for progression”
- “run multi-agent negotiation / voting”
- “resolve contested items over rounds”
- “append negotiation rationale / dissent into item cards”
- “rename item files to match final rarity/price”
## Panel architecture (fixed roles)
Use all seven agents each round.
- **Alpha**: lower rarity/more Common when plausible.
treat the following as **default post-processing for this set**, regardless of category (Recovery/Defense/Offense/etc.):
1. Append consensus + dissent block to each finalized `.txt` card.
2. Remove obsolete diagnostics (`Price basis`, `Rarity comparison vs source`).
3. Add two lore alternatives per item (same-style pair, ~120 words each).
4. Rename files to:
-`Item Name [Rarity] [Price].txt` for consensus items
-`Item Name [no consensus].txt` for unresolved items after round cap
5. Update any local manifests/index JSON paths after rename.
### Northlands economy conversion (required in this corpus)
Use `stock_gp` as the negotiation/RAW unit, then convert display price to Northlands silver by rarity:
- Common: `stock_gp × 10` silver
- Uncommon: `stock_gp × 100` silver
- Rare: `stock_gp × 1000` silver
- Very Rare: `stock_gp × 10000` silver
- Legendary: `stock_gp × 100000` silver
Do not use a flat `×10` conversion outside Common.
Display rule for this corpus:
- If converted silver ends with `000` (divisible by 1000), display as gold token: `silver/1000` with `g` suffix (e.g., `770000s` → `770g`).
- Otherwise display in silver with `s` suffix.
- For filename readability, add comma separators when the numeric token has **4 or more digits** (inclusive lower bound; e.g., `1100s` → `1,100s`, `12500s` → `12,500s`, `21800g` → `21,800g`).
Apply the display token in both:
-`Price:` line in the card text (`<token> (Northlands gold|Northlands silver)`)
- filename segment `[Price]` in `Item Name [Rarity] [Price].txt`
### Canonical stock_gp comparator rail (required)
When calibrating rarity + stock_gp for this corpus, load and use:
-`references/canonical-stock-gp-comparators.md`
Hard rules:
1. Keep argumentation in **stock_gp** against named canonical comparators.
2. Treat listed outliers as **invalid** comparator anchors.
3. Every ballot item must cite at least **two** valid comparator items and explain why the proposed rarity/stock_gp should be above/below/near those references.
4. If comparator citation is missing or uses invalid outliers, ballot is non-compliant and should be retried.
5. Convert to Northlands token format only after stock_gp + rarity consensus is settled.
- Final consensus (`rarity`, `gp`, converted local currency)
- Consensus round and vote split
- Yes list
- No list
- Dissent summary bullets (no-vote agents)
- Process note that consensus supersedes prior diagnostics
`--- End Consensus Negotiation Update ---`
## Non-blocking execution policy
For long runs:
- spawn and continue in background,
- send heartbeat progress updates,
- do not block the main chat thread waiting on sequential heavy tool chains.
### Dispatch watchdog (anti-stall)
- Do **not** always dispatch Gold last; prefer launching Gold early (first or second) so moderation ballast is available sooner.
- Set a practical watchdog per round: if one expected ballot has not arrived within ~8–10 minutes while others finished, re-dispatch that ballot once in a fresh subagent run.
- If multiple ballots are stalled after the watchdog window, re-dispatch each stalled ballot once (no infinite retry loop).
- Treat late duplicate completions as non-authoritative if a replacement run already superseded them.
- Persist round status artifacts (`expected_agents`, `received_agents`, `pending_agents`) for watchdog decisions and auditability.
## Applied-set tracking (workspace corpus)
When this skill is used against the local Item Card Images corpus, update:
-`references/applied-itemcard-sets.md`
Mark each targeted tier/category as completed only after full write-back + cleanup is done.
## Verification checklist
Before declaring done:
- [ ] All expected subagent returns received for the active round.
- [ ] Vote tallies computed and saved.
- [ ] Every item either resolved or explicitly marked unresolved (after round cap).
- [ ] Comparator-citation rule passed (>=2 valid canonical comparators per item revision; no invalid outliers used).
- [ ] Item files updated with consensus + dissent.
- [ ] Obsolete diagnostics removed.
- [ ] Filenames normalized to `Item Name [Rarity] [Price].txt`.
- [ ] Metadata file paths updated.
- [ ] Final manifest written.
- [ ] (If requested) lore alternatives inserted for all items.
- [ ] Core section integrity (`Item`, `Front (mechanics)`, `Lore`) verified for all touched cards.
- [ ] Any missing core sections repaired with timestamped backups + repair report.
- [ ] Final post-repair sweep returns zero missing-core cards in touched categories.
## Practical notes
- Preserve structured JSON from subagents; treat it as data, not prose.
- Keep joins keyed by exact item name to avoid drift during renames.
- When disagreements are narrow, choose anchors that maximize coalition viability, not ideological purity.
- Foxtrot + Gold are usually the stability core for long-term campaign balance.
- Known failure mode: a bad writeback can leave cards with only lore-alternative/consensus tail blocks; trigger the integrity-repair flow immediately when detected.
- Price token display rule in filenames/text is active (`g` when divisible by 1000 silver, else `s`, with comma separators when numeric token length is >= 4 digits).
## Comparator set (curated representative anchors)
### Common
- Spell Scroll Level 0 — 10 gp
- Potion of Healing — 50 gp
- Spell Scroll Level 1 — 60 gp
- Potion of Climbing — 180 gp
### Uncommon
- Elemental Gem — 960 gp
- Staff of the Python — 2,000 gp
- Slippers of Spider Climbing — 5,000 gp
### Rare
- Sword of Sharpness — 1,700 gp
- Ring of the Ram — 5,000 gp
- Folding Boat — 10,000 gp
### Very Rare
- Spell Scroll Level 7 — 2,560 gp
- Scimitar of Speed — 6,000 gp
- +3 Shield — 24,000 gp
### Legendary
- Sphere of Annihilation — 15,000 gp
- Vorpal Sword — 24,000 gp
- Scarab of Protection — 36,000 gp
- Holy Avenger — 165,000 gp
## Outliers (invalid for anchor/comparator use)
Treat these as invalid comparator anchors for negotiation in this workflow:
- Decanter of Endless Water — Uncommon 135,000 gp
- Prayer Bead Summons — Rare 128,000 gp
- Amulet of the Planes — Very Rare 160,000 gp
- Universal Solvent — Legendary 300 gp
Optional cautionary exclusion (same rationale as low-end legendary outlier behavior):
- Sovereign Glue — Legendary 400 gp
## Agent citation requirement
For each item revision, cite at least **two** valid comparators (non-outlier) and explain why the candidate rarity/stock_gp should be above/below/near those comparators.
Do not submit ballots that only say "higher/lower" without named comparator references.
Reference in New Issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.