docs: add tool-integration checklist + stop hardcoding roster counts (#663)

Two related drift traps, both from hand-typed numbers/lists that no guard
watches:

1. CONTRIBUTING had no "how to add a tool" checklist, and its wording
   ("all output is gitignored") implied gitignoring was automatic — so
   tool contributors kept committing generated integrations/<tool>/ output.
2. The division set and agent/division counts were hardcoded in prose in
   several places and had already gone stale (CONTRIBUTING said "16" and
   omitted healthcare; EXECUTIVE-BRIEF said "9 divisions").

Changes:
- Add an "Adding a Tool Integration" checklist to CONTRIBUTING (discuss-first,
  reuse an existing `format`, the ~5-file touch list incl. the required
  .gitignore rule, run check-tools.sh). Harmonize the "committed build
  output" policy line to point at it.
- De-hardcode the division list in CONTRIBUTING — defer to divisions.json.
- Stop scattering roster counts: strategy/EXECUTIVE-BRIEF ("9 divisions") and
  check-agent-originality.sh ("184-agent library") drop the number entirely;
  README keeps a showcase stat but softens "232 across 16" to "230+ across
  every division" so it never becomes a lie as the roster grows.


Claude-Session: https://claude.ai/code/session_01WKnDRWM4izsB8WAXKszhsq

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Michael Sitarzewski
2026-07-05 12:45:36 -05:00
committed by GitHub
parent cb45d3ea8c
commit 384dbbd2a8
5 changed files with 30 additions and 25 deletions
+3 -3
View File
@@ -91,7 +91,7 @@ Browse the agents below and copy/adapt the ones you need!
./scripts/install.sh --tool vibe
```
**Install only the teams you need** (not everyone wants all 16 divisions):
**Install only the teams you need** (not everyone wants every division):
```bash
./scripts/install.sh # interactive wizard: pick tools + teams
@@ -649,7 +649,7 @@ Each agent is designed with:
## 📊 Stats
- 🎭 **232 Specialized Agents** across 16 divisions
- 🎭 **230+ Specialized Agents** across every division
- 📝 **10,000+ lines** of personality, process, and code examples
- ⏱️ **Months of iteration** from real-world usage
- 🌟 **Battle-tested** in production environments
@@ -1037,7 +1037,7 @@ MIT License - Use freely, commercially or personally. Attribution appreciated bu
## 🙏 Acknowledgments
What started as a Reddit thread about AI agent specialization has grown into something remarkable — **232 agents across 16 divisions**, supported by a community of contributors from around the world. Every agent in this repo exists because someone cared enough to write it, test it, and share it.
What started as a Reddit thread about AI agent specialization has grown into something remarkable — **230+ agents across every division**, supported by a community of contributors from around the world. Every agent in this repo exists because someone cared enough to write it, test it, and share it.
To everyone who has opened a PR, filed an issue, started a Discussion, or simply tried an agent and told us what worked — thank you. You're the reason The Agency keeps getting better.