arquiteto-de-empresa

arquiteto-de-empresa skill の概要

arquiteto-de-empresa は何に使うものか

arquiteto-de-empresa は、創業者のまだ粗い事業アイデアを OKF bundle に落とし込むための Company Architect skill です。OKF bundle とは、YAML frontmatter、型付けされた概念、相互リンク、index.md ダッシュボード、追記専用の log.md を備えた、バージョン管理しやすい Markdown ファイル群のことです。人間にも AI エージェントにも「翻訳」なしで読める会社ナレッジベースを作りたい創業者、事業責任者、コンサルタント、戦略 planning チームに向いています。

特に相性のよい用途と利用者

会社を “as code” として構築・再編したいときに、arquiteto-de-empresa skill が役立ちます。対象は、戦略、市場、財務、営業、マーケティング、プロダクト、オペレーション、テクノロジー、人材、法務、ガバナンスまでを、ひとつのリンクされた構造にまとめるケースです。初期スタートアップの設計、ビジネスモデルの文書化、社内 company wiki、AI が読める operating system、そして意思決定の経緯を時間軸で追跡する必要がある Strategic Planning 向けの arquiteto-de-empresa として適しています。

通常のプロンプトとの違い

一般的なプロンプトでは、長い事業計画書が出力されることがあります。一方、この skill は段階的なインタビューを進め、その回答をファイルとして具体化します。1 つの概念につき 1 つの .md、管理された type 値、相対リンク、予約済みの index.md と log.md、そして再現性のある補助スクリプトを使います。主な差別化ポイントは、単なるビジネス助言ではありません。lint、index 化、Git への commit、他のエージェントによる拡張が可能な、反復利用できるドキュメント形式であることです。

導入前に確認したいこと

この skill は、フェーズごとに質問へ答える意思がある場合に最も力を発揮します。1 ページの pitch deck、法的助言、財務上の保証、あるいは創業者の入力なしで完成した会社戦略が欲しい場合には向きません。フォルダ名やファイル名の一部はポルトガル語風で、skill の言語は英語です。そのため、チームは早い段階で、元の構造をそのまま維持するのか、命名規則をローカライズするのかを決めておくべきです。

arquiteto-de-empresa skill の使い方

arquiteto-de-empresa のインストールとリポジトリ確認

インストールは次のコマンドで行います。

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

続いて、ソースのパスを確認します。

c-level-advisor/skills/arquiteto-de-empresa

まず SKILL.md を読み、ペルソナ、起動条件、運用ルール、12 フェーズの流れを把握します。次に references/phase_playbook.md、references/okf_conformance.md、references/type_vocabulary.md を確認してください。これらのファイルには、エージェントが何を質問すべきか、Markdown bundle をどのような形に整えるべきか、frontmatter の type 値として何が有効かが定義されています。実際の会社ファイルを生成する前に、assets/frontmatter_template.md、assets/index_template.md、assets/log_template.md も確認しておくと安全です。

よい出力につながる入力

arquiteto-de-empresa の利用パターンは、最初の依頼に Phase 0 を開始できるだけの事業コンテキストが含まれていると、よりうまく機能します。ステージ、ビジネスモデル、業界、管轄地域、顧客、現時点の資産、希望する出力先を含めてください。

弱いプロンプト:

“Help me structure my startup.”

より強いプロンプト:

“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.”

このように入力すると、skill が適切なフェーズを選びやすくなり、早すぎる詳細化を避けられます。また、OKF ルールに合ったファイルを作成しやすくなります。

完成度の高い OKF bundle を作る推奨ワークフロー

Phase 0 の discovery から始め、その後 12 フェーズの playbook を順番に進めます。各フェーズでは、3〜5 個の質問を行い、創業者の回答を確認し、概念ファイルを生成し、フォルダの index.md を更新し、log.md に意思決定エントリを追加します。粗いプロトタイプだけが必要な場合を除き、全フェーズを一度に出力するようエージェントへ依頼しないでください。この skill は、書き始める前にインタビューを行うことで、戦略上の幻覚を減らすよう設計されています。

戦略 planning では、意思決定の順序に沿ってフェーズを実行します。foundation、strategy、market、financial model、sales、marketing、product、operations、tech、people、legal、governance の順です。未解決の主張は [ASSUMPTION] として見える状態に保ちます。そうすることで、bundle は偽の確実性を生み出すものではなく、planning system として機能します。

