Human input

The Question Workflow.

A Question is a focused information gap, not a form field to be closed mechanically. One verbatim response can lead to four different, traceable outcomes.

scroll ↓
01

A Question begins with a grounded gap

The corpus is silent, incomplete, or contradictory about something that blocks a Requirement, Section, Deliverable, or the project overall. The integrator asks one scoped Question and tags the people most likely to know.

Source extracts record what prompted the ask. The integrator does not manufacture a negative answer from absence.

02

Save and submit are not the same event

A user can work on an answer without committing it. On submit, the response joins the UserInput queue. The UI remains responsive while the integrator works later.

During the round, the raw response is appended to responses[] verbatim. Curated quotes may also enter source_responses, but they never replace the user's own words.

03 · Pattern A

The original scope is addressed

If the response satisfies the whole ask, the Question becomes Answered. Findings credit the user and explain useful cross-references. The integrator does not repackage the same answer as its own proposed_answer.

Straight answers should end cleanly. No ceremonial follow-up is invented.

04 · Pattern B

A correct question can be partially fulfilled

If the Question asks for several people, jurisdictions, controls, or artefacts and only some arrive, it stays Open with Partial Information.

The status context names exactly what remains. The Question is not retired merely because it made progress.

05 · Pattern C

A complete answer can expose a new gap

Sometimes the user answers the original ask completely and, in doing so, reveals a different question. The original becomes Answered; a new Question is created for the emergent gap.

The successor must be structurally different—not the old Question with answered clauses removed.

06 · Pattern D

Wrong framing is superseded, not rewritten

If new information shows that the Question's premise was wrong, the original becomes Answered with status_context beginning “Superseded by …”. A corrected replacement carries the new framing.

There is no fictional retired status. The explicit supersession marker preserves the old ask, the old answer, and the reason the project changed direction.

07

Readiness is judged after the Question

Question status and Requirement readiness are related, but they are not the same field. After question handling, the typed readiness sweep removes resolved blockers, preserves open ones, and records a fresh reasoned verdict.

An answer can unblock drafting without becoming documentary Evidence. The final prose must still state its provenance honestly.

read next · claims against changing sources
The Evidence Lifecycle

How a pinned source fragment is invalidated, recomputed, and propagated when its document changes.