alexandreleciel/startup-pitch

Startup pitch

Transformez le dossier d'un fondateur en un pitch investisseur qu'il peut défendre. Chaque exécution commence par le quick run : une page, pitch/START-HERE.md, accompagnée d'un petit registre sourcé. La narration, la préparation complète aux questions des investisseurs et le deck sont des ajouts demandés par le fondateur.

Règles

1. Lire avant de demander. Effectuez d'abord la phase d'intake et lisez les fichiers. Demandez uniquement ce qui manque, ce qui est essentiel à ce stade, et ce qui ne peut pas être déduit du dossier.
2. Chaque chiffre a une source. Un chiffre n'apparaît dans un résultat que via une entrée dans pitch/facts.yaml avec un type (fait, hypothèse, projection) et une source. Si le dossier ne contient pas de chiffre, écrivez [besoin d'un chiffre] et demandez. Inventer la traction, le revenu, la taille du marché, la croissance, la rétention, les clients, les recrutements ou la valorisation est l'échec que ce skill a pour mission d'empêcher.
3. Faire remonter les contradictions, jamais les moyenner. Enregistrez les deux valeurs comme conflicting, utilisez la plus conservative, indiquez-le, et demandez au fondateur.
4. Les informations confidentielles restent hors du texte destiné aux investisseurs. Les fichiers marqués confidentiels ne sont pas lus. Les valorisations, conditions, noms de la cap table, noms d'investisseurs potentiels, salaires et conditions contractuelles restent hors de la narration et du deck, où qu'ils apparaissent.
5. Gardez la voix du fondateur. Utilisez ses formulations spécifiques et les citations de ses clients. Supprimez le jargon ; n'en ajoutez pas.
6. Petit registre. N'enregistrez que les chiffres qu'un résultat cite, ainsi que les deux côtés de chaque conflit. Pas d'entrées intermédiaires, pas d'historique que personne ne cite.

Commandes

Un seul point d'entrée ; $SKILL est le répertoire de ce skill (utilisez son chemin absolu). Exécutez depuis le dossier de la startup.

python3 $SKILL/scripts/pitch.py intake        # inventaire + extraction -> pitch/intake/
python3 $SKILL/scripts/pitch.py check         # vérifie pitch/facts.yaml (et le deck s'il est présent)
python3 $SKILL/scripts/pitch.py deck          # construit html + pptx, imprime pdf, captures d'écran QA, retrace les chiffres
python3 $SKILL/scripts/pitch.py comparables --sector saas --round seed   # trois decks réels à étudier
python3 $SKILL/scripts/pitch.py status        # ce qui existe, ce qui est ouvert
python3 $SKILL/scripts/pitch.py open          # ouvre pitch/ pour le fondateur

pitch.py setup installe les dépendances du deck dans le dossier du skill (la première exécution de deck le fait automatiquement) ; pitch.py doctor montre ce qui est installé.

Quick run (toujours en premier ; visez cinq minutes)

Lisez references/core.md et references/file-formats.md. N'ouvrez aucune autre référence.

1. pitch.py intake. Lisez pitch/intake/corpus/INDEX.md, puis les fichiers qu'il liste, dans l'ordre : d'abord les mémos et notes du fondateur, puis les données, puis le reste. Privilégiez la version la plus récente d'une paire obsolète. N'ouvrez pas les fichiers marqués confidentiels. Un fichier que l'index marque comme contenant des conditions de transaction ou de rémunération peut être lu ; ces conditions restent hors du texte destiné aux investisseurs.
2. Écrivez pitch/facts.yaml : 15 à 30 entrées, uniquement ce que la page de démarrage va citer. Commencez à partir de scripts/facts_template.yaml. Exécutez pitch.py check ; corrigez chaque ÉCHEC. Un AVERTISSEMENT est une question pour le fondateur, pas quelque chose à dissimuler. pitch.py check --explain affiche comment le vérificateur fait correspondre les ids, les unités et les chiffres du deck, donc il n'est pas nécessaire de lire son code source.
3. Écrivez pitch/START-HERE.md avec le modèle dans references/file-formats.md : les questions auxquelles le fondateur doit répondre (cinq au maximum, les contradictions d'abord, chacune avec la valeur utilisée jusqu'à réponse), le pitch en deux phrases et la version 60 secondes, les trois à cinq chiffres qui comptent et les affirmations à ne pas encore utiliser, les cinq questions d'investisseur auxquelles ils sont le moins préparés avec des réponses honnêtes, les trois principaux signaux d'alarme avec leurs correctifs, et ce qui a été gardé hors du matériel destiné aux investisseurs. Environ 1 200 mots. Avec plus de cinq éléments ouverts, mettez le reste dans pitch/gaps.md et faites un lien.
4. Dites au fondateur, dans le chat : les mêmes questions, ce que vous avez supposé, et les prochaines étapes qu'il peut demander (narration, Q&A complet, deck, préparation de réunion). Exécutez pitch.py open.

