# Feature Doc Format

`feature-doc.md` is an intermediate product-quality feature description used as input to implementation planning.

Use this structure:

```markdown
# <Feature Name>

## Outcome

## Users / Jobs / Pain

## Proposed Behavior

## Non-Goals

## Examples and Acceptance Criteria

## Edge Cases and Failure Modes

## Affected Areas and Integration Points

## Testing Expectations

## Documentation / Migration / Rollout Notes

## Open Questions and Assumptions
```

The document should be detailed enough that another agent can plan implementation without reading the original conversation, while still preserving important uncertainty.