Telos Customer Validator

Download
License: MIT
AI-Powered
Claude Compatible

---

🚀 Why This Exists: The Founder's Paradox

Every startup graveyard is paved with code that nobody wanted. You've felt it—that sinking realization after months of building that your "brilliant" idea is a solution in search of a problem. The Validation Engine exists to make that feeling extinct.

The fundamental truth: Customers don't care about your code. They care about their pain. This AI-powered plugin for Claude Code refuses to let you write a single line of production code until real humans have validated your core hypothesis. It's not a suggestion. It's a contract with reality.

Think of it as your startup's immune system—it detects the cancer of assumption before it metastasizes into useless features.

---

📊 Architecture Overview: The Validation Pipeline

graph TD
    A[Founder Inputs Idea] --> B[Adversarial Customer Roleplay AI]
    B --> C{Validation Score > 7/10?}
    C -->|No| D[Concierge Onboarding: Refine Hypothesis]
    D --> B
    C -->|Yes| E[Generate Customer Interview Script]
    E --> F[AI Conducts Mock Interviews with 13 Personas]
    F --> G[Pattern Detection: Real Pain vs. Imagined Pain]
    G --> H[Validation Report with Confidence Score]
    H --> I{Founder Approved?}
    I -->|No| J[Return to Hypothesis Refinement]
    I -->|Yes| K[Unlock Code Writing Permission]
    K --> L[Feature Prioritization Based on Customer Data]
    L --> M[Production Code Begins]

---

🔧 Core Skills: The 13 Pillars of Validation

#	Skill	Description	AI Model Used
1	Concierge Onboarding	Step-by-step idea refinement with Socratic questioning	Claude 4 Opus
2	Adversarial Customer Roleplay	13 distinct customer personas who will destroy your assumptions	GPT-5 Turbo
3	Pain Point Extraction	Identifies emotional vs. logical buying triggers	Claude 4 Sonnet
4	Market Gap Analysis	Finds white space competitors missed	GPT-5 Turbo
5	Pricing Psychology Engine	Tests willingness-to-pay thresholds	Claude 4 Opus
6	Churn Prediction	Identifies features that cause abandonment	GPT-5 Turbo
7	Feature Prioritization Matrix	Ranks features by customer impact vs. development cost	Claude 4 Sonnet
8	Interview Script Generator	Creates 15-question validation interviews	GPT-5 Turbo
9	Real-Time Sentiment Analysis	Reads emotional subtext in customer responses	Claude 4 Opus
10	Competitive Blindspot Detector	Finds what rivals ignore	GPT-5 Turbo
11	Validation Score Calculator	1-10 scoring with weighted criteria	Claude 4 Sonnet
12	Multicultural Adaptation Engine	Localizes questions for 50+ cultures	GPT-5 Turbo
13	Founder Accountability Monitor	Tracks if you're actually talking to users	Claude 4 Opus

---

💻 Quick Start: Example Profile Configuration

# profile.config.yaml - Your Startup Persona
startup:
  name: "EcoTrack"
  industry: "Sustainability/SaaS"
  target_market: "Small-to-medium businesses in Europe"
  core_proposition: "Carbon footprint tracking automated via API"
  stage: "Pre-product"
  team_size: 3

validation_settings:
  min_validation_score: 7.5
  required_real_interviews: 25
  ai_roleplay_iterations: 10
  language: "en"
  cultural_context: "European"

personas:
  - ceo_skeptic: true
  - cto_technical: true
  - early_adopter: true
  - budget_holder: true
  - competitor_loyalist: true
  - regulatory_expert: true
  - superfan: true
  - eternal_doubter: true
  - enterprise_buyer: true
  - solopreneur: true
  - investor_perspective: true
  - end_user_practical: true
  - industry_analyst: true

api_keys:
  openai: "sk-xxxxxxxxxxxxxxxxxxxxxxxx"
  claude: "sk-ant-xxxxxxxxxxxxxxxxxxxxxxxx"

---

🖥️ Example Console Invocation

# Initialize validation session for your startup idea
$ validation-engine init --idea "AI-powered meal planning for busy parents" --industry "Health & Wellness"

# Output:
╔═══════════════════════════════════════════════════════════╗
║     VALIDATION ENGINE v2026.1 - AI-Powered Discovery     ║
╠═══════════════════════════════════════════════════════════╣
║ Idea: AI-powered meal planning for busy parents          ║
║ Industry: Health & Wellness                              ║
║ Status: Analyzing with 13 adversarial personas...        ║
╚═══════════════════════════════════════════════════════════╝

[00:00:01] Persona 1/13: Busy Working Parent (2 kids)
            Pain Score: 8.2/10 - "I forget what's in my fridge weekly"
[00:00:03] Persona 2/13: Health-Conscious Single
            Pain Score: 3.1/10 - "I just eat the same thing every day, it's fine"
[00:00:05] 🔴 CRITICAL FLAG: Persona 2 reveals assumption error
            Your solution assumes everyone wants variety. 40% don't care.

[00:00:10] Overall Validation Score: 6.4/10 (BELOW THRESHOLD)
            Code writing: LOCKED
            Suggested action: Refine hypothesis with concierge onboarding

$ validation-engine refine --focus "reduce food waste" --segment "families with 2+ kids"

---

🎯 Key Features That Rewrite the Rules

🔥 Adversarial Customer Roleplay (The Assassin)

Our AI doesn't coddle you. It plays the role of your worst customer—the one who will tear your value proposition apart. This isn't negativity; it's vaccination against failure. Each of the 13 personas has distinct biases, budgets, and bullshit detectors.

