mergemat Write Agent Brief
Write the contract an implementation agent can work from later.
Prefer behavior and interfaces over file paths. File paths go stale; contracts survive.
Process
- Read the current context and any task packet.
- Separate current behavior from desired behavior.
- Name key interfaces, data shapes, commands, and user-visible behavior.
- State acceptance criteria as independent checks.
- State out of scope explicitly.
- Add human review or approval needs.
Use brief-format.md for a formal brief.
Rules
- Do not include line numbers.
- Avoid file paths unless the path itself is the contract.
- Do not prescribe implementation steps unless the user asked for a plan.
- Include verification commands when known.
- If requirements are ambiguous, list questions instead of inventing.
Output
Return a brief ready to paste into an issue, PRD, or task tracker.
If publishing to an issue tracker, follow the repo's configured issue tracker docs. If no tracker is configured, only produce markdown.