config.yaml

# config.yaml — drives the Table of Contents ordering and section layout for the
# generated README.md. This is the ONLY place category / sub-category order is
# defined; generate_readme.py reads it.
#
# Schema:
#   categories:                       # list order == the order sections appear
#     - name: "<Category heading>"    # required; must match the Category column in the CSV
#       description: "<blurb>"        # OPTIONAL; rendered as a line under the ## heading
#       submittable: false            # OPTIONAL (default true); false = curated-only,
#                                     #   omitted from the recommend-resource issue form
#       subcategories:                # OPTIONAL; list order == sub-section order
#         - name: "<Sub-Category>"    # required; must match the Sub-Category column
#           description: "<blurb>"    # OPTIONAL; rendered under the ### heading
#
# Notes:
#   * Within a category / sub-category, individual entries are sorted alphabetically
#     by Display Name (case-insensitive) — that ordering is NOT configurable here.
#   * Entries whose Sub-Category is non-empty but not listed under their category are
#     still rendered (grouped under their sub-category name, after the listed ones).
#   * The recommend-resource issue-form Category dropdown is generated from this file
#     (scripts/sync_issue_form.py, run in pre-commit): every `submittable` category, in
#     order. Never hand-edit that dropdown.

# `prefix` is vestigial. IDs used to be minted as {prefix}-{hash}; they are now
# opaque 8-char hex (see resources/ids.py), so nothing reads this key to build an
# ID. It is still written by `make add-category` and kept unique across categories,
# and the old prefixed IDs in the CSV are grandfathered as-is — but changing a
# prefix here has no effect on anything.
categories:
  - name: "Start Here"
    prefix: start
  - name: "From Anthropic"
    prefix: anthropic
    submittable: false
  - name: "Documentation, Knowledge & Learning"
    prefix: docs
    subcategories:
      - name: "Obsidian"
  - name: "Research & Scientific Inquiry"
    prefix: research
  - name: "Providers, Runtime & Integration Infrastructure"
    prefix: providers
  - name: "Remote Control, Notifications & Voice I/O"
    prefix: remote
  - name: "Alternative Clients"
    prefix: clients
  - name: "Status Lines"
    prefix: statusline
  - name: "Design & UI/UX"
    prefix: design
  - name: "Writing & Prose Quality"
    prefix: writing
  - name: "Creative Media"
    prefix: media
  - name: "Infrastructure & DevOps"
    prefix: devops
  - name: "Security"
    prefix: security
  - name: "Agent Orchestration"
    prefix: orchestration
    subcategories:
      - name: "Ralph Wiggum"
  - name: "Skills"
    prefix: skill
  - name: "Memory & Context Persistence"
    prefix: memory
  - name: "Observability & Monitoring"
    prefix: monitor
    subcategories:
      - name: "Session Monitors"
      - name: "Usage & Cost"
      - name: "Observability"
  - name: "Linting"
    prefix: lint