# Capability Spec Template

## Capability

Name:

Owner area:

## User Goal

What user-visible outcome does this capability provide?

## Actors

- primary user
- system components
- external services

## Triggers

What starts the capability?

## Success Outputs

What does success look like to the user?

## Failure Outputs

What does failure look like to the user?

## Key State Transitions

- state A -> state B
- state B -> state C

## External Dependencies

- CLI
- SDK
- provider API
- IM platform

## Observability

What logs, events, probes, or persisted state help verify behavior?

## Test Mapping

- unit:
- contract:
- scenario:
- smoke/manual:
