Signposts

Signposts (wiki index)

Use this page as the signpost. Every agent reads it before any task.

Pillars — three pillars (TBD authoring)
Decisions — D-level canonical decisions log
Nightly narrative queue — task queue spec for narrative-ops Sonnet sidekick; activation gated behind Phase D
data/src/content/_glossary.ts — naming discipline source-of-truth per D-017 (three-name rule: ENG handle / PL canon / EN transcreation). Every named entity has an entry; lint pnpm lint:naming cross-checks.

/lore/canon/ — anchor canon files (defining image, walking rule, leak physics, timeline, what-still-works, forbidden tropes, cant & greetings). Mandatory read for narrative-designer before any new lore work. Authored in Round 2.5 (current sprint).
/lore/world/ — world setting, eras, cosmology (TBD)
/lore/regions/ — region descriptions (TBD)
/lore/factions/ — faction backstories (TBD)
/lore/characters/ — major NPCs (TBD)

Architecture index — ADR + API contract entry point (phase 8a spec; D-007/D-008/D-009 anchored)
ADRs (phase 8a + phase 8b re-scope):
- ADR-0001 — GCP-native architecture topology (production target; Band Zero amendment for test phase)
- ADR-0002 — Step ingest pipeline (production target; deferred in phase 8b)
- ADR-0003 — Streak attestation algorithm (production target; trust-mode in phase 8b)
- ADR-0004 — Anti-cheat layer (production target; light validation only in phase 8b)
- ADR-0005 — GDPR data flows + retention (production target; deferred in phase 8b)
- ADR-0006 — Test-phase infrastructure (current scope for phase 8b — local + Cloudflare Tunnel + mock auth)
API contracts (phase 8a — closed-beta vertical slice, first 4 endpoints):
Prisma schema (v0): backend/prisma/schema.prisma

Design system — color tokens (6 regions + neutral + state + faction), typography (Literata + Inter), spacing scale, iconography stance, a11y baseline, bilingual layout rules, dark/light mode rationale.
Wireframes (phase 9):
- Onboarding flow — splash, mock auth, walker creation, tutorial overlay, first walk prompt
- Home screen — region card, streak ribbon, quest pill, faction strip, bottom nav
- Tree viewer — Plenny starter cluster — cluster.first-steps, 20 nodes, mastery popover, keystone lock, allocation flow, a11y focus order
- Post-walk sync — step delta, energy delta, streak update, quest progress
Components:
- TreeViewer component spec — prop contract, visual states, phase 11 blockers

Audits index — canon-audit digests (cross-cutting reviews triggered by D-level ratifications). Raw reports live in ops/audits/ (local, not committed).