Skip to main content

​
ICP (Ideal Customer Profile) Module

​
1. Overview

The ICP Module defines and validates your ideal customer before you build anything. Upload your venture documents, and the platform analyzes them to extract a clear customer profile - then helps you test whether these customers actually want what you plan to ship. This keeps you from building for the wrong market.

​
2. Step-by-Step Guide

  1. Navigate to ICP Selection - Go to /icpselection from your dashboard to start defining your ideal customer profile.
  2. Submit Your Documents - Upload pitch decks, business plans, or market research documents via the document upload interface. The system accepts Word documents and PDFs.
  3. Review Extracted Brief - The platform analyzes your documents and generates an extracted brief at /extractedbriefreview. Review the customer profile, pain points, and market segments the AI identified from your materials.
  4. Confirm or Correct the Brief - If the extracted profile matches your vision, confirm it using POST /api/v1/icp/:jobId/confirm-brief. If not, provide corrections to refine the customer definition.
  5. Analyze ICP Fit - Trigger analysis with POST /api/v1/icp/:jobId/analyze to evaluate how well your proposed solution aligns with the identified customer needs.
  6. Access Your ICP Dashboard - Visit /icplifecycle to see your complete customer profile, including demographics, psychographics, and behavioral patterns.
  7. Test Your Profile - Move to /icptesting to run validation tests against real market data and synthetic customer scenarios.
  8. Review Analytics - Check /syntheticicpdashboard for insights on how your ICP responds to different value propositions and messaging approaches.

​
3. Common Questions

What documents should I upload for the best ICP extraction?
Upload any materials that describe your target customers - pitch decks, business plans, customer research, competitor analyses, or market studies. The more detail about customer pain points and behaviors, the better the extraction quality. Can I change my ICP after it’s been confirmed?
Yes. Select a different ICP from /icpselection or update your venture profile through PUT /api/v1/icp/venture-profile. The system tracks your ICP selections and allows you to pivot as you learn more about your market. How does the platform validate my ICP?
The system generates synthetic customer profiles based on your ICP definition, then tests your value proposition against these profiles. You can see validation results, segment analysis, and messaging effectiveness reports through the testing dashboard. What happens to my ICP data if I join the Venture Studio program?
When you opt in via POST /api/v1/icp/:jobId/venture-studio-opt-in, your validated ICP becomes part of your venture portfolio. This gives studio resources access to your customer insights to accelerate your build process. Can I see how other ventures define their ICPs?
Use GET /api/v1/icp/analytics to view anonymized ICP analytics across the platform. This shows common customer patterns and market trends without exposing specific venture details.

​
4. Troubleshooting

Document extraction produces incomplete customer profiles
Your source documents may lack specific customer details. Add documents that explicitly describe customer demographics, pain points, buying behaviors, or day-in-the-life scenarios. Rerun extraction with POST /api/v1/icp/:jobId/analyze after adding richer source material. ICP testing shows low validation scores
Low scores indicate a mismatch between your proposed solution and customer needs. Review the segment analysis reports to identify which customer attributes are causing friction. Refine your value proposition or adjust your ICP definition to target a more receptive segment. Cannot confirm brief - system reports missing required fields
The extracted brief must include minimum viable customer definition - at least one clear pain point, demographic segment, and behavioral pattern. Add more specific customer information to your source documents and regenerate the brief. Synthetic ICP generation fails or times out
Check generation status at GET /api/v1/synthetic-icp/:jobId/status. If stuck, regenerate with POST /api/v1/synthetic-icp/:jobId/regenerate. Large ICP definitions with many segments may take several minutes to process. Brief Review - After confirming your ICP, move to /briefreview to see how your customer profile translates into a complete venture brief. The ICP feeds directly into brief generation, ensuring your entire venture definition aligns with real customer needs. CVP Dashboard - Visit /cvpdashboard to develop your Customer Value Proposition based on the validated ICP. This feature uses your confirmed customer profile to craft messaging and positioning that resonates with your target market. Charter - Once your ICP is validated, access /charter to formalize your venture charter. The charter incorporates your ICP insights to define success metrics, target milestones, and go-to-market strategy aligned with your ideal customer.