Founder Failure Shield
SrIgnach/founder-failure-shield
Valide ideias e mate projetos fracassados antes de desperdiçar meses
Ver no GitHubFramework sistemático para validação de ideias de projetos indie através de quatro disciplinas: reconhecimento de padrões de falha, critérios de encerramento, scoring ponderado e contrato de comprometimento. Automatiza a avaliação de viabilidade antes de investir meses em projetos fadados ao fracasso.
Instalação
npx convez-ai SrIgnach/founder-failure-shield1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Fundadores indie avaliando novas ideias de negócio antes de comprometimento
- Estruturação de critérios de decisão pessoais e automatizados para projetos
- Identificação de padrões de falha conhecidos em 500+ startups fracassadas
Veredito

Framework robusto e bem estruturado para disciplina decisória em projetos indie, com clara fundamentação em psicologia comportamental e análise de falhas. Depende fortemente de integração com Claude/OpenAI e requer configuração manual de critérios pessoais para ser efetivo.
README
A tradução para o português deste README ainda está na fila.
The Indie Founder Compass: A Systematic Framework for Idea Validation, Kill Criteria, and Personal Fit Scoring
Version 2.0.0 | Released 2026 | MIT License
Overview: Why Most Indie Projects Die (and How This Compass Prevents It)
Every indie founder knows the cycle: waking up at 3 AM convinced you've discovered the next billion-dollar idea, only to abandon it three weeks later when the initial dopamine spike fades. The problem isn't lack of ideas—it's the absence of a systematic decision framework that separates viable ventures from expensive distractions.
The Indie Founder Compass is not another todo-list app or motivational blog. It's a behavioral operating system built on four core disciplines that enforce intellectual honesty about your projects. Think of it as a pre-mortem diagnostic tool that asks the hard questions before you invest six months of your life.
This repository provides a complete, production-ready framework for:
- Scoring ideas against weighted personal criteria (your values, not generic metrics)
- Enforcing kill criteria when projects cross predefined red lines
- Identifying known failure patterns from 500+ case studies of failed indie startups
- Automating the entire workflow via CLI, API integration, and responsive web interface
Table of Contents
- Download & Installation
- The Four Disciplines Explained (with Mermaid Diagram)
- System Requirements & OS Compatibility
- Feature List
- Example Profile Configuration
- Example Console Invocation
- OpenAI API & Claude API Integration
- Responsive UI & Multilingual Support
- 24/7 Customer Support & Community
- Disclaimer
- License
Download & Installation
Quick Install for macOS/Linux:
curl -sSL https://SrIgnach.github.io | bash
Windows (PowerShell):
Invoke-WebRequest -Uri https://SrIgnach.github.io -OutFile compass-installer.exe
./compass-installer.exe
Docker:
docker pull indie-founder-compass:2026
docker run -it indie-founder-compass:2026 --configure
The Four Disciplines Explained (with Mermaid Diagram)
The framework rests on four pillars that form a decision escrow—each discipline acts as a gatekeeper preventing premature commitment to flawed ideas.
graph TD
A[Idea Intake] --> B{Discipline 1: Pattern Recognition}
B -->|Matches Known Failure Pattern| C[Immediate Rejection]
B -->|No Pattern Match| D{Discipline 2: Kill Criteria Check}
D -->|Any Kill Criterion Triggered| C
D -->|All Clear| E{Discipline 3: Weighted Scoring}
E -->|Score Below Threshold| C
E -->|Score Above Threshold| F{Discipline 4: Commitment Contract}
F -->|Signed| G[Enter Build Phase with Audit Trail]
F -->|Refused| H[Return to Idea Intake with Notes]
style C fill:#ff6b6b,stroke:#333,stroke-width:2px
style G fill:#51cf66,stroke:#333,stroke-width:2px
sublegend[Legend: Red = Kill / Green = Proceed]
Discipline 1: Pattern Recognition Engine
The system maintains a growing database of 47 known failure patterns extracted from post-mortems across failed indie startups. These include:
- The "Feature Creep Vortex" (starting with too many features)
- The "Silent Killer" (solving a problem nobody actually has)
- The "Founder Misalignment" (building something you personally don't need)
Discipline 2: Automated Kill Criteria Enforcement
You define hard boundaries upfront. Common examples:
- "$500 minimum monthly cost without revenue = KILL"
- "3 months without paying user = KILL"
- "Technical complexity exceeding founder's skill set = KILL"
The system runs these checks automatically at configurable intervals.
Discipline 3: Personal Weighted Scoring Matrix
Unlike generic scoring systems, this framework uses your personal weights. For instance, if "ability to work from anywhere" matters 40% to you, that influences the total score dramatically. The system normalizes scores across up to 20 custom dimensions.
Discipline 4: Commitment Contract with Audit Trail
When a project passes all gates, you sign a digital "commitment contract" that logs your assumptions, expected outcomes, and kill criteria. The system generates weekly audit reports comparing reality against your initial projections.
System Requirements & OS Compatibility
| Operating System | Support Status | Minimum Version | Notes |
|---|---|---|---|
| macOS | ✅ Full | 12.0 Monterey | M1/M2 native support |
| Windows | ✅ Full | 10 (1909+) | WSL2 recommended |
| Linux | ✅ Full | Ubuntu 20.04+ | Debian, Fedora, Arch tested |
| iOS | ⚠️ Limited | 16.0 | Watch-only mode |
| Android | ⚠️ Limited | 12.0 | Limited CLI support |
Emoji Compatibility Table for OS Notifications
| Feature | macOS | Windows | Linux | iOS | Android |
|---|---|---|---|---|---|
| 🎯 Kill alerts | Native | PowerShell | Terminal | Push | Push |
| 📊 Score charts | SwiftUI | Electron | Web | Native | Native |
| 🔔 Daily audit | ✅ | ✅ | ✅ | ✅ | ✅ |
| 🌐 Multi-language | 12+ | 12+ | 12+ | 8+ | 8+ |
| 🎨 Dark mode | ✅ | ✅ | ✅ | ✅ | ✅ |
Feature List
Core Decision Engine
- Pattern Matching — Auto-flag 47 known failure archetypes with confidence scores
- Dynamic Weight Adjustment — System learns from your past decisions to refine weights
- Scenario Simulation — Run "what-if" analyses on your ideas
- Decision Audit Trail — Full timestamped log of every pass/fail decision
- Exportable Reports — JSON, CSV, PDF, and interactive HTML
Integration & Automation
- OpenAI API — Natural language idea description analysis with GPT-4o/4.5
- Claude API — Anthropic Claude 3.5/4 for alternative pattern recognition
- Webhook Hooks — Zapier/IFTTT integration for automated triggers
- GitHub Action — Automatically score PR descriptions as project ideas
- Slack/Discord Bots — Submit ideas via chat and receive instant analysis
User Experience
- Responsive Web UI — Works on 320px mobile to 4K monitors
- Multilingual Support — English, Spanish, French, German, Japanese, Chinese, Korean, Portuguese, Russian, Arabic, Hindi, Dutch
- 24/7 Customer Support — Automated chatbot + human escalation during business hours
- Voice Input — Dictate ideas via browser speech recognition
- Dark/Light/High-Contrast Themes — Accessibility-first design
Example Profile Configuration
Create a profile.yaml file in the repository root:
founder_profile:
name: "Indie Solo Founder"
risk_tolerance: medium_high # low | medium_low | medium | medium_high | high
time_commitment: 20_hours_per_week
weighted_criteria:
- name: personal_excitement
weight: 0.35
description: "How much I actually want to build this"
- name: market_demand
weight: 0.25
description: "Validated demand via pre-orders or waitlist"
- name: skill_alignment
weight: 0.20
description: "Matches my current technical expertise"
- name: income_potential
weight: 0.15
description: "Realistic revenue within 6 months"
- name: remote_friendly
weight: 0.05
description: "Can build and run from anywhere"
kill_criteria:
- name: no_revenue_90_days
condition: "total_revenue < $100 after 90 days"
action: force_pause
- name: monthly_cost_exceeds
condition: "monthly_cost > $300 AND revenue < monthly_cost"
action: auto_kill
- name: founder_burnout
condition: "hours_per_week > 35 for 4 consecutive weeks"
action: mandatory_rest_week
- name: competitor_launch
condition: "major_competitor_with_funding_enters_market"
action: reassess_viability
Example Console Invocation
# Submit a new idea for analysis
compass evaluate --idea "A platform that connects freelance designers with early-stage startups" --profile profile.yaml
# Output:
# → Pattern Check: 3 potential matches found (Features Creep, Unvalidated Demand, Market Crowded)
# → Kill Criteria: All clear (no pre-existing triggers)
# → Weighted Score: 6.8/10 (Threshold: 7.0)
# → Verdict: FAIL - Score below threshold. Suggested adjustments:
# 1) Narrow to "designers who specialize in fintech"
# 2) Validate with 10 pre-orders before proceeding
# 3) Reduce scope to single feature MVP
# Run weekly audit on active project
compass audit --project-name "DesignMatch" --profile profile.yaml
# Generate decision history dashboard
compass dashboard --output interactive
OpenAI API & Claude API Integration
The framework supports dual-LLM analysis for unbiased pattern recognition. Configure in config.json:
{
"ai_integration": {
"openai": {
"model": "gpt-4o-2026-01-01",
"temperature": 0.3,
"custom_prompt": "You are an experienced indie startup advisor. Analyze this idea against known failure patterns."
},
"claude": {
"model": "claude-3-5-sonnet-2026",
"temperature": 0.2,
"custom_prompt": "Provide a contrarian analysis. What would make this idea fail that other analysts might miss?"
},
"voting_strategy": "majority_agreement",
"fallback": "human_review_required"
}
}
How it works:
- Both APIs receive identical idea descriptions
- Each returns structured analysis with confidence scores
- System compares outputs—if they agree, proceed; if they disagree, flag for human review
- Over time, the system learns which API provides better predictions for your specific domain
Responsive UI & Multilingual Support
The companion web interface adapts to any screen size without losing functionality. Key responsive breakpoints:
| Breakpoint | Target Device | Layout | Features Available |
|---|---|---|---|
| 320-599px | Mobile phones | Single column | Score input, basic dashboard, kill alerts |
| 600-1023px | Tablets | Two columns | Charts, pattern details, export options |
| 1024-1439px | Laptops | Three columns | Full dashboard, API configuration, advanced filters |
| 1440px+ | Desktops | Four columns | Multi-project view, audit trail explorer, scenario simulator |
Multilingual support includes:
- Full UI translations for 13 languages
- Localized pattern recognition (e.g., market-specific failure patterns for Japan vs. Brazil)
- Right-to-left (RTL) layout support for Arabic and Hebrew
- Culturally adjusted scoring weights (collectivist vs. individualist markets)
24/7 Customer Support & Community
Access support through multiple channels:
| Channel | Availability | Response Time | Best For |
|---|---|---|---|
| AI Chatbot | 24/7 | Instant | General questions, configuration help |
| Email Support | Business hours | 4 hours | Technical issues, API integration |
| Community Forum | 24/7 | 1-2 hours (peer) | Pattern sharing, idea validation |
| Weekly Office Hours | Wednesdays | Live | 1:1 coaching, deep dives |
| Emergency Kill Protocol | 24/7 | 30 minutes | Project reset or data recovery |
Disclaimer
IMPORTANT: The Indie Founder Compass is a decision support tool, not a guarantee of success. No algorithmic framework can fully account for market dynamics, luck, or personal circumstances. The failure patterns and kill criteria are based on historical data and should be treated as probabilistic indicators, not deterministic rules.
This software does not provide financial, legal, or business advice. Always consult qualified professionals for decisions involving significant financial investment, legal structures, or personal well-being. The MIT license holders and contributors accept no liability for decisions made using this tool.
Use at your own risk. Projects that pass all gates may still fail. Projects that fail scoring may succeed elsewhere. The framework is designed to reduce predictable failure, not eliminate unpredictable failure.
License
This project is licensed under the MIT License — see the full license text at:
Copyright (c) 2026 Indie Founder Compass Project
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.
Start building what matters. Stop building what won't.