{
  "schema_version": "1.0",
  "name": "Agent Optimization",
  "revision": "release-2026-11-11-r12",
  "canonical_origin": "https://www.aomsites.com",
  "status": "undeployed_candidate",
  "commerce": {
    "enabled": false,
    "checkout_url": null,
    "prices": []
  },
  "capabilities": [
    "read-static-guides",
    "read-preview-sample",
    "download-offline-reading-pack",
    "optional-local-record-consistency-checker"
  ],
  "limitations": [
    "No MCP endpoint",
    "No skill installer",
    "No hosted optimizer",
    "No runtime or customer-performance evidence"
  ],
  "authorization": "Reference data only. No permission to act.",
  "guides": [
    {
      "id": "durable-handoffs",
      "title": "Make the handoff survive the session",
      "category": "Continuity",
      "applies_when": "You are finishing a document, handing off a repository, or moving work between environments.",
      "skip_when": "The recipient already has a verified, durable copy and nothing material changed. Do not create another competing source of truth.",
      "evidence": "Proposed worksheet",
      "build_revision": "release-2026-11-11-r12",
      "scope_label": "Files, exports and deliverable handoffs",
      "search_terms": [
        "backup",
        "archive",
        "delivery",
        "restore",
        "download",
        "file",
        "handoff",
        "continuity"
      ],
      "html": "https://www.aomsites.com/guides/durable-handoffs/",
      "markdown": "https://www.aomsites.com/guides/durable-handoffs/guide.md",
      "json": "https://www.aomsites.com/guides/durable-handoffs/guide.json",
      "local_paths": {
        "html": "/guides/durable-handoffs/",
        "markdown": "/guides/durable-handoffs/guide.md",
        "json": "/guides/durable-handoffs/guide.json",
        "record_template_json": "/guides/durable-handoffs/record-template.json",
        "record_template_markdown": "/guides/durable-handoffs/record-template.md"
      },
      "offline_paths_from_pack_root": {
        "markdown": "guides/durable-handoffs/guide.md",
        "json": "guides/durable-handoffs/guide.json",
        "record_template_json": "guides/durable-handoffs/record-template.json",
        "record_template_markdown": "guides/durable-handoffs/record-template.md"
      },
      "reading_paths": {
        "note": "Stop here if the current task’s acceptance requirements are satisfied and no unresolved obligation remains. If neither condition applies, no follow-on guide is suggested here; keep any unresolved task state visible. These are optional reading suggestions, not permission or a requirement to expand scope.",
        "options": [
          {
            "guide_id": "useful-memory",
            "when": "The saved files are usable, but a fresh reader still cannot identify the next step or current limits.",
            "purpose": "Improve the continuity note without creating a competing copy of the artifact.",
            "title": "Keep memory useful without losing the rules",
            "local_paths": {
              "html": "/guides/useful-memory/",
              "markdown": "/guides/useful-memory/guide.md",
              "json": "/guides/useful-memory/guide.json"
            },
            "offline_paths_from_pack_root": {
              "markdown": "guides/useful-memory/guide.md",
              "json": "guides/useful-memory/guide.json"
            }
          },
          {
            "guide_id": "uncertain-effects",
            "when": "The handoff contains an action that may have completed before the session ended.",
            "purpose": "Reconcile that operation before a new session repeats it.",
            "title": "Check the outcome before retrying",
            "local_paths": {
              "html": "/guides/uncertain-effects/",
              "markdown": "/guides/uncertain-effects/guide.md",
              "json": "/guides/uncertain-effects/guide.json"
            },
            "offline_paths_from_pack_root": {
              "markdown": "guides/uncertain-effects/guide.md",
              "json": "guides/uncertain-effects/guide.json"
            }
          }
        ]
      },
      "discovery": {
        "title": "AI agent handoff checklist: save and verify deliverables",
        "description": "A proposed checklist for handing off AI-agent files and deliverables: preserve the right version, verify the receiving copy, and record what remains unresolved."
      }
    },
    {
      "id": "permission-hooks",
      "title": "Test the failure path of a permission hook",
      "category": "Controls",
      "applies_when": "A Python hook in Claude Agent SDK is part of the path that controls a consequential action.",
      "skip_when": "You do not use the SDK, or the hook only adds optional telemetry. Preserve the ordinary authorization layer either way.",
      "evidence": "Proposed worksheet",
      "build_revision": "release-2026-11-11-r12",
      "scope_label": "Claude Agent SDK Python pre-action hooks",
      "search_terms": [
        "Claude",
        "SDK",
        "hooks",
        "timeout",
        "guard",
        "permissions",
        "fail closed",
        "exception"
      ],
      "html": "https://www.aomsites.com/guides/permission-hooks/",
      "markdown": "https://www.aomsites.com/guides/permission-hooks/guide.md",
      "json": "https://www.aomsites.com/guides/permission-hooks/guide.json",
      "local_paths": {
        "html": "/guides/permission-hooks/",
        "markdown": "/guides/permission-hooks/guide.md",
        "json": "/guides/permission-hooks/guide.json",
        "record_template_json": "/guides/permission-hooks/record-template.json",
        "record_template_markdown": "/guides/permission-hooks/record-template.md"
      },
      "offline_paths_from_pack_root": {
        "markdown": "guides/permission-hooks/guide.md",
        "json": "guides/permission-hooks/guide.json",
        "record_template_json": "guides/permission-hooks/record-template.json",
        "record_template_markdown": "guides/permission-hooks/record-template.md"
      },
      "reading_paths": {
        "note": "Stop here if the current task’s acceptance requirements are satisfied and no unresolved obligation remains. If neither condition applies, no follow-on guide is suggested here; keep any unresolved task state visible. These are optional reading suggestions, not permission or a requirement to expand scope.",
        "options": [
          {
            "guide_id": "uncertain-effects",
            "when": "A failed or interrupted guard path leaves the underlying effect uncertain.",
            "purpose": "Separate the guard response from the authoritative operation outcome before retrying.",
            "title": "Check the outcome before retrying",
            "local_paths": {
              "html": "/guides/uncertain-effects/",
              "markdown": "/guides/uncertain-effects/guide.md",
              "json": "/guides/uncertain-effects/guide.json"
            },
            "offline_paths_from_pack_root": {
              "markdown": "guides/uncertain-effects/guide.md",
              "json": "guides/uncertain-effects/guide.json"
            }
          },
          {
            "guide_id": "measure-agent-improvement",
            "when": "The required boundary works and you now need to compare its overhead or usability.",
            "purpose": "Measure the authorized change against the same quality and control requirements.",
            "title": "Measure improvement in accepted results",
            "local_paths": {
              "html": "/guides/measure-agent-improvement/",
              "markdown": "/guides/measure-agent-improvement/guide.md",
              "json": "/guides/measure-agent-improvement/guide.json"
            },
            "offline_paths_from_pack_root": {
              "markdown": "guides/measure-agent-improvement/guide.md",
              "json": "guides/measure-agent-improvement/guide.json"
            }
          }
        ]
      },
      "discovery": {
        "title": "Claude Agent SDK Python: test permission-hook failures",
        "description": "A proposed worksheet for Claude Agent SDK Python pre-action hooks: check deny, exception and timeout paths with a harmless counter. No runtime validation is claimed."
      }
    },
    {
      "id": "resume-with-current-state",
      "title": "Bind every answer to the current question",
      "category": "Controls",
      "applies_when": "A LangGraph workflow pauses for input and can receive retries, multiple-tab responses, or successive answers.",
      "skip_when": "Your workflow never resumes paused input. RemoteGraph and local-runtime paths need their own documented behavior.",
      "evidence": "Proposed worksheet",
      "build_revision": "release-2026-11-11-r12",
      "scope_label": "LangGraph Python thread runs and interrupts",
      "search_terms": [
        "LangGraph",
        "SDK",
        "resume",
        "interrupt",
        "stale answer",
        "multiple tabs",
        "server",
        "checkpoint"
      ],
      "html": "https://www.aomsites.com/guides/resume-with-current-state/",
      "markdown": "https://www.aomsites.com/guides/resume-with-current-state/guide.md",
      "json": "https://www.aomsites.com/guides/resume-with-current-state/guide.json",
      "local_paths": {
        "html": "/guides/resume-with-current-state/",
        "markdown": "/guides/resume-with-current-state/guide.md",
        "json": "/guides/resume-with-current-state/guide.json",
        "record_template_json": "/guides/resume-with-current-state/record-template.json",
        "record_template_markdown": "/guides/resume-with-current-state/record-template.md"
      },
      "offline_paths_from_pack_root": {
        "markdown": "guides/resume-with-current-state/guide.md",
        "json": "guides/resume-with-current-state/guide.json",
        "record_template_json": "guides/resume-with-current-state/record-template.json",
        "record_template_markdown": "guides/resume-with-current-state/record-template.md"
      },
      "reading_paths": {
        "note": "Stop here if the current task’s acceptance requirements are satisfied and no unresolved obligation remains. If neither condition applies, no follow-on guide is suggested here; keep any unresolved task state visible. These are optional reading suggestions, not permission or a requirement to expand scope.",
        "options": [
          {
            "guide_id": "uncertain-effects",
            "when": "An old answer may already have triggered an external action.",
            "purpose": "Resolve the operation outcome rather than assuming a rejected replay undoes the first effect.",
            "title": "Check the outcome before retrying",
            "local_paths": {
              "html": "/guides/uncertain-effects/",
              "markdown": "/guides/uncertain-effects/guide.md",
              "json": "/guides/uncertain-effects/guide.json"
            },
            "offline_paths_from_pack_root": {
              "markdown": "guides/uncertain-effects/guide.md",
              "json": "guides/uncertain-effects/guide.json"
            }
          },
          {
            "guide_id": "useful-memory",
            "when": "The current question and state are correct now, but are lost when work changes sessions.",
            "purpose": "Preserve a pointer to authoritative current state without treating a saved answer as a fresh one.",
            "title": "Keep memory useful without losing the rules",
            "local_paths": {
              "html": "/guides/useful-memory/",
              "markdown": "/guides/useful-memory/guide.md",
              "json": "/guides/useful-memory/guide.json"
            },
            "offline_paths_from_pack_root": {
              "markdown": "guides/useful-memory/guide.md",
              "json": "guides/useful-memory/guide.json"
            }
          }
        ]
      },
      "discovery": {
        "title": "LangGraph Python: check stale answers when resuming agents",
        "description": "A proposed worksheet for LangGraph Python thread runs and interrupts: bind replies to current state and test stale answers. SDK support is not proof of server enforcement."
      }
    },
    {
      "id": "uncertain-effects",
      "title": "Check the outcome before retrying",
      "category": "Controls",
      "applies_when": "A tool may have sent a message, written a record or charged a payment before the connection failed.",
      "skip_when": "The operation is read-only and can be safely repeated within its authorization. Still distinguish a missing result from a failed request.",
      "evidence": "Proposed worksheet",
      "build_revision": "release-2026-11-11-r12",
      "scope_label": "Retries after uncertain external effects",
      "search_terms": [
        "payment",
        "duplicate",
        "retry",
        "timeout",
        "idempotency",
        "message",
        "unknown",
        "payments",
        "messages",
        "retries",
        "timeouts",
        "duplicate payments"
      ],
      "html": "https://www.aomsites.com/guides/uncertain-effects/",
      "markdown": "https://www.aomsites.com/guides/uncertain-effects/guide.md",
      "json": "https://www.aomsites.com/guides/uncertain-effects/guide.json",
      "local_paths": {
        "html": "/guides/uncertain-effects/",
        "markdown": "/guides/uncertain-effects/guide.md",
        "json": "/guides/uncertain-effects/guide.json",
        "record_template_json": "/guides/uncertain-effects/record-template.json",
        "record_template_markdown": "/guides/uncertain-effects/record-template.md"
      },
      "offline_paths_from_pack_root": {
        "markdown": "guides/uncertain-effects/guide.md",
        "json": "guides/uncertain-effects/guide.json",
        "record_template_json": "guides/uncertain-effects/record-template.json",
        "record_template_markdown": "guides/uncertain-effects/record-template.md"
      },
      "reading_paths": {
        "note": "Stop here if the current task’s acceptance requirements are satisfied and no unresolved obligation remains. If neither condition applies, no follow-on guide is suggested here; keep any unresolved task state visible. These are optional reading suggestions, not permission or a requirement to expand scope.",
        "options": [
          {
            "guide_id": "durable-handoffs",
            "when": "The operation is reconciled and its result needs to survive the next handoff.",
            "purpose": "Preserve the exact receipt, output and any remaining limits in the approved store.",
            "title": "Make the handoff survive the session",
            "local_paths": {
              "html": "/guides/durable-handoffs/",
              "markdown": "/guides/durable-handoffs/guide.md",
              "json": "/guides/durable-handoffs/guide.json"
            },
            "offline_paths_from_pack_root": {
              "markdown": "guides/durable-handoffs/guide.md",
              "json": "guides/durable-handoffs/guide.json"
            }
          },
          {
            "guide_id": "autonomous-business-boundaries",
            "when": "Within a delegated business workflow, nobody is clearly authorized to resolve the uncertainty or approve a materially changed action.",
            "purpose": "Clarify the owner and scope before attempting another consequential step.",
            "title": "Draw the boundary before delegating the business",
            "local_paths": {
              "html": "/guides/autonomous-business-boundaries/",
              "markdown": "/guides/autonomous-business-boundaries/guide.md",
              "json": "/guides/autonomous-business-boundaries/guide.json"
            },
            "offline_paths_from_pack_root": {
              "markdown": "guides/autonomous-business-boundaries/guide.md",
              "json": "guides/autonomous-business-boundaries/guide.json"
            }
          }
        ]
      },
      "discovery": {
        "title": "AI agent retries: check uncertain tool outcomes first",
        "description": "A proposed worksheet for AI-agent retries after tool timeouts: distinguish unknown outcomes from failures before repeating a message, payment or other external effect."
      }
    },
    {
      "id": "useful-memory",
      "title": "Keep memory useful without losing the rules",
      "category": "Continuity",
      "applies_when": "A long-running agent is preparing a handoff or approaching a context limit.",
      "skip_when": "A short, current context already supports the next action. Rewriting healthy notes can add risk without benefit.",
      "evidence": "Proposed worksheet",
      "build_revision": "release-2026-11-11-r12",
      "scope_label": "Long-running agent context and handoffs",
      "search_terms": [
        "context",
        "memory",
        "compaction",
        "summary",
        "handoff",
        "continuity",
        "summaries",
        "instructions",
        "context window"
      ],
      "html": "https://www.aomsites.com/guides/useful-memory/",
      "markdown": "https://www.aomsites.com/guides/useful-memory/guide.md",
      "json": "https://www.aomsites.com/guides/useful-memory/guide.json",
      "local_paths": {
        "html": "/guides/useful-memory/",
        "markdown": "/guides/useful-memory/guide.md",
        "json": "/guides/useful-memory/guide.json",
        "record_template_json": "/guides/useful-memory/record-template.json",
        "record_template_markdown": "/guides/useful-memory/record-template.md"
      },
      "offline_paths_from_pack_root": {
        "markdown": "guides/useful-memory/guide.md",
        "json": "guides/useful-memory/guide.json",
        "record_template_json": "guides/useful-memory/record-template.json",
        "record_template_markdown": "guides/useful-memory/record-template.md"
      },
      "reading_paths": {
        "note": "Stop here if the current task’s acceptance requirements are satisfied and no unresolved obligation remains. If neither condition applies, no follow-on guide is suggested here; keep any unresolved task state visible. These are optional reading suggestions, not permission or a requirement to expand scope.",
        "options": [
          {
            "guide_id": "durable-handoffs",
            "when": "The note points to a deliverable that is still only in the working session.",
            "purpose": "Save and verify the actual artifact; a summary is not a durable copy.",
            "title": "Make the handoff survive the session",
            "local_paths": {
              "html": "/guides/durable-handoffs/",
              "markdown": "/guides/durable-handoffs/guide.md",
              "json": "/guides/durable-handoffs/guide.json"
            },
            "offline_paths_from_pack_root": {
              "markdown": "guides/durable-handoffs/guide.md",
              "json": "guides/durable-handoffs/guide.json"
            }
          },
          {
            "guide_id": "review-agent-skills",
            "when": "A demonstrated recurring handoff problem suggests a reusable instruction package might help.",
            "purpose": "Check task fit and the current baseline before turning the procedure into a skill.",
            "title": "Review a skill before adding it",
            "local_paths": {
              "html": "/guides/review-agent-skills/",
              "markdown": "/guides/review-agent-skills/guide.md",
              "json": "/guides/review-agent-skills/guide.json"
            },
            "offline_paths_from_pack_root": {
              "markdown": "guides/review-agent-skills/guide.md",
              "json": "guides/review-agent-skills/guide.json"
            }
          }
        ]
      },
      "discovery": {
        "title": "AI agent memory: preserve context, evidence and constraints",
        "description": "A proposed worksheet for long-running AI-agent memory and handoffs: retain decision-relevant state, retrievable evidence and current constraints without rewriting healthy notes."
      }
    },
    {
      "id": "review-agent-skills",
      "title": "Review a skill before adding it",
      "category": "Methods",
      "applies_when": "You are considering a reusable instruction package or updating one already used by an agent.",
      "skip_when": "The current workflow already meets the task requirements with no repeated failure. Keep the free, competent baseline in the comparison.",
      "evidence": "Proposed worksheet",
      "build_revision": "release-2026-11-11-r12",
      "scope_label": "Adding or updating reusable agent skills",
      "search_terms": [
        "skills",
        "skill",
        "install",
        "package",
        "review",
        "provenance",
        "compatibility"
      ],
      "html": "https://www.aomsites.com/guides/review-agent-skills/",
      "markdown": "https://www.aomsites.com/guides/review-agent-skills/guide.md",
      "json": "https://www.aomsites.com/guides/review-agent-skills/guide.json",
      "local_paths": {
        "html": "/guides/review-agent-skills/",
        "markdown": "/guides/review-agent-skills/guide.md",
        "json": "/guides/review-agent-skills/guide.json",
        "record_template_json": "/guides/review-agent-skills/record-template.json",
        "record_template_markdown": "/guides/review-agent-skills/record-template.md"
      },
      "offline_paths_from_pack_root": {
        "markdown": "guides/review-agent-skills/guide.md",
        "json": "guides/review-agent-skills/guide.json",
        "record_template_json": "guides/review-agent-skills/record-template.json",
        "record_template_markdown": "guides/review-agent-skills/record-template.md"
      },
      "reading_paths": {
        "note": "Stop here if the current task’s acceptance requirements are satisfied and no unresolved obligation remains. If neither condition applies, no follow-on guide is suggested here; keep any unresolved task state visible. These are optional reading suggestions, not permission or a requirement to expand scope.",
        "options": [
          {
            "guide_id": "measure-agent-improvement",
            "when": "A candidate fits a documented problem, but its benefit over the current workflow is still unmeasured.",
            "purpose": "Define a bounded comparison before deciding to adopt it.",
            "title": "Measure improvement in accepted results",
            "local_paths": {
              "html": "/guides/measure-agent-improvement/",
              "markdown": "/guides/measure-agent-improvement/guide.md",
              "json": "/guides/measure-agent-improvement/guide.json"
            },
            "offline_paths_from_pack_root": {
              "markdown": "guides/measure-agent-improvement/guide.md",
              "json": "guides/measure-agent-improvement/guide.json"
            }
          },
          {
            "guide_id": "durable-handoffs",
            "when": "An approved trial needs its inputs, prior version and results preserved for review or recovery.",
            "purpose": "Keep the exact versions recoverable without treating a saved package as launch approval.",
            "title": "Make the handoff survive the session",
            "local_paths": {
              "html": "/guides/durable-handoffs/",
              "markdown": "/guides/durable-handoffs/guide.md",
              "json": "/guides/durable-handoffs/guide.json"
            },
            "offline_paths_from_pack_root": {
              "markdown": "guides/durable-handoffs/guide.md",
              "json": "guides/durable-handoffs/guide.json"
            }
          }
        ]
      },
      "discovery": {
        "title": "Review AI agent skills before installing or updating them",
        "description": "A proposed worksheet for reviewing reusable AI-agent skills: inspect provenance, task fit, compatibility and the existing baseline before adding another method."
      }
    },
    {
      "id": "measure-agent-improvement",
      "title": "Measure improvement in accepted results",
      "category": "Methods",
      "applies_when": "You want to change instructions, models, tools or workflow structure to improve an agent’s work.",
      "skip_when": "There is no defined task or quality contract yet. First make the desired outcome inspectable.",
      "evidence": "Proposed worksheet",
      "build_revision": "release-2026-11-11-r12",
      "scope_label": "Comparing a proposed change with the baseline",
      "search_terms": [
        "benchmark",
        "evaluation",
        "cost",
        "tokens",
        "latency",
        "experiment",
        "optimization",
        "performance"
      ],
      "html": "https://www.aomsites.com/guides/measure-agent-improvement/",
      "markdown": "https://www.aomsites.com/guides/measure-agent-improvement/guide.md",
      "json": "https://www.aomsites.com/guides/measure-agent-improvement/guide.json",
      "local_paths": {
        "html": "/guides/measure-agent-improvement/",
        "markdown": "/guides/measure-agent-improvement/guide.md",
        "json": "/guides/measure-agent-improvement/guide.json",
        "record_template_json": "/guides/measure-agent-improvement/record-template.json",
        "record_template_markdown": "/guides/measure-agent-improvement/record-template.md"
      },
      "offline_paths_from_pack_root": {
        "markdown": "guides/measure-agent-improvement/guide.md",
        "json": "guides/measure-agent-improvement/guide.json",
        "record_template_json": "guides/measure-agent-improvement/record-template.json",
        "record_template_markdown": "guides/measure-agent-improvement/record-template.md"
      },
      "reading_paths": {
        "note": "Stop here if the current task’s acceptance requirements are satisfied and no unresolved obligation remains. If neither condition applies, no follow-on guide is suggested here; keep any unresolved task state visible. These are optional reading suggestions, not permission or a requirement to expand scope.",
        "options": [
          {
            "guide_id": "review-agent-skills",
            "when": "The comparison identifies recurring instruction work and you are considering a reusable package for it.",
            "purpose": "Review the smallest relevant package instead of installing a broader workflow by default.",
            "title": "Review a skill before adding it",
            "local_paths": {
              "html": "/guides/review-agent-skills/",
              "markdown": "/guides/review-agent-skills/guide.md",
              "json": "/guides/review-agent-skills/guide.json"
            },
            "offline_paths_from_pack_root": {
              "markdown": "guides/review-agent-skills/guide.md",
              "json": "guides/review-agent-skills/guide.json"
            }
          },
          {
            "guide_id": "uncertain-effects",
            "when": "An interrupted trial may have produced an external effect whose outcome is still unknown.",
            "purpose": "Resolve the effect before retrying; do not silently omit it from the comparison.",
            "title": "Check the outcome before retrying",
            "local_paths": {
              "html": "/guides/uncertain-effects/",
              "markdown": "/guides/uncertain-effects/guide.md",
              "json": "/guides/uncertain-effects/guide.json"
            },
            "offline_paths_from_pack_root": {
              "markdown": "guides/uncertain-effects/guide.md",
              "json": "guides/uncertain-effects/guide.json"
            }
          }
        ]
      },
      "discovery": {
        "title": "Evaluate AI agents by accepted results and review cost",
        "description": "A proposed worksheet for evaluating an AI-agent change against a competent baseline: count accepted outputs, owner review, repair and recovery, not just token use."
      }
    },
    {
      "id": "autonomous-business-boundaries",
      "title": "Draw the boundary before delegating the business",
      "category": "Operations",
      "applies_when": "You are exploring an agent-run business workflow or an AI executive that coordinates other agents.",
      "skip_when": "The proposed job is a small read-only task. Use the lighter contract that actually fits it.",
      "evidence": "Proposed worksheet",
      "build_revision": "release-2026-11-11-r12",
      "scope_label": "Delegated business operations",
      "search_terms": [
        "AI CEO",
        "business",
        "operations",
        "executive",
        "authority",
        "spending",
        "approval"
      ],
      "html": "https://www.aomsites.com/guides/autonomous-business-boundaries/",
      "markdown": "https://www.aomsites.com/guides/autonomous-business-boundaries/guide.md",
      "json": "https://www.aomsites.com/guides/autonomous-business-boundaries/guide.json",
      "local_paths": {
        "html": "/guides/autonomous-business-boundaries/",
        "markdown": "/guides/autonomous-business-boundaries/guide.md",
        "json": "/guides/autonomous-business-boundaries/guide.json",
        "record_template_json": "/guides/autonomous-business-boundaries/record-template.json",
        "record_template_markdown": "/guides/autonomous-business-boundaries/record-template.md"
      },
      "offline_paths_from_pack_root": {
        "markdown": "guides/autonomous-business-boundaries/guide.md",
        "json": "guides/autonomous-business-boundaries/guide.json",
        "record_template_json": "guides/autonomous-business-boundaries/record-template.json",
        "record_template_markdown": "guides/autonomous-business-boundaries/record-template.md"
      },
      "reading_paths": {
        "note": "Stop here if the current task’s acceptance requirements are satisfied and no unresolved obligation remains. If neither condition applies, no follow-on guide is suggested here; keep any unresolved task state visible. These are optional reading suggestions, not permission or a requirement to expand scope.",
        "options": [
          {
            "guide_id": "uncertain-effects",
            "when": "A permitted consequential action has an uncertain result.",
            "purpose": "Reconcile the specific operation while preserving its current approval limits.",
            "title": "Check the outcome before retrying",
            "local_paths": {
              "html": "/guides/uncertain-effects/",
              "markdown": "/guides/uncertain-effects/guide.md",
              "json": "/guides/uncertain-effects/guide.json"
            },
            "offline_paths_from_pack_root": {
              "markdown": "guides/uncertain-effects/guide.md",
              "json": "guides/uncertain-effects/guide.json"
            }
          },
          {
            "guide_id": "measure-agent-improvement",
            "when": "One bounded workflow has clear authority and acceptance rules, and you need to decide whether a change helps.",
            "purpose": "Compare accepted outcomes against a competent baseline before expanding the operation.",
            "title": "Measure improvement in accepted results",
            "local_paths": {
              "html": "/guides/measure-agent-improvement/",
              "markdown": "/guides/measure-agent-improvement/guide.md",
              "json": "/guides/measure-agent-improvement/guide.json"
            },
            "offline_paths_from_pack_root": {
              "markdown": "guides/measure-agent-improvement/guide.md",
              "json": "guides/measure-agent-improvement/guide.json"
            }
          }
        ]
      },
      "discovery": {
        "title": "AI agent delegation: define business authority and limits",
        "description": "A proposed worksheet for delegated AI business operations: define the owner, allowed actions, approval boundaries and stop conditions before delegating work."
      }
    }
  ],
  "sample": {
    "id": "sample-001",
    "status": "preview_sample",
    "html": "https://www.aomsites.com/sample/",
    "json": "https://www.aomsites.com/sample/sample.json",
    "markdown": "https://www.aomsites.com/sample/sample.md",
    "local_paths": {
      "html": "/sample/",
      "markdown": "/sample/sample.md",
      "json": "/sample/sample.json",
      "decision_record": "/sample/decision-record.json"
    },
    "offline_paths_from_pack_root": {
      "markdown": "sample/sample.md",
      "json": "sample/sample.json",
      "decision_record": "sample/decision-record.json"
    }
  },
  "decision_record": {
    "local_html": "/decision-record/",
    "local_template": "/decision-record/template.json",
    "offline_template_from_pack_root": "decision-record/template.json",
    "offline_example_from_pack_root": "decision-record/example.json",
    "example_status": "fictional_illustration",
    "schema_version": "1.1",
    "local_schema": "/schemas/decision-record.schema.json",
    "local_checker": "/tools/check_record.py",
    "offline_schema_from_pack_root": "schemas/decision-record.schema.json",
    "offline_checker_from_pack_root": "tools/check_record.py",
    "offline_integrity_manifest_from_pack_root": "reading-pack-manifest.json",
    "examples": [
      {
        "decision": "accept",
        "recommendation": "keep",
        "record_type": "fictional_illustration",
        "local_paths": {
          "html": "/sample/",
          "json": "/sample/decision-record.json"
        },
        "offline_paths_from_pack_root": {
          "json": "sample/decision-record.json"
        }
      },
      {
        "decision": "unknown",
        "recommendation": "investigate",
        "record_type": "fictional_illustration",
        "local_paths": {
          "html": "/decision-record/#unknown-example",
          "json": "/decision-record/example.json",
          "markdown": "/decision-record/example.md"
        },
        "offline_paths_from_pack_root": {
          "json": "decision-record/example.json",
          "markdown": "decision-record/example.md"
        }
      },
      {
        "decision": "reject",
        "recommendation": "change",
        "record_type": "fictional_illustration",
        "local_paths": {
          "html": "/decision-record/#rejected-example",
          "json": "/decision-record/rejected-example.json",
          "markdown": "/decision-record/rejected-example.md"
        },
        "offline_paths_from_pack_root": {
          "json": "decision-record/rejected-example.json",
          "markdown": "decision-record/rejected-example.md"
        }
      }
    ]
  },
  "resolution": {
    "canonical_urls": "Production identity only. Not proof of live availability.",
    "local_paths": "Resolve against the current HTTP origin for local previews.",
    "offline_paths_from_pack_root": "Resolve from the extracted reading-pack root. Open offline/index.html in a browser, or use Markdown and JSON paths."
  },
  "offline_integrity_manifest_from_pack_root": "reading-pack-manifest.json",
  "offline_reader_from_pack_root": "offline/index.html",
  "record_checker": {
    "version": "1.2.0",
    "record_schema": "1.1",
    "local_path": "/tools/check_record.py",
    "offline_path_from_pack_root": "tools/check_record.py",
    "usage_from_pack_root": "decision-record/checker.md",
    "scope": "Record structure and consistency; optional explicit local guide/content/manifest comparison.",
    "execution": "Optional, user-controlled local Python. No automatic execution, network requests or file changes.",
    "authenticity_or_action_authorization": false
  }
}