Engineer Software Design

エンジニア / 詳細設計

主題は どう実装するか を、ジュニアエンジニアが手を動かせる粒度で提案することである。 要件の洗い出しそのものは engineer-software-requirement の役目である。

いつ使うか

• 要件（または要件セクション付き計画）があり、実装差分・手順が必要なとき
• /coding.design や Plan の詳細設計フェーズ
• 「ジュニアが作業可能」な計画へ落とし込むとき

要件が曖昧なまま詳細設計だけ求められた場合は、先に不足要件を指摘するか engineer-software-requirement へ戻す。

アセットディレクトリ

• ../../assets/
• apm_modules/**/coding-xm3/.apm/assets/

入力

必須に近いもの

• 要件定義、または要件が書かれた既存計画ファイル
• 関連プロンプト（意図の補足）

計画ファイルの場所は workspace-agent-temporary（.ai-agent/plan/）に従う。職能粒度は agent-job-description のジュニア定義に合わせる。

ガードレール

• プロダクションコードは変更しない（計画ファイルとレビュー用 Markdown のみ）
• 抽象方針のまま「あとは実装で」と逃げない。差分が書けないなら要件不足として止める

設計の基本

• 関連 SKILL / ドキュメントを積極的にロードする
• ドキュメントの DO / 推奨 に沿って提案する（DO NOT は example・ナレッジ側）

実行手順

ステップ1. 要件確認

• [ ] 要件定義・計画・追加プロンプトから完了条件を把握する
• [ ] 変更対象の箇所（パッケージ／レイヤー）を特定する
• [ ] 要件が抽象的すぎる場合は詳細設計を進めず、不足点を返す

ステップ2. 関連ドキュメント確認

• [ ] アーキテクチャ／レイヤー構成ドキュメント
• [ ] コーディング規約
• [ ] 既存の類似実装パターン（近い Usecase / Screen / Repository 等）
• 不明点は推測で埋めず確認する

ステップ3. 変更提案

• {assets}/coding/design.md（詳細設計テンプレート）をロードする（プロンプト指示による軽微なフォーマット差は可）
• [ ] 具体的な変更差分を提示する（前後コードまたは同等の完全手順）
• [ ] 編集対象すべてのファイルツリー（[New] / [Del] / 変更はサフィックスなし）
• [ ] 十分なコードコメント方針とテストコード提案
• [ ] ステップ・バイ・ステップの実装手順

ステップ4. 出力前チェック

• [ ] agent-job-description のジュニアが実装可能な粒度か
• [ ] ファイルツリー・差分・手順・テストが揃っているか
• {assets}/coding/design.md（詳細設計テンプレート）に沿って計画へ出力する

満たすべき品質

ジュニアが「方針に従って」ではなく、提示差分を写経・手順実行で完了できること。

• ファイルツリーによる全体像
• わかりやすい差分（疑似コードですべての分岐が追えるレベル以上）
• 詳細なコードコメント
• 十分なテスト提案（ケースと期待値）
• 実装手順がチェックリストで分割されていること

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: eaglesakura
• Source: eaglesakura/agent-skills
• License: MIT

Install and usage instructions live in the source repository linked above.