drill
Skill12 starsChanged 29 days agoMITView on GitHub
"Do the drill": clear every open PR and issue in this repo. Inventory them, implement what is pending, merge each one only with CI green, then sweep for anything else left to fix, until nothing is open and master is green. Use when the operator types /drill, "do the drill", "you know the drill", or "take care of open PRs and issues".
- Installs packages
7 other projects use a version of this.
Adopted by
Most recently taken up by
- protokol11/skillstheir own version, first seen Nov 8, 2026
- protokol11/drilltheir own version, first seen Nov 1, 2026
- Fulcrum-Governance/Fulcrum-Boundarytheir own version, first seen Oct 15, 2026
- majiayu000/test-looptheir own version, first seen Oct 13, 2026
- alexiocassanifm/anthropic-certificationstheir own version, first seen Aug 16, 2026
- deividas-butkus/claude-certified-architect_foundationstheir own version, first seen Aug 13, 2026
Other versions7 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 7
- alexiocassanifm/anthropic-certifications★ 36same name
- lgulliver/derrick★ 2same name
- protokol11/drill★ 2same name
- protokol11/skills★ 1same name
- deividas-butkus/claude-certified-architect_foundations★ 0same name
- Fulcrum-Governance/Fulcrum-Boundary★ 0same name
- majiayu000/test-loop★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository22 other files it gives its agents.
- AGENTS.mdAGENTS.md
- docs/agents.mdAGENTS.md
- agent/CLAUDE.mdCLAUDE.md
- CLAUDE.mdCLAUDE.md
- router/CLAUDE.mdCLAUDE.md
- .github/copilot-instructions.mdCopilot instructions
- .cursor/rules/verification.mdcCursor rule
- agentic-agileSkill
- agentic-portfolioSkill
- client-onboardingSkill
- cooldown-resumeSkill
- ecc-harness-patternsSkill
- fabric-patternsSkill
- graphiti-temporalSkill
- managed-agents-dreamsSkill
- model-catalogue-updateSkill
- platform-setupSkill
- repowise-intelligenceSkill
- risky-module-reviewSkill
- seo-audit-reportSkill
- user-researchSkill
- video-contextSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
20 rules. 0 are common, 14 are distinctive, and 6 are very specific to this project.
0
Common
Most of the 7 edited versions we read keep these.
14
Distinctive
This author's own choices. Worth a look.
6
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 25
Done means: every open PR is merged or closed with a reason, and every open issue is fixed, verified as already fixed, or closed with a …
- Very specific: line 56
Read the item before deciding: the body, the comments, and for a PR the diff and the failing job's log (get_job_logs, tail ≈ 80 lines).
- Distinctive: line 80
Run the touched tests, then the full suite, before pushing.
- Distinctive: line 95
Behind: update the branch. After any merge, the other PRs go behind.
- Distinctive: line 104
After each merge, confirm it landed: the merge commit is on master, and for a backend change, exactly one Render deploy went live.
- Distinctive: line 118
Look for anything an in-flight run did after you closed an issue, such as a reopen or a retry label.
- Very specific: line 120
Check .claude/state/active-tasks.md for rows the drill closed and move them to the archive (rule 44).
- Very specific: line 134
Verify a bot's claim against primary data before acting.
- Distinctive: line 137
Check whether master already fixed something before writing a fix for it.
- Distinctive: line 143
Keep tracking an item until it is merged or closed.
- Very specific: line 148
Don't merge with any required check red, pending, or skipped for the wrong reason.
- Very specific: line 149
Never force-push master, never pass --no-verify, never bypass branch protection.
- Very specific: line 150
Don't skip, disable, xfail or delete a test to get green, and don't weaken an assertion.
- Distinctive: line 152
Don't call a failure a flake without proof: same commit green earlier, or the job died before any test ran.
- Distinctive: line 154
Don't rebase or force-push someone else's branch.
- Distinctive: line 155
Don't touch an IN FLIGHT session PR, and don't close another session's work without the operator's say-so.
- Distinctive: line 157
Don't modify a rule-15 risky module, add a migration, change Actions permissions, or take a breaking dependency upgrade without asking …
- Distinctive: line 159
Don't widen a PR beyond its fix.
- Distinctive: line 160
Don't put a model identifier in commits, PR text or code comments.
- Distinctive: line 162
Don't report "done" from your own summary.
“Common” is measured: kept by at least 6 in 10 of the 7 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
/drill — clear the board, keep master green
Done means: every open PR is merged or closed with a reason, and every open issue is fixed, verified as already fixed, or closed with a reason. Master CI is green on its latest commit, no workflow's latest run on master is red, and a final report says which of these were checked. Nothing about it is a judgement call left in your head: each item ends in a merge, a close comment, or a line in the report that says why it is still open.
The drill is four phases. Work them in order and loop phases 2–3 until the inventory is empty. A merge moves master, which puts other PRs behind, and a long-running workflow can reopen an issue you just closed. So phase 4 always re-runs the inventory instead of trusting phase 1.
Phase 1 — Inventory (read-only)
git fetch origin master && git checkout -B <your-branch> origin/master
python scripts/drill_inventory.py # add --json for a machine-readable copyThe script lists every open PR and issue with its category, CI state on the PR
head, merge state, master CI, and every workflow whose latest run on master
failed. It never writes. A merge state of unknown means GitHub has not
computed it yet: query that PR again before acting on it.
Post the inventory table to the operator before changing anything. Then make a task per item; a long list goes into the task tracker, not your memory.
Phase 2 — Decide and implement, per category
Read the item before deciding: the body, the comments, and for a PR the diff
and the failing job's log (get_job_logs, tail ≈ 80 lines). The title and the
bot's own summary are claims, not evidence.
| Category | What to do |
own | Your branch's PR (the script takes the checked-out branch, or --own-branch). Drive it through phase 3 like any fix. |
dependabot | Check the new version exists on the registry. For a major bump, find the API we call (grep -rn "from <pkg>"), install the new version into a scratch dir (pip install --target <scratch> <pkg>==X) and run the tests that touch it with PYTHONPATH=<scratch>. A breaking change that affects us needs the operator (rule 40); none means it is safe to take. Branch protection requires PRs to be up to date, so each merge puts the rest behind. With more than three green bumps waiting, cherry-pick their commits into one PR from your branch and close the originals pointing at it. That is one CI round instead of one per bump. With fewer, PUT pulls/{n}/update-branch and merge them one at a time. Close a bump whose package another PR removes, saying which PR. |
agent (agent/*) | Hold it to REVIEW.md. Close, with the reason, any PR that adds root-level report files, fabricated dates, retired model ids, removed tests or assertions, or a rewrite far larger than the plan. Otherwise fix it up on its branch and drive it like your own. |
automation (claude/daily-automation-*, claude/harness-scan-*, claude/context-issue-*) | Daily model PRs follow .claude/skills/model-catalogue-update/SKILL.md. Resolve conflicts by merging master in, never by rebasing. A draft context PR whose issue closed should be closed too. A harness-scan draft is a report: merge it if it is docs-only and green, close it if superseded. |
session (claude/*) | If the inventory marks it IN FLIGHT (pushed in the last 2 h), another session is likely still on it. Report it and leave it. Older than that, treat it as abandoned work and drive it to green. |
human | Reviewers' small asks: implement. Larger asks or design questions: comment with a proposal and put the call to the operator. |
bug, automation-bug | Reproduce or find the evidence first (failing run log, traceback). Check whether master already fixed it (git log -S, the latest scheduled run). If fixed, close with the commit and the green run as proof. If not, fix it with a regression test that fails first. |
quick-note, quick-note-rejected | Read the linked source and the context PR. Build it if it is a real, scoped feature; otherwise close as not_planned and name what in the repo already covers it. |
routine | Do each checkbox that is actionable from code. Close the issue when every box is done or has a written reason. |
Implementing a fix:
- One coherent change per PR, on your own branch, from fresh master.
- A bug fix needs a regression test that fails before the fix. Show it failing.
- Entries under
## [Unreleased]in bothCHANGELOG.mdanddocs/changelog.md(python scripts/check_changelog_parity.py).chore:,docs:,ci:,test:commits are exempt. - A changed workflow needs
python agent/loop_registry.py audit --checkgreen. graphify update .and commitgraphify-out/GRAPH_REPORT.mdwith the change.- Run the touched tests, then the full suite, before pushing. A test that also fails on clean master is pre-existing: prove it by running it on master, and say so in the PR.
Phase 3 — Merge with CI green
For every PR you opened or are driving:
- Open it with the template's sections, enable squash auto-merge, and subscribe to its activity.
- Schedule a check-in about 50 minutes out (
send_later) as the safety net. Cancel it when the PR merges. - Red CI: root-cause it from the job log, then push a fix. Before calling it "not this PR's", check whether the same check is red on master. A check that fails on an old head commit after you pushed a new one is stale: ignore it.
- Conflict: merge master into the branch, keep both sides' changelog
entries, regenerate lockfiles with the tool (
npm install), never by hand. - Behind: update the branch. After any merge, the other PRs go behind; update them in turn.
- Review bots: a finding with a real path to failure gets fixed. A rate-limit or usage-limit notice from CodeRabbit or Codex is not a finding.
A push to a PR that has auto-merge on can race the merge: if the PR merges first, the pushed commit lands on a dead branch. After every push to such a PR, check that the merged head SHA (or the current head, if still open) includes your commit. If it missed, cherry-pick it onto fresh master as a new PR.
After each merge, confirm it landed: the merge commit is on master, and for a
backend change, exactly one Render deploy went live. Check that through the
Render connector (mcp__Render__*, workspace tea-d7car44p3tds739qdrs0,
service srv-d7cb43beo5us73e1leug), because the render MCP server often
reports CONNECTION_CLOSED.
Phase 4 — Prove nothing is left
Re-run python scripts/drill_inventory.py. It must show:
- 0 open items, except IN FLIGHT session PRs and anything you reported as blocked with a reason;
- master CI green;
- red workflows on master: none. A red one is an item: open its log and go back to phase 2.
Then:
- Look for anything an in-flight run did after you closed an issue, such as a reopen or a retry label.
- Check
.claude/state/active-tasks.mdfor rows the drill closed and move them to the archive (rule 44). - Reset your branch to master and push, so the stop hook has nothing to flag.
- Cancel every check-in you scheduled.
Final report — one table: item, what was done (merged / closed / fixed in #N / left open), and the evidence (commit, run id, deploy id). Then a list of what was not checked and why, for example "Render deploy not checked: connector unavailable".
Do
- Verify a bot's claim against primary data before acting. A "500/503 server
error" issue turned out to be a regex counting Playwright's
waiting 500mslines, and a "tests failing" escalation was a missing git identity in a temp repo. - Check whether master already fixed something before writing a fix for it.
- Close with a comment that names the evidence (commit SHA, run id). End every GitHub comment with the Claude Code footer.
- Fix the root cause in code when automation keeps failing the same way, such as a retry loop that hammers a model returning 404, rather than only closing the symptom issue.
- Keep tracking an item until it is merged or closed. "Auto-merge is on" is not the end.
- Re-inventory after merging. A drill is a loop, not a pass.
Don't
- Don't merge with any required check red, pending, or skipped for the wrong reason.
Never force-push master, never pass
--no-verify, never bypass branch protection. - Don't skip, disable,
xfailor delete a test to get green, and don't weaken an assertion. Don't push an empty commit or close and reopen a PR to re-trigger CI. - Don't call a failure a flake without proof: same commit green earlier, or the job died before any test ran. At most one re-run.
- Don't rebase or force-push someone else's branch. Merge master into it instead.
- Don't touch an IN FLIGHT session PR, and don't close another session's work without the operator's say-so.
- Don't modify a rule-15 risky module, add a migration, change Actions permissions, or take a breaking dependency upgrade without asking first (rule 40).
- Don't widen a PR beyond its fix. A separate problem gets its own PR or a reported follow-up.
- Don't put a model identifier in commits, PR text or code comments. Don't paste a token anywhere (rule 42).
- Don't report "done" from your own summary. The phase 4 inventory output is the 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.

