Gather the smallest reproducible context packet for one task.
This is not a repo dump. Include only evidence that helps plan, edit, or verify the task.
Process
- Identify the task, expected behavior, and acceptance criteria.
- Read project agent docs and relevant domain docs.
- Map allowed changes, read-only context, and forbidden paths.
- Find change candidates, call sites, interfaces, tests, fixtures, and configs.
- Record verification commands and known gaps.
- Capture provenance: branch, base, date, and commands used.
Use packet-format.md when writing a formal packet.
Include
- task summary
- relevant files and symbols with why each matters
- scope and forbidden changes
- product/domain rules
- architecture, API, DB, or event contracts when relevant
- focused tests and broader checks
- assumptions and open questions
Exclude
- generated files unless directly relevant
- vendor and caches
- broad docs with no task-specific takeaway
- secrets, tokens, private credentials
- stale docs unless conflict matters
Output
Return ready, ready_with_assumptions, or not_ready.
If not ready, name the blocking missing fact. If ready, keep the packet compact enough that another agent can use it immediately.