Skip to content

docs: reconcile MCP-first directive with HANDOFF and server naming#121

Merged
div0rce merged 1 commit into
mainfrom
docs/reconcile-mcp-directive-main
Jun 15, 2026
Merged

docs: reconcile MCP-first directive with HANDOFF and server naming#121
div0rce merged 1 commit into
mainfrom
docs/reconcile-mcp-directive-main

Conversation

@div0rce

@div0rce div0rce commented Jun 15, 2026

Copy link
Copy Markdown
Owner

Summary

Re-lands the reconciliation that missed the #120 squash-merge. PR #120 was squash-merged at 6ece05a while its branch was still at the original commit, so the follow-up fix commit (b2bbcdb) addressing the review never reached main. As a result, the two Codex P2 issues raised on #120 are currently live on main. This PR cherry-picks that exact delta onto current main.

Fixes (both flagged on #120, still present on main)

  1. HANDOFF/CLAUDE conflictHANDOFF.md:738 said "Use GitHub CLI over GitHub MCP", contradicting the new MCP-first directive (and resume reads HANDOFF after CLAUDE/AGENTS). HANDOFF now defers to the canonical MCP policy: prefer the GitHub MCP for PR/issue/branch/commit/milestone review, with gh as the fallback when the MCP is unavailable or for scripted steps; the adjacent docs line prefers context7 over memory.
  2. Server-name mismatch — the directive named sequential-thinking (hyphen) while the roster and HANDOFF use sequential_thinking (underscore), undercutting the "never invent a server" rule. Standardized to the underscore form in CLAUDE.md and AGENTS.md.

Definition of Done

  • HANDOFF no longer contradicts the MCP-first directive (one canonical GitHub workflow)
  • sequential_thinking used consistently; no hyphenated straggler in CLAUDE/AGENTS/HANDOFF
  • CLAUDE.md and AGENTS.md MCP sections differ only by the client-name line
  • Docs-only; analyze_change_set clean (no scored files)
  • Human squash-merges

Note

Verified against origin/main @ 6ece05a: HANDOFF:738 still had the conflict line and CLAUDE/AGENTS:181 still had the hyphen before this PR.

Address PR #120 review:
- HANDOFF.md said 'use GitHub CLI over GitHub MCP', contradicting the new
  MCP-first directive (and resume reads HANDOFF after CLAUDE/AGENTS).
  Flip HANDOFF to one canonical workflow: prefer the GitHub MCP for
  PR/issue/branch/commit/milestone review, gh CLI as fallback when the
  MCP is unavailable or for scripted steps; likewise prefer context7 for
  current docs over memory.
- The directive named 'sequential-thinking' (hyphen) while the roster and
  HANDOFF use 'sequential_thinking' (underscore); standardize on the
  configured underscore name in CLAUDE.md and AGENTS.md so no line points
  at an unconfigured server name.
@coderabbitai

coderabbitai Bot commented Jun 15, 2026

Copy link
Copy Markdown

Warning

Review limit reached

@div0rce, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 43 minutes and 55 seconds. Learn how PR review limits work.

Your organization has used up its prepaid credits, and credit purchases are no longer available. Enable the review add-on in the billing tab to keep reviews running — you're only billed for reviews past your plan's rate limits ($0.25/file).

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 080b606d-d74c-450f-9695-c2fe453705e7

📥 Commits

Reviewing files that changed from the base of the PR and between 6ece05a and faaa6c3.

📒 Files selected for processing (3)
  • AGENTS.md
  • CLAUDE.md
  • HANDOFF.md
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/reconcile-mcp-directive-main

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@codescene-delta-analysis codescene-delta-analysis Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

No application code in the PR — skipped Code Health checks.

See analysis details in CodeScene

Quality Gate Profile: Pay Down Tech Debt
Install CodeScene MCP: safeguard and uplift AI-generated code. Catch issues early with our IDE extension and CLI tool.

@div0rce div0rce merged commit 7244af0 into main Jun 15, 2026
8 checks passed
@div0rce div0rce deleted the docs/reconcile-mcp-directive-main branch June 15, 2026 14:20
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