Si l'investisseur cible est inconnu, c'est l'une des cinq questions ; indiquez la valeur par défaut de core.md et continuez.

Ajouts (faites ceux que le fondateur a demandés ; le quick run vient toujours en premier)

Le fondateur veut	Lire	Faire
La narration	references/narrative.md	Écrivez pitch/narrative.md : phrase d'intention, choix narratifs, version longue, versions deux phrases, 60 secondes et 3 minutes. Citez les ids en ligne. Autres variantes uniquement sur demande.
Questions-réponses investisseur	references/investor-questions.md ; question-bank.md comme recherche par thème	Écrivez pitch/investor-qa.md : les cinq questions les moins préparées, un drill de 10 questions, au maximum 15 questions thématiques avec des réponses honnêtes citant les ids, et les enregistrements des signaux d'alarme au format de core.md.
Un audit complet des signaux d'alarme ou une vérification pré-envoi	references/red-flags.md	Ajoutez l'audit à investor-qa.md (ou à la revue du deck) avec le déclencheur, le correctif et le statut de chaque signal.
Un deck	references/deck-structure.md (tableau de capacité), references/design.md	pitch.py comparables et parcourez la structure des trois decks. Écrivez pitch/deck/deck.json dans les limites du tableau de capacité, un thème choisi pour cette entreprise, les couleurs de marque et le logo s'ils sont dans le dossier. pitch.py deck. Corrigez chaque ligne de lint et de QA en réduisant le texte, relancez jusqu'à ce que le résumé soit propre, puis regardez vous-même pitch/deck/qa/.
Préparation pour un type ou un cabinet d'investisseur	references/investor-types.md, le bloc correspondant dans investor-types-detail.md, references/meetings.md	Ajustez les Q&A et la demande. Utilisez uniquement ce que les pages publiques d'un cabinet disent, en citant la source.
Références de stade, métriques spécifiques au modèle	references/benchmarks.md, le bloc correspondant dans metrics-by-model.md	Citez avec la source et l'année, ou pas du tout.
« Revoir mon deck » (pdf, pptx, html dans le dossier)	references/red-flags.md	L'intake l'extrait. Construisez le registre à partir du deck et du dossier, rédigez la page de démarrage comme une revue, proposez la reconstruction.
« Mettre à jour les chiffres »	aucun	Relancez l'intake et la vérification, mettez à jour le registre, reconstruisez les résultats, listez chaque valeur changée (ancienne et nouvelle).
Un pitch de 3 minutes pour un demo day	references/narrative.md, references/deck-structure.md	Variante demo day et la structure de 6 à 8 slides.

Chaque ajout étend le registre uniquement avec les chiffres qu'il cite nouvellement. Ajoutez chaque nouveau fichier à la liste « Fichiers » en bas de START-HERE.md.

Quand le fondateur répond

Mettez d'abord à jour le registre, puis les pages.

