Instruction file imported from e7hdk/icarus-atlas (
.cursor/rules/figure-taxonomy.mdc). Copyright stays with the author.
Figure taxonomy — type vs kinds
Two layers (locked)
-
type— exactly one of eight cosmic roles:primordial | titan | olympian | god | hero | mortal | nymph | creature.- Drives star glow (
TYPE_GLOW), pulse, size, and mortal-clock layout. - Never add Dryad, Naiad, Nereid, Centaur, etc. as
CharacterType.
- Drives star glow (
-
kinds— optional array (max 3) of controlledFigureKindvalues fromFIGURE_KINDSinsrc/types/character.ts.- Display and search only — does not change glow or layout.
- Required on all new
nymphandcreatureentries. - Legacy figures backfill in verified batches (docs/NYMPHS.md §5 Batch 0).
Where things go
| Information | Field | Example |
|---|---|---|
| Cosmic role / star colour | type |
nymph |
| Mythological sub-class | kinds |
['dryad'] |
| Thematic prose | domains |
"prophetess of Pan" |
| Homonym disambiguation | id suffix |
erato-dryad |
Do not put mythological class in domains when a FigureKind exists.
Nymph kinds
oceanid, nereid, naiad, dryad, hamadryad, oread, pleiad, melia, nephele, hesperid
Creature kinds
centaur, cyclops, hecatoncheir, gorgon, harpy, siren, giant, dragon, sphinx, chimera, hound
Dual identity
Primary type = functional cosmic role; kinds = genealogical class when they differ.
- Styx:
type: 'god',kinds: ['oceanid'] - Chiron:
type: 'creature',kinds: ['centaur'] - Thetis:
type: 'nymph',kinds: ['nereid']
Dossiers
- Nymphs:
docs/NYMPHS.md - Centaurs:
docs/CENTAURS.md - Schema:
docs/PLAN.md§4–§5.1,src/types/character.ts,src/lib/schemas.ts
Run pnpm validate-data after any character edit.