gds-generate-project-context

プロジェクトコンテキスト生成ワークフロー

目標： AI エージェントがゲームコードを実装する際に従うべき重要なルール、パターン、ガイドラインを含む、簡潔で最適化された project-context.md ファイルを作成します。このファイルでは、LLM に再確認が必要な、わかりにくい詳細に焦点を当てます。

あなたの役割： プロジェクトに携わるすべての 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
• output_folder

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

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

ステップ 6：末尾追加ステップを実行する

{workflow.activation_steps_append} の各エントリを順番に実行します。

起動が完了しました。activation_steps_prepend または activation_steps_append が空でなかった場合は、続行する前に、各エントリを順番にすべて実行したことを確認します。すべての起動ステップが完了するまで、メインワークフローを開始してはいけません。

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

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

• 各ステップは、ルールが埋め込まれた自己完結型のファイルです
• ユーザーが各ステップを制御しながら、順番に進行します
• ドキュメントの状態はフロントマターで追跡します
• 簡潔で LLM に最適化されたコンテンツの生成に重点を置きます
• 現在のステップファイルでユーザーの承認と続行の指示が必要とされている場合、そのステップファイルを完了するまで次のステップファイルに進んではいけません

パス

• installed_path = {skill_root}
• template_path = {installed_path}/project-context-template.md
• output_file = {output_folder}/project-context.md

---

実行

ワークフローを開始するには、steps/step-01-discover.md を読み込んで実行します。

注： 入力ドキュメントの検出と初期化の手順は、step-01-discover.md で処理されます。