DEV Community

Constantine Macris for Software Sausage

Posted on Originally published at softwaresausage.com

You probably do not need 264 AI agents

Disclosure: Software Sausage is our product. Agency Agents did not sponsor, review, or endorse this article. AI tools helped draft and edit it; the evidence boundary is stated below.

You probably do not need 264 AI agents. You need bounded roles and a gate

The Agency Agents repository is difficult to ignore: 264 specialized agent definitions, broad coding-harness support, and—when I reviewed it on September 9, 2026—roughly 151,000 GitHub stars.

The tempting conclusion is that a larger virtual team produces better work.

The repository does not establish that. What it does provide is a useful, MIT-licensed role library and a competent installer. The value comes from selecting a few narrow roles and making their outputs pass real checks.

This is a source review at commit 6d29a9b, not a benchmark. I inspected the role files, installer, converter, contribution rules, workflow example, and current GitHub checks. I did not evaluate every integration or the desktop app.

What it gets right

Agent definitions are not one-line personas. They name deliverables, workflows, constraints, and success metrics. The project converts them for Claude Code, Codex, Cursor, Gemini CLI, OpenCode, Qwen Code, Aider, and other harnesses.

More importantly, the installer lets you select one role or division, show a dry run, and target an explicit path. Agency Agents itself warns that OpenCode currently registers only about 119 agents and recommends installing a subset.

The project's contribution guide contains the best design rule: a new agent needs a narrow specialization, distinct behavior, concrete deliverables, measurable success, and real testing. Near-duplicate re-skins are rejected.

That rule should apply to the workflow too. If two roles produce the same artifact, if nobody consumes an output, or if success cannot be checked, remove the role.

What it does not prove

The README's “never sleep” and “always deliver” language is marketing. Prompts still fail, time out, overrun context, and agree on the same plausible mistake.

A role prompt also does not create process isolation. Giving a “reviewer” the same credentials and write access as the implementer makes the label cosmetic.

The repository's seven-agent startup example recommends passing full outputs between roles. Its newer Multi-Agent Systems Architect warns about context growth and recommends summaries and structured state. Use the second rule.

Green installer and manifest checks show that the repository is maintained and internally consistent. They do not show that seven agents outperform one capable agent on correctness, elapsed time, or cost.

Recipe one: one writer, two read-only reviewers

For a software change, three responsibilities are enough:

  1. The Minimal Change Engineer receives one outcome, explicit exclusions, allowed files, and an acceptance command. It can write code but cannot deploy.
  2. The Code Reviewer receives the task, diff, and check log with read-only access. It separates blockers, suggestions, and nits.
  3. The AI-Generated Code Security Auditor receives the same evidence plus the relevant trust boundaries. It uses local, read-only checks and records evidence for each finding.

The implementer gets at most two corrections. Then a person resolves the findings, reruns the repository checks, captures fresh runtime proof, and decides whether to ship.

The free three-agent code-change kit includes the handoff ledger and verifier.

Recipe two: make multi-agent earn its keep

If the question is whether orchestration helps, compare it with one agent:

  1. Freeze a resettable task and choose correctness, cost, latency, intervention, safety, and privacy thresholds before the run.
  2. Run one agent with the model, budget, tools, permissions, and fixture recorded.
  3. Let the architect choose no more than three challenger roles. Define each input, output, permission, fallback, one human gate, and a two-retry cap.
  4. Run the challenger on an identical fresh fixture. Pass agreed artifacts and summaries, not accumulated chat transcripts.
  5. Apply the same deterministic verifier and blind rubric to both results.
  6. Keep orchestration only when it clears the predeclared threshold. Retain failed and stopped runs.

The free multi-agent experiment kit provides the comparison manifest.

The useful default

Start with one agent. Add one role only when it owns a distinct artifact with a consumer and an acceptance check. Keep permissions separate. Cap retries. Leave the human at the irreversible boundary.

Agency Agents makes roles easy to install. The harder—and more valuable—work is proving which ones deserve to stay.

The complete source review and both pullable kits are at Software Sausage. The public Software Sausage MCP endpoint can also find these recipes and return their complete run ledgers inside a compatible agent client.

Top comments (0)