A field kit for using iterative research loops in domains where the evidence is unresolved, the theories compete, and there is no clean scoreboard to optimize against.
Most autoresearch work is strongest when the loop has a measurable target: a benchmark, simulation, executable experiment, loss curve, or pass/fail test. Many real research and policy domains do not look like that. The evidence is mixed. Sources disagree. Terms drift. The strongest available result may depend on scope, population, method, or time period.
This repo proposes a different loop for those settings. The goal is not to force convergence. The goal is to improve the structure of disagreement, preserve uncertainty where it is earned, and produce better next questions.
This field kit is for people who need to reason across mixed evidence without pretending the field is cleaner than it is:
- research teams comparing competing causal theories
- policy analysts working with uneven evidence
- investigative researchers building source-backed claim maps
- grant, review, or strategy teams trying to name what is actually known
- organizational teams deciding what evidence to collect next before committing to a position
It is most useful when the team has enough source material to disagree responsibly, but not enough clarity to declare a winner.
Do not use this kit when a cleaner method fits the problem better.
- If there is a clear executable test, run the test.
- If the domain has a validated benchmark or simulation, use it directly.
- If a formal systematic review is required, follow the relevant review protocol and reporting standard.
- If the decision is safety-critical, clinical, legal, or time-sensitive, use qualified domain governance.
- If the team cannot inspect the underlying sources, do not use this framework to create authority from summaries.
This kit is for structured reasoning under uncertainty. It is not a substitute for stronger evidence, formal review methods, or accountable decision-making.
In contested fields, a useful research loop should not optimize toward the most confident answer. It should optimize for:
- clearer claim-evidence binding
- better separation between findings and interpretations
- visible conflicts between credible sources
- explicit scope conditions
- adversarial review against the current leading theory
- ranked research questions that would actually move confidence
The output is structured uncertainty with a ranked attack plan.
- Turn sources into evidence cards, one finding at a time.
- Separate what a source observed from what its authors argued.
- Map findings against competing theories.
- Run study autopsies when credible sources conflict.
- Score theories diagnostically, not as verdicts.
- Use rotating adversarial roles to reduce fixation.
- Generate research questions from unresolved conflict, missing undercuts, split scores, and scope flags.
- Collect sources against thin cells in the coverage matrix.
- Re-run the cycle on a cadence and keep prior uncertainty visible.
In this repo, autoresearch does not mean autonomous science. It means the research process is expressed as a repeatable loop with explicit state, actions, feedback, and review gates.
| Loop part | In this field kit |
|---|---|
| State | Evidence cards, theory pages, autopsies, rubric splits, question backlog, source matrix |
| Actions | Add a card, revise a theory, autopsy a conflict, generate a question, collect against a thin cell |
| Feedback | Clearer scope, stronger source traceability, visible conflicts, more vulnerable theories, better next questions |
| Stop / continue signal | Human reviewers decide whether the current evidence supports a narrower claim, another collection pass, or a formal review method |
The automatable part is the movement between artifacts: sources create cards, cards expose conflicts, conflicts create autopsies, autopsies revise theories, theory gaps generate questions, and questions direct the next collection pass.
In v0.1, that loop is manual-first. AI or scripts may later help draft cards, suggest conflicts, fill matrices, or propose next questions, but source artifacts and human review remain the authority.
FIELD_NOTE.md: the original public field-kit noteFIELD_NOTES/001-after-50-cycles.md: notes from a 50-cycle manual-first run in a high-stakes contested evidence domaintemplates/: reusable Markdown templates for one manual cycleexamples/carverton/: a fictional worked example using a city transit domainexamples/llm-benchmark-reliability/: a small real-source pilot on benchmark interpretationdocs/for-autoresearch-builders.md: bridge note for people building research loopsdocs/pilot-use-cases.md: candidate pilot domains and selection criteriadocs/adjacent-work.md: nearby research areas and the novelty boundarydocs/what-this-is-not.md: explicit limits and anti-overclaiming languagedocs/release-notes.md: v0.1 release notes and status
Pick a contested field with at least two plausible theories and at least five sources that do not all point in the same direction.
Minimum first cycle:
- Write two to four competing theory pages.
- Create at least five evidence cards.
- Run one autopsy on the clearest source conflict.
- Generate three research questions from the artifacts.
- Write a short cycle report naming what changed, what stayed unresolved, and what evidence should be collected next.
For that minimum pass, start with:
templates/theory-page.mdtemplates/evidence-card.mdtemplates/study-autopsy.mdtemplates/research-question.md
Use the other templates when the project needs a full cycle.
Full cycle:
- Copy the files in
templates/into a new project folder. - Write one theory page for each major explanation.
- Create one evidence card per finding, not one per source.
- Fill the
Conflicts withfield even when the answer isnone known. - Run at least one study autopsy on a real or apparent conflict.
- Score all theories in one session with the card deck open.
- Generate research questions from the artifacts, not from intuition alone.
- Collect the next sources against empty or thin matrix cells.
Do not treat the first cycle as a conclusion. Treat it as the first map of the disagreement.
This is a decision-support framework. It is not a decision-replacement system.
Human reviewers remain responsible for source selection, extraction quality, domain interpretation, safety boundaries, and any downstream decision. The templates are meant to make reasoning inspectable, not automatic.
This is not an autonomous scientist, a systematic review replacement, a truth machine, biomedical advice, or a benchmarked scientific-discovery engine. The full boundary is in docs/what-this-is-not.md.
v0.1. Markdown-only. No CLI, UI, package manager, automation, or live data extraction.