Eager vs Deferred Tool Guidance

Exact specification from Research decision 2.5.

Principle

Documentation does not assert which specific MCP tools are eager (always available) or deferred (loaded on demand). This classification can change — a tool can become eager by simply being mentioned in a system prompt.

Documentation Standard

Instead of listing tools as “eager” or “deferred,” documentation states:

“The tool may need to be loaded if it is deferred. Use toolSearch to find available tools and loadTool to activate them.”

This applies to:

• Forge/Forge_Agent_Orchestration.md — currently says forge-discovery is “deferred”
• Forge/Forge_Infrastructure.md — currently lists specific tools as “eager” or “auto-start”

The current system prompt’s Environment section (“Most tools are deferred”) is acceptable as a general statement, but specific tool classifications should not be hardcoded in documentation.