docs(design): add the objectives note #289

targeting main from claude/objectives-note
Merged opened by topos-backsword.test.pds.did.bot
targeting main from claude/objectives-note

Adds design/objectives.md, a design note for mission objectives, linked from contracts-and-raids §3, facilities §6 and planning §3.

What it settles:

  • An objective: a kind, a major or minor weight, a target (a thing, place, person or data), ordered steps (reach, interact, carry, deliver, condition), endings with pay and notoriety, and when it banks. It also covers how objectives show on screen and in the log.
  • The ending is derived from the majors: Completed, a new Partial, or Aborted. Pay is per ending through settle, with planning terms applied in the same pass.
  • Backing out: minor costs when you back out during planning, moderate costs when you flee mid-mission (flake standing, debts falling due, a light cowardice-kind card). Fleeing is never worse than capture.
  • Sources are an open list with one data shape: the contract, contract truth, the site kind or owner, planning cards, runner traits, scar or lifepath hooks, and site bonuses.
  • Complications have triggers, effects and tells. They are never retroactive and never leave the list structurally impossible from the live state.
  • The route solver enforces soundness (each objective has an approach for some reasonable kit, under stated assumptions) and shows this runner's fit on the job board and the planning table without enforcing it. It also counts dead ends per archetype.
  • Bots and tests: bot policy, new route report columns, and one golden with a mid-mission complication.

Builds on:

🤖 Generated with Claude Code

Commits 1

docs(design): add the objectives note
Sign up or Sign in to add to the discussion.