team-patterns
Skill9 starsChanged 16 days agoMITView on GitHub
Choose how to split work across subagents and verify their output. Use for large audits, migrations, multi-source research, codebase-wide reviews, or design work with several viable options, especially when a Meta Harness route is Plan/Goal/UW. Not for small single-step tasks.
In this repository56 other files it gives its agents.
- harness/CLAUDE.mdCLAUDE.md
- academic-research-routerSkill
- accessibilitySkill
- adaptive-project-harnessSkill
- anti-slopSkill
- apple-designSkill
- arenaSkill
- astryx-design-systemSkill
- attention-spanSkill
- copywritingSkill
- crash-outSkill
- croSkill
- cybersecurity-skill-routerSkill
- design-isms-referenceSkill
- design-minimal-blue-pitchdeckSkill
- design-source-routerSkill
- design-specSkill
- diagnosing-bugsSkill
- emil-design-engSkill
- external-review-routerSkill
- frontend-designSkill
- gh-address-commentsSkill
- handoffSkill
- humanize-japaneseSkill
- hyperframes-animationSkill
- hyperframes-audioSkill
- hyperframes-cliSkill
- hyperframes-coreSkill
- hyperframes-creativeSkill
- hyperframes-keyframesSkill
- hyperframes-registrySkill
- hyperframesSkill
- hyperframes-studioSkill
- impeccableSkill
- implement-changeSkill
- leak-checkSkill
- library-docsSkill
- loop-librarySkill
- media-useSkill
- motion-graphicsSkill
- obsidian-memory-routerSkill
- openpencil-cliSkill
- ponytailSkill
- product-marketingSkill
- project-startSkill
- pr-ossSkill
- remove-ai-marksSkill
- requirements-clarificationSkill
- retroSkill
- review-changeSkill
- screenshotSkill
- security-auditSkill
- startup-evidenceSkill
- taste-guided-uiSkill
- understandSkill
- verification-before-completionSkill
The file
We split this skill into the rules it gives an agent
6 rules. About 0 are common, 5 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈5
Distinctive · estimate
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 28
Loop until dry: keep searching until K rounds in a row find nothing new.
- Distinctive: line 29
Completeness critic: before merging, one agent asks only: which lens was unused, which claim unverified, which source unread.
- Distinctive: line 30
Disclose exclusions: when sampling or top-N limits coverage, report how many items were skipped.
- Distinctive: line 36
Write one brief every attempt gets word for word: the task, the deliverable format, the constraints.
- Very specific: line 37
Run six attempts, each locked to one lens.
- Distinctive: line 54
Check each worker's evidence before accepting it.
≈ “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
Team patterns
Meta Harness (hn) decides how big the work is. This skill decides the team shape inside it. Do not generate per-project agents or CLAUDE.md files; the harness owns project guides.
Pick the shape from the control flow
| Pattern | Use when | Run it here |
| Pipeline | each step needs the previous output | sequential Agent calls; a human check between steps only if asked |
| Fan-out / fan-in | same input, independent angles | parallel background Agent calls, then merge yourself |
| Expert pool | input type decides the specialist | call only the matching agent (code-reviewer, coding-test-coach, ...) |
| Producer / reviewer | output must pass objective criteria | worker (Claude or codex-implement) then a reviewer of the other model; max 2-3 rounds |
| Supervisor | work amount changes while running | named agents + SendMessage; reassign as results come in |
| Hierarchical | problem splits into sub-problems | at most 2 levels deep |
Mix patterns per phase, e.g. analysis (pipeline) → implementation (fan-out with Codex workers) → integration test (pipeline).
Quality patterns (for audits, reviews, research)
- Adversarial check: for each finding, independent checkers try to refute it; keep it only if most confirm with evidence.
- Split perspectives: give checkers different lenses (correctness, security, reproducibility) instead of the same prompt.
- Judge panel: for open design questions, build N different options in parallel, pick the best, borrow strengths from the rest.
- Loop until dry: keep searching until K rounds in a row find nothing new; record rejected items so they are not re-proposed.
- Completeness critic: before merging, one agent asks only: which lens was unused, which claim unverified, which source unread.
- Disclose exclusions: when sampling or top-N limits coverage, report how many items were skipped.
Six lenses and a judge (/67)
The judge panel in its fixed form, for high-stakes or open-ended deliverables (a pitch, an architecture, a pricing page). Run it only when the user asks for it by name; it costs six attempts plus a judge.
- Write one brief every attempt gets word for word: the task, the deliverable format, the constraints. Tight enough that the six results compare directly.
- Run six attempts, each locked to one lens. Lenses 1-3 go to Claude
Agentcalls, lenses 4-6 tocodex-worker(two groups of three, so the three-worker limit holds per model):- Minimal: the smallest thing that fully works.
- Complete: every edge case and objection covered.
- First principles: ignore convention, derive it from scratch.
- Prior art: find the best existing versions and adapt their strongest pattern.
- Adversarial: ask what breaks each choice, keep what survives.
- Wildcard: one bold bet, done seriously. Each attempt returns a complete answer with decisions made, not "it depends".
- Judge (Claude, without writing its own answer first): score each attempt 1-10 on correctness, completeness and taste, rank all six with a one-line verdict, and name the single strongest element of each, losers included.
- Build the final on the winner, add every strongest element worth taking, and list what came from which lens.
Output: the ranking (rank, score, one line each), the final answer, then the list of borrowed parts.
Scale and limits
- Match scale to the ask: "any bugs?" is a few searchers and one checker; "audit thoroughly" is more searchers and 3-5 checkers per finding.
- At most 3 workers at once. One owner per file. Every worker gets a self-contained brief (goal, owned files, no-touch paths, acceptance).
- Check each worker's evidence before accepting it. Keep progress in TASKS.md for long runs.
Adapted from revfactory/harness (Apache-2.0) @ 92d9f1b, skills/harness/references/team-patterns.md.
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.

