quox investigate
quox investigate
Section titled “quox investigate”Investigations: a question taken through optional research, plan, critique and revise rounds to a decision, ending in no action or a QuoxPlan stream (objective + NotesQ collection + brain decisions)
| Command | What it does |
|---|---|
quox investigate open [options] <question> | Open an investigation: a not-started objective (metadata.kind investigation) plus its state note in a new NotesQ collection |
quox investigate list [options] | List investigations (objectives whose metadata.kind is investigation) with stage, round and outcome |
quox investigate show <id> | Show an investigation: question, state, notes by stage, decisions, outcome |
quox investigate add [options] <id> | Add a stage note (research, evaluate, plan, critique, revise) to the investigation’s collection |
quox investigate research <id> <question> | Ask the research agent (the quox research ask route) and save the answer as a research note in the investigation |
quox investigate critique [options] <id> | Apply a QuoxLens lens (the quox lens apply route) to the latest plan or revise note and save its findings as a critique note |
quox investigate decide [options] <id> <what> | Record a decision (the quox brain decide route) with provenance naming the investigation |
quox investigate close [options] <id> | Close an investigation: no-action, or stream (linking an existing QuoxPlan stream). Cancels the objective; the outcome is recorded on the state note |
quox investigate handoff [options] <id> | Hand off to QuoxPlan: create the stream, write the latest plan note as its plan doc, add a phase per item of its Phases section, link the investigation, close it with outcome stream. With --propose: create one QuoxProposals proposal instead, for a person to decide (required when acting as an agent) |