{
  "layer": "agent-guide",
  "title": "Route to the right layer for your task",
  "spec": "supercard",
  "version": "3.2.0",
  "era": "atlas",
  "spec_revision": "05290259e680",
  "summary": "The thin router. Read this first if your job is to produce a Supercard. It gives the disclosure protocol and the task → layers map. For the build sequence itself, fetch the pipeline layer; pipeline.data.stages carries Stage 0–5 with do/produce/check/layers_consulted per stage. For terms, fetch glossary. For a worked end-to-end build, fetch example.",
  "source": "00-INDEX/INDEX-supercard-v3.md",
  "provenance": [
    {
      "file": "00-INDEX/INDEX-supercard-v3.md",
      "updated": "2026-05-16",
      "version": "3.2.0",
      "sha256": "4a74b7c244c9055aee8eef0c28d9de8333d3b10aa91de2d4ee36838a1be801f5"
    },
    {
      "file": "10-GOVERNANCE/PIPELINE-card-assembly.md",
      "updated": "2026-05-16",
      "version": "3.2.0",
      "sha256": "2a314451c6684b0d47166da733c60f0c7e0d5b9fbf71c508857890de9dfcef96"
    }
  ],
  "data": {
    "what_is_a_supercard": "A screenshot-shareable, single-emphasis-per-block knowledge artifact built as a cognitive prosthesis for ADHD readers. Every visible region must be self-sufficient: a stranger seeing only a cropped screenshot still gets one complete idea. The format is a grammar, not a length.",
    "disclosure_protocol": [
      "1. The manifest (index.json) lists every layer with its absolute URL in the 'layers' array. Fetch any layer directly from that URL — you are NOT limited to URLs pasted into a chat. If you need a layer, fetch it.",
      "2. You are reading the agent-guide layer. Identify your task, then fetch only the layers it needs (see task_routing below). Do not fetch every layer up front.",
      "3. For the operational build sequence (Stage 0–5), fetch the pipeline layer — its data.stages array carries do/produce/check/layers_consulted per stage. This agent-guide is a router, not the operational manual.",
      "4. Each layer is self-sufficient and carries its own provenance + the full source markdown in doc_markdown.",
      "5. Re-fetch index.json and compare spec_revision before a run if you cached an earlier copy — a changed revision means a source doc moved."
    ],
    "task_routing": {
      "build a card from a topic": [
        "pipeline",
        "grammar",
        "lengths",
        "blocks",
        "tokens",
        "rendering"
      ],
      "style or render a block": [
        "tokens",
        "rendering",
        "blocks"
      ],
      "pick the right block for a section": [
        "grammar",
        "blocks"
      ],
      "judge whether something is a valid Supercard": [
        "principles"
      ],
      "choose a length variant": [
        "lengths",
        "grammar"
      ],
      "look up a term": [
        "glossary"
      ],
      "see a worked end-to-end example": [
        "example"
      ]
    },
    "build_sequence_pointer": "For Stage 0–5 with do/produce/check/layers_consulted, fetch the pipeline layer (data.stages). For constraint gates and identity invariants, fetch pipeline (data.constraint_gates and data.identity_invariants). For the frontmatter contract on breakdowns, cards, and renders, fetch pipeline (data.frontmatter_contract). For the block selection procedure, fetch grammar (data.block_selection_procedure).",
    "canonical_repo": "https://github.com/fiebsy/supercard",
    "note": "This JSON spec is a generated view of the markdown in that repo. The markdown is the source of truth (ADR-0003). To change the spec, change the markdown and regenerate — see _meta.regenerate in index.json."
  },
  "see_also": [
    "pipeline",
    "grammar",
    "glossary",
    "example"
  ],
  "see_also_urls": [
    "https://berafoot.com/spec/pipeline.json",
    "https://berafoot.com/spec/grammar.json",
    "https://berafoot.com/spec/glossary.json",
    "https://berafoot.com/spec/example.json"
  ],
  "mirror_urls": [
    {
      "name": "berafoot",
      "url": "https://berafoot.com/spec/agent-guide.json"
    },
    {
      "name": "vercel",
      "url": "https://supercard-seven.vercel.app/spec/agent-guide.json"
    }
  ]
}