Skip to content

v1.1.0 — AGENTS.md as a drift surface

Choose a tag to compare

@davesheffer davesheffer released this 02 Jul 06:39

Memory that gates, not just recalls

Markdown topic anchors — AGENTS.md / CLAUDE.md as a drift surface

The doc≠graph spoke now covers the prose files the ecosystem funnels team knowledge into:

<!-- hunch:topic auth.session -->                 grounds only
<!-- hunch:topic auth.session dec_a1b2c3d4e5 -->  pinned to a decision
  • Pre-edit grounding: editing an anchored markdown file injects each topic's current decision, what it rejected, and an inline stale-pin warning — the graph outranks the prose being edited.
  • hunch drift: a pin to a superseded decision fires doc-anchor-stale (CI-gateable, non-zero exit); a pin to a missing decision fires doc-anchor-dangling. Deterministic — only an explicit pin can fire, never a semantic guess.
  • hunch heal: renders prose≠graph findings with the reconcile-then-re-pin action. Read-only, never rewrites prose.

hunch impact + hunch path

  • hunch impact [base|--commit] / MCP hunch_pr_impact — a change's impact surface: dependent files reached, invariants direct + via blast radius, and the decisions concerned. Composed from the same primitives as the gate, so impact and gating can never disagree.
  • hunch path <A> <B> / MCP hunch_path — shortest dependency chain between any two symbols/files/components, walked in either direction.

Also: hunch heal now covers every drift kind (dead-ref, dangling supersede, doc-stale) with a next action, and findRoot stops at the .git boundary so a stray ancestor .hunch can never hijack a fresh repo.

Full suite: 394 tests green.

🤖 Generated with Claude Code