Skip to content

CTX7-3603: Align Context7 rules, setup templates, and skills with direct MCP server instructions - #3669

Open
fahreddinozcan wants to merge 6 commits into
masterfrom
CTX7-3603/align-rules-with-server-instructions
Open

fahreddinozcan wants to merge 6 commits into
masterfrom
CTX7-3603/align-rules-with-server-instructions

Conversation

@fahreddinozcan

@fahreddinozcan fahreddinozcan commented Nov 4, 2026 •

Copy link
Copy Markdown
Collaborator

Copies the MCP server instructions from #3665 into the agent guidance outside the MCP server. Closes CTX7-3603. Merge after #3665: ctx7 setup fetches these rules and skills from master.

  • rules/context7-mcp.md, context7-mcp skill (root, packages/opencode, all plugin copies), Kiro POWER.md, Cursor use-context7.mdc: the server text as is, plus a three-step resolve-library-id / query-docs section. The rule and skills keep the "Library source code" section from CTX7-3512: Add the query-code MCP tool and the ctx7 code command #3594.
  • rules/context7-cli.md and skills/find-docs/SKILL.md: the same call rule and lists with ctx7 in place of the MCP tools, plus the CLI steps, limits, and the quota/login hint.
  • templates.ts: FALLBACK_MCP equals the MCP rule, and the bundled context7-mcp skill is the repo skill. FALLBACK_CLI is the CLI rule plus the ctx7 code section, which the repo rule gets in CTX7-3540: Add ctx7 code guidance to the CLI rule and skills #3624.
  • New tests fail when a skill copy, the Cursor rule, POWER.md, find-docs, or a bundled fallback drifts from its source file.
  • Patch version bumps for the changed plugins, and a changeset for ctx7 and @upstash/context7-opencode.

@vercel

vercel Bot commented Nov 4, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment
Project Deployment Actions Updated
context7-admin-mcp Ignored Ignored Nov 10, 2026 10:58am UTC

Request Review

@linear-code

linear-code Bot commented Nov 4, 2026

Copy link
Copy Markdown

CTX7-3603

@fahreddinozcan fahreddinozcan left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

Reviewed latest head 870d7ea. No blocking code findings. All 402 CLI tests pass locally, including exact bundled-rule parity. The seven context7-mcp skill copies in this diff have identical contents. Keep find-docs, context7-cli, and the Pi skill outside this release because their CLI/setup and extension workflows differ; align them separately with dedicated validation. Keep the optional resolver-description change out of this release to preserve the measured text. Merge after #3665. An independent approval is still required because the authenticated account is the PR author. The user accepts the many-library call-limit issue as a follow-up. Copilot rule and Claude behavior reruns are in progress.

@fahreddinozcan fahreddinozcan left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

Authorized Copilot rule benchmark complete: claude-haiku-4.5 with the exact rules/context7-mcp.md installed as .github/copilot-instructions.md, custom instructions enabled, isolated configuration, and only Context7 allowed. Held-out 40-prompt set: 25/30 required calls, 0/10 wrong calls, no runner errors or failed checks. Five missed lookups remain; this is not universal enforcement. Claude behavior rerun: 24/24 required calls and 1/25 extra calls. No further wording change made without evidence that it improves these misses across clients. The accepted many-library call-budget follow-up remains recorded here; Linear needs reauthentication. Independent approval and merge order #3665 then #3669 remain required.

… facts, ports, and library choices

Keeps the "Library source code" sections that master added in CTX7-3512. The CLI fallback is the rule text plus the ctx7 code section until #3624 adds it to rules/context7-cli.md.

This branch has not been deployed

No deployments
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.

1 participant