> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fiftyknots.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Feature 030: ICP (Ideal Customer Profile) Module

> The ICP Module defines and validates your ideal customer before you build anything. Upload your venture documents, and the platform analyzes them to e

# 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.

### 5. Related Features

**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.