informed-decision/README.md
tegwick 871f5e05e8 Define headless decision lifecycle product and delivery plan
Assistant: codex
Assistant-Model: gpt-6-astra
Assistant-Session: 01a10780-6d41-7952-9718-dfbc1f41236f
2026-10-04 17:33:43 +02:00

44 lines
2 KiB
Markdown

# informed-decision
Decision lifecycle service for agents and humans: research, retrieve, prepare,
evaluate, register, publish, comment, refine and human acceptance. The target
architecture separates a headless foundation from the UI at
`decisions.coulomb.social`; new decisions are runtime data, requiring no
per-decision infrastructure rollout.
See the [product and architecture contract](docs/specs/DecisionLifecycleService.md)
and [delivery workplan](workplans/INFD-WP-0007-decision-lifecycle-service.md).
These define the requested expansion; [SCOPE.md](SCOPE.md) records what exists.
A **Decision Memo** carries a question, the context needed to answer it, the
requested act, and a binding between *identity*, *what was shown*, and *what was
bound*. The promise is not "the file was signed" but **"this person, in this
role, was shown this view, and bound this act."**
One object model from a ten-second login (L0) to a multi-party instrument (L5).
## Where to start
| File | What it is |
| --- | --- |
| `INTENT.md` | Why this repository exists and what it must never become |
| `GOAL.md` | The current stage, its invariants, and its definition of done |
| `workplans/` | Current work |
| `history/20260909-initial-exploration/` | Founding exploration — schema, state transitions, canonicalization, vectors |
## Stage 1
Own the browser-facing **approver UI** that `approval-engine` deliberately does
not contain, and answer in writing who owns it. `approval-engine` is a
bearer-token resource server with no browser client; `key-cape`
(`KEY-WP-0013-T02`) is waiting on a `client_id` and callback URI that no
component has claimed. This repository claims them.
See `GOAL.md`.
## Boundaries
This repository renders questions and records answers. It does **not** decide
(`access-engine`), does not own the approval object (`approval-engine`), does
not author approval doctrine (`gate-house`), does not authenticate anyone
(`key-cape`), and does not archive the trail (`audit-core`).