alexandreleciel/startup-pitch

Startup pitch

Convierte la carpeta de un fundador en un pitch de inversión que pueda defender. Cada ejecución comienza con la ejecución rápida: una página, pitch/START-HERE.md, respaldada por un pequeño registro de hechos con fuentes. La narrativa, la sesión completa de preguntas y respuestas con inversores y la presentación son complementos que el fundador solicita.

Reglas

1. Lee antes de preguntar. Realiza la ingesta y lee los archivos primero. Pregunta solo por lo que falta, es material en esta etapa y no se puede deducir de la carpeta.
2. Cada número tiene una fuente. Una cifra aparece en cualquier salida solo a través de una entrada en pitch/facts.yaml con un tipo (hecho, suposición, proyección) y una fuente. Si la carpeta no tiene el número, escribe [necesita número] y pregunta. Inventar tracción, ingresos, tamaño de mercado, crecimiento, retención, clientes, contrataciones o valoración es el fallo que esta habilidad existe para prevenir.
3. Saca a la luz las contradicciones, nunca las promedies. Registra ambos valores como en conflicto, usa el conservador, dilo y pregunta al fundador.
4. El material confidencial se mantiene fuera del texto para inversores. Los archivos marcados como confidenciales no se leen. Las valoraciones, condiciones, nombres de la tabla de capitalización, nombres de inversores potenciales, salarios y términos contractuales se mantienen fuera de la narrativa y la presentación dondequiera que aparezcan.
5. Mantén la voz del fundador. Usa su redacción específica y las citas de sus clientes. Elimina las palabras de moda; no añadas ninguna.
6. Registro pequeño. Registra solo los números que una salida cite, más ambos lados de cada conflicto. Sin entradas intermedias, sin historial que nadie cite.

Comandos

Un punto de entrada; $SKILL es el directorio de esta habilidad (usa su ruta absoluta). Ejecuta desde la carpeta de la startup.

python3 $SKILL/scripts/pitch.py intake        # inventario + extracción -> pitch/intake/
python3 $SKILL/scripts/pitch.py check         # verifica pitch/facts.yaml (y la presentación si existe)
python3 $SKILL/scripts/pitch.py deck          # construye html + pptx, imprime pdf, capturas de QA, rastrea números
python3 $SKILL/scripts/pitch.py comparables --sector saas --round seed   # tres presentaciones reales para estudiar
python3 $SKILL/scripts/pitch.py status        # qué existe, qué está abierto
python3 $SKILL/scripts/pitch.py open          # abre pitch/ para el fundador

pitch.py setup instala las dependencias de la presentación dentro de la carpeta de la habilidad (la primera ejecución de deck lo hace automáticamente); pitch.py doctor muestra lo que está instalado.

Ejecución rápida (siempre primero; apunta a cinco minutos)

Lee references/core.md y references/file-formats.md. No abras ninguna otra referencia.

1. pitch.py intake. Lee pitch/intake/corpus/INDEX.md, luego los archivos que enumera, en orden: primero los memos y notas del fundador, luego los datos, y luego el resto. Prefiere el más reciente de cualquier par desactualizado. No abras archivos marcados como confidenciales. Se puede leer un archivo que el índice marque como que contiene términos del acuerdo o remuneración; esos términos se mantienen fuera del texto para inversores.
2. Escribe pitch/facts.yaml: de 15 a 30 entradas, solo lo que la página de inicio citará. Comienza desde scripts/facts_template.yaml. Ejecuta pitch.py check; corrige cada FALLO. Una ADVERTENCIA es una pregunta para el fundador, no algo que ocultar. pitch.py check --explain imprime cómo el verificador empareja ids, unidades y cifras de la presentación, por lo que no es necesario leer su código fuente.
3. Escribe pitch/START-HERE.md con la plantilla en references/file-formats.md: las preguntas que el fundador debe responder (cinco como máximo, las contradicciones primero, cada una con el valor utilizado hasta que se responda), el pitch de dos frases y la versión de 60 segundos, los tres a cinco números que importan y las afirmaciones que aún no deben usarse, las cinco preguntas de inversores para las que están menos preparados con respuestas honestas, las tres principales banderas rojas con soluciones, y lo que se mantuvo fuera del material para inversores. Alrededor de 1.200 palabras. Con más de cinco elementos abiertos, pon el resto en pitch/gaps.md y enlázalo.
4. Dile al fundador, en el chat: las mismas preguntas, lo que asumiste, y los siguientes pasos que puede solicitar (narrativa, Q&A completo, presentación, preparación para la reunión). Ejecuta pitch.py open.

Si el inversor objetivo es desconocido, esa es una de las cinco preguntas; indica el valor predeterminado de core.md y procede.

Complementos (haz los que el fundador solicitó; la ejecución rápida sigue siendo lo primero)

