{
  "objective": "Align README, package skill, graph cookbook, examples, and tests after an implemented contract change.",
  "library": {
    "sources": [
      "package"
    ]
  },
  "authority": {
    "allowFilesystemRead": true,
    "allowShellTools": true,
    "allowMutationTools": true
  },
  "steps": [
    {
      "id": "surface-map",
      "agent": {
        "ref": "package:scout"
      },
      "task": "Map the human-facing README/cookbook/examples, model-facing skill/tool copy, package metadata, and validation checks affected by the implemented change. Return exact paths and mismatch risks."
    },
    {
      "id": "docs-editor",
      "agent": {
        "ref": "package:worker"
      },
      "needs": [
        "surface-map"
      ],
      "mutationScope": "REPLACE before start. Allowed files/globs: <exact docs/examples/tests paths>. Allowed mutation class: <specific docs/examples/tests edit type>. Explicit exclusions: <paths/actions not allowed>. Validation commands authorized: <exact commands or none>. Stop if broader than current parent authorization. mutationScope is not a sandbox; bash/edit/write are not path-confined, so stop rather than touch anything outside this authorization.",
      "task": "Update only the affected docs, examples, and directly affected docs/example tests or fixtures so they describe implemented behavior. If mutationScope is still a placeholder, missing, or broader than the parent authorization, do not edit and return the mismatches and blocker. Keep README, cookbook, and examples human-facing; keep the skill/tool/result microcopy model-facing. Do not edit runtime code. Return changed paths and rationale."
    },
    {
      "id": "validation-review",
      "agent": {
        "ref": "package:validator"
      },
      "needs": [
        "docs-editor"
      ],
      "task": "Validation command scope copied by parent: REPLACE_WITH_EXACT_DOCS_EXAMPLES_VALIDATION_COMMANDS. Run only those commands. If this placeholder remains, no commands are present, or scope is implied only by upstream evidence, return needs-command-scope without running commands. Candidate docs/example checks may include `node --no-warnings --experimental-strip-types --loader ./tests/pi-peer-loader.mjs --test tests/examples.test.ts` and `node --experimental-strip-types tests/check-public-docs.ts` only when the parent copied them here. Do not edit. Return pass/fail/deferred with exact commands and remaining mismatch risk."
    },
    {
      "id": "alignment-summary",
      "agent": {
        "ref": "package:synthesizer"
      },
      "after": [
        "surface-map",
        "docs-editor",
        "validation-review"
      ],
      "task": "Summarize human-facing README/cookbook/example actions, model-facing skill/tool/result-copy actions, example/test actions, validation status, and residual risk after all lanes terminalize, including failed or blocked lane evidence."
    }
  ],
  "limits": {
    "concurrency": 1,
    "timeoutSecondsPerStep": 9000
  }
}