Skip to content
cccskills
FreePublished on GitHub

request-analyzer

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.

The English summary is being prepared. Showing the original description.

See how to install

Files included (3)

  • SKILL.md5.0 KB
  • buzzword-dictionary.md5.7 KB
  • classification-criteria.md3.8 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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:

IntentIndicatorsRoute
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

TypeKey PhrasesPrimary 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

ComplexityCharacteristicsExecution Pattern
SingleClear scope, one domain, obvious routingDirect to one agent
SequentialMultiple phases, depends on previous outputAgent chain
ParallelIndependent domains, can run simultaneouslyMultiple 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:

  • 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

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Detect common technical and organizational anti-patterns in proposals, architectures, and plans. Use when strategic-cto-mentor needs to identify red flags before they become problems.

The English summary is being prepared. Showing the original description.

alirezarezvani/claude-cto-team118Updated Dec 18, 2025

Recommend architecture patterns (monolith, microservices, serverless, modular monolith) based on scale, team size, and constraints. Use when cto-architect needs to select the right architectural approach for a new system or migration.

The English summary is being prepared. Showing the original description.

alirezarezvani/claude-cto-team118Updated Dec 18, 2025

Identify and challenge implicit assumptions in plans, proposals, and technical decisions. Use when strategic-cto-mentor needs to surface hidden assumptions and wishful thinking before they become costly mistakes.

The English summary is being prepared. Showing the original description.

alirezarezvani/claude-cto-team118Updated Dec 18, 2025

Generate targeted clarifying questions (2-3 max) that challenge vague requirements and extract missing context. Use after request-analyzer identifies clarification needs, before routing to specialist agents. Helps cto-orchestrator avoid delegating unclear requirements.

The English summary is being prepared. Showing the original description.

alirezarezvani/claude-cto-team118Updated Dec 18, 2025

Infrastructure and development cost estimation for technical projects. Use when planning budgets, evaluating build vs buy decisions, or projecting TCO for architecture choices.

The English summary is being prepared. Showing the original description.

alirezarezvani/claude-cto-team118Updated Dec 18, 2025

Transform clarified user requests into structured delegation prompts optimized for specialist agents (cto-architect, strategic-cto-mentor, cv-ml-architect). Use after clarification is complete, before routing to specialist agents. Ensures agents receive complete context for effective work.

The English summary is being prepared. Showing the original description.

alirezarezvani/claude-cto-team118Updated Dec 18, 2025

See all skills by alirezarezvani

Report a problem with this skill