coordinate
Skill1 starsChanged 14 days agoApache-2.0View on GitHub
Run a multi-part project (several sub-plans) as the coordinating session — plan each part via /plan, keep a coordination plan as ledger, start one child session per approved sub-plan in its own worktree, take over finished branches. Use when a project splits into several plans (ADR-035); a single change stays plain PIV.
- Reads credentials
- Installs packages
24 other projects use a version of this.
Adopted by
Most recently taken up by
- Yesterday-AI/ytstacktheir own version, first seen Nov 16, 2026
- cayden970207/thoththeir own version, first seen Nov 15, 2026
- jsboige/CoursIAtheir own version, first seen Nov 15, 2026
- ryanportfolio/HarnessFirmware.comtheir own version, first seen Nov 8, 2026
- ryanportfolio/winuse-mcptheir own version, first seen Nov 8, 2026
- bftelman/skillstheir own version, first seen Nov 4, 2026
Used with
Projects with it also use addskill, apply-firmware and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
ryanportfolioSkilladdskill
Create, import, update, or install repo or personal skills: runtime ownership, resources, discovery checks.
Also in 6 projects that use this
ryanportfolioSkillapply-firmware
Bring current folder (plain folder, existing repo, old or partial firmware copy) up to full Harness Firmware in place. Mirror external repo → adopt-repo.
Also in 6 projects that use this
- +10 more from ryanportfolio
Other versions24 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 24
- first-fluke/fullstack-starter★ 226same name
- swyxio/skills★ 199same name
- jsboige/CoursIA★ 17same name
- zajca/pohunek★ 9same name
- cayden970207/thoth★ 8same name
- gao-xh/multi-agent-protocol★ 4same name
- AcKeskin/contexture★ 2same name
- bftelman/skills★ 2same name
- combinaut/ai-agent-orchestration★ 2same name
- leosimini/keelokit★ 2same name
14 more not listed
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 repository15 other files it gives its agents.
- .claude/CLAUDE.mdCLAUDE.md
- CLAUDE.mdCLAUDE.md
- checkSkill
- commit-msgSkill
- consolidate-lessonsSkill
- db-resetSkill
- debugSkill
- implementSkill
- ingestSkill
- migrateSkill
- planSkill
- reviewSkill
- sync-graphSkill
- testSkill
- validateSkill
The file
We split this skill into the rules it gives an agent
3 rules. 0 are common, 2 are distinctive, and 1 is very specific to this project.
0
Common
Most of the 23 edited versions we read keep these.
2
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
Always store the maximum of data (store what the source gives, judge in the view).
- Distinctive: line 27
Start the child: only on a message from the user (otherwise propose it as a card).
- Very specific: line 37
Clean up: remove implemented plans; after a child archived itself, remove leftovers (worktree only after checking it for unsaved changes: …
“Common” is measured: kept by at least 6 in 10 of the 23 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
The level above PIV (ADR-035). Every part still runs /plan → /implement → /validate → /review; this session
plans and coordinates, child sessions build. This session writes no code. It runs in the main checkout, without a
worktree, on the base branch feat/<topic>.
Setup (once per project)
- Base branch
feat/<topic>frommain, checked out in the main checkout. - Coordination plan
plans/<date>-<topic>.md, committed on the base branch, with:- Principles — always these three, plus the project's own:
- Removing removes only what is removed (dependent data stays).
- Always store the maximum of data (store what the source gives, judge in the view).
- Build on what exists instead of inventing new.
- Branches — which parts go to
mainone by one (useful on their own, branch frommain), which stay on the base branch (only go live together). No merge commits. - Rules for child sessions — §4 of ADR-035, adapted.
- Parts and a Status table: part · plan · branch · session · status. Update it after every step.
- Principles — always these three, plus the project's own:
Per part
- Plan via
/plan. Hand exploration to sub-agents (Explore, Plan) so this context stays lean over the whole project. Commit the sub-plan on the base branch; lay it before the user. - Start the child only on a message from the user (otherwise propose it as a card). Fresh context, own worktree,
the brief below. A child the user starts from a card does not get its base branch (the card drops
source_branch): after the start, check withgit merge-base --is-ancestor <base> <child-branch>that its worktree sits on the right base, otherwise correct it by message. Run in parallel only what does not touch each other: at most one child changes an app's schema at a time (shared dev DB), assign dev-server and script-check ports, never reset the dev DB, two to three children at once. - While it runs: decide technical questions yourself, take domain questions to the user. Judge user ideas critically (verdict, risks, counter-proposal). Review every diff to a protected path (ADR-023) before the child commits it.
- Take over a finished branch (checklist below), then update the status table.
- Clean up: remove implemented plans; after a child archived itself, remove leftovers (worktree only after
checking it for unsaved changes:
git -C <wt> status --short, unpushed commits).
Brief for a child session
You are a child session of <coordinating session id>. Implement exactly the approved sub-plan <plan>.
Setup: git branch -m feat/<short>-<part> (base: <main | feat/<topic>>). First commit is the plan:
git show feat/<topic>:plans/<plan>.md > plans/<plan>.md. Node: <PATH export>, pnpm install --frozen-lockfile,
symlink apps/*/.env from the main checkout. Dev server / script check on port <n>. The Stop hook checks the main
checkout — run pnpm check and node .claude/vault-lint.mjs in your worktree yourself.
Work: /implement <autonomous | --step / by hand, because <protected paths>>, then /validate and /review. Do not
re-plan: report deviations and wait. Protected paths: send me the diff, commit only after my OK. Talk only to me via
SendMessage, never to the user. Start no sessions (sub-agents are fine). No merge, push, release, deploy. Never reset
the dev DB. No personal data outside reports/.
Finish: vault notes and lessons first, remove the implemented plan in the last commit, rebase onto <base>, gate green,
then report: branch, commits, report path, what is not verified, whether a new bridge or a deploy step is needed.
No commits after that.
Clean up after I say "taken over": copy your reports/ into the main checkout's reports/, delete branch and
worktree, archive yourself.Checklist: take over a branch
- Fast-forward possible:
git merge-base --is-ancestor <base> <branch>. - Gate in the child's worktree with the right Node version, via
git -C <wt> …or a subshell ((cd <wt> && pnpm check)), never a barecdthat moves this session's shell. - Diff free of personal data (ADR-029):
git diff <base>...<branch>. - Migrations additive only (no drop/rename of data-bearing columns).
- Plan removed in the branch's last commit; vault notes and lessons present.
- Into the base branch:
git merge --ff-only <branch>. - Into
main: only with the user's OK, ff-only;git fetch . <branch>:mainwhenmainis checked out nowhere. - Then at once:
git rebase mainon the base branch, resolve conflicts,pnpm install --frozen-lockfile, gate. - Tell the child "taken over"; update the status table.
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.

