Skip to content

docs: add upstream-sync playbook for agents#3

Merged
tqtensor merged 1 commit intomainfrom
docs/agent-playbook
May 8, 2026
Merged

docs: add upstream-sync playbook for agents#3
tqtensor merged 1 commit intomainfrom
docs/agent-playbook

Conversation

@tqtensor
Copy link
Copy Markdown
Owner

@tqtensor tqtensor commented May 8, 2026

Summary

  • Adds a root-level CLAUDE.md so any Claude Code session opened in this repo gets the upstream-sync workflow on entry.
  • Codifies the rules that emerged while resolving Upstream sync: 5 new commit(s) from perplexityai/modelcontextprotocol #1: don't merge/push/close without per-step approval, prefer rebase-merge, ship via PR (never push to main), no AI attribution.
  • Captures established content filters: skip upstream's install badges and npm badge, keep the separate VS Code section with servers / type: stdio, adapt commands to github:tqtensor/... + OPENROUTER_API_KEY.
  • Documents the gh pr create from a fork pitfall (defaults to parent repo unless --repo and --head are passed) so future PRs don't accidentally land in perplexityai/modelcontextprotocol.

Test plan

  • CLAUDE.md renders correctly on GitHub.
  • Open this repo in a fresh Claude Code session and confirm the playbook is loaded into context (Claude should be able to summarize the upstream-sync workflow without re-reading the file).
  • Next time .github/workflows/upstream-sync.yml opens a new sync issue, an agent following this playbook produces a single-commit PR against the fork (not upstream), with Closes #<n> in the body.

@tqtensor tqtensor merged commit 317e7f2 into main May 8, 2026
1 check passed
@tqtensor tqtensor deleted the docs/agent-playbook branch May 8, 2026 09:46
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