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:

Step 2: Classify Request Type

Step 3: Assess Complexity

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:

• Expected user/traffic scale
• Budget constraints
• Timeline requirements
• Team size and expertise
• Existing infrastructure

For Validation Requests:

• Current state or existing plan
• Business goals and constraints
• Timeline and resources
• Success criteria

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