Startup idea validation is notoriously murky — AI tools often flatter your concepts instead of challenging them. idea-validation-agents flips this script with a markdown-driven AI agent framework that acts like a personal venture analyst for indie developers. Its core innovation is a multiplicative-floor scoring algorithm that brutally punishes any critical weakness in your startup idea, reflecting the harsh reality that one fatal flaw can sink a project.
what idea-validation-agents does
This repository provides a set of AI agent workflows designed to guide solo founders or indie developers through the process of generating, validating, and optimizing startup ideas. The system is entirely markdown-driven, relying on configuration files like CLAUDE.md, AGENTS.md, and .cursor/rules/ to define workflows and interaction logic.
The framework supports four main workflows:
- Idea generation
- A detailed 9-step validation process using a multiplicative-floor scoring system
- Market deep dives analyzing signals from platforms like TikTok, Reddit, the App Store, and Google Trends
- Pivot optimization to refine or redirect ideas based on validation feedback
Under the hood, it integrates established startup evaluation methodologies such as Van Westendorp pricing models, viral coefficient modeling with six loops, App Store Optimization (ASO) rubrics, competitor review mining, and pre-mortem risk analysis. These contribute to a composite 0–100 score representing the idea’s viability.
Importantly, the system includes a Riskiest Assumption Test (RAT) that focuses on identifying the single most critical unknown in your idea and designs a focused, low-cost experiment (≤2 weeks, ≤$100) to validate or invalidate it before any coding begins.
The entire agent system is designed to work without any installation or dependencies. It operates seamlessly when opened in AI environments like Claude Code, OpenAI Codex CLI, or Cursor, automatically routing the user to the appropriate workflow based on input.
All session outputs and analyses are persisted in a memory/ folder, ensuring continuity across user sessions.
technical strengths and design tradeoffs
The standout technical feature is the multiplicative-floor scoring algorithm. Unlike additive or averaging methods commonly used in startup validation tools, this approach ensures that any catastrophic failure in a validation step results in a zero score overall. This mirrors real-world conditions where a single fatal flaw can doom a venture regardless of strengths elsewhere.
This design choice enforces brutal honesty and prevents the AI from offering naive optimism. It’s a rare example of embedding realistic risk tolerance into AI-driven validation.
The architecture’s reliance on markdown files — CLAUDE.md, AGENTS.md, and .cursor/rules/ — to encode workflows and routing rules is both a strength and a limitation. It dramatically lowers the barrier to entry by eliminating the need for specialized setup or coding knowledge, but also constrains extensibility and performance. The code base is surprisingly clean and well-organized for a system driven by textual configuration.
Supporting multiple AI platforms out of the box (Claude Code, Codex CLI, Cursor) without additional dependencies is a practical win for developer experience. It means users can leverage existing AI tooling environments with minimal friction.
The integration of diverse market data signals (TikTok trends, Reddit discussions, App Store data, Google Trends) enriches the validation process, though the exact methods for aggregating and weighting these signals are not deeply exposed in the public configuration, which could be seen as a black-box element.
Persistence of outputs in a dedicated memory/ folder is a pragmatic feature enabling session continuity, which is essential for longer validation cycles.
quick start with idea-validation-agents
The project requires no installation or dependencies, making it accessible for quick experimentation. Here’s how to get started on each supported platform:
Claude Code
- Clone the repository:
git clone https://github.com/MaxKmet/idea-validation-agents.git
Open Claude Code and load the project folder.
Start a new chat and enter a prompt such as:
"I want to build a habit tracker for climbers. Is it worth it?"
The agent will activate automatically using CLAUDE.md and guide you through the appropriate workflow.
OpenAI Codex CLI
- Clone the repository:
git clone https://github.com/MaxKmet/idea-validation-agents.git
- Install Codex CLI if not already installed:
npm install -g @openai/codex
- Navigate to the project folder and run Codex:
cd idea-validation-agents
codex
- Enter a prompt like:
"Help me find an app idea"
The system reads AGENTS.md to route you to the right workflow.
Cursor
- Clone the repository:
git clone https://github.com/MaxKmet/idea-validation-agents.git
Open the folder in Cursor.
Open AI chat (Cmd+L / Ctrl+L) and describe your situation, for 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."
The agent reads .cursor/rules/ and activates automatically.
All analysis results save to the memory/ folder, so no work is lost between sessions.
verdict
idea-validation-agents offers a refreshing approach to early-stage startup analysis by embedding a rigorous, realistic scoring mechanism that punishes critical risks quantitatively. Its zero-install markdown-driven design is well-suited to solo indie developers who want to leverage AI for structured idea validation without wrestling with complex setup.
However, the heavy reliance on markdown workflows and AI platform compatibility means it’s not a plug-and-play tool for all environments. Extensibility beyond the provided workflows could be limited for teams wanting deeper customization or integration into larger systems.
If you’re a solo founder or indie dev looking for a no-dependency AI companion to critically assess and optimize your startup ideas with a clear emphasis on risk and experiment-driven validation, this repo is worth exploring. Just be prepared for its brutally honest scoring and the learning curve around its markdown agent architecture.
Related Articles
- Softaworks Agent Toolkit: A modular plugin marketplace for AI coding agents — Softaworks Agent Toolkit offers 40+ modular AI skills and plugins for coding agents like Claude Code, enabling composabl
- MLE-Agent: Autonomous LLM agents for end-to-end ML workflow automation — MLE-Agent is a Python LLM agent framework that automates ML workflows, including autonomous Kaggle competitions and smar
- Inside agents: a granular multi-agent orchestration system with PluginEval quality assurance — Explore agents, a Python-based multi-agent orchestration repo featuring 184 AI agents, 78 plugins, and a three-layer Plu
- Inside claude-code-writer: building a multi-platform AI content pipeline with Claude Code agents — claude-code-writer uses Claude Code slash commands and specialized agents to automate content creation from raw ideas to
- agent-startup-kit: reusable AI coding workflows as skill playbooks for SaaS dev — agent-startup-kit offers a modular set of AI-assisted coding workflows for SaaS, packaged as reusable skill playbooks fo
→ GitHub Repo: MaxKmet/idea-validation-agents ⭐ 175