Your own path. Multiple stacks. Ship everything.
From shower thought to deployed product — 39 skills, 3 agents, and a code intelligence MCP server that knows every project you've ever built.
/solo:research → /solo:validate → /solo:scaffold → /solo:setup → /solo:plan → /solo:build → /solo:deploy → /solo:launch → /solo:review
You're a solopreneur juggling iOS, Next.js, Python, Kotlin — and you want to validate, scaffold, and ship them all without slowing down.
Most AI coding tools help you write code. Solo Factory helps you run a startup — from market research and idea validation to deployment and promotion. Every skill is designed for one-person teams moving fast across multiple projects and stacks.
- No context switching — one pipeline handles research, coding, deployment, and marketing
- Stack-agnostic — 9 templates from SwiftUI to Cloudflare Workers
- Code intelligence — MCP server indexes all your projects, searches past sessions, and provides semantic code search
- Works without MCP — skills gracefully fall back to Glob, Grep, Read, WebSearch
npx skills add fortunto2/solo-factory --allWorks with Claude Code, Cursor, Copilot, Gemini CLI, Codex, and more.
claude plugin marketplace add https://github.com/fortunto2/solo-factory
claude plugin install solo@solo --scope userThe plugin auto-starts solograph MCP server via uvx — 11 tools available instantly.
Prerequisite: uv (for uvx solograph).
clawhub install solo-research # Install one skill
clawhub search "solo" # Browse all solo-* skillsclaude mcp add -s project solograph -- uvx solographnpx skills list # skills.sh
claude plugin list # Claude Code plugin| Command | What it does |
|---|---|
/solo:research <idea> |
Scout the market — competitors, SEO keywords, domains, TAM/SAM/SOM |
/solo:swarm <idea> |
3 parallel research agents (market + users + tech) for faster deep dive |
/solo:validate <idea> |
S.E.E.D. niche check + STREAM scoring + Devil's Advocate → PRD |
Examples:
/solo:research "receipt scanning app for freelancers"
→ 12 competitors, 3 niches, 2 personas, JTBD interview script, domain available, TAM $2.1B
/solo:validate "AI habit tracker"
→ Score: 7.2/10, Stack: ios-swift, beachhead: fitness enthusiasts 25-35
→ Pricing: one-time $9.99 (no server costs), PRD with 14 acceptance criteria
| Command | What it does |
|---|---|
/solo:scaffold <name> <stack> |
PRD → running project with configs, CLAUDE.md, git repo, GitHub push |
/solo:setup |
Wire dev workflow (TDD, linting, CI) — zero questions asked |
/solo:plan <feature> |
Explore codebase, write spec + phased plan with file-level tasks |
/solo:build [track-id] |
Execute plan with TDD, auto-commit, and phase gates |
/solo:deploy [platform] |
Deploy — detect CLI tools, set up DB, push, verify live |
/solo:review [focus] |
Final quality gate — tests, coverage, security, acceptance criteria |
/solo:diagnose <bug> |
Hard-bug loop — build a red-capable feedback loop first, hypothesise second |
/solo:grill <plan> |
Relentless one-question-at-a-time interview to stress-test a plan before building |
Examples:
/solo:scaffold my-app nextjs-supabase
→ Project created, GitHub repo pushed, CLAUDE.md configured
/solo:plan "Add Stripe subscription billing"
→ 3-phase plan: schema → API routes → checkout UI, 12 tasks total
/solo:build
→ TDD loop: write test → implement → green → commit, phase by phase
| Command | What it does |
|---|---|
/solo:launch |
GTM launch strategy — beachhead, channels, pricing, timeline, growth loops |
/solo:customer-finder |
Evidence-backed shortlist of first customers from public signals + outreach openers |
/solo:seo-audit <url> |
SEO health check — meta tags, JSON-LD, sitemap, score 0-100 |
/solo:landing-gen |
Landing page content — hero, features, A/B headlines, CTA, SEO meta |
/solo:content-gen |
Social media pack — LinkedIn post, Reddit draft, Twitter/X thread + release notes |
/solo:community-outreach |
Find Reddit/HN/PH threads, draft value-first responses + launch checklist |
/solo:video-promo |
Promo video plan — 30-45s script, storyboard, Remotion config |
/solo:metrics-track |
PostHog event funnel, KPI benchmarks, A/B test template, kill/iterate/scale |
/solo:legal |
Privacy policy + terms of service — privacy-first, manifest-aligned |
Examples:
/solo:launch
→ Beachhead: freelance designers 25-35, Channel: r/freelance + ProductHunt, Pricing: one-time $29
/solo:content-gen
→ LinkedIn post + Reddit answer + Twitter thread + release notes from git history
/solo:legal
→ Privacy policy (GDPR-ready), Terms of Service, App Store privacy labels
| Command | What it does |
|---|---|
/solo:pipeline research <idea> |
Automated research → validate loop |
/solo:pipeline dev <name> <stack> |
Automated scaffold → setup → plan → build → deploy → review |
/solo:stream <decision> |
STREAM 6-layer decision framework for high-stakes choices |
/solo:init |
One-time founder onboarding — manifest, calibration, stack selection |
/solo:factory |
Install the full Solo Factory toolkit in one command |
/solo:retro |
Post-pipeline retrospective — score process, find waste, suggest fixes |
/solo:audit |
KB health check — broken links, frontmatter, tag inconsistencies |
/solo:memory-audit |
Claude Code memory hierarchy — loaded files, char counts, optimization hints |
/solo:humanize |
Strip AI writing patterns — em dashes, stock phrases, performed authenticity |
/solo:index-youtube |
Index YouTube channel transcripts for semantic search |
/solo:you2idea-extract |
Extract startup ideas from YouTube video transcripts |
Examples:
/solo:pipeline dev "my-app" "nextjs-supabase"
→ Hands-free: scaffold → setup → plan → build → deploy → review
/solo:humanize
→ Rewrites AI-sounding copy into natural, human text
| Agent | Model | Specialization |
|---|---|---|
researcher |
Sonnet | Market research, competitors, pain points, web + KB search |
code-analyst |
Haiku | Codebase exploration, dependency analysis, Cypher queries |
idea-validator |
Sonnet | Idea validation, STREAM scoring, PRD generation |
/solo:validate "Parent dashboard for tracking kid's homework"
/solo:research "receipt scanning app"
/solo:validate "receipt scanning app"
/solo:swarm "AI-powered habit tracker"
/solo:validate "AI-powered habit tracker"
# Research pipeline — research → validate, fully automated
/solo:pipeline research "AI therapist app"
# Dev pipeline — scaffold → setup → plan → build → deploy → review
/solo:pipeline dev "my-app" "nextjs-supabase"
/solo:pipeline dev "my-app" "ios-swift" --feature "user onboarding"Pipeline signals — 2 universal tags, bash owns all state:
<solo:done/>— stage complete (bash creates marker in.solo/states/)<solo:redo/>— go back to build (bash removes.solo/states/build)
Stage markers live in {project}/.solo/states/ (build, deploy, review). Reset: rm -rf .solo/states/
Per-iteration logs:
~/.solo/pipelines/{project}/
├── iter-001-scaffold.log
├── iter-002-setup.log
├── iter-003-plan.log
├── iter-004-build.log
└── progress.md # Injected into next iteration prompt
Two pipeline modes:
| Mode | Launch | Best for |
|---|---|---|
| Interactive | /pipeline dev ... in Claude Code |
Quick runs, single session |
| Big Head | make bighead-dev or solo-dev.sh |
Long pipelines, tmux dashboard, logs |
/solo:research "my-app" # Scout the market
/solo:validate "my-app" # Score + generate PRD
/solo:scaffold my-app nextjs-supabase # Create project
/solo:setup # Wire dev workflow
/solo:plan "User auth with OAuth" # Write battle plan
/solo:build # Ship it
/solo:deploy # Deploy to Vercel/CF/Fly
/solo:review # Final quality gate| Stack | Tech |
|---|---|
ios-swift |
SwiftUI, CoreML, StoreKit 2 |
nextjs-supabase |
Next.js 16, React 19, Tailwind 4, shadcn-ui, Supabase |
nextjs-ai-agents |
extends nextjs-supabase + Vercel AI SDK, MCP |
cloudflare-workers |
Hono, D1, R2, Durable Objects |
kotlin-android |
Jetpack Compose, Room, Koin |
astro-static |
Astro 5, Cloudflare Pages |
astro-hybrid |
Astro 5 SSG+SSR, Cloudflare Pages/Workers, R2 CDN, Orama |
python-api |
FastAPI, Pydantic, SQLAlchemy, Alembic |
python-ml |
uv, Pydantic, FalkorDB, MLX |
Skills auto-detect and use solograph tools when available:
| Tool | What it does |
|---|---|
kb_search |
Semantic search over knowledge base (FalkorDB vectors, RU+EN) |
session_search |
Search past Claude Code sessions ("how did I solve X?") |
codegraph_query |
Cypher queries against code intelligence graph |
codegraph_stats |
Graph statistics (projects, files, symbols, packages) |
codegraph_explain |
Architecture overview of any project |
codegraph_shared |
Shared packages across projects |
project_code_search |
Semantic code search (auto-indexes on first call) |
project_code_reindex |
Reindex project code after changes |
project_info |
Project registry (stacks, status, last commit) |
web_search |
Web search via SearXNG or Tavily |
web_fetch |
Fetch and extract content from URLs |
Without MCP, skills fall back to Glob, Grep, Read, WebSearch/WebFetch.
The web_search tool connects to any Tavily-compatible API:
Self-hosted (recommended, private, free):
git clone https://github.com/fortunto2/searxng-docker-tavily-adapter.git
cd searxng-docker-tavily-adapter && cp config.example.yaml config.yaml
docker compose up -d
# → localhost:8013 (API) + localhost:8999 (UI)Or Tavily cloud: set TAVILY_API_URL=https://api.tavily.com and TAVILY_API_KEY in plugin env.
solo-factory/
├── .claude-plugin/
│ ├── plugin.json # Plugin manifest
│ └── marketplace.json # Marketplace manifest
├── skills/ # 39 skills
│ ├── research/ # Scout the market
│ ├── validate/ # Score → PRD
│ ├── scaffold/ # PRD → project
│ ├── setup/ # Wire dev workflow
│ ├── plan/ # Code research → battle plan
│ ├── build/ # TDD execution
│ ├── deploy/ # Deploy to hosting
│ ├── review/ # Final quality gate
│ ├── swarm/ # 3 parallel research agents
│ ├── stream/ # Decision framework
│ ├── pipeline/ # Automated multi-skill loop
│ ├── seo-audit/ # SEO health check
│ ├── landing-gen/ # Landing page content
│ ├── content-gen/ # Social media pack
│ ├── community-outreach/ # Reddit/HN/PH outreach
│ ├── customer-finder/ # First-customer prospecting
│ ├── video-promo/ # Promo video plan
│ ├── metrics-track/ # PostHog metrics
│ ├── humanize/ # Strip AI patterns
│ ├── audit/ # KB health check
│ ├── memory-audit/ # Memory hierarchy audit
│ ├── init/ # Founder onboarding
│ ├── factory/ # Full toolkit install
│ ├── retro/ # Pipeline retrospective
│ ├── launch/ # GTM launch strategy
│ ├── legal/ # Privacy policy + terms
│ ├── index-youtube/ # YouTube transcript indexing
│ └── you2idea-extract/ # Ideas from YouTube
├── agents/
│ ├── researcher.md # Deep research (sonnet)
│ ├── code-analyst.md # Code intelligence (haiku)
│ └── idea-validator.md # Idea validation (sonnet)
├── commands/
│ ├── dev.md # End-to-end feature development
│ └── investigate.md # Bug investigation and fix
├── hooks/
│ ├── hooks.json # SessionStart + Stop hook
│ └── pipeline-stop.sh # Pipeline progression
├── scripts/
│ ├── bighead # Interactive pipeline launcher (Rich CLI)
│ ├── solo-dev.sh # Dev pipeline bash loop
│ ├── solo-research.sh # Research pipeline bash loop
│ ├── solo-dashboard.sh # tmux dashboard manager
│ └── solo-stream-fmt.py # Colored stream formatter
├── templates/
│ └── stacks/ # 9 stack YAML templates
└── rules/
├── routing.md # Agent & skill routing table
├── ai-comments.md # AI-NOTE/TODO/ASK conventions
└── debugging.md # Background debugging practices
- solograph — MCP server for code intelligence, KB, sessions, web search
- Agent Teams — parallel feature dev, code review, debugging
- Context7 — latest library docs for scaffolding
PRs welcome! If you have ideas for new skills, stacks, or improvements — open an issue or submit a PR.
- Windows: pipeline scripts (
solo-dev.sh,solo-research.sh) require WSL or Git Bash - Without uv: MCP server won't auto-start. Install uv first
MIT
Rustam Salavatov (@fortunto2)
If Solo Factory helps you ship faster, consider giving it a star. It helps others discover the project.