{"id":50750461,"url":"https://github.com/minjikim89/make-me-unicorn","last_synced_at":"2026-06-11T01:01:32.692Z","repository":{"id":340074738,"uuid":"1164413347","full_name":"minjikim89/make-me-unicorn","owner":"minjikim89","description":"MCP-native launch OS for solo SaaS builders — Claude Code plugin + validate any startup idea against real HN+Reddit threads","archived":false,"fork":false,"pushed_at":"2026-05-21T11:05:35.000Z","size":7897,"stargazers_count":1,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-21T19:36:26.822Z","etag":null,"topics":["agent-skills","ai","anthropic","checklist","claude","claude-code","cli","developer-tools","devtools","founder","idea-validation","launch-checklist","llm","mcp","mcp-server","model-context-protocol","python","saas","solo-founder","startup"],"latest_commit_sha":null,"homepage":"https://minjikim89.github.io/make-me-unicorn/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/minjikim89.png","metadata":{"files":{"readme":"README.es.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-23T03:46:12.000Z","updated_at":"2026-05-21T11:05:39.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/minjikim89/make-me-unicorn","commit_stats":null,"previous_names":["minjikim89/make-me-unicorn"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/minjikim89/make-me-unicorn","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/minjikim89%2Fmake-me-unicorn","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/minjikim89%2Fmake-me-unicorn/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/minjikim89%2Fmake-me-unicorn/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/minjikim89%2Fmake-me-unicorn/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/minjikim89","download_url":"https://codeload.github.com/minjikim89/make-me-unicorn/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/minjikim89%2Fmake-me-unicorn/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34177444,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-10T02:00:07.152Z","response_time":89,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skills","ai","anthropic","checklist","claude","claude-code","cli","developer-tools","devtools","founder","idea-validation","launch-checklist","llm","mcp","mcp-server","model-context-protocol","python","saas","solo-founder","startup"],"created_at":"2026-06-11T01:00:52.359Z","updated_at":"2026-06-11T01:01:32.622Z","avatar_url":"https://github.com/minjikim89.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# Make Me Unicorn\n\n**Cubre también lo que no sabes que te falta. Lanza tu SaaS con confianza.**\n\nLa checklist de lanzamiento y sistema operativo de código abierto para creadores independientes.\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-black.svg)](./LICENSE)\n[![PyPI version](https://img.shields.io/pypi/v/make-me-unicorn?color=blue)](https://pypi.org/project/make-me-unicorn/)\n[![PyPI downloads](https://img.shields.io/pypi/dm/make-me-unicorn?color=blue)](https://pypi.org/project/make-me-unicorn/)\n[![CLI](https://img.shields.io/badge/cli-mmu-f59e0b.svg)](./SPEC.md)\n[![Guardrails CI](https://img.shields.io/badge/ci-doctor%20%2B%20gates-22c55e.svg)](./.github/workflows/mmu-guardrails.yml)\n[![Contributions Welcome](https://img.shields.io/badge/contributions-welcome-16a34a.svg)](./CONTRIBUTING.md)\n\n[🇺🇸 English](./README.md) · [🇰🇷 한국어](./README.ko.md) · [🇯🇵 日本語](./README.ja.md) · [🇨🇳 简体中文](./README.zh-CN.md) · **🇪🇸 Español**\n\n\u003cimg src=\"./assets/brand/unicorn-hero.png\" alt=\"Make Me Unicorn mascot\" width=\"960\" /\u003e\n\n\u003cimg src=\"./assets/demo.gif\" alt=\"MMU CLI demo — init, scan, vibecheck, dashboard\" width=\"720\" /\u003e\n\n\u003c/div\u003e\n\n## El Problema\n\nEstás construyendo un producto SaaS. Usas IA para programar más rápido que nunca. Pero entonces:\n\n\u003e \"Momento... ¿agregué el flujo de recuperación de contraseña?\"\n\u003e\n\u003e \"El webhook de pagos... ¿es idempotente?\"\n\u003e\n\u003e \"¿Tengo política de privacidad? ¿Política de reembolsos? ¿etiquetas OG?\"\n\u003e\n\u003e \"¿Qué decidí la semana pasada sobre el proveedor de autenticación? ¿Por qué?\"\n\n**No estás fallando al programar. Estás fallando en dar seguimiento a lo que importa.**\n\nTodo creador independiente se topa con los mismos muros:\n\n| Qué sale mal | Qué te cuesta |\n|--------------|---------------|\n| Te olvidas del restablecimiento de contraseña mientras construyes el inicio de sesión | Los usuarios se quedan bloqueados el día 1 |\n| Te saltas la verificación de firma del webhook | Los atacantes replican eventos de pago |\n| Lanzas sin etiquetas OG | Cada enlace compartido se ve roto |\n| Pierdes el contexto entre sesiones de IA | Re-explicas tu proyecto desde cero, cada vez |\n| No tienes política de reembolsos | Primera disputa = cuenta de Stripe congelada |\n\nMMU atrapa estos problemas **antes de que te cuesten usuarios, dinero o confianza**.\n\n## Cómo Funciona\n\n```\nmmu init                    # 1. Obtén más de 670 elementos de checklist en 15 categorías\nmmu scan                    # 2. Detecta tu stack automáticamente y marca lo que ya tienes\nmmu                         # 3. Ve qué está hecho y qué falta\nmmu status --why            # 4. Entiende tu puntuación — qué cuenta y qué se omite\nmmu next                    # 5. Obtén las próximas acciones priorizadas\n```\n\n```text\n  MAKE ME UNICORN - STATUS DASHBOARD\n\n          .--*--.\n         / *v*  \\\n        |       |\n         \\ ___ /\n          '---'\n\n  Stage: HATCHING    ######..............  22%  (124/551)\n\n  LAUNCH GATES  (16/26)\n    M0 Problem Fit         ################   4/4   PASS\n    M1 Build Fit           ################   5/5   PASS\n    M2 Revenue Fit         ############....   3/4   OPEN\n    M3 Trust Fit           ################   4/4   PASS\n    M4 Growth Fit          ########........   2/4   OPEN\n    M5 Scale Fit           ####............   1/5   OPEN\n\n  BLUEPRINTS  (124/551)\n    Frontend           ##########......  18/35  51%\n    Backend            ############....  24/46  52%\n    Auth               ##########......  16/42  38%\n    Billing            ########........  11/36  30%\n    ...11 more\n```\n\nTu unicornio evoluciona mientras construyes: Egg → Hatching → Foal → Young → Unicorn → Legendary.\n\n## Personaliza Tu Checklist\n\nNo todo proyecto necesita facturación. No todo producto necesita i18n. MMU se adapta:\n\n```bash\nmmu init                      # selecciona tu stack (Next.js, Django, Rails, ...)\n```\n\nAl ejecutar `mmu init`, se genera `.mmu/config.toml`.  \nCon estos flags puedes excluir del cálculo de puntuación los ítems que no aplican a tu proyecto.\n\n```toml\n[features]\nbilling = false               # Si no tienes facturación, se excluye la sección billing\nemail_transactional = true\nemail_marketing = false\ni18n = false\nfile_upload = false\nmfa = false\nab_testing = false\nwebhooks_outgoing = false\n\n[architecture]\ncontainerized = false\niac = false\nssr = true\nserverless = false\n\n[market]\ntargets_eu = false\ntargets_california = false\ntargets_korea = true\n```\n\nTu puntuación refleja **solo lo que aplica a tu proyecto**.  \n`mmu status --why` muestra de forma transparente qué se cuenta y qué se excluye.\n\n## Qué Cubre MMU (Para Que No Tengas Que Recordarlo)\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"33%\"\u003e\n\n**Construir el producto**\n- Frontend (responsive, accesibilidad, formularios)\n- Backend (API, DB, colas)\n- Autenticación (inicio de sesión, restablecimiento, OAuth, sesiones)\n- Facturación (Stripe, webhooks, reembolsos)\n- Pruebas (unitarias, E2E, seguridad de agentes)\n\n\u003c/td\u003e\n\u003ctd width=\"33%\"\u003e\n\n**Preparar el lanzamiento**\n- SEO (etiquetas OG, mapa del sitio, metadatos)\n- Legal (privacidad, términos, GDPR)\n- Seguridad (CORS, límites de tasa, gestión de secretos)\n- Rendimiento (caché, carga diferida)\n- CI/CD (pipeline, plan de reversión)\n\n\u003c/td\u003e\n\u003ctd width=\"34%\"\u003e\n\n**Operarlo después del lanzamiento**\n- Monitoreo (errores, disponibilidad, alertas)\n- Analítica (embudo, retención, eventos)\n- Correo (transaccional, plantillas)\n- Accesibilidad (WCAG, navegación por teclado)\n- Confiabilidad (copias de seguridad, plan de incidentes)\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n**670+ elementos. 15 categorías. Cero improvisación.**\n\n## ¿En Qué Se Diferencia MMU?\n\n| | Alcance | Dónde vive | Nativo para agentes | Seguimiento de progreso |\n|---|---|---|---|---|\n| **MMU** | SaaS completo: código + facturación + legal + growth + operaciones | Markdown en tu repo | ✅ Plugin de Claude + servidor MCP | ✅ Puntuación, gates, dashboard que evoluciona |\n| Lighthouse | Solo rendimiento/a11y/SEO de frontend | Navegador/CI | ❌ | Puntuación por ejecución, sin memoria del proyecto |\n| Checklists de vendors (docs de Vercel, Stripe) | Solo el área de ese vendor | Su sitio de docs | ❌ | ❌ Solo lectura |\n| Repos de checklists estáticos / plantillas de Notion | A menudo no verificable | Copiar y pegar | ❌ | ❌ Manual, se queda obsoleto |\n| Revisores de código con IA (CodeRabbit, etc.) | Diffs de código | Flujo de PR | Parcialmente | Solo por PR, sin visión de lanzamiento |\n\nMMU no es un linter ni un sitio de documentación: es la **capa operativa entre tus sesiones de AI coding y un lanzamiento real**: tu CLI, tu CI y tus agentes de IA leen y actualizan la misma checklist.\n\n## Vibe Check Para Tu Código Generado Por IA\n\nEl 45% del código generado por IA se publica con vulnerabilidades. Un comando escanea lo que los asistentes de IA más olvidan:\n\n```bash\nmmu vibecheck\n```\n\nComprueba: secretos hardcodeados · `.env` sin gitignore · verificación de firma + idempotencia de webhooks · flujo de password reset · SQL con f-strings · rate limiting · CORS comodín · `DEBUG = True` · monitoreo de errores. Los hallazgos P0 salen con código distinto de cero, listo para CI.\n\n## Para Quién Es\n\n| Tú eres... | MMU te ayuda a... |\n|-------------|-------------------|\n| **Un fundador que programa con IA** | Dejar de re-explicar tu proyecto en cada sesión. Mantener el contexto entre herramientas. |\n| **Un desarrollador frontend** | Saber exactamente qué construir: flujos de autenticación, estados de error, puntos de quiebre responsive y etiquetas OG. |\n| **Un product manager / planificador** | Obtener un PRD estructurado, estrategia de precios y checklist de lanzamiento, todo en Markdown. |\n| **Un desarrollador fullstack** | Rastrear frontend, backend, facturación y cumplimiento en un solo lugar. Que no se escape nada. |\n\n## Pruébalo en 60 Segundos\n\n```bash\npip install make-me-unicorn\ncd your-project\nmmu init \u0026\u0026 mmu scan \u0026\u0026 mmu status --why\n```\n\nEso es todo. Verás tu puntuación de preparación para el lanzamiento, lo que está hecho, lo que falta y por qué.\n\nLuego ejecuta `mmu next` para saber qué hacer primero.\n\n## Inicio Rápido\n\n```bash\npip install -e .\n\n# Opción A: Empieza con plantillas vacías y complétalas tú\nmmu init\n\n# Opción B: Deja que Claude genere la documentación del proyecto (requiere API key)\npip install -e \".[llm]\"\nexport ANTHROPIC_API_KEY=sk-ant-...\nmmu init --interactive        # responde 5 preguntas y obtiene docs de estrategia, producto y precios\n```\n\nLuego:\n\n```bash\nmmu scan                      # detecta automáticamente tu stack técnico\nmmu                           # mira tu panel\nmmu status --why              # mira cómo se calcula tu puntuación\nmmu next                      # obtén tus 3 próximas acciones priorizadas\nmmu show frontend             # entra en detalle de cualquier categoría\nmmu check frontend 3          # marca elementos como completados\nmmu gate --stage M0           # verifica si estás listo para la siguiente fase\nmmu doctor                    # ejecuta chequeos de salud de guardrails\n```\n\n## Comparte Tu Puntuación\n\nMuestra tu nivel de preparación para el lanzamiento. Pégalo en tu README, tuiteálo o compártelo en Discord.\n\n```bash\nmmu share                     # imprime la tarjeta de puntuación compartible\nmmu share --clipboard         # copia al portapapeles (macOS)\n```\n\n```\n┌─────────────────────────────────────────────┐\n│  Make Me Unicorn — Launch Readiness         │\n│                                             │\n│  Score: 68%  Stage: YOUNG UNICORN           │\n│                                             │\n│  M0 Problem Fit    ████████████████  PASS   │\n│  M1 Build Fit      ████████████████  PASS   │\n│  M2 Revenue Fit    ██████████░░░░░░  OPEN   │\n│  M3 Trust Fit      ████████████████  PASS   │\n│  M4 Growth Fit     ████████░░░░░░░░  OPEN   │\n│  M5 Scale Fit      ████░░░░░░░░░░░░  OPEN   │\n│                                             │\n│  Stack: Next.js · Stripe · SSR              │\n│  pip install make-me-unicorn                │\n│  #MakeMeUnicorn                             │\n└─────────────────────────────────────────────┘\n```\n\n## 6 Puertas de Lanzamiento\n\nPiensa en estas como salidas de fase. No te las saltes.\n\n```\nM0 Problem Fit    →  ¿Sabes para QUIÉN construyes y POR QUÉ?\nM1 Build Fit      →  ¿El producto principal funciona de punta a punta?\nM2 Revenue Fit    →  ¿Alguien puede pagarte? ¿Y recibir un reembolso?\nM3 Trust Fit      →  ¿Política de privacidad? ¿Canal de soporte? ¿Logs?\nM4 Growth Fit     →  ¿Los enlaces compartidos se ven bien? ¿Pueden encontrarte?\nM5 Scale Fit      →  ¿Qué pasa cuando algo falla a las 3 a. m.?\n```\n\nEjecuta `mmu gate --stage M0` para verificar. Todos los elementos sin marcar = NOT PASS.\n\n## 12 Modos de Operación\n\nUn modo por sesión. Cada modo carga solo los documentos que necesitas.\n\n```bash\nmmu start --mode backend      # carga: architecture.md, sprint, registros ADR\nmmu start --mode billing      # carga: pricing.md, checklist de facturación, cumplimiento\nmmu start --mode growth       # carga: checklist SEO, métricas\n```\n\nEsto previene el problema #1 de programar con IA: **sobrecarga de contexto**. Tu asistente de IA recibe solo lo que necesita — no tu proyecto entero.\n\n## Integración con IA (Opcional)\n\nMMU funciona sin ninguna IA. Pero con Claude, se vuelve poderoso:\n\n```bash\npip install make-me-unicorn[llm]\nexport ANTHROPIC_API_KEY=sk-ant-...\n```\n\n| Comando | Qué hace |\n|---------|----------|\n| `mmu init --interactive` | Responde 5 preguntas sobre tu producto. Claude escribe tu estrategia, especificación de producto, precios, arquitectura y documentos de UX. |\n| `mmu start --mode X --agent` | Auto-formatea el contexto de tu sesión — pega directamente en Claude Code o cualquier LLM. |\n| `mmu doctor --deep` | Claude lee tu código y docs, detecta inconsistencias, brechas de seguridad y puntos ciegos. |\n| `mmu generate strategy` | Genera o actualiza cualquier documento clave según el estado actual de tu proyecto. |\n\nEl CLI core no tiene dependencias externas. Las funciones de IA son opcionales y se degradan de forma segura.\n\n## Usar como Skill de Claude\n\nMMU también está empaquetado como plugin de Claude Code + Anthropic Agent Skill. En cualquier herramienta compatible con la especificación Agent Skills (Claude Code, Claude Desktop, OpenAI Codex CLI), MMU se invoca automáticamente cuando mencionás frases como \"validar mi idea de SaaS\" o \"checklist de lanzamiento\".\n\n```bash\n# Dentro de Claude Code:\n/plugin marketplace add minjikim89/make-me-unicorn\n/plugin install make-me-unicorn\n```\n\nEl skill carga solamente los blueprints relevantes para la conversación (progressive disclosure), manteniendo bajo el costo de contexto.\n\n## Modo Servidor MCP\n\nMMU también funciona como servidor MCP (Model Context Protocol). Cualquier agente compatible con MCP (Claude Code, Claude Desktop, Cursor, Gemini CLI) puede llamar los blueprints y templates de MMU como herramientas nativas.\n\n```bash\npip install make-me-unicorn[mcp]\nmmu serve-mcp                          # transporte stdio (por defecto)\nmmu serve-mcp --transport sse          # transporte SSE\n```\n\nConfiguración de Claude Desktop (`~/Library/Application Support/Claude/claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"mmu\": {\n      \"command\": \"mmu\",\n      \"args\": [\"serve-mcp\", \"--root\", \"/path/to/cloned/make-me-unicorn\"]\n    }\n  }\n}\n```\n\nHerramientas expuestas:\n\n- `mmu_list_blueprints` — lista 17 blueprints (15 core + 2 de industria)\n- `mmu_get_blueprint(name)` — obtiene el markdown completo de un blueprint\n- `mmu_list_idea_templates` — lista los prompts start/close/ADR + el kit de Product Hunt\n- `mmu_validate_idea(idea)` — valida contra hilos reales de HN + Reddit: veredicto, sentimiento, competidores, hilos principales (modo gratuito, sin claves API; requiere el extra `[validate]`)\n\n## Validar una Idea\n\nTomá señal real de HN + Reddit antes de construir:\n\n```bash\npip install make-me-unicorn[validate]\nmmu validate \"tutor de IA para niños\" --limit 30\n```\n\nEl modo por defecto es **gratis** — sin API key, sin llamadas de pago. Búsqueda pública en Reddit + HN Algolia, análisis de sentimiento VADER local, extracción de competidores por tokens en mayúscula. Guarda un reporte markdown en `reports/validate/\u003cslug\u003e-\u003chash\u003e.md`.\n\nPara un veredicto de validación de una página sintetizado a partir de los hilos:\n\n```bash\nmmu validate \"tutor de IA para niños\" --llm\n# Pide confirmación de costo (~$0.05–0.20). Usá -y para saltarlo.\n```\n\n`--llm` es opt-in explícito — el flujo por defecto nunca llama a la API de Anthropic.\n\n## Flujo de Sesión\n\nCada sesión sigue el mismo ritmo:\n\n```\n1. mmu start --mode backend      ← elige un foco y carga los docs relevantes\n2. Build / decide / validate      ← haz el trabajo\n3. mmu close                      ← registra qué cambió y qué sigue\n```\n\nEl cierre de sesión usa etiquetas estructuradas para la memoria:\n\n- `[DONE]` — lo que completaste\n- `[DECISION]` — decisiones tomadas (crear ADR si es significativo)\n- `[ISSUE]` — qué salió mal (categorizar: brecha de contexto / dirección incorrecta / conflicto doc-código)\n- `[NEXT]` — primera tarea para la próxima sesión\n\nEsto significa que tu próxima sesión arranca en **5 segundos**, no en 15 minutos de \"¿dónde me quedé?\"\n\n## Ejemplo: TaskNote\n\nMira un ejemplo completo de MMU en acción:\n\n```\nexamples/filled/tasknote/\n├── docs/core/strategy.md      ← ICP, propuesta de valor, competidores\n├── docs/core/product.md       ← alcance del MVP, recorrido de usuario, P0/P1\n├── docs/core/pricing.md       ← Free/Pro/Team, reglas de facturación\n├── docs/core/architecture.md  ← Next.js + FastAPI + Postgres\n├── docs/adr/001_billing_provider_choice.md  ← ¿Por qué Stripe?\n└── current_sprint.md          ← 3 objetivos de esta semana\n```\n\n## Requisitos\n\n- Python `3.10+`\n- `pip`\n- CLI core: cero dependencias externas\n- Funciones de IA: `pip install make-me-unicorn[llm]`\n\n## Estructura del Proyecto\n\n```\nmake-me-unicorn/\n├── src/mmu_cli/           # CLI source (Python)\n├── docs/\n│   ├── core/              # Strategy, Product, Pricing, Architecture, UX\n│   ├── ops/               # Roadmap, Metrics, Compliance, Reliability\n│   ├── blueprints/        # 15 category checklists (670+ items)\n│   ├── checklists/        # M0–M5 launch gates\n│   └── adr/               # Decision log templates\n├── prompts/               # Session start/close/ADR templates\n├── examples/filled/       # Concrete example (TaskNote)\n└── tests/                 # Unit tests\n```\n\n## Controles de CI\n\n`mmu doctor` se ejecuta en cada PR. `mmu gate` se ejecuta para las etapas listadas en `docs/ops/gate_targets.txt`.\n\n## Contribuir\n\nVer `CONTRIBUTING.md`.\n\n## Licencia\n\nMIT. Ver `LICENSE`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fminjikim89%2Fmake-me-unicorn","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fminjikim89%2Fmake-me-unicorn","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fminjikim89%2Fmake-me-unicorn/lists"}