literate-agent

Run the project's literate-programming verification — tangle + structure check + smoke test. Reports any violations of the four-part section shape or prose discipline.

Audit a PR diff (or recent git history) for cowork-specific drift modes — sycophancy patterns, tone drift, convergent regression, citation hallucination, stake mismatch. Reports findings grouped by rule.

Research-grounded structural audit of one literate `.org` file or a whole project tree. Checks for the anti-patterns the transfer-gradient research identifies — phase-name headings, missing :CUSTOM_ID: anchors on multi-referenced sections, missing prose-before-src, sections with no stable anchor for cold-start retrieval, typographic-only load-bearing affordances. Reports violations grouped by rule.

Audit one .org file's prose against the lp-prose-no-self-narration rule. Reports paragraphs that fail the deletion test (self-narration, filler parentheticals, mechanism-without-action). User-invocable only — do NOT auto-trigger on every edit.

Prose drives code in any literate-programming repo. Use BEFORE editing any .org file in a project that follows literate-programming discipline. Auto-activates when the user asks for a feature, change, refactor, or fix in .org files, and when they say "explain", "document", "draft a section", "write up", "rationale".

Run the 6-point dual-audience checklist on a literate .org section. Each item maps to a research-backed LP rule (heading-as-concept, :CUSTOM_ID: for ≥2 refs, WHY in prose, one mechanism per section, structural-not-typographic affordances, cold-start agent recoverability). Use after editing or writing an .org section, or as a manual review pass.

Elisp-specific literate-programming caveats — lexical-binding handling, macro re-expansion, reload discipline. Auto-activates when editing .el files or literate .org files with Elisp src blocks. Consult before adding lambdas in callbacks/timers, before changing macro definitions, or after editing a literate-elisp .org.

Python-specific literate-programming traps — tangle path resolution, ruff formatter file-local-var, noweb refs for big classes, byte-equivalence gate, bare-* parser trap. Auto-activates when editing .py files or literate .org files with Python src blocks. Consult before renaming .org files (tangle paths break), before adding new tangle targets, or after editing a literate-python .org.

5 hooks across 2 events