Bundle LLM guide files in wheel with get_llm_guide() accessor

Move docs/llms*.txt into diff_diff/guides/ so they ship inside the wheel
and are discoverable via `diff_diff.get_llm_guide()` with no network access.
Surface the helper in the module docstring so help(diff_diff) guides AI
agents to it.

- Move llms.txt, llms-full.txt, llms-practitioner.txt to diff_diff/guides/
- Add get_llm_guide(variant) using importlib.resources
- Explicit [tool.maturin] include entry for defense-in-depth across 1.4-2.0
- Switch pyproject "Practitioner Guide" URL to ReadTheDocs
- Rewrite internal cross-refs inside guide files to point at the accessor
- Update docs/conf.py html_extra_path to the new location (adds
  llms-practitioner.txt to the RTD surface)
- Update all path references (doc-deps.yaml, README, CLAUDE, REGISTRY,
  bump-version)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: igerber

.claude/commands/bump-version.md

@@ -24,7 +24,7 @@ Files that need updating:
 | `pyproject.toml` | `version = "X.Y.Z"` | ~7 |
 | `rust/Cargo.toml` | `version = "X.Y.Z"` | ~3 |
 | `CHANGELOG.md` | Section header + comparison link | Top + bottom |
-| `docs/llms-full.txt` | `- Version: X.Y.Z` | ~5 |
+| `diff_diff/guides/llms-full.txt` | `- Version: X.Y.Z` | ~5 |
 
 ## Instructions
 
@@ -80,7 +80,7 @@ Files that need updating:
      Replace `version = "OLD_VERSION"` (the first version line under [package]) with `version = "NEW_VERSION"`
      Note: Rust version may differ from Python version; always sync to the new version
 
-   - `docs/llms-full.txt`:
+   - `diff_diff/guides/llms-full.txt`:
      Replace `- Version: OLD_VERSION` with `- Version: NEW_VERSION`
 
 6. **Update CHANGELOG comparison links**:
@@ -101,7 +101,7 @@ Files that need updating:
    - diff_diff/__init__.py: __version__ = "NEW_VERSION"
    - pyproject.toml: version = "NEW_VERSION"
    - rust/Cargo.toml: version = "NEW_VERSION"
-   - docs/llms-full.txt: Version: NEW_VERSION
+   - diff_diff/guides/llms-full.txt: Version: NEW_VERSION
    - CHANGELOG.md: Added/verified [NEW_VERSION] entry
 
    Next steps:

CLAUDE.md

@@ -139,7 +139,7 @@ category (`Methodology/Correctness`, `Performance`, or `Testing/Docs`):
 | `CONTRIBUTING.md` | Documentation requirements, test writing guidelines |
 | `.claude/commands/dev-checklists.md` | Checklists for params, methodology, warnings, reviews, bugs (run `/dev-checklists`) |
 | `.claude/memory.md` | Debugging patterns, tolerances, API conventions (git-tracked) |
-| `docs/llms-practitioner.txt` | Baker et al. (2025) 8-step practitioner workflow for AI agents |
+| `diff_diff/guides/llms-practitioner.txt` | Baker et al. (2025) 8-step practitioner workflow for AI agents (accessible at runtime via `diff_diff.get_llm_guide("practitioner")`) |
 | `docs/performance-plan.md` | Performance optimization details |
 | `docs/benchmarks.rst` | Validation results vs R |
 

README.md

@@ -69,11 +69,19 @@ Signif. codes: '***' 0.001, '**' 0.01, '*' 0.05, '.' 0.1
 
 ## For AI Agents
 
-If you are an AI agent or LLM using this library, read [`docs/llms.txt`](docs/llms.txt) for a concise API reference with an 8-step practitioner workflow (based on Baker et al. 2025). The workflow ensures rigorous DiD analysis — not just calling `fit()`, but testing assumptions, running sensitivity analysis, and checking robustness.
+If you are an AI agent or LLM using this library, call `diff_diff.get_llm_guide()` for a concise API reference with an 8-step practitioner workflow (based on Baker et al. 2025). The workflow ensures rigorous DiD analysis — not just calling `fit()`, but testing assumptions, running sensitivity analysis, and checking robustness.
 
-After estimation, call `practitioner_next_steps(results)` for context-aware guidance on remaining diagnostic steps.
+```python
+from diff_diff import get_llm_guide
+
+get_llm_guide()                 # concise API reference
+get_llm_guide("practitioner")   # 8-step workflow (Baker et al. 2025)
+get_llm_guide("full")           # comprehensive documentation
+```
+
+The guides are bundled in the wheel, so they are accessible from a `pip install` with no network access required.
 
-Detailed guide: [`docs/llms-practitioner.txt`](docs/llms-practitioner.txt)
+After estimation, call `practitioner_next_steps(results)` for context-aware guidance on remaining diagnostic steps.
 
 ## For Data Scientists
 

diff_diff/__init__.py

@@ -4,12 +4,14 @@
 This library provides sklearn-like estimators for causal inference
 using the difference-in-differences methodology.
 
-For rigorous analysis, follow the 8-step practitioner workflow in
-docs/llms-practitioner.txt (based on Baker et al. 2025). After
-estimation, call ``practitioner_next_steps(results)`` for context-aware
-guidance on remaining diagnostic steps.
+For rigorous analysis, follow the 8-step practitioner workflow based
+on Baker et al. (2025). After estimation, call
+``practitioner_next_steps(results)`` for context-aware guidance on
+remaining diagnostic steps.
 
-AI agent reference: docs/llms.txt
+AI agents: call ``diff_diff.get_llm_guide()`` for a complete API reference.
+Use ``get_llm_guide("practitioner")`` for the 8-step workflow or
+``get_llm_guide("full")`` for comprehensive documentation.
 """
 
 # Import backend detection from dedicated module (avoids circular imports)
@@ -200,6 +202,7 @@
     plot_synth_weights,
 )
 from diff_diff.practitioner import practitioner_next_steps
+from diff_diff._guides_api import get_llm_guide
 from diff_diff.datasets import (
     clear_cache,
     list_datasets,
@@ -402,4 +405,6 @@
     "clear_cache",
     # Practitioner guidance
     "practitioner_next_steps",
+    # LLM guide accessor
+    "get_llm_guide",
 ]

diff_diff/_guides_api.py

@@ -0,0 +1,48 @@
+"""Runtime accessor for bundled LLM guide files."""
+from __future__ import annotations
+
+from importlib.resources import files
+
+_VARIANT_TO_FILE = {
+    "concise": "llms.txt",
+    "full": "llms-full.txt",
+    "practitioner": "llms-practitioner.txt",
+}
+
+
+def get_llm_guide(variant: str = "concise") -> str:
+    """Return the contents of a bundled LLM guide.
+
+    Parameters
+    ----------
+    variant : str, default "concise"
+        Which guide to load. One of:
+
+        - ``"concise"`` -- compact API reference (llms.txt)
+        - ``"full"`` -- complete API documentation (llms-full.txt)
+        - ``"practitioner"`` -- 8-step practitioner workflow (llms-practitioner.txt)
+
+    Returns
+    -------
+    str
+        The full text of the requested guide.
+
+    Raises
+    ------
+    ValueError
+        If ``variant`` is not one of the known guide names.
+
+    Examples
+    --------
+    >>> from diff_diff import get_llm_guide
+    >>> concise = get_llm_guide()
+    >>> workflow = get_llm_guide("practitioner")
+    """
+    try:
+        filename = _VARIANT_TO_FILE[variant]
+    except (KeyError, TypeError):
+        valid = ", ".join(repr(k) for k in _VARIANT_TO_FILE)
+        raise ValueError(
+            f"Unknown guide variant {variant!r}. Valid options: {valid}."
+        ) from None
+    return files("diff_diff.guides").joinpath(filename).read_text(encoding="utf-8")

diff_diff/guides/__init__.py

@@ -0,0 +1 @@
+"""LLM guide files bundled with diff-diff."""

docs/llms-full.txt diff_diff/guides/llms-full.txtdocs/llms-full.txt renamed to diff_diff/guides/llms-full.txt

@@ -33,7 +33,7 @@ print(f"ATT: {results.att:.3f} (SE: {results.se:.3f})")
 
 ## Practitioner Workflow (based on Baker et al. 2025)
 
-For rigorous DiD analysis, follow the 8-step framework in docs/llms-practitioner.txt.
+For rigorous DiD analysis, follow the 8-step framework (call `diff_diff.get_llm_guide("practitioner")`).
 After estimation, call:
 
 ```python

docs/llms-practitioner.txt diff_diff/guides/llms-practitioner.txtdocs/llms-practitioner.txt renamed to diff_diff/guides/llms-practitioner.txt

@@ -27,13 +27,13 @@ diagnostic steps produces unreliable results.
 After estimation, call `practitioner_next_steps(results)` for context-aware
 guidance on remaining steps.
 
-Full practitioner guide: docs/llms-practitioner.txt
+Full practitioner guide: call `diff_diff.get_llm_guide("practitioner")`
 
 ## Documentation
 
 ### Getting Started
 
-- [Practitioner Guide](docs/llms-practitioner.txt): 8-step workflow for rigorous DiD analysis (Baker et al. 2025) — **start here**
+- **Practitioner Guide** (call `diff_diff.get_llm_guide("practitioner")`): 8-step workflow for rigorous DiD analysis (Baker et al. 2025) — **start here**
 - [Quickstart](https://diff-diff.readthedocs.io/en/stable/quickstart.html): Installation, basic 2x2 DiD — column-name and formula interfaces, covariates, fixed effects, cluster-robust SEs
 - [Choosing an Estimator](https://diff-diff.readthedocs.io/en/stable/choosing_estimator.html): Decision flowchart for selecting the right estimator for your research design
 - [Troubleshooting](https://diff-diff.readthedocs.io/en/stable/troubleshooting.html): Common issues and solutions

docs/llms.txt diff_diff/guides/llms.txtdocs/llms.txt renamed to diff_diff/guides/llms.txt

@@ -33,7 +33,7 @@
 ]
 
 templates_path = ["_templates"]
-exclude_patterns = ["_build", "Thumbs.db", ".DS_Store", "llms.txt", "llms-full.txt"]
+exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]
 
 # -- Options for autodoc -----------------------------------------------------
 autodoc_default_options = {
@@ -71,7 +71,11 @@
     "https://diff-diff.readthedocs.io/en/stable/",
 )
 html_baseurl = _canonical_url
-html_extra_path = ["llms.txt", "llms-full.txt"]
+html_extra_path = [
+    "../diff_diff/guides/llms.txt",
+    "../diff_diff/guides/llms-full.txt",
+    "../diff_diff/guides/llms-practitioner.txt",
+]
 sitemap_url_scheme = "{link}"
 
 html_theme_options = {