Skip to content

Bug: CLAUDE.md references nonexistent mcp-categories.json file #299

Description

@zaziszaz

Problem

CLAUDE.md line 42 references a file that does not exist in the repository:

- `mcp-categories.json`: Canonical MCP category definitions shared across plugins

This is a dead link in documentation — users following setup instructions or reading the project structure will look for this file and not find it.

Current State

File: CLAUDE.md line 42

Reference: mcp-categories.json: Canonical MCP category definitions shared across plugins

Actual status: File does not exist anywhere in the repo

$ find . -name 'mcp-categories.json' 2>/dev/null
# (no output)

Resolution Options

  1. Create the file — If intended as a real deliverable for MCP organization and plugin configuration
  2. Remove the reference — If this was a planned but abandoned feature

If creating the file, see issue #298 for proposed schema (standardized MCP metadata with categories, auth, required/optional flags, and skill bindings).

Impact

  • Documentation is misleading
  • Users waste time looking for a nonexistent file
  • Undermines project credibility (broken promises in readme)

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions