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
- Create the file — If intended as a real deliverable for MCP organization and plugin configuration
- 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)
Problem
CLAUDE.mdline 42 references a file that does not exist in the repository: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.mdline 42Reference:
mcp-categories.json: Canonical MCP category definitions shared across pluginsActual status: File does not exist anywhere in the repo
Resolution Options
If creating the file, see issue #298 for proposed schema (standardized MCP metadata with categories, auth, required/optional flags, and skill bindings).
Impact