agent-branch-integration
Skill1 starsChanged 37 days agoMITView on GitHub
Use when reviewing delegated branches for integration. Gate the exact candidate revision.
In this repository34 other files it gives its agents.
- agent-config-syncSkill
- blocked-page-recoverySkill
- brand-retrofitSkill
- clickable-concept-prototypeSkill
- codebase-inspectionSkill
- commit-workSkill
- contrastive-refactor-demoSkill
- custom-domain-emailSkill
- delegate-coding-taskSkill
- delegated-agent-supervisionSkill
- delivery-verificationSkill
- domain-dns-cutoverSkill
- first-run-onboardingSkill
- frontend-render-performanceSkill
- github-pages-deploySkill
- hermes-cron-jobsSkill
- hermes-messaging-channelsSkill
- hermes-on-oracle-free-tierSkill
- hermes-provider-credentialsSkill
- isolated-worktree-testingSkill
- measurement-validitySkill
- multi-layout-previewSkill
- new-project-scaffoldingSkill
- parallel-agent-fanoutSkill
- premortemSkill
- recall-and-claim-verificationSkill
- single-source-training-materialsSkill
- stakeholder-decision-elicitationSkill
- static-site-vps-deploySkill
- supabase-auth-debuggingSkill
- windows-background-process-hygieneSkill
- windows-desktop-automationSkill
- windows-performance-tuningSkill
- worktree-analysisSkill
The file
We split this skill into the rules it gives an agent
8 rules. About 0 are common, 8 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈8
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- could be automatic: a setting could enforce it
- Distinctive: line 13
Read the original scope, subsequent decisions, allowed paths, acceptance and pending approvals.
- Distinctive: line 23
Do not confuse ancestry with compatibility or changed paths with scope authorization.
- Distinctive: line 26
Verify the candidate in a detached disposable worktree with independent dependencies.
- Distinctive: line 27
Run acceptance tests and, where relevant, check again after the build to catch output unexpectedly included in lint/typecheck inputs.
- Distinctive: line 33
If explicitly authorized, perform the repository's approved integration strategy.
- Distinctive: line 34
Never force-push a shared branch.
- Distinctive: line 35
Read back the resulting branch SHA and relevant remote state before claiming success.
- Distinctive: line 38
No daemon, board, credential workaround or automatic cleanup is needed.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Branch integration gate
A completed task or green worker report does not prove compatibility with the current base. The integrator owns evidence and authorization, not automatic publication.
Contract
Read the original scope, subsequent decisions, allowed paths, acceptance and pending approvals. Resolve conflicting instructions by authority and explicit supersession, not by assuming the newest comment is authorized. Do not commit, amend, rebase, merge, push or release without the applicable permission. Preparation approval is not merge approval.
Read-only gate
Run python scripts/check_candidate.py REPO BASE CANDIDATE.
It resolves exact commits, refuses a candidate not descended from BASE and reports
changed paths and both SHAs as JSON. It does not run tests or claim integration success.
Do not confuse ancestry with compatibility or changed paths with scope authorization.
- Review the complete diff, new source files, secrets and allowed scope; do not stage all.
- Verify the candidate in a detached disposable worktree with independent dependencies. Run acceptance tests and, where relevant, check again after the build to catch output unexpectedly included in lint/typecheck inputs. Never delete shared linked dependencies.
- Record local checks and CI results against the same exact SHA; distinguish skipped tests and platform differences. Local results do not invent unavailable CI evidence.
- Immediately before an approved integration, re-resolve base and candidate. Any movement invalidates the old readiness decision. Stop for conflicts; do not blindly prefer one side.
- If explicitly authorized, perform the repository's approved integration strategy. Never force-push a shared branch. Publication is a separate authorization gate.
- Read back the resulting branch SHA and relevant remote state before claiming success. Release dependent work only when the required integrated revision is actually available.
No daemon, board, credential workaround or automatic cleanup is needed. Permission blocks remain blocks. Keep a handoff with tested SHAs, commands, verdict, pending owner and next action; report integration and publication as separate states.
Run tests: python -B -m unittest discover -s tests -v.
Tests use only disposable local repositories under TMPDIR, with no remote.
Provenance
Adapted from the supplied same-named local procedure. Its metadata declares MIT licensing and machine-generated authorship, with no named human author. Distributors must retain required source notices; this summary is not a replacement license grant. Private runtime conventions and product-specific anecdotes were removed, not presented as general evidence.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

