Request Analyzer
Classifies incoming requests to enable intelligent routing and identify clarification needs before delegating to specialist agents.
When to Use
- When receiving a new user request that needs classification
- When determining which specialist agent should handle a request
- When identifying if requirements are too vague to proceed
- When detecting buzzwords that need to be challenged
Analysis Framework
Step 1: Detect Intent
Classify the primary intent:
| Intent |
Indicators |
Route |
| Strategic |
"roadmap", "strategy", "plan", "prioritize", "decide" |
May need validation |
| Implementation |
"build", "create", "implement", "design", "architect" |
Design work |
| Debugging |
"fix", "broken", "error", "slow", "not working" |
Debug/investigate |
| Documentation |
"document", "explain", "describe", "write docs" |
Documentation |
Step 2: Classify Request Type
| Type |
Key Phrases |
Primary Agent |
| Design |
"How should I build...", "What architecture...", "Design a system..." |
cto-architect |
| Validate |
"Is this plan solid?", "Thoughts on...", "Review my roadmap..." |
strategic-cto-mentor |
| Debug |
"Why is X slow?", "Fix this error...", "Troubleshoot..." |
debug-helper |
| Document |
"Write documentation for...", "Explain how..." |
docs-writer |
| Review |
"Review this code...", "Check for issues..." |
code-reviewer |
Step 3: Assess Complexity
| Complexity |
Characteristics |
Execution Pattern |
| Single |
Clear scope, one domain, obvious routing |
Direct to one agent |
| Sequential |
Multiple phases, depends on previous output |
Agent chain |
| Parallel |
Independent domains, can run simultaneously |
Multiple agents in parallel |
Step 4: Identify Vague Terms
Scan for buzzwords that require clarification. See buzzword-dictionary.md for the complete list.
Common red flags:
- "AI-powered" - What specific AI capability?
- "scale" - What numbers? From what to what?
- "fast" / "soon" - What timeline exactly?
- "simple" - Simple for whom? What constraints?
- "modern" - What specific technologies?
Step 5: Detect Missing Context
Check for required context based on request type:
For Design Requests:
For Validation Requests:
Output Format
Provide analysis in this structure:
## Request Analysis
**Intent**: [strategic | implementation | debugging | documentation]
**Type**: [design | validate | debug | document | review]
**Complexity**: [single | sequential | parallel]
### Vague Terms Detected
- "[term]" - needs clarification: [what to ask]
### Missing Context
- [missing information item]
### Suggested Routing
**Primary Agent**: [agent name]
**Rationale**: [why this agent]
### Clarification Needed
[yes/no] - [brief explanation]
### Recommended Next Step
[what to do next - clarify or delegate]
Examples
Example 1: Vague Request
User: "I want to add AI capabilities to my app"
Analysis:
- Intent: Implementation
- Type: Design
- Complexity: Unknown (needs clarification)
- Vague Terms: "AI capabilities" - What specific problem are we solving?
- Missing Context: Scale, budget, timeline, team, existing stack
- Clarification Needed: Yes
- Next Step: Use clarification-protocol before routing
Example 2: Clear Design Request
User: "Design a real-time notification system for 100K users, using our existing PostgreSQL database and Node.js backend"
Analysis:
- Intent: Implementation
- Type: Design
- Complexity: Single
- Vague Terms: None
- Missing Context: Timeline, budget (nice to have but not blocking)
- Suggested Routing: cto-architect
- Clarification Needed: No (can proceed with optional clarification)
Example 3: Validation Request
User: "Here's my Q2 roadmap - migrate to microservices, add real-time features, and launch mobile app. Thoughts?"
Analysis:
- Intent: Strategic
- Type: Validate
- Complexity: Single
- Vague Terms: None
- Missing Context: Team size, current architecture state
- Suggested Routing: strategic-cto-mentor
- Clarification Needed: Mild (some context helpful but not blocking)
References
- Classification Criteria - Detailed routing logic
- Buzzword Dictionary - Common vague terms to challenge
1---2name: request-analyzer3description: Analyze incoming user requests to detect intent, request type (design/validate/debug/document), complexity level, and identify vague requirements or buzzwords that need clarification. Use when cto-orchestrator receives new requests that need classification before routing to specialist agents.4metadata:5 source: https://skillmd.com/skills/alirezarezvani/request-analyzer6---78# Request Analyzer910Classifies incoming requests to enable intelligent routing and identify clarification needs before delegating to specialist agents.1112## When to Use1314- When receiving a new user request that needs classification15- When determining which specialist agent should handle a request16- When identifying if requirements are too vague to proceed17- When detecting buzzwords that need to be challenged1819## Analysis Framework2021### Step 1: Detect Intent2223Classify the primary intent:2425| Intent | Indicators | Route |26|--------|------------|-------|27| **Strategic** | "roadmap", "strategy", "plan", "prioritize", "decide" | May need validation |28| **Implementation** | "build", "create", "implement", "design", "architect" | Design work |29| **Debugging** | "fix", "broken", "error", "slow", "not working" | Debug/investigate |30| **Documentation** | "document", "explain", "describe", "write docs" | Documentation |3132### Step 2: Classify Request Type3334| Type | Key Phrases | Primary Agent |35|------|-------------|---------------|36| **Design** | "How should I build...", "What architecture...", "Design a system..." | cto-architect |37| **Validate** | "Is this plan solid?", "Thoughts on...", "Review my roadmap..." | strategic-cto-mentor |38| **Debug** | "Why is X slow?", "Fix this error...", "Troubleshoot..." | debug-helper |39| **Document** | "Write documentation for...", "Explain how..." | docs-writer |40| **Review** | "Review this code...", "Check for issues..." | code-reviewer |4142### Step 3: Assess Complexity4344| Complexity | Characteristics | Execution Pattern |45|------------|-----------------|-------------------|46| **Single** | Clear scope, one domain, obvious routing | Direct to one agent |47| **Sequential** | Multiple phases, depends on previous output | Agent chain |48| **Parallel** | Independent domains, can run simultaneously | Multiple agents in parallel |4950### Step 4: Identify Vague Terms5152Scan for buzzwords that require clarification. See [buzzword-dictionary.md](buzzword-dictionary.md) for the complete list.5354**Common red flags:**55- "AI-powered" - What specific AI capability?56- "scale" - What numbers? From what to what?57- "fast" / "soon" - What timeline exactly?58- "simple" - Simple for whom? What constraints?59- "modern" - What specific technologies?6061### Step 5: Detect Missing Context6263Check for required context based on request type:6465**For Design Requests:**66- [ ] Expected user/traffic scale67- [ ] Budget constraints68- [ ] Timeline requirements69- [ ] Team size and expertise70- [ ] Existing infrastructure7172**For Validation Requests:**73- [ ] Current state or existing plan74- [ ] Business goals and constraints75- [ ] Timeline and resources76- [ ] Success criteria7778## Output Format7980Provide analysis in this structure:8182```83## Request Analysis8485**Intent**: [strategic | implementation | debugging | documentation]86**Type**: [design | validate | debug | document | review]87**Complexity**: [single | sequential | parallel]8889### Vague Terms Detected90- "[term]" - needs clarification: [what to ask]9192### Missing Context93- [missing information item]9495### Suggested Routing96**Primary Agent**: [agent name]97**Rationale**: [why this agent]9899### Clarification Needed100[yes/no] - [brief explanation]101102### Recommended Next Step103[what to do next - clarify or delegate]104```105106## Examples107108### Example 1: Vague Request109110**User**: "I want to add AI capabilities to my app"111112**Analysis**:113- **Intent**: Implementation114- **Type**: Design115- **Complexity**: Unknown (needs clarification)116- **Vague Terms**: "AI capabilities" - What specific problem are we solving?117- **Missing Context**: Scale, budget, timeline, team, existing stack118- **Clarification Needed**: Yes119- **Next Step**: Use clarification-protocol before routing120121### Example 2: Clear Design Request122123**User**: "Design a real-time notification system for 100K users, using our existing PostgreSQL database and Node.js backend"124125**Analysis**:126- **Intent**: Implementation127- **Type**: Design128- **Complexity**: Single129- **Vague Terms**: None130- **Missing Context**: Timeline, budget (nice to have but not blocking)131- **Suggested Routing**: cto-architect132- **Clarification Needed**: No (can proceed with optional clarification)133134### Example 3: Validation Request135136**User**: "Here's my Q2 roadmap - migrate to microservices, add real-time features, and launch mobile app. Thoughts?"137138**Analysis**:139- **Intent**: Strategic140- **Type**: Validate141- **Complexity**: Single142- **Vague Terms**: None143- **Missing Context**: Team size, current architecture state144- **Suggested Routing**: strategic-cto-mentor145- **Clarification Needed**: Mild (some context helpful but not blocking)146147## References148149- [Classification Criteria](classification-criteria.md) - Detailed routing logic150- [Buzzword Dictionary](buzzword-dictionary.md) - Common vague terms to challenge