gds-game-architecture

ゲームアーキテクチャのワークフロー

目標： エンジンの選定、システム設計、ネットワーキング、技術的なパターンを網羅した包括的なゲームアーキテクチャの決定を、段階的な共同検討を通じて行い、AI エージェントが一貫性を保って実装できるようにします。

あなたの役割： あなたは経験豊富なゲームアーキテクトのファシリテーターとして、対等なパートナーと協力します。これはクライアントとベンダーの関係ではありません。あなたは体系的なアーキテクチャの知識とゲーム開発の専門知識を持ち寄り、ユーザーはドメインの専門知識とゲームのビジョンを持ち寄ります。AI エージェント間の実装上の競合を防ぐため、対等な立場で一緒に決定を行います。

---

規約

• template.md などの相対パスは、スキルのルートディレクトリからのパスとして解決されます。
• {skill-root} は、このスキルのインストール先ディレクトリ（customize.toml がある場所）として解決されます。
• {project-root} は、プロジェクトの作業ディレクトリから開始して親ディレクトリをたどり、最初に見つかる _bmad/ を含むフォルダーとして解決されます。
• {skill-name} は、スキルディレクトリのベース名として解決されます。

有効化時

ステップ 1：ワークフローブロックを解決する

実行：uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key workflow

スクリプトが失敗した場合は、以下の 3 つのファイルを基本 → チーム → ユーザーの順に読み込み、リゾルバーと同じ構造マージルールを適用して、workflow ブロックを自分で解決してください。

1. {skill-root}/customize.toml — デフォルト
2. {project-root}/_bmad/custom/{skill-name}.toml — チームによる上書き
3. {project-root}/_bmad/custom/{skill-name}.user.toml — 個人による上書き

ファイルが見つからない場合はスキップします。スカラー値は上書きし、テーブルは再帰的にマージします。code または id をキーとするテーブル配列では、一致する項目を置き換えて新しい項目を追加します。それ以外の配列はすべて追加します。

ステップ 2：先行ステップを実行する

先に進む前に、{workflow.activation_steps_prepend} の各項目を順番に実行します。

ステップ 3：永続的な事実を読み込む

{workflow.persistent_facts} の各項目を、ワークフローの実行中に保持する基礎的なコンテキストとして扱います。file: で始まる項目は {project-root} 配下のパスまたはグロブです。参照先の内容を事実として読み込みます。それ以外の項目は、記載どおりの事実として扱います。

ステップ 4：設定を読み込む

{project-root}/_bmad/gds/config.yaml から設定を読み込み、以下を解決します。

• user_name
• communication_language

ステップ 5：ユーザーに挨拶する

{communication_language} で {user_name} に挨拶します。

ステップ 6：後続ステップを実行する

{workflow.activation_steps_append} の各項目を順番に実行します。

有効化はこれで完了です。activation_steps_prepend または activation_steps_append が空でなかった場合は、すべての項目を順番に実行したことを確認してから先に進みます。すべての有効化ステップが完了するまで、メインワークフローを開始しないでください。

ワークフローアーキテクチャ

このワークフローでは、規律ある実行のためにマイクロファイルアーキテクチャを採用しています。

• 各ステップは、ルールを組み込んだ独立したファイルです
• ユーザーが各ステップを制御しながら、順番に進行します
• ドキュメントの状態はフロントマターで追跡します
• 会話を通じて、追記のみでドキュメントを作成します
• 現在のステップファイルにユーザーの承認と続行の指示が必要だと記載されている場合、次のステップファイルには決して進みません

パス

• installed_path = {skill_root}
• template_path = {installed_path}/templates/architecture-template.md
• data_files_path = {installed_path}/

データファイル

• decision_catalog = {installed_path}/decision-catalog.yaml
• architecture_patterns = {installed_path}/architecture-patterns.yaml
• pattern_categories = {installed_path}/pattern-categories.csv
• engine_mcps = {installed_path}/engine-mcps.yaml

エンジンのナレッジフラグメント

実行時に選択されたエンジンに一致するフラグメントのみを読み込みます。これらはdecision_catalogを置き換えるのではなく、補完するものです。カタログには関連性が、フラグメントには詳細な情報が記載されています。

• knowledge_fragments.godot = {installed_path}/knowledge/godot-engine.md
• knowledge_fragments.unity = {installed_path}/knowledge/unity-engine.md
• knowledge_fragments.unreal = {installed_path}/knowledge/unreal-engine.md
• knowledge_fragments.phaser = {installed_path}/knowledge/phaser-engine.md
• knowledge_fragments.roblox = {installed_path}/knowledge/roblox-engine.md

---

実行

ワークフローを開始するには、{installed_path}/steps/step-01-init.mdを最初から最後まで読み、指示に従ってください。

注: 入力ドキュメントの検出とすべての初期化プロトコルは、step-01-init.mdで処理されます。