--- description: Item (and station) descriptions must stay in-universe; never expose mechanics or implementation status. alwaysApply: true --- # In-universe item descriptions Player-facing `description` text on items (and craft-station blurbs shown in UI) **must** describe the thing in-world — what it is, looks like, or is for — never how the game implements it. ## Forbidden - Stack sizes, slots, skill levels, equip rules, UI labels - Implementation status (“TBD”, “for now”, “mostly cosmetic”, “placeholder”, “tintable”, “scaffold”) - Code/art notes (“shared sprite”, “overrides material colour”) - Out-of-character systems talk (“your bag”, “inventory space”) ## Allowed - In-world craft hints at the softest end, e.g. “Smelt these ores in a furnace.” - Flavor and material/origin that a character could know ```text # ❌ BAD "Mostly cosmetic for now; optional dye overrides the material colour." "Same colour and uses stack up to 16." "Drink to apply its effect (effects TBD)." "Bronze may be equipped at any Woodcutting level." # ✅ GOOD "A warm cotton sweater, soft enough for travel." "Bottled colour for cloth and clothing." "A bottled brew. Sip with care." "A bronze axe for felling trees." ``` When adding or editing item defs, write lore/flavor first; put rules in code and tooltips that are explicitly mechanical if needed later — not in `description`.