{
  "id": "informed-command",
  "title": "Informed Command — the human-loop constitution",
  "asOf": "2026-06-18",
  "humanRoute": "/informed-command",
  "thesis": "The human remains in informed command: decision-complete, able to know what matters when it matters without hunting, never left blind, surprised, misled, or demoted to clerical supervision. The deliverable is reclaimed attention, not a dashboard.",
  "humanStakes": {
    "framing": "Being informed is peace of mind: knowing when to take the next step, and when it is safe to not think about this at all.",
    "states": [
      { "id": "clean", "headline": "It will run clean for the next three hours.", "feels": "attention fully freed", "rule": "Earned silence frees you to do the most valuable thing you have." },
      { "id": "watch", "headline": "It will stall now and then, keep half an eye on it.", "feels": "watching, not anxious", "rule": "A named, bounded uncertainty costs a little attention and no peace." },
      { "id": "blind", "headline": "You have no idea what it is doing.", "feels": "maximum mental noise", "rule": "Blindness is maximum uncertainty is maximum mental noise; the work may be fine and opacity manufactures the anxiety anyway." }
    ],
    "punchline": "Informed Command keeps you in the first two states and out of the third."
  },
  "failureFamilies": [
    { "id": "approval-spam", "name": "Dragged into the mechanics", "breaks": "You become the execution engine, approving steps you cannot or should not evaluate." },
    { "id": "opacity", "name": "Left blind or uncertain", "breaks": "The loop acts but you cannot tell what is running, why, under what authority, or whether it is converging." }
  ],
  "passCondition": "A design passes only if it avoids both families: it does not drag you into mechanics, and it does not leave you uncertain.",
  "filter": [
    { "id": "intent", "name": "Intent", "question": "Aimed right and checkable; convergence vs drift, caught before it compounds." },
    { "id": "visibility", "name": "Visibility", "question": "See convergence without hunting; denominator, durable status, right urgency channel." },
    { "id": "authority", "name": "Authority", "question": "What may happen unattended; reads, writes, tools, gates, blast radius." },
    { "id": "control", "name": "Control", "question": "Command not just watch; pause, correct, reroute, revoke, downgrade, read-only query." },
    { "id": "trust", "name": "Trust", "question": "Silence watchdog-backed; uncertainty and tool failure surfaced by the format, not memory." },
    { "id": "learning", "name": "Learning", "question": "Correction updates source-of-truth/tests/rules so it cannot recur forever." }
  ],
  "deliveryLaw": [
    { "signal": "routine progress", "channel": "ambient" },
    { "signal": "low-risk deltas", "channel": "digest" },
    { "signal": "material risk", "channel": "interrupt" },
    { "signal": "deep evidence", "channel": "pull" },
    { "signal": "receipts", "channel": "always attached" }
  ],
  "silenceRule": "Silence is allowed only when watchdog-backed. Quiet must mean monitored progress, never unknown drift.",
  "acceptanceTests": {
    "gates": [
      { "id": "t2", "name": "Convergence is present", "test": "Distance to done, not raw activity; no denominator means the design fails." },
      { "id": "t7", "name": "Silence is earned", "test": "A watchdog, heartbeat, or durable status proves the work is still in bounds while quiet." },
      { "id": "t8", "name": "Read-only inspection", "test": "Query current state without perturbing the work." },
      { "id": "t10", "name": "Authority is visible", "test": "The authority envelope is exposed." },
      { "id": "t1", "name": "Status declares its fields", "test": "What is running, why, under what authority, what changed, what is next, what is risky, what needs you." }
    ],
    "judgment": [
      { "id": "t3", "name": "No canonical surprise", "test": "Never discover after the fact that authoritative state changed unexpectedly." },
      { "id": "t4", "name": "Alerts are actionable", "test": "Every interrupt needs a real decision or action." },
      { "id": "t5", "name": "No fake calm", "test": "Low confidence, conflict, tool failure, stale evidence, and drift are surfaced honestly." },
      { "id": "t6", "name": "Correction closes the loop", "test": "A correction updates source-of-truth so it does not recur forever." },
      { "id": "t9", "name": "No approval spam", "test": "Not asked to approve mechanics the system can safely perform under policy." }
    ]
  },
  "hitlMoments": [
    { "id": "monitor", "moment": "Monitor", "needs": "phase, denominator, delta, risk, blocker, next action, input-needed." },
    { "id": "finalization", "moment": "Finalization", "needs": "what was confirmed, value created, what it enables, receipts, next." },
    { "id": "decision", "moment": "Decision gate", "needs": "options, tradeoffs, recommendation, risk, cost of no decision, exact approval." },
    { "id": "exception", "moment": "Exception", "needs": "what failed, blast radius, containment, options, recommended action, rollback." }
  ],
  "shortForm": "A filter every loop, prompt, objective, tool, and harness passes before it ships. A filter you do not run is a doctrine you do not have.",
  "relatedRoutes": ["/path", "/architecture", "/for-agents", "/notes/my-human-became-the-middleware"],
  "pairedLesson": "/lessons/human-loop-progress-visibility.json"
}