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 エージェントの両方が読める構造化ナレッジとして具体化します。

向いているユーザーと意思決定

この skill は、単なるピッチ用ストーリーではなく、継続的に更新される会社のナレッジベースを必要とする創業者、chief-of-staff 型のオペレーター、venture studio、コンサルタント、戦略企画チームに向いています。初期段階の会社設計、ビジネスモデルの文書化、経営オペレーティングシステムの構築、“company as code” のワークフローに適しています。arquiteto-de-empresa for Strategic Planning は、戦略、市場、財務、営業、マーケティング、プロダクト、オペレーション、技術、人材、法務、ガバナンスに関する意思決定を 1 つのリポジトリ内でつなげたい場合に特に有用です。

この skill の違い

最大の差別化要素は構造です。この skill は 12 フェーズのプレイブックに沿って進み、一度に少数の質問を行い、制御された type 語彙を使って 1 つの概念を 1 つの .md ファイルに書き出します。そのため、Git での差分確認、検証、インデックス化、他のエージェントによる再利用がしやすくなります。付属のリファレンスと Python スクリプトは、スキャフォールド作成、OKF 準拠の lint、インデックステーブルの再生成を支援します。

使いこなすには重すぎる場合

簡単な SWOT、ランディングページ用のブリーフ、短い投資家向けメモだけが必要なら、arquiteto-de-empresa skill をインストールする必要はありません。この手法は意図的に体系立てられています。段階的な質問に答え、ファイルをメンテナンスし、仮説を最終的な真実ではなくドラフトのナレッジとして扱える場合に最も効果を発揮します。

arquiteto-de-empresa skill の使い方

まずインストールしてリポジトリを確認する

Claude skills のワークフローでは、次のコマンドでリポジトリからインストールします。

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

利用しているツールがこのコマンドに対応していない場合は、c-level-advisor/arquiteto-de-empresa/skills/arquiteto-de-empresa から skill フォルダをコピーするか参照してください。本格的に使う前に、まず SKILL.md を読み、その後で references/phase_playbook.md、references/okf_conformance.md、references/type_vocabulary.md を確認します。さらに assets/frontmatter_template.md、assets/index_template.md、assets/log_template.md を事前に見ておくと、エージェントが満たすべきファイル契約を理解できます。

最初の発見プロンプトを具体的に書く

良い arquiteto-de-empresa usage は、曖昧な依頼ではなく文脈から始まります。「会社を作って」ではなく、Phase 0 の発見に必要な初期情報を渡してください。

• 会社アイデアと顧客課題
• ステージ: idea、MVP、operating、scaling
• ビジネスモデル: service、SaaS、marketplace、product、hybrid
• 業界、国、法的管轄
• 既存の名称、アセット、制約、既知の仮説
• 希望する出力先。例: ./my-company-okf

より良いプロンプト例は次のようになります。「arquiteto-de-empresa を使って、ブラジルのクリニック向けに no-show を減らす B2B SaaS の OKF bundle を作成してください。現在は MVP 段階で、まだ法人はありません。Git で扱いやすいファイルにしたいです。まず Phase 0 を実行し、必要な質問だけを行い、不明点は [ASSUMPTION] としてマークしてから、bundle を scaffold してください。」

12 フェーズの流れに沿い、一括生成にしない

この skill は、discovery、foundation、strategy、market、finance、sales、marketing、product、operations、tech、people、legal、governance の順にインタビューするよう設計されています。エージェントには 1 フェーズずつ完了させ、生成された概念を確認し、ルートの index.md を更新し、log.md に追記してから次へ進むよう依頼してください。これにより、浅く一貫性のない出力を防ぎ、戦略上の意思決定を追跡可能な状態に保てます。

品質管理にヘルパースクリプトを使う

リポジトリには scripts/scaffold_bundle.py、scripts/okf_linter.py、scripts/index_generator.py が含まれています。エージェントがコンテンツをドラフトした後の実装支援として使います。特に linter は重要です。OKF の品質は細部に左右されます。すべての概念が個別の Markdown ファイルになっていること、frontmatter に有効な type が含まれていること、リンクが孤立した文書ではなく使えるグラフを形成していることを確認する必要があります。

