VMS

VMS は、VCDesign の設計思想を経営実務に接続するための仕様リポジトリです。
このリポジトリには実装コードは含まれず、生成 AI や対話システムに読み込ませるための運用プロトコルを YAML とテキストで管理しています。

目的

• 経営上の相談を VCDesign の Loop、Boundary、Decision の枠組みに変換する
• 既存事業を守る判断と、新しい構造を探る判断を分離して扱う
• 利用者の役割に応じて、AI 出力の粒度と責任範囲を調整する

リポジトリ構成

.
├── README.md
├── repomix-output.xml
└── specs/
    ├── # Transition_Protocol.yaml
    ├── Execution_Loop.yaml
    ├── Exploration_Decision_Schema.yaml
    ├── Exploration_Engine.yaml
    ├── Exploration_Metrics.yaml
    ├── Framework_Selection_Protocol.yaml
    ├── Input_Interface.yaml
    ├── Metrics_Standard.yaml
    ├── Mode_Switcher.yaml
    ├── Onboarding.yaml
    ├── Output_Structure.yaml
    ├── User_Role_Definition.yaml
    ├── VMS.yaml
    └── prompt.txt

各ファイルの役割

中核仕様

• specs/VMS.yaml VMS 全体のアイデンティティ、運用ロジック、価値定義、判断ルールを定義します。
• specs/Mode_Switcher.yaml 利用者の意図を Closure Mode、Exploration Mode、Diagnostic Exploration に振り分けます。
• specs/Output_Structure.yaml AI が返す出力の層構造を定義します。
• specs/User_Role_Definition.yaml L1 から L3 までのユーザーレベルごとの出力要件を定義します。

入力と初期導入

• specs/Input_Interface.yaml 症状の分類と、追加で取得すべきコンテキストを定義します。
• specs/Onboarding.yaml 初回セッションの流れを定義します。
• specs/prompt.txt AI に与えるベースプロンプトです。

実行と監視

• specs/Execution_Loop.yaml 週次または月次のレビューサイクルを定義します。
• specs/Metrics_Standard.yaml 監視対象となる主要なズレや侵害を定義します。
• specs/Framework_Selection_Protocol.yaml 外部フレームワークを採用するか、VCDesign の原理にフォールバックするかの判断ルールを定義します。

探索モード関連

• specs/Exploration_Engine.yaml 探索時に見るべき観点を定義します。
• specs/Exploration_Decision_Schema.yaml 探索時の意思決定フォーマットを定義します。
• specs/Exploration_Metrics.yaml 探索結果の評価軸を定義します。
• specs/# Transition_Protocol.yaml 探索で得た仮説を、継続運用側へ引き渡す条件と手順を定義します。

補助ファイル

• repomix-output.xml リポジトリ内容を集約した補助生成物です。運用の正本は specs/ 配下です。

想定する使い方

1. specs/VMS.yaml を基点として AI に全体方針を渡します。
2. specs/prompt.txt をベースプロンプトとして使用します。
3. 初回対話では specs/Input_Interface.yaml と specs/Onboarding.yaml を参照させます。
4. 対話の意図に応じて specs/Mode_Switcher.yaml でモードを選択します。
5. 出力時は specs/Output_Structure.yaml と specs/User_Role_Definition.yaml に従って粒度を調整します。
6. 継続運用では specs/Execution_Loop.yaml と specs/Metrics_Standard.yaml を使ってレビューします。
7. 探索を行う場合は探索関連の spec 群を追加で読み込みます。

生成 AI 向けの最小読込セット

生成 AI にこの VMS を使わせる場合、最低限以下を同時に参照させてください。

• specs/VMS.yaml 判断原則、価値定義、責任の置き方
• specs/prompt.txt AI への基本指示
• specs/Input_Interface.yaml 症状の分類と不足情報の確認
• specs/Mode_Switcher.yaml モード選択
• specs/Output_Structure.yaml 出力フォーマット
• specs/User_Role_Definition.yaml 利用者レベルごとの粒度調整

初回導入では、これに加えて specs/Onboarding.yaml を読み込ませてください。
探索を許可する場合は、探索系 spec を追加で読み込ませてください。

生成 AI の推奨読込順

1. specs/VMS.yaml
2. specs/prompt.txt
3. specs/Input_Interface.yaml
4. specs/Mode_Switcher.yaml
5. specs/Output_Structure.yaml
6. specs/User_Role_Definition.yaml
7. 必要に応じて specs/Onboarding.yaml、探索系 spec、監視系 spec

この順序にしておくと、AI は先に原則を把握し、その後に入力分類、モード判定、出力整形へ進めます。

生成 AI が従うべき運用手順

1. ユーザーの相談を Input_Interface.yaml に照らして 4 つの Loop のどれに近いか判定する
2. 不足情報があれば current_pain、desire、constraints を質問する
3. Mode_Switcher.yaml に従って 守る、攻める、わからない のどれかに振り分ける
4. 必要なら Framework_Selection_Protocol.yaml に従って補助理論を選ぶ
5. 回答を Boundary、Metrics、Decision の形に変換する
6. 出力は Output_Structure.yaml の Do、Don't、Outcome と、設計記録を最低限含める
7. 最終決定権は常にユーザー側に残す

AI への入力例

以下のように指示すると、VMS の利用意図が AI に伝わりやすくなります。

このリポジトリの VMS に従って、以下の相談を整理してください。
まず Loop を判定し、不足情報があれば質問してください。
その後、Mode を選び、Boundary / Metrics / Decision の形で回答してください。

相談:
今の悩みを一言で言うと、お金が残らないことです。

前提と注意

• このリポジトリは仕様書リポジトリであり、実行用アプリケーションや CLI は含みません。
• specs/ の内容は、VCDesign の概念を既に共有している前提で設計されています。
• specs/# Transition_Protocol.yaml はファイル名の先頭に # と空白を含みます。利用ツールによっては扱いに注意が必要です。
• YAML を機械処理する前提では、キー名の重複や曖昧な参照がないことが重要です。

現時点で不足しやすい点と対策

• 相談の入力例が少ない AI が分類に迷うため、今後は Loop ごとの具体例を 2 から 3 件ずつ追加すると安定します。
• Decision の最終出力例がない 回答のばらつきを抑えるため、Closure 用と Exploration 用の完成例を別ファイルで追加すると有効です。
• 読み込み対象が多く、利用場面ごとの最小セットが分かりづらい 本 README に最小読込セットを追加済みですが、将来的には closure_bundle.md と exploration_bundle.md のような束ね資料があるとさらに扱いやすくなります。
• ファイル名が一部特殊である specs/# Transition_Protocol.yaml はツール互換性のため、将来的には Transition_Protocol.yaml など通常名への変更を推奨します。
• VCDesign の前提知識が暗黙的である 外部の AI に使わせる場合は、Loop、Boundary、Decision の用語集を別ファイルで持つと誤読を減らせます。

README の見直し観点

この README では、元の文書にあった以下の問題を整理しています。

• 会話の導入文が残っており、文書の目的が不明瞭だった
• 実在しないファイル名や曖昧な参照が含まれていた
• Markdown の見出し、表、箇条書きが未整形で、文書構造が追いづらかった
• 利用手順が概念説明に偏っており、どのファイルをどう読むかが分かりづらかった

ライセンス

必要に応じて追記してください。