parallel-work
Skill4 starsChanged 4 months agoMITView on GitHub
Rules for working in a repository where other Claude sessions are editing at the same time — no git writes, no process kills, strict scope, and verification narrowed or deferred so a test run cannot corrupt another session's. Use when the user says another session or agent is running in this codebase, asks to work in parallel mode, or mentions \"/parallel-work\".
7 other projects use a version of this.
Adopted by
Most recently taken up by
- Destrayon/Connapsetheir own version, first seen Nov 7, 2026
- Tcuzzo/backs-aios-skillstheir own version, first seen Nov 3, 2026
- davidscotttufts/hyvemindtheir own version, first seen Nov 1, 2026
- aprameyak/coding-skillstheir own version, first seen Oct 2, 2026
- joris887/exosuittheir own version, first seen Aug 20, 2026
- nfeuer/project-foundation-kittheir own version, first seen Jul 5, 2026
Other versions7 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 7
- Destrayon/Connapse★ 22same name
- joris887/exosuit★ 9same name
- Tcuzzo/backs-aios-skills★ 2same name
- aleiby/claude-skills★ 1same name
- aprameyak/coding-skills★ 1same name
- davidscotttufts/hyvemind★ 0same name
- nfeuer/project-foundation-kit★ 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 repository10 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- axiomatic-inductionSkill
- generate-prSkill
- genesisSkill
- git-commitSkill
- repo-hardeningSkill
- security-auditSkill
- sourcesSkill
- test-gateSkill
- todoSkill
The file
We split this skill into the rules it gives an agent
4 rules. 0 are common, 3 are distinctive, and 1 is very specific to this project.
0
Common
Most of the 6 edited versions we read keep these.
3
Distinctive
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 16
No git writes: Do not commit, push, stage, stash, checkout, reset, restore, merge, rebase, or switch branches.
- Distinctive: line 22
No drive-by refactors and no reformatting.
- Very specific: line 42
Narrow and provably non-interfering: Run only what covers the change you made — and only after checking that it touches nothing shared: no …
- Distinctive: line 49
Don't run it: If the only honest verification is a full suite, a shared database, or anything carrying a global reset — do not run it now.
“Common” is measured: kept by at least 6 in 10 of the 6 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
Parallel session mode
Another Claude session is working in this repository right now. The working tree, the running processes, the git index, and whatever the tests touch are all shared. Assume every one of them has an owner other than you.
Rules
- No git writes. Do not commit, push, stage, stash, checkout, reset, restore, merge, rebase, or switch branches. Finish the work, leave it uncommitted, and say so. The owner commits.
- Diffs you did not make are not yours.
git statuswill show another session's in-flight edits. Never revert, clean, or "tidy" them. If a file you are editing changes under you, re-read it and merge your change on top — do not overwrite. - Stay inside the requested scope. Touch only the files the request names or strictly requires. No drive-by refactors and no reformatting. A problem in a file you are not already editing is named in the report and never fixed here — it probably belongs to another session's in-flight work, and an unrelated file you edit is a file you are colliding with someone on. A defect in a file you are already changing stays yours to fix, in this mode as in every other.
- Do not kill processes. No
pkill,killall, port sweeps, or container teardowns — the dev server, test run, or database you would kill probably belongs to the other session. Kill only a PID you spawned this turn and captured yourself. Leftovers you did not spawn get reported, not killed.
Verifying without corrupting anyone
A test run is not a read. Most suites write: they insert fixtures, truncate or reset a database, bind a fixed port, populate a cache, or write to a shared build directory. Run one while another session is mid-run and you corrupt both — and that is worse than a wasted run, because the wreckage looks like real findings. Rows vanish mid-assertion, a port refuses to bind, a snapshot mismatches, a count comes back one too high. Whoever reads that output then debugs a bug that does not exist. Both sessions lose, and the false result is the expensive part.
So verification has three settings here, in order of preference:
- Narrow and provably non-interfering. Run only what covers the change you made — and only after checking that it touches nothing shared: no shared database, no fixed port, no shared cache or build output, no global truncate/reset/seed in its setup or teardown. Read the setup and teardown before trusting it. "It's only one test file" is not the same as "it touches nothing else" — a per-file hook or a global setup can reset the world on behalf of a single file.
- Static checks. Typecheck, lint, reading the code, a build to a private output path. Usually safe, usually catches most of what a suite would, and never collides with anyone.
- Don't run it. If the only honest verification is a full suite, a shared database, or anything carrying a global reset — do not run it now. Say what you skipped and why.
Before any command that touches shared state, look for an active run — processes, lock files, a database whose contents are changing under you. If you find one, wait for it or skip; never race it, and never kill it (rule 4).
If you ran something anyway and a foreign run was active, the result is not evidence. Say so plainly rather than reporting the number as fact. A contaminated green and a contaminated red are equally worthless.
Deferring the run is a correct outcome, not a failure
The operator would rather run the suite themselves on a quiet machine and bring back real failures
than read a green that was contaminated or a red that was someone else's collision. Handing back
"changed X; verified Y; did not run Z; run <command> when the machine is yours" is a complete
delivery in this mode.
An automated gate, stop hook, or checklist that demands a full run does not override this. If one fires, treat the conflict as something to report, not a reason to race: state that the gate was not run, why, and the exact command that would run it. A gate result produced while another session was writing to the same database or port is a result nobody can act on — strictly worse than an honest "not run". If the shared resources genuinely go quiet, running it then is fine.
Reporting
End the turn with: what you changed, which files, and the plain statement that it is uncommitted. Then, explicitly:
- Verified — what you actually ran, and its real output.
- Not verified — what you deliberately skipped, why, and the command the operator should run.
- Not yours — other sessions' in-flight edits you noticed and left alone, so they are not mistaken for part of your change.
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.

