An adversarial business-validation pipeline for Claude Code. It takes a raw idea and refuses to be impressed by it — demanding cited demand evidence from real communities, unit economics that survive a sensitivity analysis, a minimum-investment forecast, a regulatory check, and an Al Ries positioning decision — before producing a Pitch, Business Plan, SWOT and Roadmap.
business-brainstorming is a Claude Code skill that runs a 9-phase validation pipeline on a business idea, plus three custom subagents that do the hard, unpleasant parts: a devil's advocate, a positioning strategist, and an economic-model analyst.
Most AI brainstorming makes you feel good about your idea. This one is built to do the opposite.
| Generic AI brainstorm | Venture Validator |
|---|---|
| Agrees with your premise | Default stance: this idea will fail — prove me wrong |
| "The market is large and growing" | TAM/SAM/SOM with method and sources declared |
| Invented user pain | Quotes from Reddit / forums / reviews, or an explicit [NON VERIFICATO] tag |
| Optimistic revenue projections | Unit economics with every assumption named + 3 scenarios + sensitivity analysis |
| "You could differentiate by…" | Forced decision: sharpen an existing category, or create a new one — and what you sacrifice |
| Deliverables on demand | Hard gate: no Business Plan until the evidence phases exist on disk |
Every run writes a full paper trail to ventures/<slug>/ in your working directory:
ventures/my-idea/
├── 00-intake.md Founder-market fit, assets, budget, geography, goal
├── 01-ideation-funnel.md (Generate mode only) N ideas scored and funnelled
├── 02-demand-validation.md Cited pain evidence, customer lexicon, signal strength
├── 03-market-competition.md TAM/SAM/SOM, competitor matrix, substitutes, whitespace
├── 04-economics.md Revenue model, CAC/LTV, min investment, 3 scenarios
├── 05-barriers-feasibility.md Licences, sector rules, privacy, time/cost to clear them
├── 06-positioning.md The word to own, category strategy, naming, sacrifice
├── 07-verdict-scorecard.md 8-dimension scorecard, verdict, top 3 risks + experiments
└── deliverables/
├── pitch.md 10-12 slides + one-liner + 30s elevator pitch
├── business-plan.md 11 sections, each traced back to its source artifact
├── swot.md SWOT + TOWS cross-strategies, every entry evidence-linked
└── roadmap.md De-risking roadmap driven by the top 3 risks
- Claude Code — the skill relies on the Skill tool, the Agent tool (subagents) and web search. It is not designed for the web UI.
- Optional: Bright Data MCP for deeper community/review sentiment. Without it the skill degrades to WebSearch +
deep-researchand says so in the artifact — it never silently pretends.
Option A — as a Claude Code plugin (recommended)
/plugin marketplace add giosh-me/venture-validator/plugin install venture-validator@giosh-pluginsThen /reload-plugins. Plugin skills are namespaced, so it is invoked as /venture-validator:business-brainstorming.
Option B — installer script
git clone https://github.com/giosh-me/venture-validator.git && cd venture-validator && ./install.shCopies the skill to ~/.claude/skills/business-brainstorming/ and the three agents to ~/.claude/agents/. Existing files are backed up with a timestamp, never silently overwritten. ./install.sh --project installs into the current project's .claude/ instead; ./install.sh --uninstall removes both.
Option C — manual
cp -R skills/business-brainstorming ~/.claude/skills/ && cp agents/*.md ~/.claude/agents//business-brainstorming
Phase 0 asks which entry mode you want:
- Validate — you already have a defined idea. Skips Phase 1, starts at demand validation.
- Generate — you have a domain, a problem or an asset ("I'm good at X", "this annoys me"). Phase 1 generates N ideas, scores them, shortlists, and you pick 1–2.
Both modes converge on the same Phase 2→8 pipeline. You can also enter mid-pipeline (e.g. jump to Phase 4 if you already did the demand research) — the skill will tell you which scorecard dimensions will be left unassessed.
flowchart TD
P0[Phase 0 - Intake and framing] --> M{Entry mode}
M -->|Generate| P1[Phase 1 - Ideation funnel]
M -->|Validate| P2
P1 --> P2[Phase 2 - Demand validation]
P2 --> P3[Phase 3 - Market and competition]
P3 --> P4[Phase 4 - Economics and forecast]
P4 --> P5[Phase 5 - Barriers and feasibility]
P5 --> P6[Phase 6 - Positioning]
P6 --> P7[Phase 7 - Stress test and scorecard]
P7 --> P8[Phase 8 - Deliverables]
P2 -.critique.-> DA(Devil's Advocate)
P4 -.critique.-> DA
P6 -.critique.-> DA
DA -.leads pre-mortem.-> P7
| # | Phase | What it does | Scorecard dimension |
|---|---|---|---|
| 0 | Intake & framing | Founder-market fit, assets, budget/time, geography, lifestyle vs scalable goal | Founder-Market Fit |
| 1 | Ideation funnel (Generate only) | N ideas scored on pain, market access, asset fit, monetisability, defensibility | quick screen |
| 2 | Demand validation | Real sentiment from Reddit/forums/reviews: pain intensity, what people already pay, customer lexicon, trend | Demand Evidence |
| 3 | Market & competition | Who already serves the need, prices, gaps, substitutes, TAM/SAM/SOM, timing | Market Attractiveness · Competitive Whitespace |
| 4 | Economics & forecast | Revenue model, CAC/LTV/margin/payback, pricing, break-even, minimum investment, 3 scenarios | Economic Viability · Capital Efficiency |
| 5 | Barriers & feasibility | Licences, sector regulation, privacy, per-geography requirements, time and cost to clear | Entry Barriers / Regulatory |
| 6 | Positioning (Al Ries) | The one word to own, existing vs new category, focus and sacrifice, naming direction | Positioning Strength |
| 7 | Stress test & scorecard | 18-month pre-mortem, fragile assumptions, kill criteria, weighted verdict, top 3 risks | consolidated verdict |
| 8 | Deliverables | Pitch, Business Plan, SWOT, Roadmap, built from the artifacts above | — |
Each phase dispatches agents (in parallel where useful), writes its artifact, and ends with a dialogue checkpoint — you correct or proceed. If a phase comes out weak, the skill warns you before letting you spend more research on the next one.
Eight dimensions, each scored 1–5 against explicit anchors, aggregated into a weighted score:
| Dimension | Weight | Phase |
|---|---|---|
| Demand Evidence | 25% | 2 |
| Economic Viability | 15% | 4 |
| Positioning Strength | 15% | 6 |
| Capital Efficiency | 10% | 4 |
| Market Attractiveness | 10% | 3 |
| Entry Barriers / Regulatory | 10% | 5 |
| Founder-Market Fit | 10% | 0 |
| Competitive Whitespace | 5% | 3 |
Four verdict bands: GO · GO-WITH-RISKS · PIVOT (with a pivot direction) · NO-GO (with what would need to change).
Two rules make the verdict hard to game:
- Soft gates. No verdict blocks you. If you want to proceed against a NO-GO you can — but the override is recorded in the verdict artifact with your stated reason.
- Anti-masking rule. If
Demand EvidenceorEconomic Viabilityscores 1, it is raised as a red flag at the top of the verdict regardless of the weighted average. A good average cannot bury the absence of real demand or of an economy that stands up.
Weights are per-project adjustable — redistribute them for capital-intensive or heavily regulated ventures, but they must still sum to 100% and the change is declared in the verdict artifact.
| Agent | Role |
|---|---|
business-devils-advocate |
Adversarial critic. Vitamin vs painkiller, founder-bias exposure, "would they actually pay?", steelmans the strongest competitor and the do-nothing status quo, runs the 18-month pre-mortem. Never nihilistic: every critique names the evidence threshold that would change its mind. |
positioning-strategist |
Al Ries / Jack Trout tradition. Finds the single word to own in the mind and forces the call — sharpen an existing category or create a new one — with focus, sacrifice and a naming direction. Backed by a 22-laws playbook in references/positioning-playbook.md. |
economic-model-analyst |
Revenue model (immediate vs future monetisation), unit economics with every assumption declared, minimum-investment forecast (capex/opex, runway to break-even), 3 scenarios and a sensitivity analysis of the 2–3 assumptions that move the result most. |
A three-level cascade, checked at runtime and degraded gracefully:
- Bright Data MCP — primary for communities and reviews (
brand-listening,scrape,search,competitive-intel) - Native WebSearch / WebFetch — fallback and cross-check
deep-research— adversarially verified dossier on a critical claim
Binding rules, enforced in references/research-methods.md:
- Every key insight carries ≥1 citation (quote + source). Anything unverifiable is tagged
[NON VERIFICATO]and kept in a separate section. - Direct evidence (customers speaking) is distinguished from proxy (third-party articles and reports).
- Weak signal is declared, not inflated — "weak signal: only N mentions" — and it lowers the Demand score.
- Default search runs in Italian + English (Italian communities are often small; English widens the signal). Adjustable per project.
Beyond the three bundled agents, phases dispatch optional agents and skills you may not have installed — Trend Researcher, Reddit Community Builder, Investment Researcher, Financial Analyst, Brand Guardian, Reality Checker, Legal Compliance Checker, Executive Summary Generator, and skills like competitor-teardown, customer-research, deep-research, financial-unit-economics, pricing-strategy, launch-strategy, docx/pptx/xlsx.
None of them are required. If one is missing, the skill does that work inline with native tools, keeps the same artifact structure and citation rules, and declares at the bottom of the artifact which dependency was unavailable. It never pretends to have used a tool it did not have.
references/document-catalog.md lists ~20 further documents you can request on demand — Business Model Canvas, Lean Canvas, Value Proposition Canvas, JTBD map, ICP/persona, pricing & packaging, 18–36 month P&L, break-even & sensitivity, cap table / funding plan, compliance checklist, risk register, GTM plan, pre-mortem report, experiment backlog, 30-60-90 plan, KPI dashboard spec, investor one-pager. Each entry says what it is for and which phase/agent produces it.
.
├── .claude-plugin/ Plugin + marketplace manifests
├── skills/
│ └── business-brainstorming/
│ ├── SKILL.md Orchestrator: 9 phases, gates, fallbacks
│ └── references/
│ ├── stages.md Per-phase playbook with agent dispatch prompts
│ ├── scorecard.md 8 dimensions, 1-5 anchors, verdict logic
│ ├── positioning-playbook.md 22 immutable laws, category design
│ ├── research-methods.md Query building, signals, anti-hallucination
│ ├── document-catalog.md On-demand document catalog
│ └── deliverable-templates/ pitch · business-plan · swot · roadmap
├── agents/ The three custom subagents
├── docs/ Design spec and implementation plan
└── install.sh
The skill's instructions, playbooks and templates are written in Italian, and it produces Italian artifacts by default. The YAML description fields are in English because that is what drives skill triggering. If you want English deliverables, say so at Phase 0 — Claude will follow, though the reference playbooks it reads stay Italian.
- It does not replace an accountant or a lawyer. The compliance checklists are indicative, not legal advice.
- It does not guarantee market numbers. They are estimates with declared sources and methods.
- It does not build your MVP. If you decide to build software, Phase 8 offers an optional handoff to a planning skill — the pipeline's terminal is the verdict plus the four deliverables.
- It does not collect real personal data. Public and aggregate sources only.
Issues and PRs welcome — new scorecard anchors, additional deliverable templates, translations, or research-method improvements. See CONTRIBUTING.md.
The dialogue-driven structure (one question at a time, phase checkpoints, artifact-per-phase) is inspired by the brainstorming skill from the Superpowers project by Jesse Vincent. The validation pipeline, agents, scorecard, positioning playbook and deliverables are original work.
Positioning material draws on Positioning and The 22 Immutable Laws of Marketing by Al Ries and Jack Trout — the playbook is an operational synthesis, not a reproduction.
MIT — see LICENSE.
business-brainstorming è una skill per Claude Code che esegue una pipeline di validazione in 9 fasi su un'idea di business, più tre subagenti custom che fanno il lavoro scomodo: un avvocato del diavolo, uno stratega di positioning e un analista di modello economico.
Quasi tutti i brainstorming con l'AI ti fanno sentire bene rispetto alla tua idea. Questo è costruito per fare l'opposto.
| Brainstorming AI generico | Venture Validator |
|---|---|
| Ti dà ragione | Postura di default: questa idea fallirà — dimostrami il contrario |
| "Il mercato è grande e in crescita" | TAM/SAM/SOM con metodo e fonti dichiarate |
| Dolore utente inventato | Citazioni da Reddit / forum / recensioni, oppure marcatura esplicita [NON VERIFICATO] |
| Proiezioni di ricavo ottimistiche | Unit economics con ogni assunzione dichiarata + 3 scenari + analisi di sensibilità |
| "Potresti differenziarti con…" | Decisione forzata: affilare una categoria esistente o crearne una nuova — e cosa sacrifichi |
| Deliverable a richiesta | Hard gate: nessun Business Plan finché gli artefatti di evidenza non esistono su disco |
Ogni run scrive tutta la tracciabilità in ventures/<slug>/ nella working directory:
ventures/mia-idea/
├── 00-intake.md Founder-market fit, asset, budget, geografia, obiettivo
├── 01-ideation-funnel.md (solo modalità Genera) N idee punteggiate e imbutite
├── 02-demand-validation.md Evidenze citate del dolore, lessico cliente, forza del segnale
├── 03-market-competition.md TAM/SAM/SOM, matrice competitor, sostituti, whitespace
├── 04-economics.md Revenue model, CAC/LTV, investimento minimo, 3 scenari
├── 05-barriers-feasibility.md Licenze, regole di settore, privacy, tempi/costi per superarle
├── 06-positioning.md La parola da possedere, strategia di categoria, naming, sacrificio
├── 07-verdict-scorecard.md Scorecard a 8 dimensioni, verdetto, 3 rischi + esperimenti
└── deliverables/
├── pitch.md 10-12 slide + one-liner + elevator pitch da 30s
├── business-plan.md 11 sezioni, ognuna tracciata al proprio artefatto sorgente
├── swot.md SWOT + cross-strategie TOWS, ogni voce ancorata alle evidenze
└── roadmap.md Roadmap di de-risking guidata dai 3 rischi prioritari
- Claude Code — la skill usa lo Skill tool, l'Agent tool (subagenti) e la ricerca web. Non è pensata per l'interfaccia web.
- Opzionale: Bright Data MCP per un sentiment più profondo su community e recensioni. Senza, la skill degrada a WebSearch +
deep-researche lo dichiara nell'artefatto — non finge mai.
Opzione A — come plugin Claude Code (consigliata)
/plugin marketplace add giosh-me/venture-validator/plugin install venture-validator@giosh-pluginsPoi /reload-plugins. Le skill dei plugin hanno un namespace, quindi si invoca come /venture-validator:business-brainstorming.
Opzione B — script di installazione
git clone https://github.com/giosh-me/venture-validator.git && cd venture-validator && ./install.shCopia la skill in ~/.claude/skills/business-brainstorming/ e i tre agenti in ~/.claude/agents/. I file esistenti vengono salvati con backup timestampato, mai sovrascritti in silenzio. ./install.sh --project installa nel .claude/ del progetto corrente; ./install.sh --uninstall rimuove tutto.
Opzione C — manuale
cp -R skills/business-brainstorming ~/.claude/skills/ && cp agents/*.md ~/.claude/agents//business-brainstorming
La Fase 0 chiede quale ingresso vuoi:
- Valida — hai già un'idea definita. Salta la Fase 1 e parte dalla validazione della domanda.
- Genera — parti da un dominio, un problema o un asset ("so fare X", "questa cosa mi fa impazzire"). La Fase 1 genera N idee, le punteggia, fa la shortlist e tu ne scegli 1-2.
Le due modalità convergono sulla stessa pipeline (Fasi 2→8). Puoi anche entrare a metà pipeline (es. saltare alla Fase 4 se hai già fatto la ricerca di domanda): la skill ti segnala quali dimensioni della scorecard resteranno non valutate.
| # | Fase | Cosa fa | Dimensione scorecard |
|---|---|---|---|
| 0 | Intake & inquadramento | Founder-market fit, asset, budget/tempo, geografia, obiettivo lifestyle vs scalabile | Founder-Market Fit |
| 1 | Ideazione & funnel (solo Genera) | N idee punteggiate su dolore, accesso mercato, fit asset, monetizzabilità, difendibilità | screening rapido |
| 2 | Validazione domanda | Sentiment reale da Reddit/forum/recensioni: intensità del dolore, quanto già pagano, lessico, trend | Demand Evidence |
| 3 | Mercato & concorrenza | Chi serve già il bisogno, prezzi, gap, sostituti, TAM/SAM/SOM, timing | Market Attractiveness · Competitive Whitespace |
| 4 | Modello economico & previsionale | Revenue model, CAC/LTV/margine/payback, pricing, break-even, investimento minimo, 3 scenari | Economic Viability · Capital Efficiency |
| 5 | Barriere & fattibilità | Licenze, regolamenti di settore, privacy, requisiti per geografia, tempi e costi | Entry Barriers / Regulatory |
| 6 | Positioning (Al Ries) | La parola da possedere, categoria esistente vs nuova, focus e sacrificio, direzione di naming | Positioning Strength |
| 7 | Stress test & scorecard | Pre-mortem a 18 mesi, assunzioni fragili, kill criteria, verdetto pesato, 3 rischi prioritari | verdetto consolidato |
| 8 | Deliverable | Pitch, Business Plan, SWOT, Roadmap costruiti dagli artefatti precedenti | — |
Ogni fase fa dispatch degli agenti (in parallelo dove serve), scrive il proprio artefatto e chiude con un checkpoint di dialogo — correggi o procedi. Se una fase risulta debole, la skill ti avvisa prima di farti spendere altra ricerca nella successiva.
L'Avvocato del Diavolo interviene con critica mirata a fine Fase 2, 4 e 6, e guida la Fase 7 (pre-mortem).
Otto dimensioni, ognuna su scala 1-5 con ancore esplicite, aggregate in un punteggio pesato:
| Dimensione | Peso | Fase |
|---|---|---|
| Demand Evidence | 25% | 2 |
| Economic Viability | 15% | 4 |
| Positioning Strength | 15% | 6 |
| Capital Efficiency | 10% | 4 |
| Market Attractiveness | 10% | 3 |
| Entry Barriers / Regulatory | 10% | 5 |
| Founder-Market Fit | 10% | 0 |
| Competitive Whitespace | 5% | 3 |
Quattro bande di verdetto: GO · GO-CON-RISCHI · PIVOT (con direzione di pivot) · NO-GO (con cosa servirebbe per riconsiderare).
Due regole rendono il verdetto difficile da aggirare:
- Gate soft. Nessun verdetto ti blocca. Se vuoi procedere contro un NO-GO puoi farlo, ma l'override viene registrato nell'artefatto del verdetto con la tua motivazione.
- Regola anti-mascheramento. Se
Demand EvidenceoppureEconomic Viabilityvalgono 1, scattano come red flag in cima al verdetto a prescindere dalla media pesata. Una media alta non può seppellire l'assenza di domanda reale o di un'economia che sta in piedi.
I pesi sono modificabili per progetto — ridistribuiscili per business capital-intensive o molto regolati — ma la somma deve restare 100% e la modifica va dichiarata nell'artefatto del verdetto.
| Agente | Ruolo |
|---|---|
business-devils-advocate |
Critico avversario. Vitamina vs antidolorifico, smascheramento del founder bias, "pagherebbe davvero?", steelman del concorrente più forte e dello status quo, pre-mortem a 18 mesi. Mai nichilista: ogni critica dichiara la soglia di evidenza che gli farebbe cambiare idea. |
positioning-strategist |
Tradizione Al Ries / Jack Trout. Trova l'unica parola da possedere nella mente e forza la decisione — affilare una categoria esistente o crearne una nuova — con focus, sacrificio e direzione di naming. Si appoggia al playbook delle 22 leggi in references/positioning-playbook.md. |
economic-model-analyst |
Revenue model (monetizzazione immediata vs futura), unit economics con ogni assunzione dichiarata, previsionale di investimento minimo (capex/opex, runway al break-even), 3 scenari e analisi di sensibilità sulle 2-3 assunzioni che spostano di più il risultato. |
Cascata a tre livelli, verificata a runtime e degradata con grazia:
- Bright Data MCP — primario per community e recensioni (
brand-listening,scrape,search,competitive-intel) - WebSearch / WebFetch nativi — fallback e cross-check
deep-research— dossier verificato avversarialmente su una claim critica
Regole vincolanti, definite in references/research-methods.md:
- Ogni insight chiave porta ≥1 citazione (quote + fonte). Ciò che non è verificabile viene marcato
[NON VERIFICATO]e tenuto in una sezione separata. - Evidenza diretta (clienti che parlano) distinta da proxy (articoli e report di terzi).
- Il segnale debole si dichiara, non si gonfia — "segnale debole: solo N menzioni" — e abbassa il punteggio Demand.
- Ricerca di default in italiano + inglese (le community italiane sono spesso piccole, l'inglese amplia il segnale). Regolabile per progetto.
Oltre ai tre agenti inclusi, le fasi fanno dispatch di agenti e skill opzionali che potresti non avere: Trend Researcher, Reddit Community Builder, Investment Researcher, Financial Analyst, Brand Guardian, Reality Checker, Legal Compliance Checker, Executive Summary Generator, e skill come competitor-teardown, customer-research, deep-research, financial-unit-economics, pricing-strategy, launch-strategy, docx/pptx/xlsx.
Nessuna è obbligatoria. Se manca, la skill svolge quel lavoro inline con gli strumenti nativi, mantiene la stessa struttura di artefatto e le stesse regole di citazione, e dichiara in fondo all'artefatto quale dipendenza non era disponibile. Non finge mai di aver usato uno strumento che non aveva.
references/document-catalog.md elenca una ventina di documenti ulteriori richiedibili on-demand: Business Model Canvas, Lean Canvas, Value Proposition Canvas, mappa JTBD, ICP/persona, pricing & packaging, conto economico previsionale 18-36 mesi, break-even & sensitivity, cap table / funding plan, checklist compliance, risk register, piano GTM, pre-mortem report, experiment backlog, piano 30-60-90, KPI dashboard spec, one-pager per investitori. Ogni voce dice a cosa serve e quale fase/agente lo produce.
.
├── .claude-plugin/ Manifest plugin + marketplace
├── skills/
│ └── business-brainstorming/
│ ├── SKILL.md Orchestratore: 9 fasi, gate, fallback
│ └── references/
│ ├── stages.md Playbook per fase con i prompt di dispatch
│ ├── scorecard.md 8 dimensioni, ancore 1-5, logica del verdetto
│ ├── positioning-playbook.md 22 leggi immutabili, category design
│ ├── research-methods.md Query building, segnali, anti-allucinazione
│ ├── document-catalog.md Catalogo documenti on-demand
│ └── deliverable-templates/ pitch · business-plan · swot · roadmap
├── agents/ I tre subagenti custom
├── docs/ Design spec e implementation plan
└── install.sh
- Non sostituisce commercialista o avvocato. Le checklist di compliance sono indicative, non consulenza legale.
- Non garantisce i numeri di mercato: sono stime con fonti e metodo dichiarati.
- Non costruisce il tuo MVP. Se decidi di sviluppare software, la Fase 8 offre un handoff opzionale a una skill di pianificazione — il terminale della pipeline è il verdetto più i quattro deliverable.
- Non raccoglie dati personali reali: solo fonti pubbliche e aggregate.
Issue e PR benvenute — nuove ancore per la scorecard, template di deliverable aggiuntivi, traduzioni, miglioramenti ai metodi di ricerca. Vedi CONTRIBUTING.md.
La struttura di dialogo (una domanda alla volta, checkpoint di fase, un artefatto per fase) è ispirata alla skill brainstorming del progetto Superpowers di Jesse Vincent. Pipeline di validazione, agenti, scorecard, playbook di positioning e deliverable sono lavoro originale.
Il materiale di positioning attinge a Positioning e The 22 Immutable Laws of Marketing di Al Ries e Jack Trout: il playbook è una sintesi operativa, non una riproduzione.
MIT — vedi LICENSE.