Tool Audit

2. Description length ≤ 100 chars per tool

grep -B5 'async fn ' crates/mcp-server/src/tools/*.rs | grep 'description = "' | awk -F'description = "' '{print length($2)-2, $2}' | sort -rn | head -10

Any line starting with a number > 100 is over budget.

3. Description keyword quality

For each tool description, check:

• First 50 chars answer "WHAT does it do?"
• Has concrete domain keywords the model can match
• Disambiguates from similar tools

4. Consolidation candidates

Look for tool pairs where descriptions differ in <3 keywords — those are merge candidates.

Output format

Report markdown:

## Tool Audit (YYYY-MM-DD)

**Total tools:** N / 40 ✅
**Descriptions over 100 chars:** 0 ✅

### Tools by file
...

### Consolidation candidates
- tool_a + tool_b — both search-related, could be merged

### Breaking change budget
Next release: patch / minor / major

Codescope-first rule

• search(mode="fuzzy", query="#\\[tool(") to see all tool declarations in context
• knowledge(action="search", query="tool consolidation") for historical decisions