Skip to content

00 — Source of truth and ID conventions

Tell every engineer which document wins, and how requirement IDs work, before they touch C++.

  • FS §0 — Document contract
  • GDD reader (pack master): E:\Cursor_Terra\programming bible\tfa_gdd_html
  • FS HTML (pack master): E:\Cursor_Terra\programming bible\tfa_fs_html
  • Architecture Map: E:\Cursor_Terra\programming bible\Terra_Firma_Architecture_Map.md
  • Front-End Spec: E:\Cursor_Terra\programming bible\Terra_Firma_FrontEnd_UI_UX_Spec.md
  • Worldbuilding: E:\Cursor_Terra\programming bible\Terra_Firma_Earth_Worldbuilding.md
  • Storyline / Game Progression: E:\Cursor_Terra\programming bible\Terra_Firma_Storyline_and_Game_Progression.md
  • Live host: E:\Dev\Local copies\5.8_terra_demo (see ch. 02b)
Layer Owns File
Product / FE flow Boot, Solo vs Online pools, Command Deck, maps chrome Front-End Spec
Design Fantasy, catalogs, formulas, figures HTML GDD
Contract Runtime behavior, UE5 mapping, acceptance Functional Spec
Balance sheets Numeric bands; cadence locked in FS Separate data + FS-GUN-007
Worldbuilding Shared Earth fiction for novel writers and game designers (book + Game Story) pack Terra_Firma_Earth_Worldbuilding.md · GDD earth-worldbuilding
Story Book canon (parent) → GDD Game Story adaptation (child) pack Terra_Firma_Storyline_and_Game_Progression.md · GDD storyline-game-progression
This bible How to implement + Done/Have/Need this repo
Plugin deps / ownership Live host plugins, Build.cs arrows, class hierarchy, conflicts MASTER: 02b-plugin-dependencies.md (HTML bible chapter)
Plugify (modular plugs) Complete catalog: all TFA* GFPs + MonetaryPlatform (money product) MASTER: 02-gfp-cookbook.md § Complete Plugify catalog · FS-ARCH-010
How to program Full game · Ladder Demo · Cinematic Benchmark (Lyra 5.8, no LyraGame fork) 25-howto-program-full-game.md · 26-howto-program-demo.md · 29-howto-program-cinematic-benchmark.md
Tutorials (MM) Pose Search on Demo + Full (Lyra upper/lower) tutorials/motion-matching-demo-and-full.md
Wall Run MM Wall L/R cycle mid-stint; Pose Search enter/exit edges only (CMC authority) superpowers/specs/2026-11-07-wall-run-motion-matching-design.md
Tutorials (Sequencer feet) MetaHuman Foot Placement + Animation Mixer in Level Sequence (no MM in cine) tutorials/sequencer-foot-placement-cinematic.md
Tutorials (Melee Drive / Singularity) Melee Drive + guns → one Flow → Singularity (GAS / Plugify; deferred until Melee foundation) tutorials/melee-drive-guns-singularity.md · design 2026-10-26-singularity-one-flow-two-verbs-design.md
Mutable / appearance mesh Full-game Create Character + MetaHuman + armor a_* + gun Spine (not Demo) 27-mutable-character-weapons.md · FS-APP-*
Mesh attach naming a_ / w_ sockets + corp (c1–c5) + kit/hand authorship inventory/mesh-naming.md · FS-MESH-001
Keymapping states Press / Hold / Release per key (+ context) MASTER: 08-camera-input-movement.md § Keymapping bible · FS-INP-004
Monetary platform Portable Credits / BTUCOIN / LUMENAR plugin Separate .uplugin; TFA adapts via TFAEconomy — see ch. 14
Website Public WP IA / plugins / Pre-CF vs CF Website Spec tfa_website_html · bible 23-website.md · Kanban Website board
Companion Player API Companion read API for companion Discord bot / BenchMark / third-party FS-API-* · GDD companion-player-api · bible 31-companion-player-api.md · map superpowers/specs/2026-11-12-companion-player-api-map.md
Cinematic Benchmark Standalone entitled UE showcase (MM + score submit); Full integrate later 28-cinematic-benchmark.md · Kanban Cinematic Benchmark — ≠ Ladder · ≠ WP page · ≠ Lyra host now
Marketing CF / SSO / store / mystery plan Pack tfa_marketing_html/ · bible 24-marketing.md

Conflict rule: later volume lock wins (Vol. 15 HUD names; Vol. 16 + Character I attributes; FE on save pools).

  • FS-<SYS>-<nnn> — functional shall
  • AC-<SYS>-<nnn> — acceptance check
  • TBD-<nnn> — open lock; expose as data; do not invent in C++
  • Full Year 1 FS + Architecture Map + HTML GDD written and readable
  • This Programming Bible repo scaffolded
  • Spec Markdown + tfa_fs_html / tfa_gdd_html readers on disk
  • Keep bible inventory synced when demo5.8 or FS changes
  • Follow 20-critical-path.md when sequencing plugin work
  • Optional later: GDD left-rail link to this reader

Never treat Word .docx as design authority. HTML GDD is master lore.