Vibe Adoption Framework · Roboco
既存企業のバイブコーディング導入のためのフレームワーク — Vibe Adoption Framework（VAF）の紹介
vaf.roboco.io · github.com/roboco-io/vibe-adoption-framework
Why now
高水準の開発人材を低コストで大規模に確保したのと同じ効果。リードタイム・品質・コスト構造が変わる。
ツールを使いながらも組織レベルの成果へ結びつけられない。「AIを使ったのに何も変わらない」という結論に帰結。
コーディングエージェントは、すでに熟練開発者が担っていた相当数の作業を代替する。その差は広がり続けている。
大前提
変わるのは原則ではなく経済性である。
明確な要求、良いアーキテクチャ、レビュー、テスト、文書化 — 人の開発を成功させてきた原則が、エージェントの開発も成功させる。
かつて高価だったもの（綿密なレビュー、徹底したテスト、レガシー全体の分析）を、エージェントが低コストで常時遂行する。
問いは「AIのために何を変えるか」ではなく、「本来やるべきだったことを、エージェントとどう実現するか」。
Foundational Principles
有能な新人に与えるもの — アクセス権限、システムの説明、ルール、明確な指示、レビュー — をエージェントにも与えよ。失敗する組織はエージェントを責め、成功する組織はオンボーディングの体系を作る。
「エージェントが作ったから私は知らない」を許容しない。作成の主体が変わっても、説明の義務は移らない。誰に問われてもいつでも答えられる状態を保つ。
人の理解と実際のシステムのギャップ＝認知負債。技術負債と同じく、除去ではなくトレードオフ管理の対象。どこに深い理解を維持するかは組織が決める。
Named Concepts
人が担っていたレビューとガードレールを、AIが代わりに遂行するよう体系化する工学。ルールファイル・自動レビュー・フック・検証パイプラインの組み合わせ。よくできたハーネスは、人のレビューをより高い抽象度（意図・設計・トレードオフ）へ引き上げる。
非嗜好（セキュリティ・ガードレール・コーディング規約）はリポジトリとともに管理され、全員に強制される。嗜好（文書化の詳細度など）のみ、ごく限定的に裁量を許容。リポジトリに組み込まれたルールは、エージェントにとって破れない環境になる。
Framework
「組織は何を備えるべきか？」診断と改善計画の単位。
「実際に何が変わるのか？」各領域のAsIs → ToBe。
「どの順序で進めるのか？」準備→診断→パイロット→変革の反復サイクル。
ジャーニーに沿って進みながらケイパビリティを備え、そのケイパビリティで変革領域のAsIsをToBeへ変える。
Value Chain
ツール導入を成果と取り違える — ライセンス購入はチェーンの最初のマスにすぎない。
変革なしに成果を直ちに求める — 「AIを使ったのに何も変わらない」という誤った結論。
経営陣への問い: 今このチェーンのどのマスがボトルネックか？ それが投資の優先順位である。
Transformation Domains
| Domain | AsIs | ToBe |
|---|---|---|
| コード生産 | 人が書く、採用がすなわちキャパシティ計画 | エージェントが書く、人は意図の指示と承認 |
| 品質保証 | 人によるレビュー、納期圧力で真っ先に犠牲に | ハーネスが自動強制、人は設計判断に集中 |
| 知識 | 暗黙知・口頭伝承、退職＝知識損失 | エージェントが常時活用する文書化された知識基盤 |
| 組織と役割 | 作成者中心のチーム、コード量で評価 | オーナー・オーケストレーター中心のチーム |
最も遅く、最も難しい変革は組織と役割 — 明示的に扱わなければ「ツールは買ったのに誰も使わない」状態になる
Perspectives
なぜ、何を得るのか — 導入戦略、ROI測定、SDLCギャップ分析、優先順位
人の役割 — オーナーシップ体系、認知負債管理、役割転換、ケイパビリティ開発、文化
何を強制するのか — 嗜好／非嗜好、ポリシーのリポジトリ強制、セキュリティ、コスト
エージェントは働けるか — アクセス経路、ツール接続、実行環境、権限
エージェントは知っているか — 知識基盤、リポジトリ文書化、懸案の文書化、コンテキスト供給
品質を誰が守るのか — ルールファイル、スキル・フック、自動レビュー、検証パイプライン、改善ループ
Perspectives in one line
なぜ導入し、何を得るのか？ — この観点が脆弱なら、残る五つの努力は個人技へと散らばる。
人の役割は何か？ — 人の価値は、何を書いたかではなく、何に責任を負うか。
何を強制するのか？ — エージェントにはルールを破る意志がない。ルールが環境になければ、その存在を知らないだけ。
エージェントは働けるか？ — アカウントのない新人に成果は期待できない。
エージェントは知っているか？ — エージェントの成果は、アクセスできる知識の質に比例する。
品質を誰が守るのか？ — ハーネスのない組織では、エージェントの速度はそのまま欠陥の速度。
Adoption Journey
VAFは診断より環境準備を先に置く。
診断・分析・文書化の遂行主体がエージェントだからである。
Journey Principles
小さく完走せよ — 狭く最後まで行く方が、広く手を付けて止まるより良い。完走の経験が拡散の燃料になる。
段階を飛ばすな — 準備なき診断は人の速度に、診断なきパイロットは文脈なきコードに、パイロットなき変革は検証されていない強要になる。
すべての段階で深層インタビューで確認せよ — 文書が現実とずれたまま次の段階へ進むことが、最も高くつく失敗。
指標はサイクルごとに更新せよ — 経営陣の信頼は指標の連続性から生まれる。
Anti-patterns
6か月後、「活用率が低い」という報告とともに勢いが尽きる。
成果を証明できず、予算更新の時点で座礁。
返ってくる答えは全面遮断。セキュリティは設計参加者に。
原因はエージェントではなく、ハーネスの空白である。
VAF本文には26のケイパビリティごとにアンチパターンが明示されている
Execution Kit
26ケイパビリティ × 3段階（不在／部分／定着）の判別質問
ビジネス懸案 · IT懸案 · SDLC · 知識管理の4領域
診断ワークショップ（半日）· パイロット着手ワークショップ（1日）
フレームワーク全用語の英語併記
診断段階のアセスメントとインタビューから、パイロット着手まで — フレームワークを読むことから、実行することへ。
Expected Outcomes
機能開発・バグ修正・レガシー分析が並列で、常時進行。
レビュー・検証がハーネスへ移り、例外なく強制。
人員規模に比例していた開発キャパシティの限界が緩和。
暗黙知が文書化された知識基盤へ。個人依存を解消。
人がコードを手で書かない状態がデフォルトになり、
オーナーシップと認知負債管理の体系がそれを支える。
Vibe Adoption Framework
vaf.roboco.io
（EN · 한국어 · 日本語）
github.com/roboco-io/
vibe-adoption-framework
ロボコ — roboco.io
© Roboco · Vibe Adoption Framework