Open format

Permutia for developers

A ranking is a JSON array of exactly 10 objects, strongest first. Each object has a title and a description. No wrapper object, no Markdown fences, and no outbound links. That is the Permutia Open Format: the same contract our generate API, crawlers, and paste-into-ChatGPT workflow share.

Rank is implied by array order. Index 0 is #1.
Titles are real, specific things. Descriptions are one sentence.
Agents should read /llms.txt.

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://permutia.app/schema/ranking.json",
  "title": "Permutia Ranking",
  "description": "Exactly ten ranked items, strongest first. A JSON array, not an object wrapper.",
  "type": "array",
  "minItems": 10,
  "maxItems": 10,
  "items": {
    "type": "object",
    "additionalProperties": false,
    "required": [
      "title",
      "description"
    ],
    "properties": {
      "title": {
        "type": "string",
        "minLength": 1,
        "description": "A real, specific, verifiable thing. Not a category or a placeholder."
      },
      "description": {
        "type": "string",
        "minLength": 1,
        "description": "One concise sentence explaining why this item holds this rank."
      }
    }
  }
}

Prompt scaffold

You are generating a ranking for Permutia.

Topic: {{TOPIC}}

Follow the Permutia Open Format exactly:

1. Return exactly 10 items ranked from strongest (#1) to weakest (#10).
2. Output a JSON array only. Do not wrap the array in an object. Do not use Markdown code fences.
3. Each object must include string keys "title" and "description". Do not include a "url" or any outbound link.
4. Every title must be a real, specific, verifiable thing rather than a category.
5. Every description must be one concise sentence explaining the rank.
6. Do not repeat entries. Do not add commentary, headings, or markdown outside the JSON array.

JSON Schema:
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://permutia.app/schema/ranking.json",
  "title": "Permutia Ranking",
  "description": "Exactly ten ranked items, strongest first. A JSON array, not an object wrapper.",
  "type": "array",
  "minItems": 10,
  "maxItems": 10,
  "items": {
    "type": "object",
    "additionalProperties": false,
    "required": [
      "title",
      "description"
    ],
    "properties": {
      "title": {
        "type": "string",
        "minLength": 1,
        "description": "A real, specific, verifiable thing. Not a category or a placeholder."
      },
      "description": {
        "type": "string",
        "minLength": 1,
        "description": "One concise sentence explaining why this item holds this rank."
      }
    }
  }
}

Replace {{TOPIC}} with the ranking topic, then paste this prompt into ChatGPT, Claude, or Gemini.

Replace {{TOPIC}} in the scaffold, then paste it into ChatGPT, Claude, or Gemini. The model should return a bare JSON array this site can ingest.