Skip to content

Repository files navigation

Research, Rewritten

ci docs DOI

Deep research gives you plausible. This book gives you reliable.

Written for software and AI engineers who have to do research at work. You are asked to sign off on a technical judgment (can a small model replace the large one, should the retrieval layer be swapped, can this AI report be trusted), and the evidence is an experiment anyone can rerun. The signature is yours. Academic researchers, analysts, and people doing due diligence use the same process, with the shape of the case converted as Chapter 3, section 3.6 shows. If "sounds right" is good enough, you need a good search tool, not this book. It wires general-purpose AI and agents into every step of truth-seeking work, from reading the literature to red-teaming, and at every step it says plainly where you can hand it to AI, where you must gate it yourself, and where nobody knows yet. Sixteen chapters plus Start Here, prompts and templates for every chapter, and two rerunnable experiments. Start Here runs a real experiment in two hours; the reading paths and the spine case are in docs/index.md.

How to read

Hand it to your agent

After every chapter's exercise block there is an instruction you can paste straight into Claude Code, Codex, or any coding agent. It walks you through the chapter's appendix prompt set, leaves the criteria, the scoring, and the signature to you, and opens the verification channel in a separate session, as the book's discipline requires. The one-time setup instruction is on the home page. An agent can also read the whole book from llms.txt (index) and llms-full.txt (full text).

The skill

The book's templates, dispatch briefs and checks are packaged as a Claude Code skill in skills/research-rewritten. It triggers when you are about to sign off on an AI-assisted result: a memo, an announcement, a report someone else generated, a tool's claim. It carries 24 fillable templates, 16 independent-channel briefs, and five stdlib Python checks (preregistration timing, append-only ledger, effective sample size, number interlock, leak check). The book stays the source of truth; the skill is the desk copy. Install it in Claude Code with /plugin marketplace add hallieren/research-rewritten then /plugin install research-rewritten@research-rewritten, or symlink it with ln -s "$PWD/skills/research-rewritten" ~/.claude/skills/research-rewritten. The comparison against a no-skill baseline is in skills/research-rewritten/evals/.

Chapters

# Chapter Templates Code
Preface This Book Was Put on Trial / smol-army · persona-panel
Start Here A Two-Hour Win / smol-army
Part I · Reframing
1 After Coding, Research Templates
2 A Map Stolen from Paradigm Shifts Templates
3 The Truth-Seeking Workflow and the Autonomy Ladder Templates
Part II · The Main Line, One Step per Chapter
4 Master a Field Templates
5 Questions and Hypotheses Templates persona-panel
6 Turn an Idea into a Falsifiable Test Plan Templates persona-panel
7 Execution Templates
8 Read the Results, Catch the Errors Templates smol-army · persona-panel
9 Delivery Templates smol-army
10 Red Team Templates persona-panel
Part III · Trust, the Book's Cutting Edge
11 Failure Modes Unique to Research Templates persona-panel
12 The Verification Workflow Templates persona-panel
13 An Honest Map Templates
Part IV · New Roles
14 The Researcher's New Craft Templates
15 Make It a Habit and a Capability Templates
16 Coda · How This Book Stays Current Templates

Templates: Template index · Experiments: Experiment ledger index · Companion code: code/smol-army · code/persona-panel (install uv, then uv sync --extra dev && uv run pytest inside either project)

Verified by its own method

A book that teaches verification publishes the full record of its own verification. The spine experiment's criteria were written down before it ran (prereg.md), its conclusions took a red team before release (redteam-2026-07-25.md), every cent of API spend is in the cost ledger, and every number in the book points back to its raw results. The Experiment ledger index is the entry point.

Prose CC BY-NC-SA 4.0 · code MIT (LICENSE.md) · Contributing · How to cite

About

Research, Rewritten: using AI to produce knowledge you can trust. A free open-source book on AI-assisted research, with prompts, templates, and two rerunnable preregistered experiments.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages