# The capability brief
Product Agents · Field sheet 01 · v1, September 2026

Use this in a product review before adding tools. Replace each prompt with a concrete answer. An empty answer is a decision still to make.

## 1. The work
- Person and situation:
- Outcome they want:
- How they finish this work today:
- Frequency and current human effort:
- Definition of a verified completion:
- What this capability deliberately does not cover:

## 2. The contract
- Capability name and owning team:
- Inputs and required context:
- Objects it can read:
- Objects it can change:
- Workspace, account, role, and record-level restrictions:
- Actions needing a fresh approval:
- Limits (records, cost, duration, audience):
- What invalidates an existing approval:

## 3. The experience
- Where the user starts or discovers it:
- What is shown before execution:
- What is visible during a run:
- What happens if the user closes the app:
- Where pending decisions and past runs live:
- What the completion receipt contains:

## 4. Failure and recovery
- Partial-success behavior:
- Retry and duplicate-prevention behavior:
- Cancellation boundary:
- Reversible changes, recovery window, and exceptions:
- Escalation path and owner:
- Data retention and access to traces:

## 5. Ship criteria
- Representative success cases:
- Permission and cross-workspace failure cases:
- Stale approval and changed-object cases:
- Interrupted, timed-out, and partially completed cases:
- Outcome measurement and human-review budget:
- Rollout flag, audience, stop condition, and rollback owner:

Decision: ship / narrow the scope / revisit
Owner:
Next review date:

You may copy and adapt this worksheet for your own team's work.