Research-update mode
Creates, extends, or re-verifies one or more pages' research evidence file on its own, independent of a rewrite. No draft is written and no review is produced.
Creates, extends, or re-verifies one or more pages’ research evidence file on its own, independent of a rewrite. No draft is written and no review is produced.
- For each page path the user gave, check whether
<source-directory>/_ak/<document-key>/research.mdexists, and whether<source-directory>/_ak/<document-key>/research-context.mdexists and is newer than it. - Choose the mode per page under the researcher brief:
createwhen no file exists; otherwiseextend(a new question or topic),reverify(re-check cited sources, optional topic), orrebuild. Infer it from the user’s words and ask once only when it is unclear. An existing file is never replaced withoutrebuildand an explicit yes for that page. When the context is newer than the file, offer anextendwith no topic. - Delegate to the researcher one page at a time, never in parallel. Wait for the returned handoff before the next page; the synchronous-delegation rule of Iterate mode applies.
- Report, per page: the research file path, a one-line summary of findings and gaps, and the
one-line research summary. If the handoff lists contested
points, offer each as an
Open questionsentry forresearch-context.md, never as a[decision]placeholder, and say a laterextendwith no topic records their resolution once they decide. Say you will add the entries toresearch-context.mdif they ask (Context files); add nothing otherwise. Do not draft, review, or touch a source document orcontent-quality-ledger.json.
The pipeline router owns mode selection. The researcher brief owns the delegation and its acceptance. The shared output layout owns generated paths.