Proposal:
Enhancement proposals (KEP/RFC-style) are how architectural and product change flows — before first implementation they stage features against the implementation arc (the
milestone:field); after it, they are the change process for the running system. Move this file fromdraft/toaccepted/and advancestatus:(draft | accepted | implemented | withdrawn) as it moves. Early in the project this is deliberately lightweight; the discipline matters more than the ceremony. If a decision is foundational rather than an enhancement, it may instead warrant an ADR.
Motivation
What problem does this solve? Why now? What is the user- or operator-visible need?
Design
The proposed change. Be concrete about interfaces and the affected components.
Alternatives considered
What else was weighed, and why this over those?
Graduation criteria
How do we know it is done and correct? What tests and what definition of done? What telemetry confirms it in production?
Backward compatibility
Effect on existing data, existing deployments (version skew during rollout), and the public API.
Open questions
Mark unresolved points explicitly.