ouroboros_interview
Clarify requirements interactively by starting, resuming, or answering interview questions; each response refines the project context for downstream execution.
Instructions
Interactive interview for requirement clarification. Start a new interview with initial_context, resume with session_id, or record an answer to the current question. In plugin mode, returns a delegation receipt (status=delegated_to_subagent) and the interview executes in an OpenCode Task pane — the real session_id is returned there.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cwd | No | Working directory for brownfield auto-detection. Defaults to the current working directory if not provided. | |
| answer | No | Response to the current interview question | |
| references | No | Bounded user-provided reference cues. Each object requires reference_id, label, and origin; url/excerpt are optional. | |
| session_id | No | Session ID to resume an existing interview | |
| interview_id | No | Optional caller-supplied id for a brand-new interview. Must match the server format 'interview_<16 lowercase hex>' and must NOT collide with an existing interview file. Only valid for the start action — supplying it together with session_id (resume) or answer is rejected with an error to prevent silent identifier hijacking; do not preserve this argument across turns. Used by the bounded auto driver to pre-allocate the id so a driver-level cancel cannot leave auto state out of sync with the persisted interview file (see Q00/ouroboros#687). | |
| last_question | No | The question text from the previous child session's response. In plugin mode each dispatch creates a new child session whose questions are not automatically persisted server-side. Pass the child's last question here when submitting an answer so the interview transcript preserves the real question text instead of a placeholder. | |
| confused_terms | No | Explicit domain terms the user says they do not understand. Queued on the start turn and applied only after the first answer. | |
| initial_context | No | Initial context to start a new interview session |