arquiteto-de-empresa
von alirezarezvaniarquiteto-de-empresa ist ein Company Architect Skill, der Eingaben von Gründern in eine OKF-Unternehmenswissensbasis überführt: verknüpfte Markdown-Dateien mit YAML-Frontmatter, Indizes, Logs und kontrollierten Typen. Geeignet für Strategic Planning, Company-as-Code-Workflows und phasenweise Interviews zu Strategie, Markt, Finanzen, Produkt, Operations, People, Legal und Governance.
Dieser Skill erreicht 82/100 Punkte und ist damit ein solider Kandidat für Verzeichnisnutzer, die einen Agenten suchen, der Unternehmensgründung und -dokumentation als strukturiertes Markdown-Wissenspaket begleitet. Das Repository bietet ausreichend Trigger-Hinweise, einen phasenweisen Workflow, Vorlagen, Konformitätsregeln und Hilfsskripte, sodass weniger geraten werden muss als bei einem generischen Business-Planning-Prompt. Die Nutzung wäre jedoch einfacher mit klarerer Installations- und Quick-Start-Dokumentation.
- Sehr gute Auslösbarkeit: Das Frontmatter nennt ausdrücklich Anwendungsfälle zum Aufbau, Strukturieren oder Dokumentieren eines gesamten Unternehmens, einschließlich Formulierungen wie „company as code“, „company knowledge base for AI“, „OKF“ und „knowledge bundle“.
- Operativ klarer Ablauf: Der Skill definiert ein sequenzielles Interview in 12 Phasen; das Phase Playbook beschreibt Ziele, Fragenblöcke, erzeugte Dateien sowie Aktualisierungsschritte für index.md und log.md.
- Guter Agenten-Nutzen über reines Prompting hinaus: Referenzen definieren OKF-Konformität und ein kontrolliertes Typvokabular, während Skripte Scaffolding, Linting und Indexgenerierung für ein versionskontrollierbares Markdown-Bundle unterstützen.
- Im Skill-Pfad gibt es keinen Installationsbefehl und kein README; Nutzer müssen die Installation daher aus dem übergeordneten Repository oder den Konventionen für Agent Skills ableiten.
- Der Workflow ist ambitioniert und deckt das ganze Unternehmen ab. Wer nur punktuelle Beratung zu Finance, Legal oder GTM sucht, könnte den 12-phasigen OKF-Bundle-Ansatz als umfangreicher empfinden als nötig.
Überblick über den arquiteto-de-empresa skill
Wofür arquiteto-de-empresa gedacht ist
arquiteto-de-empresa ist ein Company Architect skill, der aus einer groben Geschäftsidee eines Gründers ein OKF-Bundle macht: eine versionierbare Baumstruktur aus Markdown-Dateien mit YAML frontmatter, typisierten Konzepten, Querverweisen, index.md-Dashboards und einem nur ergänzbaren log.md. Der arquiteto-de-empresa skill eignet sich besonders für Gründer, Operator, Berater und Strategie-Teams, die eine Unternehmenswissensbasis aufbauen möchten, die sowohl Menschen als auch AI agents ohne Übersetzung lesen können.
Ideale Anwendungsfälle und Nutzer
Nutze den arquiteto-de-empresa skill, wenn du ein Unternehmen „as code“ aufbauen oder neu ordnen willst: Strategie, Markt, Finanzen, Vertrieb, Marketing, Produkt, Operations, Technologie, People, Recht und Governance in einer verlinkten Struktur. Er passt zu Early-Stage-Venture-Design, Business-Model-Dokumentation, internen Company Wikis, AI-lesbaren Betriebssystemen und arquiteto-de-empresa for Strategic Planning, wenn Entscheidungen über längere Zeit nachvollziehbar bleiben müssen.
Was ihn von einem normalen Prompt unterscheidet
Ein generischer Prompt kann einen langen Businessplan erzeugen. Dieser Skill führt stattdessen durch ein phasenweises Interview und materialisiert die Antworten als Dateien: ein Konzept pro .md, kontrollierte type-Werte, relative Links, reservierte index.md und log.md sowie deterministische Helper-Skripte. Der zentrale Unterschied liegt nicht nur in der Business-Beratung, sondern in einem wiederholbaren Dokumentationsformat, das gelintet, indexiert, in Git committed und von anderen Agents erweitert werden kann.
Was du vor der Einführung beachten solltest
Der Skill ist am stärksten, wenn du bereit bist, Fragen Phase für Phase zu beantworten. Er ist weniger geeignet, wenn du ein einseitiges Pitch Deck, Rechtsberatung, finanzielle Garantien oder eine fertige Unternehmensstrategie ohne Input der Gründer erwartest. Einige Ordner- und Dateinamen folgen einem portugiesisch geprägten Stil, während die Skill-Sprache Englisch ist. Teams sollten daher früh entscheiden, ob sie die ursprüngliche Struktur beibehalten oder Namenskonventionen lokalisieren.
So nutzt du den arquiteto-de-empresa skill
arquiteto-de-empresa installieren und Repository prüfen
Installiere mit:
npx skills add alirezarezvani/claude-skills --skill arquiteto-de-empresa
Prüfe anschließend den Quellpfad:
c-level-advisor/skills/arquiteto-de-empresa
Lies zuerst SKILL.md, um Persona, Trigger-Bedingungen, Arbeitsregeln und den 12-Phasen-Ablauf zu verstehen. Sieh dir danach references/phase_playbook.md, references/okf_conformance.md und references/type_vocabulary.md an; diese Dateien definieren, was der Agent fragen soll, wie das Markdown-Bundle aufgebaut sein muss und welche frontmatter-type-Werte gültig sind. Prüfe assets/frontmatter_template.md, assets/index_template.md und assets/log_template.md, bevor du echte Unternehmensdateien generierst.
Eingaben, die bessere Ergebnisse liefern
Das Nutzungsmuster von arquiteto-de-empresa funktioniert am besten, wenn die erste Anfrage genug Geschäftskontext liefert, um mit Phase 0 zu starten. Nenne Stage, Geschäftsmodell, Branche, Jurisdiktion, Kunden, vorhandene Assets und den gewünschten Ausgabeort.
Schwacher Prompt:
„Hilf mir, mein Startup zu strukturieren.“
Stärkerer Prompt:
„Use arquiteto-de-empresa to create an OKF bundle for a B2B SaaS in Brazil that helps small clinics reduce missed appointments. Stage: MVP with 5 pilot customers. Model: monthly subscription. Need the first phases only: discovery, foundation, strategy, and market. Ask me questions in small blocks, mark unknowns as [ASSUMPTION], and generate conformant Markdown files with relative links.“
Das verbessert die Ergebnisse, weil der Skill die passende Phase wählen, verfrühte Detailarbeit vermeiden und Dateien erzeugen kann, die den OKF-Regeln entsprechen.
Empfohlener Workflow für ein vollständiges OKF-Bundle
Beginne mit Phase 0 discovery und arbeite dich dann der Reihe nach durch das 12-Phasen-Playbook. Stelle in jeder Phase 3–5 Fragen, bestätige die Antworten des Gründers, generiere die Konzeptdateien, aktualisiere das index.md des jeweiligen Ordners und ergänze einen Entscheidungseintrag in log.md. Bitte den Agent nicht darum, alle Phasen auf einmal auszugeben, außer du brauchst nur einen groben Prototyp; der Skill ist darauf ausgelegt, halluzinierte Strategie zu reduzieren, indem er vor dem Schreiben interviewt.
Für Strategic Planning solltest du die Phasen in Entscheidungsreihenfolge durchlaufen: foundation, strategy, market, financial model, sales, marketing, product, operations, tech, people, legal und governance. Halte ungeklärte Aussagen mit [ASSUMPTION] sichtbar, damit das Bundle zu einem Planungssystem wird und nicht zu einem Generator falscher Gewissheit.
Helper-Skripte verwenden
Das Repository enthält Python-Tools, die die Ausgabe verlässlicher machen. Nutze scripts/scaffold_bundle.py, um ein Grundgerüst zu erstellen, scripts/okf_linter.py, um die Konformität zu prüfen, und scripts/index_generator.py, um Konzepttabellen in index.md neu zu generieren. Die Skripte orientieren sich an der Standardbibliothek und unterstützen einen Git-Workflow: generieren, Diffs prüfen, linten, dann committen. Wenn dein Agent Dateien manuell erstellt, solltest du trotzdem den Linter ausführen, bevor du das Bundle als kanonisch behandelst.
FAQ zum arquiteto-de-empresa skill
Ist arquiteto-de-empresa nur für neue Unternehmen gedacht?
Nein. Der Skill ist darauf ausgerichtet, ein Unternehmen von Grund auf aufzubauen, kann aber auch ein bestehendes Unternehmen dokumentieren, dessen Wissen über Dokumente, Tabellen, Chats und Gründerwissen verteilt ist. Bei einem laufenden Geschäft solltest du dem Agent zuerst mitteilen, was bereits existiert, und ihn bitten, Legacy-Fakten, Annahmen und fehlende Belege getrennt zu markieren.
Wie unterscheidet sich das von einem Businessplan-Generator?
Ein Businessplan-Generator erstellt in der Regel ein einzelnes narratives Dokument. Der arquiteto-de-empresa skill erzeugt einen OKF-Wissensgraphen: viele kleine Markdown-Konzeptdateien mit konsistenten Metadaten und Links. Das ist besser für langfristige Pflege, AI Retrieval, Git-Diffs und funktionsübergreifende Planung. Weniger praktisch ist es, wenn du lediglich ein poliertes, investorenorientiertes PDF brauchst.
Müssen Einsteiger OKF vorher verstehen?
Nein, aber sie sollten die Grundidee verstehen: eine Datei pro Konzept, typisiertes frontmatter, Links zwischen verwandten Dateien und ein Entscheidungslog. Wer references/okf_conformance.md vor intensiver Nutzung liest, vermeidet typische Fehler wie das Zusammenführen mehrerer Konzepte in eine Datei oder inkonsistente type-Labels.
Wann sollte ich diesen Skill nicht verwenden?
Nutze ihn nicht als Ersatz für professionelle Prüfung in den Bereichen Recht, Steuern, Buchhaltung oder regulierte Branchen. Vermeide ihn, wenn das Team grundlegende Discovery-Fragen nicht beantworten kann, wenn es nur um Branding-Texte geht oder wenn du vertrauliche Finanzmodellierung ohne sichere Ausführungsumgebung brauchst. Der Skill strukturiert Entscheidungen; er validiert Marktannahmen nicht aus eigener Kraft.
So verbesserst du den arquiteto-de-empresa skill
arquiteto-de-empresa mit stärkerem Kontext verbessern
Der größte Hebel ist eine bessere Eingabequalität. Liefere echte Rahmenbedingungen: Budget, Runway, Geografie, Zielkunden, Sales Motion, Pricing-Hypothesen, Teamkapazität, Technologie-Stack, regulatorische Exponierung und vorhandene Dokumente. Bitte den Agent, in jeder Konzeptdatei Abschnitte für „known“, „assumed“ und „to validate“ zu trennen. So wird das OKF-Bundle für Strategic Planning nützlich und bleibt nicht nur beschreibende Dokumentation.
Typische Fehlermuster, auf die du achten solltest
Achte auf überkomprimierte Dateien, fehlendes frontmatter, ungültige type-Werte, schwache relative Links und index.md-Seiten, die die tatsächlichen Ordnerinhalte nicht widerspiegeln. Ein weiteres häufiges Problem ist übertrieben selbstsichere Business-Sprache, obwohl der Gründer keine Belege geliefert hat. Verlange [ASSUMPTION]-Markierungen und aktualisiere log.md, sobald sich eine wichtige Entscheidung ändert.
Nach dem ersten generierten Bundle iterieren
Prüfe das Bundle nach dem ersten Durchlauf wie ein Product Backlog. Frage: Welche Konzepte sind zu groß? Für welche Aussagen fehlen Belege? Welche Entscheidungen brauchen Alternativen und Begründungen? Welche Links würden einem zukünftigen Agent helfen, von Strategie zu Finanzen, Produkt oder Operations zu navigieren? Bitte den Skill anschließend, zu große Dateien aufzuteilen, fehlende Konzeptlinks zu ergänzen, Indizes neu zu generieren und die Änderungen im Entscheidungslog festzuhalten.
Den Skill für deine Organisation erweitern
Teams können arquiteto-de-empresa verbessern, indem sie unternehmensspezifische Templates, Jurisdiktions-Checklisten, Branchenvokabular und Validierungs-Gates ergänzen. Halte die zentralen OKF-Regeln stabil: ein Konzept pro Datei, verpflichtender type, relative Links, reservierte index.md und log.md sowie skriptbasierte Prüfungen. Wenn du Ordnernamen lokalisierst oder neue Konzepttypen hinzufügst, aktualisiere references/type_vocabulary.md, damit zukünftige Agents konsistent bleiben.