Skip to content

Commit e65be16

Browse files
igerberclaude
andcommitted
Inline deviation notes into bundled practitioner guide
The guide's opening blockquote previously pointed at `docs/methodology/REGISTRY.md` for details on reorganizations relative to Baker et al. (2025). That path does not exist inside a wheel-only install, so it was a dead breadcrumb for offline AI agents - exactly the scenario this PR is meant to fix. Inline the four deviation bullets (numbering, PT as Step 3, uncertainty folding into Step 5, Step 8 = Robustness & Reporting) directly into the guide so it is self-contained. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent 5646126 commit e65be16

1 file changed

Lines changed: 15 additions & 1 deletion

File tree

diff_diff/guides/llms-practitioner.txt

Lines changed: 15 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,21 @@
33
> An 8-step workflow for rigorous Difference-in-Differences analysis, based on
44
> Baker et al. (2025) "Difference-in-Differences Designs: A Practitioner's
55
> Guide" and adapted for the diff-diff library. Some steps are reorganized or
6-
> extended relative to the paper (see docs/methodology/REGISTRY.md for details).
6+
> extended relative to the paper:
7+
>
8+
> - **Numbering**: diff-diff uses 1-Define, 2-Assumptions, 3-Test PT,
9+
> 4-Choose estimator, 5-Estimate, 6-Sensitivity, 7-Heterogeneity,
10+
> 8-Robustness. The paper uses 1-Define, 2-Assumptions, 3-Estimation method,
11+
> 4-Uncertainty, 5-Estimate, 6-Sensitivity, 7-Heterogeneity, 8-Keep learning.
12+
> - **Parallel trends testing** is a separate Step 3 (the paper embeds it in
13+
> Step 2), to ensure AI agents execute it as a distinct action.
14+
> - **Sources of uncertainty** (paper's Step 4) are folded into Step 5
15+
> (Estimate) with an explicit cluster-count check directive: >= 50 clusters
16+
> for asymptotic SEs, otherwise wild bootstrap. The 50-cluster threshold is
17+
> a diff-diff convention.
18+
> - **Step 8** is "Robustness & Reporting" (compare estimators, report with
19+
> and without covariates). The paper's Step 8 is "Keep learning." The
20+
> mandatory with/without covariate comparison is a diff-diff convention.
721

822
## Instructions for AI Agents
923

0 commit comments

Comments
 (0)