agentleFS
taljeontaljeon/plzdo/skills/team-patterns/SKILL.md

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.

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
  1. Distinctive:

    Loop until dry: keep searching until K rounds in a row find nothing new.

    line 28
  2. Distinctive:

    Completeness critic: before merging, one agent asks only: which lens was unused, which claim unverified, which source unread.

    line 29
  3. Distinctive:

    Disclose exclusions: when sampling or top-N limits coverage, report how many items were skipped.

    line 30
  4. Distinctive:

    Write one brief every attempt gets word for word: the task, the deliverable format, the constraints.

    line 36
  5. Very specific:

    Run six attempts, each locked to one lens.

    line 37
  6. Distinctive:

    Check each worker's evidence before accepting it.

    line 54

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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

PatternUse whenRun it here
Pipelineeach step needs the previous outputsequential Agent calls; a human check between steps only if asked
Fan-out / fan-insame input, independent anglesparallel background Agent calls, then merge yourself
Expert poolinput type decides the specialistcall only the matching agent (code-reviewer, coding-test-coach, ...)
Producer / revieweroutput must pass objective criteriaworker (Claude or codex-implement) then a reviewer of the other model; max 2-3 rounds
Supervisorwork amount changes while runningnamed agents + SendMessage; reassign as results come in
Hierarchicalproblem splits into sub-problemsat 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.

  1. Write one brief every attempt gets word for word: the task, the deliverable format, the constraints. Tight enough that the six results compare directly.
  2. Run six attempts, each locked to one lens. Lenses 1-3 go to Claude Agent calls, lenses 4-6 to codex-worker (two groups of three, so the three-worker limit holds per model):
    1. Minimal: the smallest thing that fully works.
    2. Complete: every edge case and objection covered.
    3. First principles: ignore convention, derive it from scratch.
    4. Prior art: find the best existing versions and adapt their strongest pattern.
    5. Adversarial: ask what breaks each choice, keep what survives.
    6. Wildcard: one bold bet, done seriously. Each attempt returns a complete answer with decisions made, not "it depends".
  3. 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.
  4. 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.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.