{
"markdown": "\n\n\n\n# SoloFounder\n\n### Your AI Virtual Team\n\n**One founder. Any challenge. A full team assembled in seconds.**\n\n[]()\n[]()\n[]()\n[]()\n[]()\n\n---\n\n*SoloFounder dynamically composes specialist teams and optimized workflows*\n*for any business challenge — software, marketing, legal, operations, design.*\n*No templates. No hardcoded pipelines. Every flow is generated fresh.*\n\n[Getting Started](#getting-started) • [How It Works](#how-it-works) • [Iron Laws](#the-five-iron-laws) • [Architecture](#architecture) • [Capabilities](#capabilities)\n\n
\n\n---\n\n## The Problem\n\nYou're a solo founder. You need to ship software, design brands, plan marketing, review contracts, architect infrastructure — all by yourself.\n\nAI coding assistants give you a single generalist. That's like hiring one intern for every department.\n\n**SoloFounder gives you a full company.**\n\nFor every challenge you face, SoloFounder assembles a team of specialists — not generic \"agents,\" but deeply specialized roles like *\"React Native 0.84 + Expo SDK 55 Specialist with EAS Build expertise\"* or *\"B2B SaaS Content Strategist with PLG funnel experience.\"*\n\nEach specialist knows what to check, what to flag, and when to stop. They review each other's work. They resolve conflicts through structured arbitration. And after every completed project, the system learns — making your next project faster and higher quality.\n\n---\n\n## How It Works\n\n```\n YOU SOLOFOUNDER\n ─── ────────────\n\n \"Build me a ┌─────────────────────────┐\n language learning ──────>│ 1. CLARIFY │\n app\" │ Ask smart questions │\n │ with options & │\n │ recommendations │\n └────────────┬────────────┘\n │\n Review & answer ┌────────────v────────────┐\n questions <──────>│ 2. DESIGN THE FLOW │\n │ Generate optimal │\n │ stage sequence │\n └────────────┬────────────┘\n │\n Approve team ┌────────────v────────────┐\n composition <──────>│ 3. ASSEMBLE THE TEAM │\n │ Generate specialist │\n │ roles with deep │\n │ domain expertise │\n └────────────┬────────────┘\n │\n ┌────────────v────────────┐\n Approve each stage <──────>│ 4. EXECUTE & VERIFY │\n deliverable │ Specialists work in │\n │ parallel, review │\n │ each other, verify │\n │ everything │\n └────────────┬────────────┘\n │\n ┌────────────v────────────┐\n │ 5. LEARN │\n │ Analyze what worked, │\n │ update knowledge for │\n │ next project │\n └─────────────────────────┘\n```\n\n### The Clarification Phase\n\nSoloFounder doesn't jump straight to work. It asks you the right questions first — each with **concrete options** and a **recommended path**:\n\n```\nQ1: Who is the primary audience for this app?\n 1. Children (6-12) learning their first foreign language\n 2. Adults learning conversationally for travel\n 3. Professionals needing business-level fluency\n 4. Heritage speakers reconnecting with family language\n → Recommended: 2 — largest addressable market with clearest monetization path\n\nQ2: What's the core learning mechanic?\n 1. Spaced repetition flashcards (Anki-style)\n 2. Conversational AI practice (chat-based)\n 3. Gamified lessons with progression (Duolingo-style)\n 4. Immersion through real content (news, videos, podcasts)\n → Recommended: 2 — highest engagement ceiling, best use of AI capabilities\n```\n\nOnly after understanding your vision does it design the flow.\n\n### Progressive Flow Generation\n\nSoloFounder doesn't commit to a tech stack before deciding one. Flows are generated in phases:\n\n```\nPHASE 1 — Generated immediately (no stack assumptions)\n┌──────────────┐ ┌──────────────┐ ┌──────────────┐\n│ Discovery │───>│ Research & │───>│ [EXPAND] │\n│ & Brainstorm│ │ Architecture│ │ │\n└──────────────┘ └──────────────┘ └──────┬───────┘\n │\n Architecture decides: React Native 0.84 + Supabase + Claude API\n │\nPHASE 2 — Generated AFTER decisions v\n┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐\n│ Design │─>│ Brand │─>│ Visual │─>│ Plan & │─>│Implement │\n│ Research│ │ Book │ │ Design │ │ Review │ │ (TDD) │\n└──────────┘ └──────────┘ └──────────┘ └──────────┘ └──────────┘\n```\n\nA *\"React Native Specialist\"* is only created **after** the architecture stage decides on React Native. No premature commitments.\n\n### Structured Artifacts\n\nEvery stage defines exactly what it produces — not just a filename, but a **contract**:\n\n```\nStage 2: Research & Architecture\n\n Artifacts:\n Research Report → .solofounder/stages/architecture/research.md\n Format: markdown with comparison tables\n Sections: options evaluated, comparison matrix, runtime performance, maturity\n Complete when: every recommendation cites a live source, 3+ options per decision\n\n Architecture Decision Record → .solofounder/stages/architecture/adr.md\n Format: markdown\n Sections: decisions, rationale, rejected alternatives\n Complete when: every decision has rationale tied to research findings\n\n Completion Checklist:\n [x] Research covers 3+ alternatives per major decision\n [x] Every recommendation cites live documentation\n [x] Runtime performance comparison included\n [x] No unresolved exceptions\n [x] User approves\n```\n\nDownstream stages know exactly what they're receiving. Long sessions stay on track.\n\n---\n\n## The Five Iron Laws\n\nEvery agent, every stage, every role operates under these laws. They are not guidelines — they are **enforcement mechanisms**.\n\n| | Law |\n|:---:|-----|\n| **I** | **NO FALLBACKS. NO SILENT FAILURES. NO TEMP SOLUTIONS.** Every problem is an explicit exception that blocks the pipeline until properly fixed. |\n| **II** | **ONE CORRECT PATH.** Never offer alternatives to the correct approach. Never degrade gracefully. If the correct path fails, STOP with full context. |\n| **III** | **EVERY EXCEPTION IS ACTIONABLE.** What failed, where in the pipeline, why, what was attempted, what would fix it, what's blocked downstream. |\n| **IV** | **IMPLEMENTATION COSTS NOTHING.** Time and budget do not exist. Never trade quality for speed. The only cost is poor quality. |\n| **V** | **EVERYTHING IS REVIEWED AND VERIFIED.** Nothing moves forward unchecked. Evidence before claims. No output moves forward without review and verification. |\n\nThese laws include **rationalization prevention** — when an agent catches itself thinking *\"this is good enough for now\"* or *\"I'll fix this later\"*, the Iron Laws mandate: **STOP. Do it right.**\n\n---\n\n## Architecture\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│ SOLOFOUNDER SYSTEM │\n│ │\n│ ┌─────────────────────────────────────────────────────┐ │\n│ │ META-SKILLS (The Brain) │ │\n│ │ │ │\n│ │ Bootstrap → Flow Composer → Role Generator → Learn │ │\n│ └─────────────────────────────────────────────────────┘ │\n│ │ │\n│ generates & uses │\n│ │ │\n│ ┌─────────────────────────v───────────────────────────┐ │\n│ │ CAPABILITIES (The Toolbox) │ │\n│ │ │ │\n│ │ TDD | Debugging | Verify | Research | Mockups│ │\n│ └─────────────────────────────────────────────────────┘ │\n│ │ │\n│ generates at runtime │\n│ │ │\n│ ┌─────────────────────────v───────────────────────────┐ │\n│ │ DYNAMIC LAYER (Generated Per-Request) │ │\n│ │ │ │\n│ │ Flows | Stages | Specialist Roles | Artifacts │ │\n│ └─────────────────────────────────────────────────────┘ │\n│ │\n│ ┌─────────────────────────────────────────────────────┐ │\n│ │ CROSS-PROJECT LEARNING (Compounds) │ │\n│ │ │ │\n│ │ ~/.solofounder/learning/ │ │\n│ │ insights.md — loaded every session │ │\n│ │ stacks/ — tech-specific patterns │ │\n│ │ domains/ — domain-specific patterns │ │\n│ │ roles/ — role effectiveness tracking │ │\n│ │ conflicts/ — recurring conflict patterns │ │\n│ └─────────────────────────────────────────────────────┘ │\n└─────────────────────────────────────────────────────────────┘\n```\n\n### Static Layer (Ships with the plugin)\n\n| Component | What It Does |\n|-----------|-------------|\n| **Bootstrap** | Loads Iron Laws, cross-project learning, prior state at session start |\n| **Flow Composer** | Clarifies requirements, designs optimal stage sequence, orchestrates execution |\n| **Role Generator** | Creates deeply specialized roles with 3-layer composition |\n| **Conversation Analysis** | Post-completion learning engine — 5 analysis dimensions |\n| **TDD Methodology** | RED-GREEN-REFACTOR enforcement. No code without failing test first |\n| **Systematic Debugging** | 4-phase root cause investigation before any fix attempt |\n| **Verification** | Evidence before claims. Run commands, read output, then assert |\n| **Live Research** | Verify tech recommendations against live docs. Design research from Dribbble/Behance |\n| **Exception Enforcement** | Iron Laws applied to every output with rationalization prevention |\n| **Mockup Server** | Browser-based visual preview with multi-variant voting |\n\n### Dynamic Layer (Generated per-request)\n\nEverything else is generated fresh: flows, stages, specialist roles, artifact definitions, completion checklists. No templates. No standard pipeline.\n\n---\n\n## Capabilities\n\n### Specialist Roles — Not Generic Agents\n\nSoloFounder doesn't use generic \"Backend Agent\" or \"Frontend Agent\" roles. Every specialist is deeply specialized for your specific project:\n\n```diff\n- Generic (useless):\n \"Backend Agent\"\n Review: Check for security issues. Verify performance.\n\n+ SoloFounder (actionable):\n \"ASP.NET 10 + Entity Framework Core 10 + Azure SQL Backend Specialist\"\n Review:\n - EF Core: no raw SQL with string interpolation (parameterized only)\n - EF Core: .Include() chains max 3 levels, use projection beyond\n - Auth: tokens in httpOnly cookies, never localStorage\n - Connection strings: Azure Managed Identity, not passwords\n - MediatR handlers: one handler per file, validation in pipeline\n```\n\nRoles are composed from **three layers**:\n\n1. **Foundation** — core expertise, review methodology, output format\n2. **Stack Specialization** — technology-specific concerns, patterns, anti-patterns\n3. **Cross-Project Learning** — patterns discovered in past projects (grows over time)\n\n### Conflict Resolution\n\nWhen specialists disagree, SoloFounder doesn't just pick one — it generates an **arbiter** specialized for the conflict domain:\n\n```\nPerformance Specialist: \"Use server-side rendering for initial load\"\nUX Specialist: \"Client-side rendering gives better interactivity\"\n │\n v\n ┌───────────────────────┐\n │ ARBITER GENERATED │\n │ (Technical Product │\n │ Manager) │\n │ │\n │ Iteration 1: Propose │\n │ Iteration 2: Refine │\n │ Iteration 3: Final │\n │ │\n │ Still disagree? │\n │ → Escalate to user │\n │ with full context │\n └───────────────────────┘\n```\n\n### Deep Research\n\nWhen research is needed, SoloFounder goes deep — multiple sources, cross-referenced, structured deliverables:\n\n```\nResearch: Mobile Framework Selection\n\nLandscape Compared\n Framework Runtime Perf Bundle Size Ecosystem Maturity\n React Native Near-native 7-12 MB Massive Mature (0.84)\n Flutter Near-native 5-8 MB Large Mature (3.41)\n Kotlin Multi. Native Minimal Growing Stable (2.3)\n\nRisks & Gotchas\n - React Native: New Architecture is now default since 0.82 — verify all libraries support it\n - Flutter: Platform channel overhead for heavy native API usage\n\nRecommendation\n React Native — largest ecosystem, proven at scale, New Architecture\n default since 0.82. Source: reactnative.dev/blog (verified live)\n```\n\n### Visual Brainstorming\n\nThe mockup server enables visual collaboration directly in your browser:\n\n- **Multi-variant comparison** — see design options side by side\n- **Click to vote** — select preferred variants\n- **Per-variant feedback** — annotate what works and what doesn't\n- **Design references** — curated from Dribbble/Behance, saved and persisted\n- **Brand books** — generated for new projects, enforced as contracts\n\n### Cross-Project Learning\n\nSoloFounder gets smarter with every project:\n\n```\nProject 1: \"EF Core lazy loading caused N+1 in production\"\n │\n v\nProject 2: Role automatically includes:\n \"Exception: EF Core lazy loading in API controller → BLOCKS (N+1)\"\n```\n\nAfter every completed flow, **Conversation Analysis** examines five dimensions:\n\n1. **Wasted Work** — what was produced and thrown away?\n2. **Misalignment** — where did intent and execution diverge?\n3. **Exception Archaeology** — could issues have been caught earlier?\n4. **Role Effectiveness** — which specialists gave advice that was used?\n5. **Flow Effectiveness** — were stages in the right order?\n\nInsights feed back into role definitions, flow generation, and cross-project learning files.\n\n---\n\n## Getting Started\n\n### Install from Marketplace\n\n```bash\n/plugin install solofounder\n```\n\nThat's it. One command. SoloFounder loads automatically on every session.\n\n### Alternative: Install from GitHub\n\nIf SoloFounder isn't in the official marketplace yet, add it as a custom marketplace:\n\n```bash\n# Add the marketplace (one time)\n/plugin marketplace add solofounder-ai/solofounder\n\n# Install the plugin\n/plugin install solofounder@solofounder\n```\n\n### Cursor\n\n```bash\n/add-plugin solofounder\n```\n\n### Usage\n\nJust start talking. SoloFounder bootstraps automatically on every session.\n\n```\nYou: \"Build a subscription analytics dashboard for my SaaS\"\n\nSoloFounder:\n → Asks clarifying questions (audience, metrics, integrations, quality bar)\n → Designs flow (research → architecture → design → implement)\n → Assembles team (Product Analyst, Data Viz Specialist, React Architect, ...)\n → Executes stages with review gates\n → Learns for next time\n```\n\nIt works for any domain:\n\n| Domain | Example Request |\n|--------|----------------|\n| **Software** | \"Build a real-time collaboration feature\" |\n| **Design** | \"Redesign our onboarding flow\" |\n| **Marketing** | \"Create a content strategy for our B2B SaaS\" |\n| **Legal** | \"Review this partnership agreement\" |\n| **Operations** | \"Design our incident response process\" |\n| **Strategy** | \"Analyze our pricing model vs competitors\" |\n\n---\n\n## Project Structure\n\n```\nsolofounder/\n skills/ # Meta-skills (the brain)\n using-solofounder/SKILL.md # Session bootstrap\n flow-composer/ # Flow design & orchestration\n SKILL.md\n stage-execution.md\n role-generator/SKILL.md # Specialist role creation\n conversation-analysis/SKILL.md # Post-completion learning\n\n capabilities/ # Battle-tested disciplines (the toolbox)\n tdd-methodology/SKILL.md # RED-GREEN-REFACTOR\n systematic-debugging/ # 4-phase root cause investigation\n verification/SKILL.md # Evidence before claims\n exception-enforcement/SKILL.md # Iron Laws enforcement\n mockup-server/ # Visual preview & voting\n live-research/SKILL.md # Tech verification & design research\n\n hooks/ # Platform integration\n .claude-plugin/ # Claude Code manifest\n .cursor-plugin/ # Cursor manifest\n```\n\n### Runtime State (Generated per-project)\n\n```\nyour-project/.solofounder/\n flow.md # Current flow definition\n artifacts.md # Registry of all produced artifacts\n roles/ # Specialist role definitions\n stages/ # Stage deliverables\n design-references/ # Curated design inspiration\n brand/ # Brand book (new projects)\n insights/ # Stage metrics & conflict records\n retrospective.md # Post-completion analysis\n```\n\n---\n\n## What Makes This Different\n\n| Traditional AI Assistant | SoloFounder |\n|-------------------------|-------------|\n| One generalist agent | Specialized team per challenge |\n| Jumps straight to code | Clarifies, researches, designs, then executes |\n| Generic advice | Stack-specific review checklists |\n| Silent failures | Explicit exceptions that block the pipeline |\n| Forgets everything | Cross-project learning compounds |\n| \"Good enough\" | Iron Law IV: Implementation costs nothing |\n| Trusts its own output | Everything reviewed and verified |\n| Static workflow | Dynamic flow generated per request |\n| Hardcoded stages | Progressive — discovery first, implementation after decisions |\n\n---\n\n## Spec\n\nFull product design: [`docs/solofounder/specs/2026-04-01-solofounder-design.md`](docs/solofounder/specs/2026-04-01-solofounder-design.md)\n\n---\n\n\n\n**Built for founders who refuse to compromise on quality.**\n\n*SoloFounder is open source. Contributions welcome.*\n\n
\n",
"bytes": 19691,
"sha": "387de913c2647ef78741656b0ab11e532d952fbbfaa2a449c249461e212288e4",
"repo_slug": "solofounder-ai/solofounder",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/plg_solofounder_ai_solofounder_solofounder_54a4244b/readme"
}