Files
affaan-m--ecc/docs/examples/product-capability-template.md
wehub-resource-sync e76d0ad892
CI / Test (macos-latest, Node 18.x, bun) (push) Has been cancelled
CI / Test (macos-latest, Node 18.x, npm) (push) Has been cancelled
CI / Test (macos-latest, Node 18.x, pnpm) (push) Has been cancelled
CI / Test (macos-latest, Node 18.x, yarn) (push) Has been cancelled
CI / Test (ubuntu-latest, Node 18.x, bun) (push) Has been cancelled
CI / Test (ubuntu-latest, Node 18.x, npm) (push) Has been cancelled
CI / Test (ubuntu-latest, Node 18.x, pnpm) (push) Has been cancelled
CI / Test (ubuntu-latest, Node 18.x, yarn) (push) Has been cancelled
CI / Test (windows-latest, Node 18.x, npm) (push) Has been cancelled
CI / Test (windows-latest, Node 18.x, pnpm) (push) Has been cancelled
CI / Test (windows-latest, Node 18.x, yarn) (push) Has been cancelled
CI / Test (macos-latest, Node 20.x, bun) (push) Has been cancelled
CI / Test (macos-latest, Node 20.x, npm) (push) Has been cancelled
CI / Test (macos-latest, Node 20.x, pnpm) (push) Has been cancelled
CI / Test (macos-latest, Node 20.x, yarn) (push) Has been cancelled
CI / Test (ubuntu-latest, Node 20.x, bun) (push) Has been cancelled
CI / Test (ubuntu-latest, Node 20.x, npm) (push) Has been cancelled
CI / Test (ubuntu-latest, Node 20.x, pnpm) (push) Has been cancelled
CI / Test (ubuntu-latest, Node 20.x, yarn) (push) Has been cancelled
CI / Test (windows-latest, Node 20.x, npm) (push) Has been cancelled
CI / Test (windows-latest, Node 20.x, pnpm) (push) Has been cancelled
CI / Test (windows-latest, Node 20.x, yarn) (push) Has been cancelled
CI / Test (macos-latest, Node 22.x, bun) (push) Has been cancelled
CI / Test (macos-latest, Node 22.x, npm) (push) Has been cancelled
CI / Test (macos-latest, Node 22.x, pnpm) (push) Has been cancelled
CI / Test (macos-latest, Node 22.x, yarn) (push) Has been cancelled
CI / Test (ubuntu-latest, Node 22.x, bun) (push) Has been cancelled
CI / Test (ubuntu-latest, Node 22.x, npm) (push) Has been cancelled
CI / Test (ubuntu-latest, Node 22.x, pnpm) (push) Has been cancelled
CI / Test (ubuntu-latest, Node 22.x, yarn) (push) Has been cancelled
CI / Test (windows-latest, Node 22.x, npm) (push) Has been cancelled
CI / Test (windows-latest, Node 22.x, pnpm) (push) Has been cancelled
CI / Test (windows-latest, Node 22.x, yarn) (push) Has been cancelled
CI / Validate Components (push) Has been cancelled
CI / Python Tests (push) Has been cancelled
CI / Security Scan (push) Has been cancelled
CI / Coverage (push) Has been cancelled
CI / Lint (push) Has been cancelled
chore: import upstream snapshot with attribution
2026-07-13 12:15:35 +08:00

1.7 KiB

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