arquiteto-de-empresa

Présentation de la skill arquiteto-de-empresa

À quoi sert arquiteto-de-empresa

arquiteto-de-empresa est une skill de Company Architect qui transforme une idée d’entreprise encore approximative, portée par un fondateur, en bundle OKF : une arborescence de fichiers Markdown versionnable, avec frontmatter YAML, concepts typés, liens croisés, tableaux de bord index.md et journal log.md en écriture append-only. Plutôt que de produire un business plan ponctuel, la skill mène un entretien par phases et matérialise l’entreprise sous forme de connaissance structurée, lisible par des humains comme par des agents IA.

Utilisateurs et décisions pour lesquels elle est la plus adaptée

Cette skill convient surtout aux fondateurs, chief-of-staff operators, venture studios, consultants et équipes de planification stratégique qui ont besoin d’une base de connaissances vivante sur l’entreprise, et pas seulement d’un récit de pitch. Elle s’applique bien à la conception d’entreprise en phase amont, à la documentation de business model, à la création d’un système d’exploitation d’entreprise et aux workflows de type “company as code”. arquiteto-de-empresa for Strategic Planning est particulièrement utile lorsque vous voulez relier, dans un même repository, les décisions de stratégie, marché, finance, vente, marketing, produit, opérations, technologie, RH, juridique et gouvernance.

Ce qui distingue cette skill

Son principal différenciateur est la structure. La skill suit un playbook en 12 phases, pose quelques questions à la fois et rédige un concept par fichier .md à partir d’un vocabulaire contrôlé de type. Le résultat est ainsi plus facile à comparer dans Git, valider, indexer et réutiliser par d’autres agents. Les références et scripts Python inclus aident à créer le scaffold, vérifier la conformité OKF et régénérer les tableaux d’index.

Quand elle peut être disproportionnée

N’installez pas arquiteto-de-empresa skill si vous avez seulement besoin d’une SWOT rapide, d’un brief de landing page ou d’un court mémo investisseur. La méthode est volontairement systématique. Elle fonctionne le mieux si vous êtes prêt à répondre à des questions par étapes, à maintenir des fichiers et à traiter les hypothèses comme de la connaissance provisoire plutôt que comme une vérité définitive.

Utiliser la skill arquiteto-de-empresa

Installer et inspecter le repository avant de commencer

Pour un workflow Claude skills, installez depuis le repository avec :

npx skills add alirezarezvani/claude-skills --skill arquiteto-de-empresa

Si votre outil ne prend pas en charge cette commande, copiez ou référencez le dossier de la skill depuis c-level-advisor/arquiteto-de-empresa/skills/arquiteto-de-empresa. Avant un usage sérieux, lisez SKILL.md, puis references/phase_playbook.md, references/okf_conformance.md et references/type_vocabulary.md. Parcourez aussi assets/frontmatter_template.md, assets/index_template.md et assets/log_template.md afin de comprendre le contrat de fichiers que l’agent doit respecter.

Commencer avec un prompt de découverte complet

Un bon arquiteto-de-empresa usage commence par du contexte, pas par une demande vague. Au lieu d’écrire “build my company”, fournissez les faits initiaux nécessaires à la découverte de Phase 0 :

• idée d’entreprise et problème client
• stade : idée, MVP, activité lancée ou passage à l’échelle
• business model : service, SaaS, marketplace, produit, hybride
• secteur, pays et juridiction légale
• nom existant, actifs, contraintes et hypothèses connues
• emplacement de sortie souhaité, par exemple ./my-company-okf

Un prompt plus solide serait : “Use arquiteto-de-empresa to create an OKF bundle for a B2B SaaS in Brazil that helps clinics reduce no-shows. We are at MVP stage, have no legal entity yet, and want files suitable for Git. Run Phase 0 first, ask only the necessary questions, mark unknowns as [ASSUMPTION], then scaffold the bundle.”

Suivre le workflow en 12 phases, pas générer un bloc de contenu

La skill est conçue pour mener l’entretien dans l’ordre : discovery, foundation, strategy, market, finance, sales, marketing, product, operations, tech, people, legal et governance. Demandez à l’agent de terminer une phase, de confirmer les concepts générés, de mettre à jour le index.md racine et d’ajouter une entrée à log.md avant de passer à la suivante. Cela évite les livrables superficiels ou incohérents et garde les décisions stratégiques traçables.

Utiliser les scripts d’aide pour contrôler la qualité

