arquiteto-de-empresa
von alirezarezvaniarquiteto-de-empresa verwandelt die Geschäftsidee eines Gründers in ein versionskontrolliertes OKF Markdown-Bundle mit Frontmatter, Querverweisen, index.md, log.md und einem 12-Phasen-Interview zu Strategie, Markt, Finanzen, Produkt, Betrieb, Recht und Governance. Enthalten sind Templates sowie Python-Skripte für Scaffolding, Linting und Indexerstellung.
Dieser Skill erreicht 84/100 Punkte und ist damit ein solider Kandidat für Verzeichnisnutzer, die einen agentengestützten Workflow suchen, um ein Gründerinterview in eine versionskontrollierbare Unternehmens-Wissensbasis zu überführen. Er bietet genügend Trigger-Hinweise, Phasenstruktur, Templates, Referenzen und Skripte, um deutlich mehr Hebelwirkung zu liefern als ein generischer Business-Planning-Prompt. Installation sowie Erwartungen an Sprache und Benennung sollten jedoch klarer paketiert werden.
- Sehr gut auslösbar: Das Frontmatter nennt konkrete Anwendungsfälle wie den Aufbau eines Unternehmens von Grund auf, company-as-code, OKF-Bundles und KI-lesbare Unternehmens-Wikis.
- Operativ gehaltvoll: Das referenzierte 12-Phasen-Playbook definiert Ziele, Fragen, erzeugte Artefakte und Aktualisierungsschritte für jede Phase, statt sich auf einen vagen Business-Advisor-Prompt zu stützen.
- Hoher Nutzen für Agenten: OKF-Konformitätsregeln, ein kontrolliertes Typvokabular, Templates, ein Beispiel-Bundle und Python-Tools für Scaffolding, Linting und Indexerzeugung sorgen für strukturiertere und besser wiederverwendbare Ergebnisse.
- Im Skill-Verzeichnis gibt es keine README und keinen Installationsbefehl. Nutzer müssen die Installation daher aus dem übergeordneten Repository bzw. den zugehörigen Tools ableiten.
- Die Bundle-Struktur verwendet portugiesische Ordner- und Dateinamen, während die Skill-Beschreibung angibt, dass der Skill auf Englisch arbeitet. Diese Erwartungen an Sprache und Benennung sollten vor der Nutzung geklärt werden.
Überblick über arquiteto-de-empresa skill
Wofür arquiteto-de-empresa gedacht ist
arquiteto-de-empresa ist ein Company Architect skill, der aus einer noch groben Geschäftsidee eines Gründers ein OKF-Bundle macht: eine versionierbare Baumstruktur aus Markdown-Dateien mit YAML frontmatter, typisierten Konzepten, Querverlinkungen, index.md-Dashboards und einem append-only log.md. Statt einen einmaligen Businessplan zu erzeugen, führt der Skill ein phasenweises Interview durch und bildet das Unternehmen als strukturiertes Wissen ab, das Menschen und AI agents lesen und weiterverwenden können.
Für wen der Skill passt und welche Entscheidungen er unterstützt
Dieser Skill eignet sich besonders für Gründer, chief-of-staff operators, venture studios, Berater und strategische Planungsteams, die eine lebendige Wissensbasis für ihr Unternehmen brauchen — nicht nur eine Pitch-Erzählung. Er passt zu frühen Phasen des Unternehmensdesigns, zur Dokumentation von Geschäftsmodellen, zum Aufbau eines Operating Systems und zu „company as code“-Workflows. arquiteto-de-empresa for Strategic Planning ist besonders hilfreich, wenn Strategie-, Markt-, Finanz-, Sales-, Marketing-, Produkt-, Operations-, Tech-, People-, Legal- und Governance-Entscheidungen in einem Repository miteinander verbunden werden sollen.
Was den Skill unterscheidet
Der wichtigste Unterschied liegt in der Struktur. Der Skill folgt einem Playbook mit 12 Phasen, stellt jeweils nur wenige Fragen auf einmal und schreibt ein Konzept pro .md-Datei mit einem kontrollierten type-Vokabular. Dadurch lassen sich die Ergebnisse leichter in Git vergleichen, validieren, indexieren und von anderen agents wiederverwenden. Die enthaltenen Referenzen und Python-Skripte unterstützen das Scaffolding, das Linting der OKF-Konformität und das erneute Generieren von Index-Tabellen.
Wann der Skill zu aufwendig sein kann
Installieren Sie arquiteto-de-empresa skill nicht, wenn Sie nur eine schnelle SWOT, ein Landing-Page-Briefing oder ein kurzes Investorenmemo benötigen. Die Methode ist bewusst systematisch. Sie funktioniert am besten, wenn Sie bereit sind, gestaffelte Fragen zu beantworten, Dateien zu pflegen und Annahmen als vorläufiges Wissen zu behandeln — nicht als endgültige Wahrheit.
So verwenden Sie arquiteto-de-empresa skill
Repository zuerst installieren und prüfen
Für einen Claude skills Workflow installieren Sie den Skill aus dem Repository mit:
npx skills add alirezarezvani/claude-skills --skill arquiteto-de-empresa
Wenn Ihr Tool diesen Befehl nicht unterstützt, kopieren oder referenzieren Sie den Skill-Ordner aus c-level-advisor/arquiteto-de-empresa/skills/arquiteto-de-empresa. Bevor Sie den Skill ernsthaft einsetzen, lesen Sie SKILL.md, danach references/phase_playbook.md, references/okf_conformance.md und references/type_vocabulary.md. Sehen Sie sich außerdem assets/frontmatter_template.md, assets/index_template.md und assets/log_template.md an, damit klar ist, welchen Datei-Contract der agent erfüllen soll.
Mit einem vollständigen Discovery-Prompt starten
Gute arquiteto-de-empresa usage beginnt mit Kontext, nicht mit einer vagen Anfrage. Statt „build my company“ zu schreiben, liefern Sie die Ausgangsinformationen, die Phase 0 Discovery benötigt:
- Geschäftsidee und Kundenproblem
- Phase: idea, MVP, operating oder scaling
- Geschäftsmodell: service, SaaS, marketplace, product, hybrid
- Branche, Land und rechtliche Jurisdiktion
- vorhandener Name, Assets, Einschränkungen und bekannte Annahmen
- gewünschter Ausgabeort, zum Beispiel
./my-company-okf
Ein stärkerer Prompt wäre: “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.”
Dem 12-Phasen-Workflow folgen, statt alles auf einmal auszugeben
Der Skill ist darauf ausgelegt, der Reihe nach zu interviewen: Discovery, Foundation, Strategy, Market, Finance, Sales, Marketing, Product, Operations, Tech, People, Legal und Governance. Bitten Sie den agent, eine Phase abzuschließen, die erzeugten Konzepte bestätigen zu lassen, das Root-index.md zu aktualisieren und log.md zu ergänzen, bevor es weitergeht. So vermeiden Sie oberflächliche, widersprüchliche Ergebnisse und halten strategische Entscheidungen nachvollziehbar.
Hilfsskripte für die Qualitätskontrolle nutzen
Das Repository enthält scripts/scaffold_bundle.py, scripts/okf_linter.py und scripts/index_generator.py. Verwenden Sie diese Skripte als Umsetzungshilfen, nachdem der agent Inhalte entworfen hat. Der Linter ist wichtig, weil OKF-Qualität von Details abhängt: Jedes Konzept sollte eine eigene Markdown-Datei sein, frontmatter sollte einen gültigen type enthalten, und Links sollten einen nutzbaren Graphen bilden statt isolierte Dokumente.
FAQ zu arquiteto-de-empresa skill
Ist arquiteto-de-empresa nur für neue Unternehmen gedacht?
Nein. Am stärksten ist der Skill beim Aufbau eines Unternehmens von Grund auf, er kann aber auch ein bestehendes Unternehmen dokumentieren, wenn Sie aktuelle Strategie, Prozesse, Tools, Finanzen und Organisationsdetails bereitstellen. Bei einem laufenden Unternehmen sollten Sie den Skill anweisen, zwischen „current state“, „target state“ und [ASSUMPTION]-Einträgen zu unterscheiden, damit das Bundle die Realität nicht als Wunschbild umschreibt.
Worin ist der Skill besser als ein gewöhnlicher Businessplan-Prompt?
Ein normaler Prompt liefert oft ein gut formuliertes, aber flaches Dokument. arquiteto-de-empresa erzeugt ein navigierbares Wissenssystem: typisierte Markdown-Konzepte, reservierte Indexe, Entscheidungslogs und Querverlinkungen. Das ist wichtig, wenn zukünftige agents Unternehmenswissen abrufen, ein einzelnes Konzept aktualisieren können sollen, ohne alles neu zu schreiben, oder wenn Sie nachvollziehen möchten, wie sich Entscheidungen im Zeitverlauf verändert haben.
Muss ich OKF kennen, bevor ich den Skill nutze?
Nein, aber Sie sollten die OKF-Konformitätsreferenz lesen, bevor Sie dem Ergebnis vertrauen. Die wichtigsten Regeln sind einfach: ein Konzept pro Datei, YAML frontmatter mit gültigem type, reservierte index.md und log.md, relative Links zwischen Konzepten und klar markierte Annahmen. Auch Einsteiger können den Skill gut nutzen, wenn sie dem phasenweisen Interview folgen, statt alle Dateien auf einmal anzufordern.
Wann sollte ich diesen Skill nicht verwenden?
Verzichten Sie auf diesen Skill, wenn Geschwindigkeit wichtiger ist als Struktur, wenn das Geschäft zu vertraulich ist, um es in einer AI-Umgebung zu teilen, oder wenn Sie rechtlich verbindliche Beratung benötigen. Der Skill kann Legal- und Governance-Konzepte strukturieren, ersetzt aber keine Anwälte, Steuerberater oder eine compliance-Prüfung für eine bestimmte Jurisdiktion.
So verbessern Sie arquiteto-de-empresa skill
Eingaben für arquiteto-de-empresa verbessern, bevor Dateien erzeugt werden
Der größte Hebel für Qualität ist die Genauigkeit der Eingaben. Nennen Sie echte Einschränkungen: Budgetrahmen, Zielkunden, Geografie, Gründerkompetenzen, aktuelle Traction, Preishypothesen, Sales Motion, regulatorische Risiken und Technologiepräferenzen. Wenn etwas unbekannt ist, sagen Sie das ausdrücklich. Die [ASSUMPTION]-Konvention des Skills ist nur dann nützlich, wenn der agent weiß, welche Fakten fehlen.
Typische OKF-Fehler vermeiden
Achten Sie auf Dateien, die mehrere Konzepte vermischen, fehlende type-Werte, generische Beschreibungen, defekte relative Links und strategische Aussagen, die nicht mit Markt- oder Finanzannahmen verbunden sind. Bitten Sie den agent nach jeder Phase um einen Konformitätscheck: “Check every generated concept against references/okf_conformance.md and references/type_vocabulary.md; list fixes before rewriting.”
Phasenergebnisse anhand von Entscheidungskriterien iterieren
Prüfen Sie nach jeder Phase, ob die Ergebnisse für Entscheidungen wirklich brauchbar sind. Eine gute Foundation-Phase sollte Zweck, Problem, Werte und Annahmen klären. Eine gute Finance-Phase sollte Umsatzmodell, Kostenstruktur, Unit Economics, Pricing und Projektionen sichtbar machen. Eine gute Operations-Phase sollte Prozesse und Runbooks liefern, die jemand tatsächlich ausführen kann. Wenn das Ergebnis wie Marketingtext klingt, verlangen Sie klarere Trade-offs, Abhängigkeiten und verworfene Alternativen.
Den Skill an Ihr Operating Model anpassen
Um arquiteto-de-empresa für Ihre Organisation zu verbessern, ergänzen Sie unternehmensspezifische Templates, Erweiterungen des type vocabulary oder Review-Checklisten, ohne die OKF-Grundlagen zu beschädigen. Ein reguliertes Healthcare-Startup könnte zum Beispiel Felder für Compliance-Nachweise ergänzen; ein venture studio könnte den Status im Investment Committee hinzufügen; ein SaaS-Team könnte PRDs mit Roadmap- und Architekturdateien verlinken. Halten Sie Erweiterungen explizit, damit zukünftige agents das Bundle ohne versteckte Konventionen verstehen können.