🧠 Concierge Onboarding with Socratic Method

Most founders have the wrong problem. Our AI guides you through a question-based refinement that looks like a therapist crossbred with a venture capitalist. "Why do you believe this is painful?" "What's the cost of NOT solving this?" "Who feels this pain most acutely?"

📊 Validation Scoring: Objective Reality Check

No more "my mom thinks it's a great idea." The Validation Score (0-10) incorporates:

• Emotional intensity of pain (40%)
• Willingness to pay (25%)
• Frequency of problem occurrence (20%)
• Size of affected market (15%)

Score below 7.0? Code writing remains LOCKED. Go talk to more humans.

🌍 Multilingual & Multicultural Intelligence

Customers in Tokyo don't think like customers in Berlin. Our system adapts validation scripts to 50+ cultural contexts, adjusting for:

• Direct vs. indirect communication styles
• Individualistic vs. collectivist decision-making
• Price sensitivity baselines per region

🔄 Real-Time Sentiment Evolution Tracking

Watch your validation score change in real-time as the AI processes more customer data. It's like watching your startup's future flicker between "possible unicorn" and "expensive lesson."

---

📱 Emoji OS Compatibility Table

Operating System	Compatibility	Notes
🐧 Linux (Ubuntu 22+)	✅ Full	Optimized for terminal-based validation
🍎 macOS 14+	✅ Full	Native Claude Code integration
🪟 Windows 11	✅ Full	WSL2 recommended for best experience
📱 iOS (Claude App)	⚠️ Partial	Limited to interview review, no roleplay
🤖 Android	⚠️ Partial	Read-only validation reports
🐳 Docker	✅ Full	Containerized deployment available
☁️ Cloud (AWS/GCP/Azure)	✅ Full	Serverless validation pipelines

---

🔌 OpenAI & Claude API Integration

The Validation Engine is model-agnostic by design, but optimized for the unique strengths of both ecosystems:

OpenAI (GPT-5 Turbo)

• Best for: Rapid-fire adversarial roleplay, market gap analysis, pricing psychology
• Configuration: --ai-backend openai --model gpt-5-turbo
• Cost: ~$0.03 per validation session (100 persona interactions)
• API Requirements: OPENAI_API_KEY environment variable

Claude (Claude 4 Opus & Sonnet)

• Best for: Concierge onboarding (nuanced Socratic questioning), emotional sentiment analysis, founder accountability monitoring
• Configuration: --ai-backend claude --model claude-4-opus
• Cost: ~$0.05 per validation session (handles complex reasoning)
• API Requirements: ANTHROPIC_API_KEY environment variable

Hybrid Mode (Recommended)

$ validation-engine run --hybrid \
  --openai-for "roleplay" \
  --claude-for "onboarding" \
  --validation-threshold 7.5

The system automatically routes tasks to the optimal model, giving you GPT's speed for adversarial testing and Claude's depth for empathetic refinement.

---

🛠️ Installation & Setup

Prerequisites

• Python 3.11+ or Node.js 18+
• Claude Code CLI installed
• OpenAI API key (for GPT-powered roleplay)
• Anthropic API key (for Claude-powered onboarding)

Quick Install

# Via pip (Python)
pip install validation-engine-2026

# Via npm (Node.js)
npm install @validation-engine/core

# Via Homebrew (macOS)
brew install validation-engine/tap/ve

Docker Deployment

docker pull validation-engine/core:2026.1
docker run -e OPENAI_API_KEY=xxx -e ANTHROPIC_API_KEY=xxx validation-engine/core:2026.1

---

🌟 Why Founders Choose The Validation Engine

"I wasted 18 months building a product nobody wanted. The Validation Engine showed me in 3 hours why it would fail. I pivoted before writing a line of code. This tool should be mandatory for every accelerator."
— Founder, Y Combinator S24 Batch

"The adversarial roleplay is brutal. I cried twice. But I saved $200,000 in development costs. Best emotional beating I ever paid for."
— CEO, ClimateTech Startup

---

📋 Responsive UI & 24/7 Support

Web Dashboard

• Real-time validation score visualization with trend lines
• Persona interaction transcripts with sentiment highlights
• Feature prioritization matrix drag-and-drop interface
• Mobile-responsive for on-the-go interview review

Multilingual Support

The entire dashboard is available in:

• English (default)
• Spanish
• Mandarin Chinese
• Arabic
• Hindi
• French
• German
• Japanese
• Portuguese
• Russian

Customer Support

• AI Chat Support: 24/7/365, < 30 second response time
• Human Escalation: Available Mon-Fri, 9am-6pm EST
• Founder Office Hours: Weekly group sessions with validation experts
• Documentation: Full API reference, video tutorials, and case studies

---

⚠️ Disclaimer

This tool does not guarantee startup success. Markets are complex, timing matters, and execution is everything. The Validation Engine is a decision-support system, not a crystal ball. It dramatically reduces the risk of building something nobody wants, but it cannot eliminate all uncertainty.

AI-generated customer personas are simulations. While our AI has been trained on millions of real customer interactions, simulated feedback cannot fully replace conversations with actual humans. The 25 real interview requirement exists for exactly this reason.

API costs may vary. The prices quoted are estimates based on typical usage. Heavy users (100+ persona interactions per session) may incur higher costs.

Privacy note: All validation session data is encrypted end-to-end. We do not train on your startup ideas. Your competitive advantage stays yours.

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Copyright (c) 2026

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

---

📦 Download & Get Started

Download
Stars
Forks

---

Stop building. Start validating. Because the only code that matters is code your customers are waiting for.