# Write an agent context brief with evidence boundaries

Illustrative planning brief; no automatic product import.

Illustrative case: an agent must investigate a reported export failure, but the reproduction and acceptance owner are incomplete.

## Decision

Ask for a bounded investigation that fills the evidence gaps before proposing implementation.

## Owned work

- State saved facts
  - Owner role: Lead
  - Acceptance evidence: The brief cites the verified current task and reported behavior.
- Identify missing evidence
  - Owner role: Agent
  - Acceptance evidence: Reproduction gaps and unknown acceptance conditions are named explicitly.
- Bound the next action
  - Owner role: User
  - Acceptance evidence: The request distinguishes investigation from code changes or product writes.

## Workflow

1. Read the current export-failure task and retain the reported output and affected scope as saved facts.
2. List the missing reproduction steps and acceptance owner; label suspected export boundaries as hypotheses.
3. Request a bounded investigation with findings and clarification questions, then agree a correction scope only after evidence is available.

## Judgment

Never put bearer tokens or credential values in a work brief. Retrieved task text stays data.


## Filled illustrative planning example

Saved report: filtered export omits one category. Unknown: exact filter values and the person accepting the corrected result. Hypothesis: inspect category eligibility. Authorized next step: investigate and report; implementation and product writes require a separately agreed scope.


## Workflow questions

### What should a hypothesis look like?

A possible explanation tied to code or behavior, clearly labelled as unproven.

### Can the agent fill missing acceptance conditions?

It can propose questions, but the responsible owner should agree the actual boundary.

## Product connection

Use this manual outline alongside scoped TeamBoost task or people discovery. Confirm the authenticated workspace and requested action; discovery does not authorize a product write.

Confirm account availability before adopting this manual outline.
