Roadmap Analyzer

Overview

This skill analyzes a project's current feature set against the needs of the Ideal Customer Profile (ICP). Before analyzing, discover the project's ICP from documentation (.agent/SYSTEM/ or project docs) and current features from the codebase and documentation.

The skill produces three outputs:

1. Gap Analysis Table: Side-by-side comparison of ICP needs vs current features with gaps highlighted
2. Prioritized Backlog: Ranked list of features to build next based on ICP alignment and impact
3. Strategic Themes: High-level focus areas with specific initiatives

When to Use This Skill

Invoke this skill when asked to:

• "What should we build next?"
• "Compare our features against what our customers need"
• "Analyze product gaps for our ICP"
• "Help me plan the product roadmap"
• "What features are missing for our target customers?"
• "Evaluate our competitive positioning"
• "What do we need to focus on to serve SMBs creating UGC?"

Analysis Workflow

Step 1: Discover Current Features

Use a hybrid approach to identify existing project capabilities (discover from project):

1.1 Automated Codebase Scan

Search the codebase for feature implementations. Focus on:

Key directories to explore:

apps/frontend-apps/*/      - Frontend applications
apps/apis/*/               - Backend APIs
packages/*/                - Shared packages

Search patterns for features:

• Component names (React components often indicate UI features)
• API endpoints (routes indicate backend capabilities)
• Service methods (business logic indicates functionality)
• Database schemas (data models reveal supported features)
• Configuration files (feature flags, settings)

Use grep/glob to find:

• Video editing features: pattern: "edit|timeline|trim|cut|transition"
• Avatar features: pattern: "avatar|character|persona|voice"
• Export features: pattern: "export|format|platform|render"
• Template features: pattern: "template|preset|brand"
• AI features: pattern: "ai|generate|auto|openai|anthropic"

1.2 User Context Integration

Ask the user:

• "Are there features I should know about that might not be obvious in the code?"
• "Any recent features added that might not be fully integrated?"
• "Features in beta or soft-launched?"
• "Integrations or capabilities documented elsewhere?"

1.3 Feature Inventory Creation

Organize discovered features into categories from references/feature-categories.md:

1. Content Input & Ideation
2. AI Avatar Creation & Management
3. Video Editing & Assembly
4. Visual Enhancement & Effects
5. Text, Captions & Typography
6. Audio & Music
7. Platform Optimization & Export
8. Templates & Brand Management
9. Collaboration & Workflow
10. Asset Management & Media Library
11. AI & Automation Features
12. Analytics & Performance
13. Learning & Support
14. Integration & Ecosystem
15. E-commerce & Monetization

For each feature, note:

• Status: Exists (production), Partial (incomplete), Planned, Missing
• Quality: Production-ready, Beta, Prototype, Needs improvement
• Location: Where found in codebase (file paths)

Step 2: Load ICP and Editor Needs Context

Read the reference documents to understand requirements:

Required reading:

• references/icp-profile.md - Deep understanding of target customer needs
• references/editor-needs.md - What editors need for great social content
• references/feature-categories.md - Comprehensive feature taxonomy

Key focus areas from ICP:

1. AI Avatar Army: Creating multiple avatars, consistency, customization
2. User Empowerment: Self-service creation, templates, intuitive UX
3. UGC at Scale: Volume, speed, platform-native content
4. Team Collaboration: Multi-user, approvals, brand consistency

Critical editor needs:

• Platform-specific optimization (TikTok, Instagram, YouTube)
• Fast pacing and trending effects
• Text overlays and captions
• Audio/music integration
• Quick variations for A/B testing

Step 3: Gap Analysis

Compare current features against ICP needs and editor requirements.

3.1 Create Gap Analysis Table

Format:

| Feature Category | ICP Need Priority | Current State | Gap Severity | Key Missing Elements |
|-----------------|-------------------|---------------|--------------|----------------------|
| AI Avatar Creation | CRITICAL | Partial | HIGH | Multiple avatars, avatar library, voice cloning |
| Platform Optimization | CRITICAL | Missing | CRITICAL | Auto-reframe, batch export multiple formats |
| ... | ... | ... | ... | ... |

Gap Severity Levels:

• CRITICAL: Blocking ICP adoption, core value prop missing
• HIGH: Significantly impacts ICP success, competitive disadvantage
• MEDIUM: Limits scale/efficiency, nice-to-have
• LOW: Future enhancement, not blocking

Priority Levels:

• CRITICAL: Must-have for ICP, core to value proposition
• HIGH: Important for ICP succe

...