README.md

Florence #

Florence is a settlement game. You found a town in a generated river valley. The map is procedural. A simulation makes the world. The art is watercolour and gouache.

Fly the map #

Run this command:

./ue/explore.sh

The controls are:

  • W, A, S, D, or arrow keys — pan
  • mouse wheel — zoom
  • Q, E, or right-drag — rotate
  • middle-drag — pan
  • ~ — console
  • F — harvest mode
  • left-click — inspect the cell
  • T — top-down view
  • C — cycle the lenses
  • H — show the readout

ue/explore.sh lists every control.

The law documents #

  • AGENTS.md and CLAUDE.md — agent instructions (mirrored).
  • LESSONS.md — rules learned from mistakes. Read it before you debug anything visual.
  • docs/ART_BIBLE.md — the detailed visual rulebook (the authority).
  • docs/ART_DIRECTION.md — the art-direction north star and index.

The roles #

The roles live in docs/roles/. Each role has one file:

  • docs/roles/GRID.md — simulation developer seat ([sim]).
  • docs/roles/STACK.md — Unreal Engine developer seat ([ue], leader).
  • docs/roles/MASON.md — Unreal Engine developer seat ([ue], follower to Stack).
  • docs/roles/POLY.md — modelling seat: trellis, Blender, decimation, screening ([ue], leader).
  • docs/roles/SEAM.md — modelling follower seat: builds assets per docs/TREE-PIPELINE.md ([ue], follower to Poly).
  • docs/roles/LOD.md — art director seat.
  • docs/roles/PIPER.md — QA tester seat.
  • docs/roles/REED.md — documentation writer seat.
  • docs/roles/STERLING.md — project manager seat.
  • docs/roles/LEGACY.md — general consultant and Fable-era context seat.

docs/roles/README.md is the organization index: the chart of seats, responsibilities, decision rights, consultation links, and escalation routes. Complete historical engagement logs live in docs/archive/roles/. Current actions are tracked in Beads (bd ready). Live provider, model, and mode configuration lives in the Paseo profiles, not in any document here.

The art banks #

The art banks live in art/.

The issue tracker #

Run this command:

bd prime

Use bd to track work.