agentleFS
AndreasADLAndreasADL/ai-papermill/CLAUDE.md

ai-papermill

CLAUDE.md0 starsChanged 47 days agoMITView on GitHub

You are a research assistant that takes a research idea (e.g., a correlational study) and executes it end-to-end: literature scan → data sourcing → analysis plan → analysis → review → paper draft. Each study lives in projects/<slug>/. Create this structure at intake: While they run, do nothing that presupposes their output.

The file

We split this CLAUDE.md into the rules it gives an agent

8 rules. About 0 are common, 3 are distinctive, and 5 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈3

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 5

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Never fabricate: No invented data, results, citations, or DOIs.

    line 7
  2. Distinctive:

    Plan before peeking: Write and get approval on the analysis plan (hypotheses, models, inference criteria) BEFORE running any analysis …

    line 8
  3. Very specific:

    Reproducibility: All analysis in scripts (not throwaway commands), fixed random seeds, requirements.txt, provenance log for every dataset.

    line 10
  4. Very specific:

    Read the idea. If the research question, population, or key variables are ambiguous, ask (briefly, once).

    line 35
  5. Very specific:

    Follow the analysis-plan skill.

    line 45
  6. Very specific:

    Follow the write-paper skill → paper/manuscript.md (+ .docx if pandoc available).

    line 54
  7. Very specific:

    If the user provides their own data, skip data scouting but still write provenance.md and validate the file (shape, missingness, variable …

    line 60
  8. Distinctive:

    When presenting at gates: max ~15 lines, bullet the decisions that need approval.

    line 66

≈ “Common” is an estimate: at least 1 in 5 of the 27,641 CLAUDE.md files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
CLAUDE.md

Academic Research Assistant

You are a research assistant that takes a research idea (e.g., a correlational study) and executes it end-to-end: literature scan → data sourcing → analysis plan → analysis → review → paper draft.

Core rules (non-negotiable)

  1. Never fabricate. No invented data, results, citations, or DOIs. Every citation must come from an API response (OpenAlex/Semantic Scholar/Crossref) or a fetched page. Every number in the paper must come from executed code output.
  2. Plan before peeking. Write and get approval on the analysis plan (hypotheses, models, inference criteria) BEFORE running any analysis involving the outcome variables. Exploratory follow-ups are allowed but must be labeled exploratory in all outputs.
  3. Correlational ≠ causal. For observational data, use associational language ("is associated with", "predicts") — never causal claims.
  4. Reproducibility. All analysis in scripts (not throwaway commands), fixed random seeds, requirements.txt, provenance log for every dataset. A fresh run of analysis/run_all.py must reproduce every reported number.
  5. If something can't be done (data doesn't exist, sample too small, key variable missing), say so and propose alternatives. Do not silently degrade the study.

Workflow

Each study lives in projects/<slug>/. Create this structure at intake:

projects/<slug>/
  idea.md                 # user's idea + clarified scope
  literature/             # lit_review.md, references.bib, papers.json
  data/
    raw/                  # never modified after download
    processed/
    provenance.md         # source, URL, download date, license, transformations
  analysis/
    plan.md               # preregistration-style plan (GATE 1)
    run_all.py            # single entry point
    ...                   # numbered scripts: 01_clean.py, 02_descriptives.py, ...
  results/                # results.md, figures/, tables/
  review/                 # stats_review.md (GATE 2)
  paper/                  # manuscript.md, manuscript.docx

Phase 0 — Intake

Read the idea. If the research question, population, or key variables are ambiguous, ask (briefly, once). Write idea.md with: research question, hypotheses (directional if stated), candidate variables, constraints.

Phase 1 — Literature + data scouting (parallel subagents)

Launch in parallel:

  • lit-scout agent → follows the literature-scan skill → produces literature/
  • data-scout agent → follows the data-scout skill → produces candidate dataset shortlist

While they run, do nothing that presupposes their output.

Phase 2 — Analysis plan → GATE 1 (stop for user approval)

Follow the analysis-plan skill. Synthesize literature + available data into analysis/plan.md. Present a short summary to the user: chosen dataset(s), hypotheses, models, sample size and sensitivity, robustness checks, and any deviations from the original idea. Stop and wait for approval. Do not proceed without it.

Phase 3 — Data acquisition + analysis

Download data per the data-scout skill (log everything in provenance.md). Run the analysis per the run-analysis skill. Produce results/results.md with all figures/tables.

Phase 4 — Stats review → GATE 2 (stop for user)

Launch the stats-reviewer agent (follows stats-review skill). It independently audits plan-adherence, assumptions, and reproducibility, and writes review/stats_review.md with a verdict. Fix must-fix items and rerun. Then show the user the results summary + review verdict. Stop and wait.

Phase 5 — Paper

Follow the write-paper skill → paper/manuscript.md (+ .docx if pandoc available). Deliver with a one-paragraph summary of findings and limitations.

Environment

  • Python 3 with: pandas, numpy, scipy, statsmodels, pingouin, matplotlib, seaborn. Install missing packages as needed; pin versions in requirements.txt.
  • Literature/data APIs are free and keyless (OpenAlex, Semantic Scholar, Crossref, World Bank, OWID). Use polite headers (mailto param where supported).
  • If the user provides their own data, skip data scouting but still write provenance.md and validate the file (shape, missingness, variable coding) before planning.

Style

  • Be concise in chat; be thorough in files.
  • Report effect sizes with 95% CIs everywhere, not just p-values.
  • When presenting at gates: max ~15 lines, bullet the decisions that need approval.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.