{"id":51215829,"url":"https://github.com/MaxKmet/idea-validation-agents","last_synced_at":"2026-07-16T14:01:09.370Z","repository":{"id":351179957,"uuid":"1209890423","full_name":"MaxKmet/idea-validation-agents","owner":"MaxKmet","description":"AI agents that act as your personal venture analyst - from startup idea brainstorming to full validation and go-to-market strategy. Built for indie developers who'd rather validate in a weekend than regret in six months. Powered by Claude Code, OpenAI Codex, and Cursor.","archived":false,"fork":false,"pushed_at":"2026-04-13T22:45:54.000Z","size":1759,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-14T00:30:26.509Z","etag":null,"topics":["ai-agents","ai-skills","appstore","aso-intelligence","brainstorming","claude-code","codex","cursor","idea-generation","idea-validation","market-analysis","reddit","skills","startup","tiktok","workflow-automation"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MaxKmet.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-04-13T22:13:08.000Z","updated_at":"2026-04-13T22:45:59.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/MaxKmet/idea-validation-agents","commit_stats":null,"previous_names":["maxkmet/idea-validation-agents"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/MaxKmet/idea-validation-agents","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MaxKmet%2Fidea-validation-agents","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MaxKmet%2Fidea-validation-agents/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MaxKmet%2Fidea-validation-agents/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MaxKmet%2Fidea-validation-agents/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MaxKmet","download_url":"https://codeload.github.com/MaxKmet/idea-validation-agents/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MaxKmet%2Fidea-validation-agents/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35546267,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-16T02:00:06.687Z","response_time":83,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","ai-skills","appstore","aso-intelligence","brainstorming","claude-code","codex","cursor","idea-generation","idea-validation","market-analysis","reddit","skills","startup","tiktok","workflow-automation"],"created_at":"2026-06-28T04:01:00.195Z","updated_at":"2026-07-16T14:01:09.362Z","avatar_url":"https://github.com/MaxKmet.png","language":null,"funding_links":[],"categories":["⭐ 精选第三方技能"],"sub_categories":["📣 平台运营 / 自媒体 / 办公流量"],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"readme-assets/to-build-or-not-to-build-meme.png\" alt=\"To Build or Not to Build\" width=\"500\"/\u003e\n\n# Startup Idea Validation Agent\n### *To Build or Not to Build — that is the question this answers.*\n\n**Stop guessing. Start validating.**\n\nAI agents that act as your personal venture analyst — from startup idea brainstorming to full validation and go-to-market strategy. Built for indie developers who'd rather validate in 10 minutes than regret in six months. Powered by Claude Code, OpenAI Codex, and Cursor.\n\n[![Stars](https://img.shields.io/github/stars/MaxKmet/idea-validation-agents?style=flat-square\u0026logo=github\u0026label=Stars)](https://github.com/MaxKmet/idea-validation-agents)\n![AI Agents](https://img.shields.io/badge/AI_Agents-15_Skills-blue)\n![Platforms](https://img.shields.io/badge/Platforms-Claude_Code_%7C_Codex_%7C_Cursor-green)\n![No Setup](https://img.shields.io/badge/Setup-None_Required-brightgreen)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n\n⭐ **Star this repo if you've ever asked ChatGPT to generate a million dollar idea.**\n\n\u003c/div\u003e\n\n---\n\nClone the repo. Open it in your AI tool. Start talking. No setup, no API keys, no commands.\n\n---\n\n## Who Is This For?\n\n- **Indie app developers** who want to validate app ideas before building\n- **Solo founders** exploring B2C startup ideas and looking for a data-driven brainstorming partner\n- **Side-project builders** deciding where to invest their limited time\n- **Aspiring developers** with no idea yet who want to discover one worth building\n- **Anyone** tired of building things nobody wants\n\n---\n\n## 🚀 Quickstart\n\nNo installation. No dependencies. No terminal commands. Just clone and go.\n\n### Claude Code\n\n1. Clone this repository\n```bash\ngit clone https://github.com/MaxKmet/idea-validation-agents.git\n```\n2. Open [Claude Code](https://claude.ai/code) and open the project folder\n3. Start a new chat and say anything — e.g., `\"I want to build a habit tracker for climbers. Is it worth it?\"`\n4. The agent activates automatically from `CLAUDE.md` and starts the right workflow\n\n### OpenAI Codex CLI\n\n1. Clone this repository\n```bash\ngit clone https://github.com/MaxKmet/idea-validation-agents.git\n```\n2. Install [Codex CLI](https://github.com/openai/codex) if you haven't yet\n```bash\nnpm install -g @openai/codex\n```\n3. Navigate to the project folder and run Codex\n```bash\ncd idea-validation-agents\ncodex\n```\n4. Say what you want — e.g., `\"Help me find an app idea\"`. The agent reads `AGENTS.md` and routes you automatically.\n\n### Cursor\n\n1. Clone this repository\n```bash\ngit clone https://github.com/MaxKmet/idea-validation-agents.git\n```\n2. Open the folder in [Cursor](https://cursor.com)\n3. Open the AI chat (Cmd+L / Ctrl+L) and describe your situation  \n   Example: `\"I'm a solo developer with 3 years experience. Help me validate an idea for climbers — a habit tracker with daily streaks and tips.\"`\n4. The agent reads from `.cursor/rules/` and activates automatically\n\n\u003e **That's it.** The agent detects your intent and routes you to the right workflow. All analysis results are saved to the `memory/` folder so nothing is lost between sessions.\n\n---\n\n## Workflows - 4 Ways to Use the Agent\n\n### 💡 Idea Generation — *\"I don't know what to build\"* · `~10–15 min`\n\nThe agent interviews you about your background, skills, and interests — then researches what's actually trending — and generates 7–10 scored app ideas matched specifically to you.\n\n```\nI don't have an app idea yet. Help me find one.\nWhat should I build? I'm a fitness coach with 8k Instagram followers.\nI want to find an app idea in the productivity space.\n```\n\n**Steps:** background interview → builder profile → trend analysis → idea generation → scoring\n\n**Methodology:** Trend signals are pulled from TikTok Creative Center (hashtag velocity), Reddit (community pain language), X/Twitter (public builder and buyer conversations), App Store (new entrants + review patterns), and Google Trends (search demand). Ideas are filtered against your domain expertise, skills, and distribution advantages from the interview — so you get ideas you can actually build and sell.\n\n**Output:** Ranked + scored list of app ideas saved to `memory/ideas/`\n\n\u003e Don't want to answer questions? Say **\"browse topics\"** to pick from 20 product domains, or **\"skip\"** to jump straight to ideas.\n\n---\n\n### 🔍 Idea Validation — *\"Is my idea worth building?\"* · `~10–15 min`\n\nFull 9-step validation. Every dimension scored, weighted, and combined into a final verdict — with the single riskiest assumption identified and a concrete experiment to test it before writing any code.\n\n```\nValidate my idea: an AI tool that rewrites your emails to sound more professional.\nI want to build a habit tracker for intermittent fasting. Worth it?\nScore this — a subscription app that sends meal plans based on your grocery budget.\n```\n\n**Steps:** trend analysis → competitor mapping → desire scoring → pricing model → distribution analysis → retention prediction → CAC modeling → final score (0–100) → decision memo\n\n**Methodology:**\n- **Scoring** uses a multiplicative-floor algorithm — one catastrophic weakness kills the overall score, just like in a real startup\n- **Pricing** is estimated via Van Westendorp price sensitivity analysis + desire-premium multipliers (e.g. survival/status desires command 1.3–2× price premium)\n- **Distribution** models viral coefficient (k-factor) across 6 loop types, ASO opportunity via a 5-factor rubric, and creator economy fit\n- **Competitors** are analyzed via systematic App Store search + 1-star/3-star review mining to surface the exact gaps incumbents leave open\n- **Riskiest Assumption Test (RAT)** designs a ≤2-week, ≤$100 behavioral experiment to validate the single assumption most likely to kill the idea\n- **Pre-mortem** (Klein, 2007) imagines the idea failing in 12 months and traces the most probable causes back to scored weaknesses\n\n**Output:** `decision_memo.md` — verdict (pursue / test / pivot / drop), strengths, risks, RAT experiment, kill criteria, and your next step\n\n---\n\n### 📊 Market Deep Dive — *\"Tell me about this market\"* · `~10–15 min`\n\nResearch a category before committing to any idea. Understand who already owns it, what users hate, and whether the timing is right.\n\n```\nTell me about the journaling app market.\nWhat's happening in the AI language learning space?\nIs the meditation app market still worth entering?\n```\n\n**Steps:** multi-platform trend analysis → competitor landscape → market size (TAM/SAM/SOM) → distribution channel assessment\n\n**Methodology:**\n- Trend velocity scored across platforms: rising-fast / rising / stable / declining\n- X/Twitter analysis separates public demand signals from viral noise, then corroborates them against pricing, competitors, and cross-platform evidence\n- Market saturation rated via a 5-factor rubric (competitor count, incumbent dominance, funding activity, keyword saturation, content saturation)\n- Market size uses triangulated bottom-up estimation: search volume × intent conversion rate, community size × platform multiplier, and competitor revenue proxies — cross-checked for consistency\n- SOM estimates use indie-realistic capture rate benchmarks by app category (e.g. niche productivity: 0.5–2.0% year 1)\n\n**Output:** Trend intelligence + competitor map + TAM/SAM/SOM estimates saved to `memory/market_insights/`\n\n---\n\n### 🔄 Pivot Optimization — *\"My idea scored low. Now what?\"* · `~10–15 min`\n\nFinds the best version of a failing idea instead of abandoning it entirely. Each pivot option changes exactly 1–2 variables — audience, niche, pricing model, or feature emphasis — with a projected score improvement before you commit.\n\n```\nMy idea scored 34/100. Should I pivot?\nThe validation said to pivot. What are my best options?\nThis isn't working — what should I change about my fitness app idea?\n```\n\n**Steps:** re-read scores → weakness root cause analysis → 2–3 pivot options with projected scores → re-score best option\n\n**Methodology:**\n- Weaknesses are classified by root cause: structural (can't fix), situational (fixable with time/budget), knowledge-gap (needs more research), or addressable (clear fix exists) — only the latter two generate pivot options\n- Each pivot must pass the **Same Idea Test**: changes 1–2 variables, preserves at least one strong dimension, and has evidence from market_insights or competitor review mining\n- Scoring simulation projects how each dimension shifts before full re-scoring\n- Effort is estimated and adjusted for founder tier — what's \"medium\" for a builder is \"high\" for a beginner\n\n**Output:** `pivot_options.json` with ranked pivots, effort estimates, and projected score ranges\n\n---\n\n## What Gets Saved\n\nAll outputs persist in `memory/` between sessions.\n\n```\nmemory/\n├── user_profile.md                   ← your builder profile (reused across sessions)\n├── market_insights/\n│   └── fitness-tiktok-2026-04.md     ← trend data per niche + platform\n└── ideas/\n    └── habit-tracker-climbers/\n        ├── competitors.json\n        ├── pricing.json\n        ├── scores.json\n        └── decision_memo.md          ← the final verdict\n```\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**[⭐ Star this repo](https://github.com/MaxKmet/idea-validation-agents)** so you don't lose it.\n\n*Validate in 10 minutes. Build with confidence.*\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMaxKmet%2Fidea-validation-agents","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FMaxKmet%2Fidea-validation-agents","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMaxKmet%2Fidea-validation-agents/lists"}