67 lines
1.5 KiB
Markdown
67 lines
1.5 KiB
Markdown
# Proposal: <Concise Title>
|
||
|
||
Status: draft
|
||
Authors: <names/handles>
|
||
Owners: <approvers/maintainers>
|
||
Created: <yyyy-mm-dd>
|
||
Scope: spec|infra|policy|process
|
||
Related: <links to issues/PRs/specs>
|
||
|
||
Summary
|
||
- One paragraph that states the problem, the audience, and the outcome.
|
||
|
||
Motivation
|
||
- Why this matters to our community (especially those with chronic/terminal illness). Link data or feedback.
|
||
|
||
Goals / Non‑Goals
|
||
- Goals: …
|
||
- Non‑Goals: …
|
||
|
||
User Stories
|
||
- As a <role>, I want … so that …
|
||
|
||
Requirements
|
||
- Functional: …
|
||
- Accessibility: WCAG 2.2 AA+ requirements …
|
||
- Privacy & Compliance: PHI/PII boundaries, HIPAA/GDPR notes …
|
||
- Performance/SLOs: …
|
||
|
||
Architecture & Design
|
||
- System overview and component boundaries
|
||
- Data model updates (ERD snippet or tables)
|
||
- API design (OpenAPI excerpt or endpoints)
|
||
- Feature flags / configuration
|
||
|
||
Security & Threat Model
|
||
- Trust boundaries, principal actions, abuse cases, mitigations
|
||
|
||
Observability & Telemetry
|
||
- Logs/metrics/traces; PII/PHI handling policy
|
||
|
||
Migration / Rollout Plan
|
||
- Data migration steps, backfills, dry‑run plan
|
||
- Rollout stages, monitoring, rollback
|
||
|
||
Test Plan
|
||
- Unit, integration, E2E, accessibility checks
|
||
|
||
Risks & Mitigations
|
||
- …
|
||
|
||
Alternatives Considered
|
||
- … and why not chosen
|
||
|
||
Work Breakdown
|
||
- Milestones and tasks with owners
|
||
|
||
Acceptance Criteria
|
||
- Checkable criteria that define done
|
||
|
||
Open Questions
|
||
- …
|
||
|
||
Slash Commands
|
||
- `/review areas=accessibility,compliance,security,mobile,web,backend`
|
||
- `/apply spec=openspec/specs/<target-file>.md` once approved
|
||
- `/archive link=<PR>` after merge
|
||
|