Communitygithub.com

ProdaZhang/aidd

1つのAIと機能の設計をブレインストーミングし、チェック済みのプラットフォーム非依存なパッケージを別のAIに渡して実装させるスキル。ゲームでもアプリでも、決定論的チェッカーで品質を保証。

aidd とは?

AIDD(AI支援設計→開発)は、設計議論をプラットフォーム非依存のハンドオフパッケージに変換し、決定論的チェッカーで「主要な問題ゼロ」にゲートしてから別のAI(または人間)に引き渡すためのスキルです。ゲームシステム、SaaSのプラン・割り当て・権限・フィーチャーフラグ・フォーム・オンボーディングなど、設定・ルール・UIが中心となるシステムをスクラッチから設計する場合や、既存プロジェクトの中核(スパイン)を進捗・同期する場合に有効です。Claude Code、Cursor、CodexなどのAIエージェントが搭載するスキルディレクトリにインストールして使用します。1つのスキルがプロジェクトスパイン(プロジェクト憲章+マニフェスト)を読み、進捗を判断し、適切なフェーズのプレイブック(references/内)にルーティングすることで、少ないトークンで全体をカバーします。ドメイン非依存であり、チェッカーは設定スキーマのドリフト、外部キーの欠損、循環参照、未解決のRコードなどを検出しますが、設計の良し悪し自体は判断しません。

対応✓Claude Code~Codex CLI~Cursor
npx skills add ProdaZhang/aidd

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

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。

エントリー時 — 自己チェック → ルーティング(積極的に前進させる)

  1. スパインは存在するか?(project-charter + manifest)— 存在しない → コンセプトフェーズから開始してスパインを構築。存在する → 両方を読む。
  2. まだ Final になっていないシステムは? 一覧表示し、今回どのシステムを進めるか尋ねる。
  3. Recheck 状態のシステムはあるか?(共有アイテムが変更された)→ 最初に finalize/sync フェーズで解決する。
  4. 番号範囲の競合 / 依存関係の循環は? 確認して報告する。

フェーズ(該当するプレイブックを読み、作業を実行)

何をしたいか読むもの
コンセプト:コアループ / プラットフォーム / ユーザー / システム分割 / スパインの開始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 から初期化します。

関連スキル