{
  "version": "2",
  "generatedAt": "2026-11-03T23:31:18.850Z",
  "source": "CONTEXT.md is the glossary. Each term's Avoid list is published here as synonyms so an agent can map a user's words to ours.",
  "glossary": {
    "Listing": {
      "definition": "One entry in the directory, describing one piece of software in one form factor. The unit of the directory.",
      "synonyms": [
        "App",
        "product",
        "tool",
        "template",
        "entry"
      ]
    },
    "Adaptable": {
      "definition": "A capability of a Listing: the software still needs adapting to the Adopter's use case, and its source is available to adapt. Requires a Repo and a Customization surface.",
      "synonyms": [
        "Side A",
        "template",
        "starter",
        "90% app"
      ]
    },
    "Operable": {
      "definition": "A capability of a Listing: the software is ready as-is and an agent can drive it through an interface. Does not require a Repo.",
      "synonyms": [
        "Side B",
        "agent-first app",
        "agent-native app",
        "AI app"
      ]
    },
    "Skill": {
      "definition": "A Listing whose deliverable is only SKILL.md and prompt files, with no app, server, or CLI of its own. Always tagged as its own shape, never folded into apps or MCP servers. Software that ships skills alongside an app is not a Skill.",
      "synonyms": [
        "Prompt pack",
        "plugin",
        "agent",
        "skill-or-mcp"
      ]
    },
    "Repo": {
      "definition": "The public source repository backing a Listing, on any git host: GitHub, GitLab, Codeberg, a self-hosted Forgejo, or another. A Listing is that git remote plus our record (adr/0011). Required when the Listing is Adaptable, optional otherwise.",
      "synonyms": [
        "Source",
        "codebase",
        "project"
      ]
    },
    "Provenance": {
      "definition": "How the software was written: vibe-coded, human-written, or mixed. Recorded on every Listing, never a condition of inclusion and never used for ranking.",
      "synonyms": [
        "Vibe-coded",
        "AI-built"
      ]
    },
    "Customization surface": {
      "definition": "The named env vars, config files, and prompt files an Adopter edits to adapt an Adaptable Listing, plus the Builder's account of what to change.",
      "synonyms": [
        "Config",
        "settings",
        "the ten percent"
      ]
    },
    "Effort": {
      "definition": "How much work it is to adapt an Adaptable Listing: config-only, light-edit, or fork-and-modify. Exists only when a Customization surface exists.",
      "synonyms": [
        "Difficulty",
        "complexity",
        "work level"
      ]
    },
    "Operability": {
      "definition": "How an agent can drive an Operable Listing, in five levels: native (built for the agent as the primary interface), official (the Builder ships an agent interface), wrapped (a third party wraps the software's API), config (an agent can only drive it by editing files), gui (screen control only). An interface is official only when it is published by the same organization that ships the software. GUI-level Listings are allowed and sorted last.",
      "synonyms": [
        "Has an MCP server",
        "agent-ready",
        "AI-enabled",
        "integration level"
      ]
    },
    "Recommended wrapper": {
      "definition": "The one third-party interface the Curator names for a wrapped Listing, chosen by maintenance recency, then breadth of the interface, then stars. The runner-up is recorded so the choice is auditable.",
      "synonyms": [
        "Best wrapper",
        "default MCP",
        "the MCP server"
      ]
    },
    "Reach": {
      "definition": "The list of jobs an Operable Listing's software does, each marked reachable or not through the stated interface. Coverage (complete or partial) is derived from Reach, never set by hand. The unreachable jobs are as visible as the reachable ones.",
      "synonyms": [
        "Coverage",
        "agent support",
        "feature parity",
        "integration depth"
      ]
    },
    "Vertical": {
      "definition": "The business area a Listing serves, from a controlled list (content publishing, ecommerce, notes and knowledge, invoicing and finance, SMB ops and CRM, support and bookkeeping, scheduling and staffing, video and streaming). A find that fits none is `unassigned` until the Curator opens a vertical. Opening one is a decision recorded in an ADR.",
      "synonyms": [
        "Category",
        "industry",
        "tag",
        "niche"
      ]
    },
    "Alternative to": {
      "definition": "The commercial products a Listing replaces, named plainly (\"Notion\", \"Zapier\"). Recorded because that is how Adopters and agents actually search; never used to rank.",
      "synonyms": [
        "Competitor",
        "clone",
        "killer",
        "open-source X"
      ]
    },
    "Find": {
      "definition": "A candidate at the sourcing stage: a URL, where it was seen (platform, account, date), and one line on why it might fit. Anyone can file one; an agent turns it into a sourcing record. Nothing else is known yet.",
      "synonyms": [
        "Lead",
        "submission",
        "suggestion"
      ]
    },
    "Decision": {
      "definition": "A recorded verdict on a Find that will not go further for now: `held` (passes the gates but no vertical fits, or a product call is pending) or `rejected` (fails a gate or the Curator declines on editorial grounds), with the reason and date. Exists so the same software is not reevaluated from scratch.",
      "synonyms": [
        "Blacklist",
        "backlog",
        "parked"
      ]
    },
    "Edition": {
      "definition": "One way a Listing's software is offered: free or priced, open or closed source, with its own distribution. A Listing has one or more Editions. Open-core software is one Listing with a free open Edition and a priced closed one.",
      "synonyms": [
        "Tier",
        "plan",
        "paid version",
        "pro version",
        "SKU"
      ]
    },
    "Builder": {
      "definition": "The person or organization that made the software and owns its Repo or interface. Lists, claims, and confirms.",
      "synonyms": [
        "Owner",
        "vendor",
        "developer",
        "author",
        "maker"
      ]
    },
    "Adopter": {
      "definition": "The person who pulls an Adaptable Listing to adapt it, or points an agent at an Operable one. An agency adapting software for a client and a power user driving software from a coding agent are both Adopters.",
      "synonyms": [
        "User",
        "customer",
        "client",
        "buyer",
        "agency",
        "power user"
      ]
    },
    "Curator": {
      "definition": "mothermachine itself, acting as editor: picks among duplicates, attaches gotchas, and approves Listings from the review queue.",
      "synonyms": [
        "Admin",
        "moderator",
        "us"
      ]
    }
  },
  "fields": [
    {
      "name": "capability",
      "definition": "One entry in the directory, describing one piece of software in one form factor. The unit of the directory.",
      "synonyms": [
        "App",
        "product",
        "tool",
        "template",
        "entry"
      ],
      "values": [
        {
          "value": "adaptable",
          "label": "Adaptable",
          "count": 113
        },
        {
          "value": "operable",
          "label": "Operable",
          "count": 117
        }
      ]
    },
    {
      "name": "vertical",
      "values": [
        {
          "value": "content-publishing",
          "label": "Content publishing",
          "count": 16
        },
        {
          "value": "ecommerce",
          "label": "Ecommerce",
          "count": 15
        },
        {
          "value": "invoicing-finance",
          "label": "Invoicing and finance",
          "count": 16
        },
        {
          "value": "notes-knowledge",
          "label": "Notes and knowledge",
          "count": 16
        },
        {
          "value": "scheduling-staffing",
          "label": "Scheduling and staffing",
          "count": 15
        },
        {
          "value": "smb-ops-crm",
          "label": "SMB ops and CRM",
          "count": 16
        },
        {
          "value": "support-bookkeeping",
          "label": "Support and bookkeeping",
          "count": 15
        },
        {
          "value": "video-streaming",
          "label": "Video and streaming",
          "count": 16
        }
      ]
    },
    {
      "name": "shape",
      "values": [
        {
          "value": "agent-workflow",
          "label": "Agent workflow",
          "count": 5
        },
        {
          "value": "business-app",
          "label": "Business app",
          "count": 79
        },
        {
          "value": "internal-tool",
          "label": "Internal tool",
          "count": 3
        },
        {
          "value": "mcp-server",
          "label": "MCP server",
          "count": 2
        },
        {
          "value": "product",
          "label": "Product",
          "count": 30
        },
        {
          "value": "skill",
          "label": "Skill",
          "count": 6
        }
      ]
    },
    {
      "name": "effort",
      "definition": "How much work it is to adapt an Adaptable Listing: config-only, light-edit, or fork-and-modify. Exists only when a Customization surface exists.",
      "synonyms": [
        "Difficulty",
        "complexity",
        "work level"
      ],
      "values": [
        {
          "value": "config-only",
          "label": "Config only",
          "count": 96
        },
        {
          "value": "light-edit",
          "label": "Light edit",
          "count": 16
        },
        {
          "value": "fork-and-modify",
          "label": "Fork and modify",
          "count": 1
        }
      ]
    },
    {
      "name": "operability",
      "definition": "How an agent can drive an Operable Listing, in five levels: native (built for the agent as the primary interface), official (the Builder ships an agent interface), wrapped (a third party wraps the software's API), config (an agent can only drive it by editing files), gui (screen control only). An interface is official only when it is published by the same organization that ships the software. GUI-level Listings are allowed and sorted last.",
      "synonyms": [
        "Has an MCP server",
        "agent-ready",
        "AI-enabled",
        "integration level"
      ],
      "values": [
        {
          "value": "native",
          "label": "Native",
          "count": 17
        },
        {
          "value": "official",
          "label": "Official",
          "count": 95
        },
        {
          "value": "wrapped",
          "label": "Wrapped",
          "count": 2
        },
        {
          "value": "config",
          "label": "Config",
          "count": 1
        },
        {
          "value": "gui",
          "label": "GUI",
          "count": 2
        }
      ]
    },
    {
      "name": "coverage",
      "definition": "The list of jobs an Operable Listing's software does, each marked reachable or not through the stated interface. Coverage (complete or partial) is derived from Reach, never set by hand. The unreachable jobs are as visible as the reachable ones.",
      "synonyms": [
        "Coverage",
        "agent support",
        "feature parity",
        "integration depth"
      ],
      "values": [
        {
          "value": "complete",
          "label": "Complete",
          "count": 10
        },
        {
          "value": "partial",
          "label": "Partial",
          "count": 105
        },
        {
          "value": "none",
          "label": "None",
          "count": 2
        }
      ]
    },
    {
      "name": "interfaceKind",
      "values": [
        {
          "value": "api",
          "label": "API",
          "count": 50
        },
        {
          "value": "cli",
          "label": "CLI",
          "count": 13
        },
        {
          "value": "config",
          "label": "Config files",
          "count": 1
        },
        {
          "value": "gui",
          "label": "Screen only",
          "count": 2
        },
        {
          "value": "mcp",
          "label": "MCP server",
          "count": 50
        },
        {
          "value": "sdk",
          "label": "SDK",
          "count": 1
        }
      ]
    },
    {
      "name": "formFactor",
      "values": [
        {
          "value": "agent",
          "label": "Agent",
          "count": 1
        },
        {
          "value": "api",
          "label": "API / service",
          "count": 11
        },
        {
          "value": "cli",
          "label": "CLI",
          "count": 8
        },
        {
          "value": "desktop",
          "label": "Desktop app",
          "count": 9
        },
        {
          "value": "library",
          "label": "Library",
          "count": 1
        },
        {
          "value": "mcp-server",
          "label": "MCP server",
          "count": 3
        },
        {
          "value": "skill",
          "label": "Skill",
          "count": 6
        },
        {
          "value": "web-app",
          "label": "Web app",
          "count": 85
        },
        {
          "value": "workflow",
          "label": "Workflow",
          "count": 1
        }
      ]
    },
    {
      "name": "executionModel",
      "values": [
        {
          "value": "ai-inferential",
          "label": "AI inferential",
          "count": 1
        },
        {
          "value": "deterministic",
          "label": "Deterministic",
          "count": 81
        },
        {
          "value": "hybrid",
          "label": "Hybrid",
          "count": 43
        }
      ]
    },
    {
      "name": "provenance",
      "definition": "How the software was written: vibe-coded, human-written, or mixed. Recorded on every Listing, never a condition of inclusion and never used for ranking.",
      "synonyms": [
        "Vibe-coded",
        "AI-built"
      ],
      "values": [
        {
          "value": "human-written",
          "label": "Human-written",
          "count": 73
        },
        {
          "value": "mixed",
          "label": "Mixed",
          "count": 17
        },
        {
          "value": "unknown",
          "label": "Unknown",
          "count": 35
        }
      ]
    }
  ],
  "indexes": [
    "index/all.json",
    "index/search.json",
    "index/vertical/content-publishing.json",
    "index/vertical/ecommerce.json",
    "index/vertical/invoicing-finance.json",
    "index/vertical/notes-knowledge.json",
    "index/vertical/scheduling-staffing.json",
    "index/vertical/smb-ops-crm.json",
    "index/vertical/support-bookkeeping.json",
    "index/vertical/video-streaming.json",
    "index/effort/config-only.json",
    "index/effort/light-edit.json",
    "index/effort/fork-and-modify.json",
    "index/operability/native.json",
    "index/operability/official.json",
    "index/operability/wrapped.json",
    "index/operability/config.json",
    "index/operability/gui.json"
  ]
}