Menu

#100 site(concepts): tighten intent-debt page (Opus review pass)

closed
nobody
None
2026-05-17
2026-05-17
Anonymous
No

Originally created by: TheoV823

Summary

Opus review pass on /concepts/intent-debt/ — eight targeted edits that sharpen the argument without expanding scope.

Highest-leverage change: rewrite of the "Why it emerges" section. The original framed agents as just "faster + less context." The new framing names the load-bearing piece: human reviewers were silently carrying the missing intent and applying it during review. Intent debt was always there — agents made it load-bearing.

Edits

  • Lede. Replaced abstract "made explicit, current, and enforceable" framing with the consequence (the human buffer collapses; the deficit becomes visible).
  • Callout [#1]. Dropped forced subtraction-operator metaphor ("draw against the balance"); replaced with structural-not-behavioral framing.
  • Why it emerges. Opens with "intent debt is not new — what changed is who absorbed it"; explicitly names the human buffer that was doing enforcement.
  • Differentiation section. Promoted "zero technical debt and high intent debt" punchline from FAQ into the body; added "ADRs read by a person at 2pm do not constrain an agent writing code at 2:03."
  • Review/memory/orchestration. Trimmed redundancy across paragraphs; callout now names the common failure mode (treating advisory as enforced) rather than restating "advisory or post-generation."
  • New section: "How to know you have intent debt." Five observable symptoms + a simple diagnostic. Closes the measurability gap relative to the AI Agent Drift page.
  • Related concepts. Fixed "intent debt enables drift" wording; reframed as co-manifestations.
  • Further-reading link. Removed internal-voice "the evidence-led argument."

Test plan

  • [ ] /concepts/intent-debt/ renders correctly with new lede and "How to know" section
  • [ ] FAQ still mirrors body claims (no contradictions introduced)
  • [ ] Internal links from body and related panel resolve

🤖 Generated with Claude Code

Related

Tickets: #1

Discussion

  • Anonymous

    Anonymous - 2026-05-17

    Ticket changed by: TheoV823

    • status: open --> closed
     
  • Anonymous

    Anonymous - 2026-05-17

    Originally posted by: github-actions[bot]

    mneme self-governance check

    Mode: warn - verdicts are visible but do not block merge. Rollout plan: .mneme/README.md.

    Summary: 0 pass, 0 warn, 0 fail

    verdict file
    ❔ UNKNOWN site/concepts/index.html
    ❔ UNKNOWN site/concepts/intent-debt/index.html
    ❔ UNKNOWN site/insights/index.html

    Generated by .github/workflows/mneme-check.yml · query = PR title + file path · scope = repo-governance paths.

     

Log in to post a comment.

Auth0 Logo