Context
Product Goals
- Make long-running AI tasks visible instead of opaque.
- Separate user intent, retrieved context, tool output, and final response.
- Give humans clear review points before important actions.
- Track latency, cost, and error states per workflow step.
- Keep failed tasks inspectable instead of turning them into generic error messages.
Engineering Shape
Decisions
- Use structured step state instead of free-form logs.
- Keep tool contracts strict so failures can be attributed to schema, permission, upstream, or model behavior.
- Store enough trace data for debugging while avoiding sensitive prompt leakage.
- Prefer explicit review actions for irreversible operations.