prompt-atoms-atom-v1

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://prompt-atoms.com/schemas/atom-v1.json",
  "title": "prompt-atoms v1 atom",
  "description": "A single atom in the prompt-atoms catalog. Discriminated by the top-level `type` field; one of: persona, constraint, format-instruction, tool-use-template, refusal-pattern, output-schema.",
  "type": "object",
  "required": ["schema", "type", "id", "version", "name", "content"],
  "additionalProperties": false,
  "properties": {
    "schema": {
      "type": "string",
      "const": "https://prompt-atoms.com/schemas/atom-v1.json"
    },
    "type": {
      "type": "string",
      "enum": ["persona", "constraint", "format-instruction", "tool-use-template", "refusal-pattern", "output-schema"]
    },
    "id": {
      "type": "string",
      "pattern": "^[a-z0-9][a-z0-9-]{1,62}[a-z0-9]$",
      "description": "URL-safe slug; unique within the atom's type."
    },
    "version": {
      "type": "string",
      "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:-[A-Za-z0-9.-]+)?$"
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "description": {
      "type": "string",
      "maxLength": 500
    },
    "tags": {
      "type": "array",
      "items": { "type": "string", "minLength": 1, "maxLength": 40 },
      "uniqueItems": true
    },
    "vendors": {
      "type": "array",
      "items": { "type": "string", "enum": ["claude", "gpt", "llama", "gemini", "mistral", "any"] },
      "uniqueItems": true,
      "description": "LLM families this atom is known to work well with. 'any' means vendor-agnostic."
    },
    "content": {
      "type": "string",
      "minLength": 1,
      "description": "The prompt fragment itself. For atoms with structured content (output-schema, tool-use-template), use the schema or template form; the renderer assembles it into a prompt turn."
    },
    "applicable_turns": {
      "type": "array",
      "items": { "type": "string", "enum": ["system", "user", "assistant", "tool"] },
      "uniqueItems": true,
      "description": "Which turns this atom legally appears in. Defaults to ['system'] for persona/constraint/format-instruction/refusal-pattern; ['tool'] for tool-use-template; ['system','assistant'] for output-schema."
    },
    "see_also": {
      "type": "array",
      "items": { "type": "string", "pattern": "^prompt-atoms://atoms/[a-z-]+/[a-z0-9-]+$" },
      "description": "Sibling atoms commonly composed with this one."
    }
  }
}