genre

Use when

The design is a top-down/arcade racer where cornering is a real physics tradeoff and lap time is the score.

Racing

What it is. You drive a line through corners where speed and control genuinely trade off — flooring it understeers you wide, braking tucks you tight. The whole game is finding and holding the fast line lap after lap, usually against rivals.

Player fantasy. “I found the perfect line.” Mastery you can feel in your thumbs: the corner you used to blow now flows, and the clock proves it.

Pillars

  1. The speed/line tradeoff is physical. Turn authority falls with speed (understeer), not grip that magically holds — so flat-out must NOT make every bend. Braking is the skill the genre sells; make it a dedicated control.
  2. The clock never lies. Lap time is the honest, legible score. Every tenth is a decision you made three corners ago. Ghosts and rivals externalise it.
  3. The track is the level. Corner radius, track width, and sequence author the difficulty. Design the geometry against the car’s turn radius, not by vibes.

The loop stack

ScaleThe beat
MomentBrake point → apex → throttle out; one corner, committed.
EncounterA lap: chain corners into a rhythm, defend/overtake a rival.
SessionA race or time-trial; the grand prix; podium or PB.
MetaUnlocked tracks/cars/tuning; championship standings; leaderboard chase.

Essential systems

SystemWhy it’s load-bearing
system-enemy-aiThe rival driveLine() is difficulty dial, completability proof, and skill-delta meter in one.
system-difficulty-and-ddaRubber-banding, assist braking, racing-line guides — the ramp for a wide skill range.
pattern-mastery-and-flowThe corner you now flow through is the flow channel; the genre is a mastery curve.
system-progressionTrack/car unlocks; tuning as a shallow build layer.
pattern-risk-rewardLate braking, cutting the kerb, the overtake into a blind corner.

Content & difficulty model

Signature-mechanic seeds

Common pitfalls

Anchors

Still worth borrowing across both: anchor-tetris for the “one tuned verb, endless mastery” discipline, and anchor-into-the-breach for perfect-information honesty if you telegraph rival intent. Corpus references: WitchCup1276 (2023 gameplay #10), DR1V3N WILD (2024 gameplay #3).

Verify

Prove it against FUN.md §20 — Top-down racing: the driveLine() bot finishes laps; braking beats flooring (skill delta); cutting advances nothing; off-track speed cap holds; golden grand prix. See sandboxes/physics-lab for the vehicle-physics primitives and sandboxes/pathfinding-demo for the racing-line follower.

Composes with

See also

This module rendersthe repo's markdowndirectly — edit it there, it changes here.