AIDD · オーケストレーター(1スキル)
AIDD = AI支援設計→開発。設計議論をプラットフォーム非依存なハンドオフパッケージ(ルール/設定/コントラクト/受け入れ条件/UIプロトタイプ/スパイン)に変換します。このパッケージは別のAI(または人間)が直接開発できるもので、決定論的チェッカーによって「主要な問題がゼロ」になってから引き渡されます。ドメイン非依存:同じエンジンでゲームシステムもSaaS課金機能も設計できます。実装(技術スタックを選んでクライアント/サーバーを書く)は後続工程であり、このパッケージには含まれません。
これはパイプライン全体をカバーする1つのスキルです。各フェーズの詳細なプレイブックは
references/にあり、必要に応じて読み込まれます。これにより、コンテキストを軽量に保ちながら、多数のスキルに分割する必要がありません。
コアモデル
- 2つの層: ① ライブな プロジェクトスパイン —
project-charter(コンセプト / プラットフォーム / ターゲットユーザー / ドメイン / 命名規則)+manifest(システム一覧 + 依存関係グラフ + クロスレイヤーインデックス + 番号範囲レジストリ + 凍結台帳)、継続的に改訂;② システムごとのプロダクションループ。 - 一元化されたソース・オブ・トゥルース: 列挙型 / 番号 / コントラクト / 設定テーブルはプロジェクト層に配置。散文からは名前で参照し、位置に依存しない(
table[key].field/screenID.elementID/Rコード)— 生の数値をインラインで埋め込まない。 - すべての操作: スパインを読む → 作業を実行 → スパインに書き戻す。
- 標準メソッド:
references/methodology.md。落とし穴:references/gotchas.md。各ハーネス固有の詳細:references/harness-adapt.md。
エントリー時 — 自己チェック → ルーティング(積極的に前進させる)
- スパインは存在するか?(
project-charter+manifest)— 存在しない → コンセプトフェーズから開始してスパインを構築。存在する → 両方を読む。 - まだ
Finalになっていないシステムは? 一覧表示し、今回どのシステムを進めるか尋ねる。 Recheck状態のシステムはあるか?(共有アイテムが変更された)→ 最初に finalize/sync フェーズで解決する。- 番号範囲の競合 / 依存関係の循環は? 確認して報告する。
フェーズ(該当するプレイブックを読み、作業を実行)
| 何をしたいか | 読むもの |
|---|---|
| コンセプト:コアループ / プラットフォーム / ユーザー / システム分割 / スパインの開始 | references/phases/concept.md |
| システムを設計する:ルール(Rコード)+ 設定テーブル(テストデータ)+ UIプロトタイプ | references/methodology.md — ステップ0~5、パートA |
| ドライラン後の反復:ルール / 設定 / プロトタイプを微調整(安価、繰り返し可能) | references/methodology.md — パートAを再実行 |
| 最終化&ハンドオフ:コントラクト + 受け入れ条件 +(必要に応じて)バックエンド + チェックリスト;その後スパインを同期 | references/methodology.md パートB + references/handoff-checklist.md |
| UIスクリーンショット → UI DSL(参照画面を知識ベースに取り込む) | references/phases/ui-capture.md |
標準的なパス:コンセプト(1回)→ システムごと { 設計 → 反復…(繰り返し)→ 最終化&ハンドオフ } → 同期(継続的)。順序は強制されません — 作業の必要性に応じてルーティングします。再分割 / 巻き戻しは、マニフェストにロールバックログエントリを記録し、最終化された下流システムを
Recheckとしてマークします。
決定論的チェッカー(ゲート — ハンドオフ前に実行)
references/scripts/(純Python、ほぼstdlib):config_check(設定仕様 ↔ xlsx のずれ)・value_check(壊れた外部キー / カバレッジ / 単調性)・manifest_check(スパインの自己整合性)・ref_graph --check(未解決のRコード / 参照)・gherkin_to_checklist・ui_render(UI DSL → ワイヤーフレーム)。0 major = ハンドオフ可能。 実行可能な例:references/examples/subscription-plans/。
境界(これではないもの)
- 構造と一貫性を管理し、品質を判断しない: チェッカーは壊れたリンク / カバレッジ / 単調性 / スキーマのずれを検出しますが、設計の良し悪し(ゲームバランス、UX、ビジネスの正しさ)は判断しません — それは人間や専用ツールの役割です。
- HTMLプロトタイプは情報アーキテクチャとフローを検証するものであり、感触 / タイミング / ネットワーキングを検証するものではありません。UI密度の高い面(インベントリ、ショップ、設定、ダッシュボード、オンボーディング)に適しています。リアルタイムな感触はエンジニアリングプロトタイプに任せてください。
- 数値や規則を決定しません: 未決定のものはすべて
[確認必要]としてタグ付けされ、人間に引き渡されます。 - ハンドオフパッケージまでの範囲です。技術スタックの選択とクライアント/サーバー実装は後続工程です。
パッケージ(1フォルダ)
単一の aidd/ スキルフォルダをホストのスキルディレクトリ(例:Claude Code の .claude/skills/)にインストールします。方法論、チェッカー、テンプレート、例題 — すべて aidd/references/ の下に出荷されます。ドメインパック(アプリ / ゲームのパターン+例題)は references/patterns/ + references/examples/ に配置します。
ハード制約(違反禁止)
- ファイルは UTF-8(BOMなし)。
- 名前で参照(位置非依存)。使用する場合は一律で万分率
/10000。 - 集中設定: テーブルはグローバルにプールされ、システムごとのプライベートテーブルは禁止。クロスシステム参照は通常の参照であり、依存関係エッジではありません。ブロードキャスト型の共有ソース(ID名前空間 / 列挙型 / テキスト)は追加専用で、決して破壊しない。
- ツール呼び出しはハーネスの関数呼び出し形式を使用すること。そうしないと静かに失敗する可能性があります — 成果物が実際に配置されたことを確認(read-file /
ls)してください。ハーネスごとの詳細はreferences/harness-adapt.mdを参照。 - 変更のたびに、プロジェクトの変更台帳(
CHANGELOG.md)に追記します。存在しない場合はreferences/templates/CHANGELOG.tpl.mdから初期化します。