Skip to main content

:::warning AUTO-GENERATED — do not edit This page is generated from the MCP server snapshot content/backend-mcp.json. Edit the source MCP server (not this file), then run npm run generate. :::

Run the backend verify gate before declaring done

When to use: You believe a backend task is finished and want to confirm it before reporting done.

Prerequisites​

  • All intended code + tests are written.

Steps​

Step 1: Re-validate every new/changed route against the codebase.​

Tools: validate_backend_endpoint

Step 2: Re-read the guardrails and confirm no banned pattern was introduced.​

Tools: get_backend_guardrails

Step 3: Run the backend verify gate (lint + typecheck + tests) and fix any failures.​

Step 4: Only report done once the gate is fully green.​

Full recipe definition​

The complete machine-readable recipe as returned by the MCP server:

{
  "id": "run-verify",
  "title": "Run the backend verify gate before declaring done",
  "when": "You believe a backend task is finished and want to confirm it before reporting done.",
  "prerequisites": [
    "All intended code + tests are written."
  ],
  "steps": [
    {
      "action": "Re-validate every new/changed route against the codebase.",
      "tools": [
        "validate_backend_endpoint"
      ],
      "note": "A failed result means STOP and fix — do not declare done."
    },
    {
      "action": "Re-read the guardrails and confirm no banned pattern was introduced.",
      "tools": [
        "get_backend_guardrails"
      ],
      "note": "Check auth via JWKS, wrapper-based DB access, structured logging, one-endpoint-per-chart."
    },
    {
      "action": "Run the backend verify gate (lint + typecheck + tests) and fix any failures.",
      "note": "Run the project's verify command; pytest and lint must be green. Do not suppress errors (no bare excepts to hide failures)."
    },
    {
      "action": "Only report done once the gate is fully green.",
      "note": "A hallucinated wrapper/logger/DB call surfaces here as an import or test error — fix it, don't ignore it."
    }
  ],
  "filesToCreate": [],
  "validation": [
    "`validate_backend_endpoint` passes for all changed routes.",
    "Lint, typecheck, and pytest are all green."
  ],
  "doneCriteria": [
    "The verify gate passes with zero errors.",
    "No guardrail is violated."
  ],
  "commonMistakes": [
    "Declaring done without running the gate.",
    "Suppressing errors instead of fixing them.",
    "Skipping re-validation of the final routes."
  ],
  "relatedRecipes": [
    "create-endpoint",
    "add-auth-guard",
    "wire-db-read",
    "wire-db-write",
    "add-tests"
  ]
}