research

# Research ## Overview Investigate the real-world facts a story depends on and keep them in `research/` notes: the question, a search plan, the findings with a citation for each, how confident the finding is, and the chapters that rely on them. Research is active work, not only a ledger: form precise questions, go to primary sources where they exist, interview people and visit places, and record what was found in a form a later fact-check can retrace. The CLI tracks each note's status (`open`, `verified`, `disputed`), its `used-in` chapters, and the optional `accuracy`, `confidence`, `method`, `risk`, and `reviewed-by` fields. It checks the chapter links, warns when a final chapter still rests on research that is open or disputed, and warns when a risky note reaches a final chapter without a qualified reviewer. ## Prerequisites A story project with `story.md` in the root. The `research/` folder and its registry are created by the first `story add research`. ## When to Use - A chapter depends on history, science, law, medicine, a trade, a real place, or any detail a knowledgeable reader could check - The user asks whether something is accurate - Before marking a chapter `final` in historical, technical, or contemporary fiction - NOT for invented world facts (use `worldbuilding`) or story-internal continuity (use `revision-continuity`) ## Workflow ### 1. Open a note ```shell story add research "Tidal bore timing" --used-in chapter-03 \ --accuracy must-be-accur...