| name | software-designing |
| description | 技術設計書を作成・編集する。アーキテクチャ設計、コンポーネント定義、API設計、データベーススキーマの文書化が必要な場合に使用する。設計フェーズのみを単独で実行する際に使用する。Do NOT use for SDDワークフロー全体の管理（sdd-documentationを使用すること）。 |
| metadata | {"version":"1.0.0"} |
設計スキル
技術アーキテクチャ、コンポーネント設計、API設計、データベーススキーマを文書化する設計書を作成します。
概要
このスキルは、以下の成果物を作成・管理します：
- docs/sdd/design/index.md: 設計概要（目次）
- docs/sdd/design/components/*.md: コンポーネント詳細
- docs/sdd/design/api/*.md: API設計詳細
- docs/sdd/design/database/schema.md: データベーススキーマ
- docs/sdd/design/decisions/DEC-XXX.md: 技術的決定事項
ドキュメント構成
docs/sdd/design/
├── index.md # 目次・アーキテクチャ概要
├── components/
│ ├── component-a.md # コンポーネント詳細
│ └── component-b.md
├── api/
│ ├── users.md # API設計詳細
│ └── items.md
├── database/
│ └── schema.md # データベーススキーマ
└── decisions/
├── DEC-001.md # 技術的決定事項
└── DEC-002.md
このスキルを使用する場面
新規作成時
- 技術アーキテクチャを文書化したい場合
- コンポーネント設計を明確にしたい場合
- API設計を定義したい場合
- データベーススキーマを設計したい場合
既存ドキュメントの修正時
- docs/sdd/design/の設計内容を更新・変更する場合
- 新しいコンポーネントを追加する場合
前提条件
requirements/との連携
docs/sdd/requirements/が存在する場合：
- 要件を読み込み、設計との整合性を確認
- すべての要件（REQ-XXX）に対応する設計要素があるか確認
- 要件にない機能が設計に含まれていないか確認
設計原則
コンポーネント設計
- 単一責任の原則: 各コンポーネントは1つの明確な目的を持つ
- 疎結合: コンポーネント間の依存関係を最小限に
- 高凝集: 関連する機能を同じコンポーネントに
- インターフェース定義: 明確な入出力を定義
API設計
- RESTful原則に従う
- 適切なHTTPステータスコードを使用
- バージョニング戦略を定義
- エラーレスポンスの一貫性
データベース設計
- 正規化と非正規化のバランス
- インデックス戦略
- トランザクション境界
ワークフロー
- 要件確認: docs/sdd/requirements/が存在すれば内容を確認
- 情報分類: 明示された情報と不明な情報を分類
- 不明点確認: 必要な情報をユーザーに確認
- ディレクトリ作成:
docs/sdd/design/ 以下のサブディレクトリを作成
- 各ドキュメント作成: テンプレートを使用
- 整合性確認: requirements/との整合性をチェック
- ユーザー確認: 承認を得て完了
検証チェックリスト
要件との整合性チェック
docs/sdd/requirements/が存在する場合、以下を確認：
| チェック項目 | 確認内容 |
|---|
| 機能カバレッジ | すべての要件（REQ-XXX）に対応する設計要素があるか |
| 非機能要件対応 | NFR-XXXの要件が設計に反映されているか |
| 過剰設計チェック | requirements/にない機能が設計に含まれていないか |
ユーザーとの対話ガイドライン
確認が必要な場面
- アーキテクチャパターンの選択
- 技術スタックの選定
- データモデルの構造
- 外部サービスとの連携方法
推奨度付き選択肢の提示
技術スタックについて確認させてください：
A) Next.js + TypeScript
推奨理由：モダンで型安全、SSR/SSG対応
B) React + JavaScript
推奨理由：シンプルで導入が容易
どれを選択しますか？
後続スキルとの連携
docs/sdd/design/の作成完了後：
- task-planning: design/を基にタスクを分解
task-planningスキルで逆順レビュー（タスク → 設計 → 要件）が行われます。
リソース
テンプレート
- 目次テンプレート:
assets/templates/design_index_template_ja.md
- コンポーネントテンプレート:
assets/templates/component_template_ja.md
- APIテンプレート:
assets/templates/api_template_ja.md
- データベーステンプレート:
assets/templates/database_template_ja.md
- 技術的決定テンプレート:
assets/templates/decision_template_ja.md
リファレンス
- 設計パターン:
references/design_patterns_ja.md
- CI/CDガイド:
references/cicd_guide_ja.md
- EARS記法（要件参照用）:
references/ears_notation_ja.md
命名規則
| ファイル種別 | 命名規則 | 例 |
|---|
| コンポーネント | ケバブケース | user-service.md, auth-handler.md |
| API | リソース名 | users.md, items.md |
| 技術的決定 | DEC-XXX.md | DEC-001.md, DEC-002.md |
