klappy.dev

The RecordMethods

Tool Specialization

Description

When systems accumulate many tools or actions, generalist reasoning becomes
unreliable. The Tool Specialization pattern isolates tool usage behind narrowly
scoped reasoning units, reducing decision complexity while preserving capability.

This pattern captures invariants and tradeoffs without prescribing a specific
implementation.

Context

This pattern emerges when adding tools increases confusion, misfires, or decision
paralysis instead of effectiveness.

Typical triggers:

  • a growing tool menu that the "main" agent uses inconsistently
  • repeated tool misuse despite prompt reminders
  • correct tools, wrong selection timing
  • tool choice dominates reasoning time

The Pattern

Assign responsibility for a narrow set of tools or actions to a dedicated reasoning
unit with constrained scope and explicit outputs.

The goal is not "smarter" reasoning.
The goal is making tool-use boring and reliable.


Invariants

  • Capability grows faster than reliability without isolation
  • Isolation precedes orchestration
  • Specialization reduces decision load, not intelligence
  • Outputs must be explicit and promotable

Tradeoffs

  • Increased coordination overhead
  • Additional interfaces to maintain
  • Risk of premature specialization if created before pressure is visible

Non-goals

This pattern does not define:

  • an agent framework
  • a required topology
  • how sub-agents are implemented in any specific repo

See Also

Markdown · RSS · built from klappy/klappy.dev@b750d7d