Validador de ideas de negocio

¿Qué hace Validador de ideas de negocio?

Uso: /business-idea-validator <texto de la idea o ruta a un archivo> [--lang en|pl|es] [--quick] [--out <dir>]

Evalúa una idea de negocio según diez rúbricas, aplica una regla de veredicto fija y escribe un informe. El juicio está en las puntuaciones y su razonamiento; el veredicto es un cálculo aritmético sobre las puntuaciones, de modo que dos ideas reciben el mismo tratamiento y un lector puede verificarlo manualmente.

Ejecuta desde el directorio de trabajo que el usuario elija (--out <dir>, por defecto el directorio actual). Nunca escribas dentro de la carpeta de esta skill.

Archivos que usarás

• references/rubrics/01-problem.md … 10-risks.md: un archivo por rúbrica. Lee la que estás evaluando.
• references/report-style.md: reglas de escritura. Léelo una vez antes de cualquier evaluación.
• references/intake.md: cuándo hacer preguntas al fundador primero.
• references/verdict.md: la regla, para tu comprensión; el código está en scripts/verdict.mjs.
• assets/rubric-output.schema.json: el JSON exacto que devuelve una pasada de rúbrica.
• assets/report.schema.json: el informe completo.
• assets/examples/fieldnote/: un ejemplo completo (idea inventada) de idea.md, report.json, report.md.
• scripts/check.mjs: valida, computa el veredicto y renderiza Markdown. ${CLAUDE_SKILL_DIR} apunta a esta carpeta en Claude Code; en otros lugares usa la ruta donde se instaló la skill.

Pasos

1. Captura

Toma la idea del argumento, del prompt o de la ruta de un archivo. Decide el idioma del informe: el idioma del texto de la idea, a menos que --lang indique lo contrario.

Aplica references/intake.md. Si el texto es escaso (menos de unas 40 palabras, o falta para quién es como rol o persona, qué hace o cómo gana dinero), pregunta al fundador una vez, hasta cinco preguntas en un solo mensaje, y espera. Si no puedes preguntar (modo no interactivo, o --quick), continúa con suposiciones y menciónalo en synthesis.notes.

Almacena lo que tienes como idea.text e idea.answers (for, money, today, advantage, stage; solo las proporcionadas).

2. Evalúa las diez rúbricas

Lee primero references/report-style.md. Luego, para cada rúbrica en el orden problem, customer, market, alternatives, monetization, distribution, feasibility, moat, founder, risks:

• Proporciona a la pasada el texto de la idea, las respuestas, el archivo de la rúbrica, las reglas de estilo y el esquema de salida.
• La pasada devuelve un objeto JSON que coincide con assets/rubric-output.schema.json: id, score del 1 al 5, confidence bajo/medio/alto, evidence (citas textuales), assumptions, reasoning (máximo 160 palabras), questions, improve.

Ejecuta las pasadas en paralelo a través del subagente business-idea-rubric cuando la herramienta Agent esté disponible (un agente por rúbrica, instrúyelo con las rutas de los archivos y la idea; pídele que devuelva solo el JSON). De lo contrario, evalúalas tú mismo, una rúbrica a la vez, leyendo el archivo de la rúbrica de nuevo cada vez para tener los anclajes presentes.

Crea <out>/rubrics/ y guarda los diez resultados allí como <id>.json a medida que avanzas. Valida cada uno: node ${CLAUDE_SKILL_DIR}/scripts/check.mjs --rubric <out>/rubrics/<id>.json. Corrige cualquier problema que reporte (generalmente una lista demasiado larga o un razonamiento de más de 120 palabras) antes de continuar.

3. Pasada crítica

Omite con --quick. De lo contrario, proporciona al subagente business-idea-critic (o hazlo tú mismo) los diez resultados, la idea y los archivos de rúbrica. Su trabajo: intentar refutar cada puntuación de 1, 2 o 5 usando los anclajes y el texto, y marcar cualquier rúbrica donde la confianza no coincida con lo asentada que está la puntuación. Devuelve { "changes": [{ "id", "from", "to", "confidence", "why" }], "notes": "" } donde confidence es same o el nuevo nivel; why y notes están en el idioma del informe. Aplica cada cambio al resultado de la rúbrica: establece la puntuación y la confianza, y reescribe el reasoning de esa rúbrica para que argumente a favor de la nueva puntuación (un resultado no debe contradecirse a sí mismo). Mantén el objeto crítico para el informe.

4. Síntesis

Con las puntuaciones finales, escribe el objeto de síntesis (assets/report.schema.json, synthesis): summary (tres oraciones), riskiestAssumption (una), experiments (de una a tres, máximo 14 días, cada una con una métrica numérica), pivots (solo reales; vacío está bien), openQuestions (las preguntas de las rúbricas, sin duplicados, las más importantes primero, máximo ocho), notes (cómo se creó el informe cuando sea relevante, si no, vacío). Sigue las reglas de síntesis en references/report-style.md.

5. Ensamblar y renderizar

Escribe <out>/report.json con version: "1", lang, idea, rubrics (las diez), critic (si se ejecutó), synthesis, verdict: {} (el script lo llena; nunca escribas un veredicto manualmente), meta (model: el modelo en el que te estás ejecutando según tu conocimiento, createdAt: fecha ISO, generator: "skill").

Ejecuta node ${CLAUDE_SKILL_DIR}/scripts/check.mjs <out>/report.json. Valida todo, escribe el veredicto en el archivo y escribe <out>/report.md. Corrige los problemas hasta que imprima OK.

6. Entrega

Indica al usuario: el veredicto y la regla que lo produjo, el supuesto más riesgoso, el primer experimento y dónde están los dos archivos. Mantenlo en menos de diez líneas; el informe contiene el resto. No repitas la tabla de puntuaciones en el chat.

Reglas que anulan todo lo anterior

• Cita, no parafrasees, en evidence. Cualquier cosa que no esté en el texto es un supuesto y se etiqueta como tal.
• Sin números inventados. Los tamaños de mercado y precios son "asumiendo …" con un rango.
• El veredicto proviene de scripts/check.mjs. Nunca lo escribas manualmente y nunca discutas con él en el informe; si parece incorrecto, una puntuación está mal, corrige la puntuación con una razón.
• El idioma del informe sigue el texto de la idea (o --lang). Las claves JSON permanecen en inglés.
• Estilo: oraciones cortas, sin guiones largos, sin exageraciones, sin "no solo X sino Y".