Questionnaire docs
Artifact model
Understand the durable files created during a run.
The run directory is the core promise of Questionnaire: each conversation leaves a small, reviewable set of files.
Run directory
Every run lives under .questionnaire/<timestamp>/. The browser can read and export drafts, but the agent is responsible for writing durable files into that directory.
.questionnaire/2026-05-18:12-00-00/
index.html
state.json
transcript.md
CONTEXT.md
research/
adrs/state.json
The source of truth for run status, active question, answers, decisions, research references, ADR references, exports, and UI state.
transcript.md
The human-readable trail. It should capture the question, the recommended answer, the user's answer, and the decision that resulted.
CONTEXT.md
A glossary only. Use it for terms the agent and user will reuse, not scratch notes, hidden reasoning, or implementation decisions.
research/
Research notes hold source-backed checks when an answer depends on an external fact, standard, API, competitor, compliance issue, or changing dependency.
adrs/
ADR files record hard-to-reverse decisions with context, options considered, consequences, and revisit triggers.