El fundador quiere	Lee	Haz
La narrativa	references/narrative.md	Escribe pitch/narrative.md: oración de propósito, opciones narrativas, forma larga, versiones de dos frases, 60 segundos y 3 minutos. Cita ids en línea. Otras variantes solo bajo petición.
Q&A para inversores	references/investor-questions.md; question-bank.md como consulta por tema	Escribe pitch/investor-qa.md: las cinco menos preparadas, entrenamiento de 10 preguntas, como máximo 15 preguntas temáticas con respuestas honestas citando ids, y registros de banderas rojas en el formato de core.md.
Una auditoría completa de banderas rojas o verificación previa al envío	references/red-flags.md	Añade la auditoría a investor-qa.md (o a la revisión de la presentación) con el desencadenante, la solución y el estado de cada bandera.
Una presentación	references/deck-structure.md (tabla de capacidad), references/design.md	pitch.py comparables y hojea la estructura de las tres presentaciones. Escribe pitch/deck/deck.json dentro de la tabla de capacidad, un tema elegido para esta empresa, colores de marca y logotipo si la carpeta los tiene. pitch.py deck. Corrige cada lint y línea de QA recortando palabras, vuelve a ejecutar hasta que el resumen esté limpio, luego mira pitch/deck/qa/ tú mismo.
Preparación para un tipo o firma de inversor	references/investor-types.md, el bloque correspondiente en investor-types-detail.md, references/meetings.md	Ajusta el Q&A y la solicitud. Usa solo lo que dicen las páginas públicas de una firma, citado.
Puntos de referencia de etapa, métricas específicas del modelo	references/benchmarks.md, el bloque correspondiente en metrics-by-model.md	Cita con fuente y año, o no lo hagas en absoluto.
"Revisa mi presentación" (pdf, pptx, html en la carpeta)	references/red-flags.md	La ingesta la extrae. Construye el registro a partir de la presentación más la carpeta, escribe la página de inicio como una revisión, ofrece la reconstrucción.
"Actualiza los números"	ninguno	Vuelve a ejecutar la ingesta y la verificación, actualiza el registro, reconstruye las salidas, enumera cada valor cambiado (antiguo y nuevo).
Un pitch de 3 minutos para el demo day	references/narrative.md, references/deck-structure.md	Variante de demo day y la estructura de 6 a 8 diapositivas.

Cada complemento extiende el registro solo con los números que cita de nuevo. Añade cada archivo nuevo a la lista "Archivos" al final de START-HERE.md.

Cuando el fundador responde

Actualiza primero el registro, luego las páginas.

• Una decisión (el tamaño de la ronda, el inversor objetivo, cuál de las dos cifras es actual) se convierte en status: confirmed; el otro lado de un conflicto se mueve a su note.
• Una afirmación sin ningún archivo detrás (un recuento de reembolsos, la experiencia del fundador) se registra con source: fundador declaración, <fecha> y status: unverified, se indica claramente en las salidas, y el registro que la respaldaría va a la lista de cosas que traer.
• Un problema que el fundador deja abierto ("Necesito rehacer el presupuesto") obtiene open_question: en la entrada que le concierne, por lo que la verificación reporta una ADVERTENCIA, no un FALLO. No añadas entradas para equilibrar una identidad.
• Una respuesta que contradice un archivo se aplica, y el archivo se nombra en START-HERE.md sección 1 como que necesita una actualización.
• Si nombran un tipo de inversor o región, abre references/investor-types.md.

Ejecuta pitch.py check, actualiza START-HERE.md y cada salida que citó los ids cambiados, e informa cada valor cambiado como antiguo a nuevo. Elimina las preguntas respondidas; promueve el siguiente elemento abierto. Si piden una presentación mientras aún hay espacios abiertos, constrúyela y enumera los espacios restantes [necesita número] primero en tu respuesta.

Cuando nadie puede responder (ejecución no interactiva)

Continúa con el valor conservador para cada conflicto y [necesita número] para cada vacío. START-HERE.md sección 1 enumera cada elemento abierto, por lo que nada está oculto; una presentación puede mantener espacios [necesita número] visibles.

Antes de entregar

• pitch.py check no tiene FALLOS; con una presentación, el resumen de pitch.py deck muestra un PPTX verificado, recuento de páginas PDF coincidente, 0 problemas de QA.
• Cada número en cada salida cita un id del registro; sin contenido confidencial en el texto para inversores.
• Los títulos de las diapositivas por sí solos cuentan el pitch (léelos de arriba a abajo).
• Las muestras pequeñas indican n y el entorno; los datos de más de 18 meses llevan su fecha.
• Agrega una entrada con fecha a pitch/run-log.md: archivos leídos, preguntas realizadas, respuestas, salidas.

Mapa de referencias

Archivo	Ábrelo cuando
references/core.md	cada ejecución
references/file-formats.md	cada ejecución (registro, plantilla START-HERE, deck.json, diseño de carpeta)
references/narrative.md	al escribir narrative.md o cualquier variante hablada
references/investor-questions.md, question-bank.md, meetings.md	Q&A, consultas por tema, hoja de ruta de reunión y seguimiento
references/red-flags.md	revisiones de presentación, auditorías completas, verificación previa al envío
references/investor-types.md, investor-types-detail.md	se nombra un tipo de inversor o región objetivo
references/metrics.md, metrics-by-model.md, benchmarks.md	definiciones de métricas, métricas de un modelo de negocio, barreras de etapa
references/deck-structure.md, references/design.md	al construir o revisar una presentación
references/deck-library.md	una presentación comparable tiene notas de estructura allí (el comando comparables lo indica)

Errores comunes

• Escribir el pitch primero y rellenar las fuentes después. El registro va primero para que la historia se construya a partir de lo que es verdad.
• Confiar en el memo del fundador por encima de la exportación de métricas. Los memos redondean hacia arriba: registra ambos, pregunta.
• Presentar el resultado de tres meses de un solo cliente como una métrica de la empresa. Indica n y el entorno.
• Llenar la diapositiva de mercado a partir de un informe porque la carpeta no tiene nada. Usa [necesita número] y dale al fundador el método ascendente.
• Leer todas las referencias antes de empezar. La ejecución rápida necesita dos archivos.
• Inflar el registro para silenciar el verificador. Usa computed: true para valores que sumaste o contaste, y cita solo lo que usas.
• Ajustar una diapositiva desbordada reduciendo el tamaño de la letra. Recorta palabras o divide la diapositiva.
• Ocultar una respuesta débil. Los inversores la encuentran; una respuesta sincera con un plan se lee como madurez.