Le repository inclut scripts/scaffold_bundle.py, scripts/okf_linter.py et scripts/index_generator.py. Servez-vous-en comme aides à l’implémentation après la rédaction initiale par l’agent. Le linter est important, car la qualité OKF repose sur des détails : chaque concept doit avoir son propre fichier Markdown, le frontmatter doit inclure un type valide, et les liens doivent former un graphe exploitable plutôt qu’un ensemble de documents isolés.

FAQ sur la skill arquiteto-de-empresa

arquiteto-de-empresa est-elle réservée aux nouvelles entreprises ?

Non. Elle est particulièrement forte pour créer une entreprise à partir de zéro, mais elle peut aussi documenter une entreprise existante si vous fournissez sa stratégie actuelle, ses processus, ses outils, ses finances et les détails de son organisation. Pour une entreprise déjà en activité, demandez à la skill de distinguer “current state”, “target state” et les éléments [ASSUMPTION], afin que le bundle ne réécrive pas la réalité sous forme d’aspiration.

En quoi est-elle meilleure qu’un prompt classique de business plan ?

Un prompt classique renvoie souvent un document bien rédigé, mais plat. arquiteto-de-empresa produit un système de connaissance navigable : concepts Markdown typés, index réservés, journaux de décision et liens croisés. C’est important si vous voulez que de futurs agents puissent récupérer la connaissance de l’entreprise, mettre à jour un concept sans tout réécrire ou suivre l’évolution des décisions dans le temps.

Faut-il connaître OKF avant de l’utiliser ?

Non, mais vous devriez lire la référence de conformité OKF avant de faire confiance au résultat. Les règles clés sont simples : un concept par fichier, frontmatter YAML avec un type valide, fichiers réservés index.md et log.md, liens relatifs entre concepts et hypothèses clairement signalées. Les débutants peuvent très bien utiliser la skill s’ils suivent l’entretien par phases au lieu de demander tous les fichiers d’un coup.

Quand ne faut-il pas utiliser cette skill ?

Évitez cette skill lorsque la vitesse compte davantage que la structure, lorsque l’activité est trop confidentielle pour être partagée dans un environnement IA, ou lorsque vous avez besoin d’un conseil juridiquement opposable. Elle peut organiser des concepts juridiques et de gouvernance, mais elle ne remplace pas des avocats, des experts-comptables ni une revue de conformité propre à une juridiction.

Améliorer la skill arquiteto-de-empresa

Améliorer les inputs arquiteto-de-empresa avant de générer les fichiers

Le principal levier de qualité est la précision des informations fournies. Donnez de vraies contraintes : fourchette de budget, client cible, géographie, compétences des fondateurs, traction actuelle, hypothèses de prix, approche commerciale, risques réglementaires et préférences technologiques. Si quelque chose est inconnu, dites-le. La convention [ASSUMPTION] de la skill n’est utile que si l’agent sait quels faits manquent.

Prévenir les échecs OKF les plus fréquents

Surveillez les fichiers qui mélangent plusieurs concepts, les valeurs type manquantes, les descriptions génériques, les liens relatifs cassés et les affirmations stratégiques qui ne sont pas reliées à des hypothèses de marché ou de finance. Demandez à l’agent d’effectuer une passe de conformité après chaque phase : “Check every generated concept against references/okf_conformance.md and references/type_vocabulary.md; list fixes before rewriting.”

Itérer sur les sorties de phase avec des critères de décision

Après chaque phase, vérifiez l’utilité du résultat pour la décision. Une bonne phase foundation doit clarifier la raison d’être, le problème, les valeurs et les hypothèses. Une bonne phase finance doit faire apparaître le modèle de revenus, la structure de coûts, l’économie unitaire, le pricing et les projections. Une bonne phase operations doit produire des processus et des runbooks qu’une personne pourrait réellement exécuter. Si le résultat ressemble à du contenu marketing, demandez des arbitrages plus nets, des dépendances et des options rejetées.

Étendre la skill pour votre modèle opérationnel

Pour améliorer arquiteto-de-empresa dans votre organisation, ajoutez des templates propres à l’entreprise, des extensions au vocabulaire de types ou des checklists de revue sans casser les bases OKF. Par exemple, une startup de santé réglementée pourrait ajouter des champs de preuves de conformité ; un venture studio pourrait ajouter un statut de comité d’investissement ; une équipe SaaS pourrait relier les PRD aux fichiers de roadmap et d’architecture. Gardez ces extensions explicites afin que les futurs agents puissent comprendre le bundle sans conventions cachées.