docs(agents): codify merge/worktree discipline + shared read-only permission allowlist#1555
Merged
Merged
Conversation
…d read-only permission allowlist AGENTS.md: - Drop the stale ".github/copilot-instructions.md mirror" instruction — that file doesn't exist, and Copilot (coding agent + CLI, since Aug 2025) reads AGENTS.md natively. Single source of truth for all agents. - Multi-agent discipline: prefer one git worktree per agent/task for physical isolation; frame the defensive rules as the shared-working-tree fallback. - Add rule #7: merge only after remote CI is green, never `gh pr merge --auto` (#1475 — auto-merge can land a red PR on shared main). .claude/settings.json (new, committed/shared): - Read-only permission allowlist derived from recent transcript usage, so parallel agents prompt less. Browser/preview observation tools (screenshot/snapshot/logs/network/list) + `agent-browser snapshot|skills`. - Deliberately excludes mutating/arbitrary-exec calls (preview_eval, click, fill, start/stop, pnpm, node, npx) and anything Claude Code already auto-allows (git/gh read-only, grep, cat, ls, …). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
github-actions
Bot
added
documentation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Two small, agent-facing housekeeping changes for parallel multi-agent work.
AGENTS.md.github/copilot-instructions.mdmirror instruction. That file doesn't exist in the repo, and GitHub Copilot (coding agent + CLI, since Aug 2025) readsAGENTS.mdnatively as primary instructions — no mirror needed. AGENTS.md is now the single source of truth for Claude Code / Copilot / etc.gh pr merge --auto. Auto-merge can land a still-red PR onto sharedmainand break it for every parallel agent (see Validation rules: 6 of 9 spec rule types are declared but not enforced at runtime #1475)..claude/settings.json(new, committed/shared)Read-only permission allowlist derived from recent transcript usage so parallel agents prompt less. Covers browser/preview observation tools (screenshot / snapshot / logs / network / list) plus
agent-browser snapshot|skills.Deliberately excludes:
preview_eval,preview_click/fill/start/stop,pnpm,node,npxgrep,cat,ls, ….claude/settings.local.json(gitignored, per-machine) is untouched.Notes
examples/app-showcase/objectstack.config.tswas already modified in the working tree by other in-flight work and is intentionally not part of this PR.🤖 Generated with Claude Code