0 Fork 0

mirror of https://github.com/kevinveenbirkenbach/computer-playbook.git synced 2026-11-06 10:59:59 +00:00

Files

T

kevinveenbirkenbachandClaude Opus 5 f40d627a1b docs(agents): merge the tool-specific files into AGENTS.md

CLAUDE.md and GEMINI.md existed as per-runtime extensions of AGENTS.md, and
only one of them carried anything at all: GEMINI.md stated that it had no
additions, while CLAUDE.md held rules that bind every runtime anyway — the
permission announcement, the make-over-raw preference, the loop, chain and
heredoc bans, the stream-the-log-to-/tmp rule, the CI-evidence rule, the push
ban and the comment rule. A rule that binds every agent does not belong in one
agent's file. AGENTS.md absorbs them and now states that no tool-specific
extension file exists; agents whose runtime auto-loads a different filename
reach it through their own configuration instead.

The filenames were machinery as much as prose. The PR templates, the branch
and pull-request scope tables, the settings and security docs that justified
the loop deny by "the textual CLAUDE.md rule", six requirement documents whose
push instruction linked ../../CLAUDE.md, and a test docstring citing the
shell-loop ban all named them, and now name AGENTS.md.
scripts/meta/resolve/pr/scope.sh deliberately keeps matching CLAUDE.md and
GEMINI.md: this change deletes them, and without those patterns the change
itself would not classify as agent-scope.

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

2026-09-21 22:51:04 +02:00

2.9 KiB

Raw Blame History

Pull Request 🔀

Templates 📋

You MUST pick the template that matches your change. The table below links the actual templates.

Change type	Template
Server and `web-*` changes	server.md
Workstation and `desk-*` changes	workstation.md
Shared system changes such as `sys-`, `svc-`, `dev-`, `drv-`, `pkgmgr`, `update-`, or `user-`	system.md
CI/CD and workflow changes	pipeline.md
Documentation-only changes limited to `.md` or `.rst` files outside `AGENTS.md` and `docs/agents/*`	documentation.md
Agent-specific changes limited to `AGENTS.md` or `docs/agents/*`	agents.md

Branch Naming 🏷️

Branch names MUST follow the naming conventions defined in branch.md. The branch prefix MUST match the type of change and is used to classify the PR scope and select the CI pipeline.

The protection rules enforced on main are documented in branch.md.

Forking Flow 🍴

Before marking a PR as ready for review, CI in your fork MUST be green. The required scope depends on what you changed:

Change type	Isolated?	Required CI
Single role	✅ No dependencies	MAY use manual CI for that role only
Single role	❌ Has dependencies	MUST run full pipeline
Multiple roles or shared code	N/A	MUST run full pipeline
CI/CD, tooling, systemic	N/A	MUST run full pipeline

If you are unsure whether other roles are affected, you MUST run the full pipeline.

Drafts 📝

You SHOULD open a Pull Request as a draft while your change is still in progress. CI will not run and no reviewer time is spent until you mark it ready.

You MUST mark the PR ready for review before requesting a review. CI starts automatically at that point.
If you continue working on the PR after marking it ready, you MUST convert it back to a draft before pushing new commits. Otherwise CI triggers on every push to the main repository.
You MAY convert it back to a draft at any time. Any running CI jobs will be cancelled immediately.

Checklist ✅

Before you open a Pull Request:

CI in your fork MUST be green.
Your branch MUST be up to date with main.
Your change SHOULD be small and focused.
Relevant documentation MUST be updated.
The correct Pull Request template MUST be used.
The Pull Request MUST be linked to the related work item in project.infinito.nexus and back.
Screenshots, logs, traces, or migration notes SHOULD be attached when they help review the change.

2.9 KiB Raw Blame History