This repository contains enhancement proposals for submariner-io projects.
A Submariner Enhancement Proposal (SEP) is a design document that describes a significant change to any Submariner project. SEPs provide a consistent format for proposing features, documenting design decisions, and tracking implementation.
Each SEP is numbered sequentially (SEP-NNNN) and lives in the seps/ directory.
- Use template.md as your starting point
- Assign the next available SEP number
- Name your file
seps/SEP-NNNN-short-description.md - Set
status: draftin the frontmatter - Submit a PR for community review
draft → proposed → accepted → implementing → done
↘ deferred
- draft — work in progress, not ready for review
- proposed — PR open, ready for community review
- accepted — merged, implementation can begin
- implementing — work in progress
- done — fully implemented and verified
- deferred — postponed for future consideration
All SEPs include: Summary, Motivation, Design, Alternatives Considered.
Two optional sections support structured implementation:
- Implementation Plan — step-by-step guidance with file paths and code. Useful for both human contributors following the plan and AI agents executing it.
- Done When — verification criteria with executable commands where possible. Lets anyone confirm the proposal has been fully implemented.
These sections are optional. Pure design/architecture proposals may not need them.