Method Audit
Reverse-engineer the data collection and empirical methods across a corpus of papers. Produce a critical comparison table that surfaces methodological blind spots.
Output Path
Per rules/review-artefact-routing.md (auto-loads in research projects (path-scoped to paper-*/ and paper/)):
- Source slug:
method-audit
- Write reports to:
reviews/_project/method-audit/<YYYY-MM-DD-HHMM>.md inside the project. Path is relative to the research project root, not the Task-Management repo.
- Never at project root (
./CRITIC-REPORT.md-style filenames are forbidden — pre-rule layout).
- Idempotency: timestamps include hour+minute (HHMM) to disambiguate same-day runs; never overwrite an earlier run's report.
- Index update: if
reviews/INDEX.md exists, write a one-line entry under "Latest per source" pointing at the new file. Otherwise review-recap will rebuild the index next time it runs.
- Infrastructure repos (Task-Management, atlas-workspace, etc.): this section does not apply — the path-scoped rule won't load there.
When to Use
- Writing a methodology section — need to justify your approach relative to the literature
- Reviewing empirical papers — need to compare data quality across studies
- Identifying methodological gaps — what approach has nobody tried yet?
- Preparing a replication or extension — need to understand exactly how prior work was done
When NOT to Use
- Theoretical papers — use an installed theoretical-comparison workflow instead
- Single-paper deep read — use
split-pdf
- Your own research design — use
causal-design or experiment-design
- Code review — use the
code-review agent
Input
A .bib file, PDF directory, topic description, or list of papers. If ambiguous, ask.
Workflow
Phase 1: Corpus Assembly
Assemble 10-20 empirical papers from the supplied bibliography or directory, or through configured scholarly-search tools. Prioritise papers with empirical content and filter out pure theory, editorials, and commentaries.
Phase 2: Method Extraction
For each paper, read using split-pdf methodology. Extract:
- Research design — experimental, quasi-experimental, observational, survey, qualitative, mixed
- Data source — where the data comes from (name the dataset, survey instrument, or archive)
- Sample
- Population and sampling frame
- Sample size (N)
- Unit of observation
- Time period
- Response rate (if survey)
- Attrition (if longitudinal)
- Variables
- Dependent variable(s) and how measured
- Key independent variable(s) and how measured
- Controls included
- Estimation strategy
- Statistical method (OLS, IV, DiD, RCT, qualitative coding, etc.)
- Identification strategy (what makes the estimate causal, if claimed)
- Robustness checks reported
- Biases acknowledged — what limitations the authors discuss
- Biases NOT acknowledged — what you can spot that they don't mention
Phase 3: Comparative Analysis
3.1 Methods Comparison Table
| Paper |
Design |
Data Source |
N |
Period |
Method |
ID Strategy |
Response Rate |
Sort by sample size (largest first).
3.2 Technique Distribution
Count how many papers use each:
- Design type (experimental, observational, etc.)
- Estimation method (OLS, IV, DiD, etc.)
- Data type (survey, admin, experimental, scraped, etc.)
Flag any technique that is dominant (>60% of papers) — this signals a methodological monoculture.
3.3 Bias Audit
For each paper, classify biases:
| Paper |
Biases Acknowledged |
Biases Missed |
Severity |
Common missed biases to check for:
- Selection bias — non-random sampling without correction
- Measurement error — self-reported outcomes, proxy variables
- External validity — single-country, single-firm, WEIRD samples
- Survivorship bias — studying only firms/people that survived
- Publication bias — significant results overrepresented
- Endogeneity — causal claims without credible identification
- Multiple testing — many outcomes tested without correction
3.4 Methodological Gaps
- Designs nobody has tried (e.g., no RCT in a field of observational studies)
- Data sources nobody has used (e.g., admin data when everyone uses surveys)
- Robustness checks nobody runs (e.g., no placebo tests, no sensitivity analysis)
- Populations understudied (e.g., only US data in a global phenomenon)
Phase 4: Output
Write to METHOD-AUDIT.md in the project directory.
Output Format
# Method Audit: [Topic]
**Date:** YYYY-MM-DD
**Corpus:** [N] empirical papers
**Dominant design:** [Most common research design]
**Dominant method:** [Most common estimation method]
## Comparison Table
| Paper | Design | Data | N | Period | Method | ID Strategy | Biases Noted |
|-------|--------|------|---|--------|--------|-------------|-------------|
## Technique Distribution
| Category | Count | Papers |
|----------|-------|--------|
## Bias Audit
### Commonly Acknowledged
- [Bias type] — mentioned by [N] papers
### Commonly Missed
- [Bias type] — present in [N] papers but acknowledged by [M]
- **Why it matters:** [Impact on findings]
- **Papers affected:** [List]
## Methodological Gaps
1. **No [design/method] studies** — [Why this matters]
2. **Understudied population:** [Who is missing]
3. **Missing robustness check:** [What should be tested]
## Implications for Your Research
- **Opportunity:** [What methodological gap you could fill]
- **Risk:** [What bias to watch for in your own design]
- **Benchmark:** [What sample size / design quality is expected in this field]
Cross-References
| Skill |
When to use instead/alongside |
| Installed theoretical-comparison workflow |
For theoretical rather than methodological comparison |
causal-design |
To design your own identification strategy |
experiment-design |
To design experiments or surveys |
replication-audit |
To check which findings have been replicated |
1---2name: method-audit3description: "Extract and compare data-collection methods across a set of empirical papers. Use when the user needs a cross-paper methods matrix or wants to assess how a literature gathers evidence."4allowed-tools: Read, Write, Edit, Glob, Grep, Bash(uv*), Bash(uv:*), Task, WebSearch, WebFetch, Bash(paperpile*)5argument-hint: "[topic, .bib file, or paper directory]"6skill-dependencies: [causal-design, split-pdf]7---89# Method Audit1011> Reverse-engineer the data collection and empirical methods across a corpus of papers. Produce a critical comparison table that surfaces methodological blind spots.1213## Output Path1415Per `rules/review-artefact-routing.md` (auto-loads in research projects (path-scoped to `paper-*/` and `paper/`)):1617- **Source slug:** `method-audit`18- **Write reports to:** `reviews/_project/method-audit/<YYYY-MM-DD-HHMM>.md` inside the project. Path is relative to the research project root, not the Task-Management repo.19- **Never** at project root (`./CRITIC-REPORT.md`-style filenames are forbidden — pre-rule layout).20- **Idempotency:** timestamps include hour+minute (HHMM) to disambiguate same-day runs; never overwrite an earlier run's report.21- **Index update:** if `reviews/INDEX.md` exists, write a one-line entry under "Latest per source" pointing at the new file. Otherwise `review-recap` will rebuild the index next time it runs.22- **Infrastructure repos** (Task-Management, atlas-workspace, etc.): this section does not apply — the path-scoped rule won't load there.232425## When to Use2627- Writing a methodology section — need to justify your approach relative to the literature28- Reviewing empirical papers — need to compare data quality across studies29- Identifying methodological gaps — what approach has nobody tried yet?30- Preparing a replication or extension — need to understand exactly how prior work was done3132## When NOT to Use3334- **Theoretical papers** — use an installed theoretical-comparison workflow instead35- **Single-paper deep read** — use `split-pdf`36- **Your own research design** — use `causal-design` or `experiment-design`37- **Code review** — use the `code-review` agent3839## Input4041A `.bib` file, PDF directory, topic description, or list of papers. If ambiguous, ask.4243## Workflow4445### Phase 1: Corpus Assembly4647Assemble 10-20 empirical papers from the supplied bibliography or directory, or through configured scholarly-search tools. Prioritise papers with empirical content and filter out pure theory, editorials, and commentaries.4849### Phase 2: Method Extraction5051For each paper, read using split-pdf methodology. Extract:52531. **Research design** — experimental, quasi-experimental, observational, survey, qualitative, mixed542. **Data source** — where the data comes from (name the dataset, survey instrument, or archive)553. **Sample**56 - Population and sampling frame57 - Sample size (N)58 - Unit of observation59 - Time period60 - Response rate (if survey)61 - Attrition (if longitudinal)624. **Variables**63 - Dependent variable(s) and how measured64 - Key independent variable(s) and how measured65 - Controls included665. **Estimation strategy**67 - Statistical method (OLS, IV, DiD, RCT, qualitative coding, etc.)68 - Identification strategy (what makes the estimate causal, if claimed)69 - Robustness checks reported706. **Biases acknowledged** — what limitations the authors discuss717. **Biases NOT acknowledged** — what you can spot that they don't mention7273### Phase 3: Comparative Analysis7475#### 3.1 Methods Comparison Table7677| Paper | Design | Data Source | N | Period | Method | ID Strategy | Response Rate |78|-------|--------|-------------|---|--------|--------|-------------|--------------|7980Sort by sample size (largest first).8182#### 3.2 Technique Distribution8384Count how many papers use each:85- Design type (experimental, observational, etc.)86- Estimation method (OLS, IV, DiD, etc.)87- Data type (survey, admin, experimental, scraped, etc.)8889Flag any technique that is **dominant** (>60% of papers) — this signals a methodological monoculture.9091#### 3.3 Bias Audit9293For each paper, classify biases:9495| Paper | Biases Acknowledged | Biases Missed | Severity |96|-------|-------------------|---------------|----------|9798Common missed biases to check for:99- **Selection bias** — non-random sampling without correction100- **Measurement error** — self-reported outcomes, proxy variables101- **External validity** — single-country, single-firm, WEIRD samples102- **Survivorship bias** — studying only firms/people that survived103- **Publication bias** — significant results overrepresented104- **Endogeneity** — causal claims without credible identification105- **Multiple testing** — many outcomes tested without correction106107#### 3.4 Methodological Gaps108109- Designs nobody has tried (e.g., no RCT in a field of observational studies)110- Data sources nobody has used (e.g., admin data when everyone uses surveys)111- Robustness checks nobody runs (e.g., no placebo tests, no sensitivity analysis)112- Populations understudied (e.g., only US data in a global phenomenon)113114### Phase 4: Output115116Write to `METHOD-AUDIT.md` in the project directory.117118## Output Format119120```markdown121# Method Audit: [Topic]122123**Date:** YYYY-MM-DD124**Corpus:** [N] empirical papers125**Dominant design:** [Most common research design]126**Dominant method:** [Most common estimation method]127128## Comparison Table129130| Paper | Design | Data | N | Period | Method | ID Strategy | Biases Noted |131|-------|--------|------|---|--------|--------|-------------|-------------|132133## Technique Distribution134135| Category | Count | Papers |136|----------|-------|--------|137138## Bias Audit139140### Commonly Acknowledged141- [Bias type] — mentioned by [N] papers142143### Commonly Missed144- [Bias type] — present in [N] papers but acknowledged by [M]145 - **Why it matters:** [Impact on findings]146 - **Papers affected:** [List]147148## Methodological Gaps1491501. **No [design/method] studies** — [Why this matters]1512. **Understudied population:** [Who is missing]1523. **Missing robustness check:** [What should be tested]153154## Implications for Your Research155156- **Opportunity:** [What methodological gap you could fill]157- **Risk:** [What bias to watch for in your own design]158- **Benchmark:** [What sample size / design quality is expected in this field]159```160161## Cross-References162163| Skill | When to use instead/alongside |164|-------|-------------------------------|165| Installed theoretical-comparison workflow | For theoretical rather than methodological comparison |166| `causal-design` | To design your own identification strategy |167| `experiment-design` | To design experiments or surveys |168| `replication-audit` | To check which findings have been replicated |