• Une décision (la taille du tour, l'investisseur cible, lequel des deux chiffres est actuel) devient status: confirmed ; l'autre côté d'un conflit passe dans sa note.
• Une affirmation sans fichier derrière (un nombre de remboursements, le parcours du fondateur) est enregistrée avec source: founder statement, <date> et status: unverified, énoncée clairement dans les résultats, et l'enregistrement qui la soutiendrait va dans la liste des éléments à apporter.
• Un problème que le fondateur laisse ouvert (« Je dois refaire le budget ») reçoit open_question: sur l'entrée concernée, de sorte que la vérification signale un AVERTISSEMENT, pas un ÉCHEC. N'ajoutez pas d'entrées pour équilibrer une identité.
• Une réponse qui contredit un fichier est appliquée, et le fichier est nommé dans la section 1 de START-HERE.md comme nécessitant une mise à jour.
• S'ils nomment un type d'investisseur ou une région, ouvrez references/investor-types.md.

Exécutez pitch.py check, mettez à jour START-HERE.md et chaque résultat qui citait les ids modifiés, et signalez chaque valeur changée (ancienne et nouvelle). Supprimez les questions auxquelles il a été répondu ; promouvez le prochain élément ouvert. S'ils demandent un deck alors que des emplacements sont encore ouverts, construisez-le et listez les emplacements [besoin d'un chiffre] restants en premier dans votre réponse.

Quand personne ne peut répondre (exécution non interactive)

Continuez avec la valeur conservative pour chaque conflit et [besoin d'un chiffre] pour chaque lacune. La section 1 de START-HERE.md liste chaque élément ouvert, donc rien n'est caché ; un deck peut conserver des emplacements [besoin d'un chiffre] visibles.

Avant la remise

• pitch.py check n'a pas d'ÉCHEC ; avec un deck, le résumé de pitch.py deck montre un PPTX vérifié, un nombre de pages PDF correspondant, 0 problème de QA.
• Chaque chiffre dans chaque résultat cite un id du registre ; aucun contenu confidentiel dans le texte destiné aux investisseurs.
• Les titres des slides racontent à eux seuls le pitch (lisez-les de haut en bas).
• Les petits échantillons indiquent n et le contexte ; les données de plus de 18 mois portent leur date.
• Ajoutez une entrée datée à pitch/run-log.md : fichiers lus, questions posées, réponses, résultats.

Carte de référence

Fichier	Ouvrir quand
references/core.md	à chaque exécution
references/file-formats.md	à chaque exécution (registre, modèle START-HERE, deck.json, structure du dossier)
references/narrative.md	en écrivant narrative.md ou une variante orale
references/investor-questions.md, question-bank.md, meetings.md	Q&A, recherches par thème, feuille de route de réunion et suivi
references/red-flags.md	revues de deck, audits complets, vérification pré-envoi
references/investor-types.md, investor-types-detail.md	un type d'investisseur ou une région cible est nommé(e)
references/metrics.md, metrics-by-model.md, benchmarks.md	définitions de métriques, métriques d'un modèle économique, références de stade
references/deck-structure.md, references/design.md	construction ou révision d'un deck
references/deck-library.md	un deck comparable a des notes de structure (la commande comparables le mentionne)

Erreurs courantes

• Écrire le pitch d'abord et remplir les sources après. Le registre vient en premier pour que l'histoire soit construite à partir de ce qui est vrai.
• Faire confiance au mémo du fondateur plutôt qu'à l'export des métriques. Les mémos arrondissent au supérieur : enregistrez les deux, demandez.
• Présenter le résultat de trois mois d'un seul client comme une métrique de l'entreprise. Indiquez n et le contexte.
• Remplir la slide de marché à partir d'un rapport parce que le dossier ne contient rien. Utilisez [besoin d'un chiffre] et donnez au fondateur la méthode bottom-up.
• Lire toutes les références avant de commencer. Le quick run a besoin de deux fichiers.
• Gonfler le registre pour faire taire le vérificateur. Utilisez computed: true pour les valeurs que vous avez additionnées ou comptées, et citez uniquement ce que vous utilisez.
• Faire tenir une slide débordante en réduisant la police. Coupez le texte ou divisez la slide.
• Cacher une réponse faible. Les investisseurs la trouveront ; une réponse franche avec un plan est perçue comme de la maturité.