edit-tool

# Edit Tool Orchestrator

Automatically triages tool creation requests to the appropriate mechanism (skill, command, agent, or script).

## Triage Process

**CRITICAL**: Always follow these steps:

1. **Analyze request** against decision tree
2. **Explain decision** to user with rationale
3. **Invoke appropriate skill** or provide guidance

## Decision Tree

```mermaid
graph TD
    A[Tool Request] --> B{Deterministic<br/>shell only?}
    B -->|Yes| C{AI needed to<br/>decide when/how?}
    C -->|No| BASH[✅ Bash Script<br/>0 tokens]
    C -->|Yes| D{Token<br/>budget?}
    D -->|<500| WRAP[✅ Skill + scripts/<br/>AI wraps code]
    D -->|>500| CMD1[✅ Command<br/>+ @filepath]

    B -->|No| E{Token<br/>budget?}
    E -->|>2000| AGENT[✅ Sub-Agent<br/>Isolated context]
    E -->|500-2000| F{Invocation?}
    F -->|User| CMD2[✅ Command<br/>User controls]
    F -->|Auto| AGENT

    E -->|<500| G{Frequency?}
    G -->|5+ per session| H{Specific<br/>capability?}
    H -->|Yes| SKILL[✅ Skill<br/>Auto-invoked]
    H -->|No| CMD2
    G -->|1-2 per session| CMD2
    G -->|Rare <1/10| DIRECT[❌ Direct Request<br/>No tool needed]

    style BASH fill:#90EE90,stroke:#000,stroke-width:2px,color:#000
    style SKILL fill:#FFD700,stroke:#000,stroke-width:2px,color:#000
    style WRAP fill:#FFA500,stroke:#000,stroke-width:2px,color:#000
    style CMD1 fill:#87CEEB,stroke:#000,stroke-width:2px,color:#000
    style CMD2 fill:#87CEEB,stroke:#000,stroke-width:2px,color:#000
    style AGENT fill:#DDA0DD,stroke:#000,stroke-width:2px,color:#000
    style DIRECT fill:#FFB6C1,stroke:#000,stroke-width:2px,color:#000
```

## Decision Factors Reference

When path requires multiple criteria, consult:

| Factor | Key Question | Result |
|--------|--------------|--------|
| **Token Budget** | <500 / 500-2000 / >2000? | Skill / Command / Agent |
| **Frequency** | 5+ / 1-2 / <1 per 10 sessions? | Skill / Command / Direct |
| **Context** | Main / Isolated? | Command / Agent |
| **Scripts** | AI wrapper need