arquiteto-de-empresa skill FAQ

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

いいえ。ゼロから事業を作る用途に最も強みがありますが、現在の戦略、プロセス、ツール、財務、組織情報を提供すれば、既存企業の文書化にも使えます。すでに事業運営中の会社で使う場合は、bundle が現実を願望に書き換えてしまわないように、「current state」「target state」「[ASSUMPTION]」を区別するよう skill に指示してください。

通常の事業計画プロンプトより何が優れていますか？

通常のプロンプトは、見栄えはよいものの平面的な文書を返しがちです。arquiteto-de-empresa は、型付けされた Markdown の概念、予約済みインデックス、意思決定ログ、相互リンクを備えた、移動可能なナレッジシステムを生成します。将来のエージェントに会社ナレッジを検索させたい場合、全体を書き直さずに 1 つの概念だけを更新したい場合、あるいは意思決定が時間とともにどう変わったかを追跡したい場合に、この違いが重要になります。

使う前に OKF を理解しておく必要がありますか？

いいえ。ただし、出力を信頼する前に OKF conformance のリファレンスは読むべきです。重要なルールはシンプルです。1 ファイルにつき 1 概念、有効な type を含む YAML frontmatter、予約済みの index.md と log.md、概念間の相対リンク、そして仮説の明確なマーキングです。初心者でも、すべてのファイルを一度に求めるのではなく、フェーズごとのインタビューに従えば十分に活用できます。

この skill を使わないほうがよいのはどんな時ですか？

構造よりスピードを優先したい場合、AI 環境に共有するには事業情報の機密性が高すぎる場合、または法的拘束力のある助言が必要な場合は、この skill は避けてください。法務やガバナンスの概念を整理することはできますが、弁護士、会計士、管轄地域ごとのコンプライアンスレビューの代替にはなりません。

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

ファイル生成前に arquiteto-de-empresa への入力を改善する

品質を最も大きく左右するのは、入力の具体性です。予算レンジ、ターゲット顧客、地域、創業者のスキル、現在の traction、価格仮説、営業モーション、規制リスク、技術上の好みなど、実際の制約を渡してください。不明なことがあれば、不明だと明示します。この skill の [ASSUMPTION] という慣例は、どの事実が欠けているのかをエージェントが把握している場合にだけ有効です。

よくある OKF の失敗パターンを防ぐ

複数の概念を 1 つのファイルにまとめてしまう、type 値が欠けている、説明が汎用的すぎる、相対リンクが壊れている、市場や財務の仮説とつながっていない戦略主張がある、といった問題に注意してください。各フェーズの後で、エージェントに準拠チェックを依頼します。「生成したすべての概念を references/okf_conformance.md と references/type_vocabulary.md に照らして確認し、書き直す前に修正点を一覧にしてください。」

意思決定基準でフェーズ出力を反復する

各フェーズの後、意思決定に役立つ内容になっているかを確認します。良い foundation フェーズは、目的、課題、価値観、仮説を明確にします。良い finance フェーズは、収益モデル、コスト構造、ユニットエコノミクス、価格設定、予測を見える化します。良い operations フェーズは、誰かが実行できるプロセスと runbook を生み出します。出力がマーケティング文のように読める場合は、より明確なトレードオフ、依存関係、却下した代替案を求めてください。

自社の運営モデルに合わせて skill を拡張する

自組織向けに arquiteto-de-empresa を改善するには、OKF の基本を壊さない範囲で、会社固有のテンプレート、type vocabulary の拡張、レビュー用チェックリストを追加します。たとえば、規制対象の healthcare startup ならコンプライアンス証跡フィールドを追加し、venture studio なら投資委員会ステータスを追加し、SaaS チームなら PRD を roadmap や architecture ファイルにリンクできます。将来のエージェントが隠れた慣習なしに bundle を理解できるよう、拡張は明示的に保ってください。