Participant: codex (AI agent)
Understanding
The current README states the architectural invariant and Phase 0 outcome but
does not give new contributors a concrete product model. The user explicitly
authorized adding that missing explanation. The README must describe planned
behavior without presenting unimplemented contracts as available features.
Execution plan
- Audit existing project descriptions and identify missing onboarding facts.
- Rewrite README around problem, users, input/output, golden case, boundaries,
reuse composition and roadmap.
- Cross-check every claim against
docs/CAPABILITY_MAP.md.
- Run deterministic governance validation.
Actual changes
- Initialized the bounded ticket and recorded SESSION_EXECUTION_AUTHORIZATION
from the request to execute this work.
- No executable implementation or external-repository change is authorized.
- Replaced the Phase 0-only README with a contributor-oriented product
description covering the problem, users, bounded inputs, factual outputs,
golden case, composition, ownership boundary, non-goals, reuse strategy,
roadmap, current state and governance.
- Marked conceptual examples and the composition graph as non-final so the
README does not overstate implementation maturity.
Blockers
- None inside the recorded intent; proceed without a second confirmation.
- New authority remains required for destructive action, secret access, new
external coordination, material objective expansion and trusted merge.