# Documentation brief

## Document job

- **Document family:** {{DOC_FAMILY}}
- **Primary outcome:** {{PRIMARY_OUTCOME}}
- **Target audience:** {{AUDIENCE}}
- **Assumed knowledge:** {{PREREQUISITES}}

## Scope

**In scope:** {{IN_SCOPE}}

**Out of scope:** {{OUT_OF_SCOPE}}

## Supported environment

- **Product / service:** {{PRODUCT}}
- **Version range:** {{VERSION_RANGE}}
- **Platform assumptions:** {{PLATFORMS}}
- **Required access:** {{ACCESS_LEVEL}}

## Success criteria

- Reader can complete: {{TASK_SUCCESS}}
- Reader can verify: {{VERIFICATION}}
- Reviewer can confirm accuracy from: {{SOURCE_OF_TRUTH}}

## Subject movement

- **Reader starts with:** {{READER_START}}
- **Reader should move toward:** {{READER_SHIFT}}
- **Main pressure:** {{MAIN_PRESSURE}} (ambiguity, missing prerequisite, operational risk, version drift, unsafe action, unclear owner)
- **Key interaction:** {{KEY_INTERACTION}} (step vs. failure mode, prerequisite vs. action, source of truth vs. local convention, normal path vs. recovery path)

## Risks to avoid

- Missing prerequisite context: {{PREREQ_RISK}}
- Unsafe or destructive guidance: {{SAFETY_RISK}}
- Version drift: {{VERSION_RISK}}
- Ambiguous terminology: {{TERM_RISK}}

## Open questions

{{OPEN_QUESTIONS}}