Skip to content

docs: fix 27 stale claims found in documentation audit#3637

Merged
jqnatividad merged 2 commits into
masterfrom
docs-mcp-audit-20260322
Mar 22, 2026
Merged

docs: fix 27 stale claims found in documentation audit#3637
jqnatividad merged 2 commits into
masterfrom
docs-mcp-audit-20260322

Conversation

@jqnatividad

Copy link
Copy Markdown
Collaborator
  • Update 7 files with stale version 17.0.0 → 18.0.0
  • Update 5 files with stale component counts (3/6/2 → 5/8/3 skills/commands/agents)
  • Update 6 files with stale command counts (68/60 → 70/62 for qsv/qsvmcp)
  • Update 2 project structure trees (add 6 missing src files, fix cowork-setup.cjs)
  • Fix SKILLS_API.md category table (remove non-existent grep/apply/flatten/to skills)
  • Fix emoji conventions in skills/CLAUDE.md to show actual emoji prefixes
  • Add undocumented QSV_MCP_ENABLE_APPS to ENVIRONMENT_VARIABLES.md
  • Fix plugin.json description count (52 → 51 skill-based commands)
  • Fix completions/CLAUDE.md count (66 → 69, remove non-existent generate command)

- Update 7 files with stale version 17.0.0 → 18.0.0
- Update 5 files with stale component counts (3/6/2 → 5/8/3 skills/commands/agents)
- Update 6 files with stale command counts (68/60 → 70/62 for qsv/qsvmcp)
- Update 2 project structure trees (add 6 missing src files, fix cowork-setup.cjs)
- Fix SKILLS_API.md category table (remove non-existent grep/apply/flatten/to skills)
- Fix emoji conventions in skills/CLAUDE.md to show actual emoji prefixes
- Add undocumented QSV_MCP_ENABLE_APPS to ENVIRONMENT_VARIABLES.md
- Fix plugin.json description count (52 → 51 skill-based commands)
- Fix completions/CLAUDE.md count (66 → 69, remove non-existent generate command)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates multiple documentation and guidance files to reflect the current qsv/qsvmcp + MCP ecosystem (version bump to 18.0.0, refreshed component/tool/command counts, corrected skills tables, and newly documented MCP env var).

Changes:

  • Refreshes version references (17.0.0 → 18.0.0) across docs.
  • Updates stated counts for skills/commands/agents and corrects skills category listings and emoji conventions.
  • Documents QSV_MCP_ENABLE_APPS and updates MCP/extension/plugin docs accordingly.

Reviewed changes

Copilot reviewed 16 out of 16 changed files in this pull request and generated 5 comments.

Show a summary per file
File Description
docs/PERFORMANCE.md Updates example qsv --version output and narrative to 18.0.0.
docs/ENVIRONMENT_VARIABLES.md Adds QSV_MCP_ENABLE_APPS documentation.
contrib/completions/CLAUDE.md Updates completions command-count statement.
.serena/memories/codebase_structure.md Updates MCP-related component counts in the structure tree.
.claude/skills/docs/reference/UPDATE_SYSTEM.md Updates reference doc version to 18.0.0.
.claude/skills/docs/reference/SKILLS_API.md Fixes category table to remove non-existent skills and add current ones.
.claude/skills/docs/reference/AUTO_UPDATE.md Updates reference doc version to 18.0.0.
.claude/skills/docs/guides/WINDOWS_SETUP.md Updates Cowork plugin component counts and subagent list.
.claude/skills/docs/guides/START_HERE.md Updates qsvmcp command count claim in the “Two Pieces” table.
.claude/skills/docs/guides/MACOS_SETUP.md Updates Cowork plugin component counts and subagent list.
.claude/skills/docs/guides/CLAUDE_CODE.md Updates minimum expected qsv version in setup instructions.
.claude/skills/docs/desktop/README-MCPB.md Updates qsv/qsvmcp command count claims throughout extension docs.
.claude/skills/README.md Updates repo tree and “What’s Available” tool-count summary.
.claude/skills/README-MCP.md Updates qsvmcp vs qsv command-count claims and related narrative.
.claude/skills/CLAUDE.md Updates emoji conventions and plugin-mode agent count statement.
.claude/skills/.claude-plugin/plugin.json Updates description command count phrasing (52 → 51 skill-based commands).
Comments suppressed due to low confidence (1)

.claude/skills/README-MCP.md:21

  • The docs claim qsvmcp ships with 62 commands and excludes 8 commands, but the source build cargo build --bin qsvmcp -F qsvmcp does not enable the to or ui features, so to and color are also excluded. Based on src/main.rs command gating and the qsvmcp feature set in Cargo.toml, qsvmcp should expose 60 commands (not 62). Please update the counts and excluded-command list (or clarify that release builds enable extra features beyond -F qsvmcp).
The **qsvmcp** binary variant is purpose-built for MCP server use. It includes only the 62 commands needed by the MCP server (vs 70 in the full qsv binary), resulting in a smaller, faster binary.

**Features included in qsvmcp**: Polars, Luau scripting, geocoding, self-update, MCP skill generation (`--update-mcp-skills`), and the `log` command for MCP audit logging.

**Commands excluded from qsvmcp** (not needed for MCP): `apply`, `fetch`, `fetchpost`, `foreach`, `lens`, `prompt`, `python`, and `clipboard` — 8 commands total.

Comment thread .claude/skills/docs/desktop/README-MCPB.md Outdated
Comment thread .claude/skills/docs/guides/START_HERE.md Outdated
Comment thread .claude/skills/docs/desktop/README-MCPB.md Outdated
Comment thread .claude/skills/docs/desktop/README-MCPB.md Outdated
Comment thread .claude/skills/docs/desktop/README-MCPB.md Outdated
Copilot review correctly identified that qsvmcp excludes 10 commands
(not 8): apply, fetch, fetchpost, foreach, lens, prompt, python,
clipboard, to, and color. The `to` and `color` commands were missed
because qsvmcp doesn't enable the `to` or `ui` features.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@jqnatividad jqnatividad merged commit 8e325df into master Mar 22, 2026
27 checks passed
@jqnatividad jqnatividad deleted the docs-mcp-audit-20260322 branch March 22, 2026 12:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants