feat: add product capability planning lane

This commit is contained in:
Affaan Mustafa
2026-04-05 16:58:02 -07:00
parent 9d7531706d
commit 05d836387e
10 changed files with 379 additions and 11 deletions

View File

@@ -0,0 +1,84 @@
# Product Capability Template
Use this when product intent exists but the implementation constraints are still implicit.
The purpose is to create a durable capability contract, not another vague planning doc.
## Capability
- **Capability name:**
- **Source:** PRD / issue / discussion / roadmap / founder note
- **Primary actor:**
- **Outcome after ship:**
- **Success signal:**
## Product Intent
Describe the user-visible promise in one short paragraph.
## Constraints
List the rules that must be true before implementation starts:
- business rules
- scope boundaries
- invariants
- rollout constraints
- migration constraints
- backwards compatibility constraints
- billing / auth / compliance constraints
## Actors and Surfaces
- actor(s)
- UI surfaces
- API surfaces
- automation / operator surfaces
- reporting / dashboard surfaces
## States and Transitions
Describe the lifecycle in terms of explicit states and allowed transitions.
Example:
- `draft -> active -> paused -> completed`
- `pending -> approved -> provisioned -> revoked`
## Interface Contract
- inputs
- outputs
- required side effects
- failure states
- retries / recovery
- idempotency expectations
## Data Implications
- source of truth
- new entities or fields
- ownership boundaries
- retention / deletion expectations
## Security and Policy
- trust boundaries
- permission requirements
- abuse paths
- policy / governance requirements
## Non-Goals
List what this capability explicitly does not own.
## Open Questions
Capture the unresolved decisions blocking implementation.
## Handoff
- **Ready for implementation?**
- **Needs architecture review?**
- **Needs product clarification?**
- **Next ECC lane:** `project-flow-ops` / `tdd-workflow` / `verification-loop` / other