---
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`.