補助スクリプトの使い方

このリポジトリには、出力の信頼性を高める Python ツールが含まれています。スケルトン作成には scripts/scaffold_bundle.py、準拠チェックには scripts/okf_linter.py、index.md 内の概念テーブル再生成には scripts/index_generator.py を使います。これらのスクリプトは標準ライブラリ中心で、Git ワークフローにも合います。生成し、diff を確認し、lint を実行し、commit する流れです。エージェントが手動でファイルを作成した場合でも、その bundle を正と見なす前に必ず linter を実行してください。

arquiteto-de-empresa skill FAQ

arquiteto-de-empresa は新会社専用ですか？

いいえ。ゼロから会社を作る前提で構成されていますが、docs、spreadsheets、chats、創業者の記憶に散らばった既存企業のナレッジを文書化する用途にも使えます。稼働中の事業に使う場合は、すでに存在する情報をエージェントに伝え、過去からの事実、仮説、不足している証拠を分けて扱うよう依頼してください。

ビジネスプラン生成ツールと何が違いますか？

ビジネスプラン生成ツールは、通常 1 つの物語形式の文書を作ります。arquiteto-de-empresa skill は OKF knowledge graph を生成します。つまり、一貫したメタデータとリンクを持つ、小さな Markdown 概念ファイルの集合です。そのため、長期的な保守、AI retrieval、Git diff、部門横断の planning に向いています。一方で、投資家向けに整った PDF だけが必要な場合には、やや手間がかかります。

初心者は先に OKF を理解する必要がありますか？

いいえ。ただし、運用上の考え方は理解しておくべきです。1 つの概念につき 1 ファイル、型付けされた frontmatter、関連ファイル間のリンク、意思決定ログという考え方です。本格的に使う前に references/okf_conformance.md を読んでおくと、複数の概念を 1 ファイルにまとめてしまう、type ラベルが不統一になる、といったよくあるミスを防げます。

この skill を使わないほうがよい場面は？

法務、税務、会計、規制業界における専門家レビューの代替としては使わないでください。チームが基本的な discovery 質問に答えられない場合、目的がブランディングコピーだけの場合、安全な実行環境なしに機密性の高い財務モデリングが必要な場合にも避けるべきです。この skill は意思決定を構造化するものであり、市場の真実をそれ自体で検証するものではありません。

arquiteto-de-empresa skill を改善する方法

より強いコンテキストで arquiteto-de-empresa の結果を改善する

最も効果が大きい改善は、入力品質を上げることです。予算、ランウェイ、地域、ターゲット顧客、営業 motion、価格仮説、チームの稼働能力、技術スタック、規制上の exposure、既存ドキュメントといった実際の制約を提供してください。各概念ファイルの中で “known”、 “assumed”、 “to validate” を分けるようエージェントに依頼します。これにより OKF bundle は、単なる説明文書ではなく、戦略 planning に使えるものになります。

注意すべきよくある失敗パターン

ファイルが圧縮されすぎている、frontmatter が欠けている、無効な type 値が使われている、相対リンクが弱い、index.md ページが実際のフォルダ内容を反映していない、といった点に注意してください。もう 1 つよくある問題は、創業者が根拠を示していないのに、過度に断定的なビジネス表現になることです。[ASSUMPTION] マーカーを必須にし、重要な意思決定が変わるたびに log.md を更新してください。

最初の bundle 生成後に反復する

最初の生成が終わったら、bundle を product backlog のようにレビューします。どの概念が大きすぎるか。どの主張に根拠が足りないか。どの意思決定に代替案と理由づけが必要か。将来のエージェントが strategy から finance、product、operations へたどるために、どんなリンクがあると役立つか。こうした観点で確認したうえで、肥大化したファイルの分割、不足している概念リンクの追加、index の再生成、意思決定ログへの変更記録を skill に依頼してください。

自組織向けに skill を拡張する

チームは、会社固有のテンプレート、管轄地域別チェックリスト、業界用語、検証ゲートを追加することで arquiteto-de-empresa を改善できます。ただし、OKF の中核ルールは安定させてください。1 概念 1 ファイル、必須の type、相対リンク、予約済みの index.md と log.md、スクリプトによるチェックです。フォルダ名をローカライズしたり新しい概念タイプを追加したりする場合は、将来のエージェントが一貫して扱えるよう references/type_vocabulary.md を更新してください。