# Design Generator

> 要件定義書から SOLID 準拠の設計文書を生成・検証する。C4 ダイアグラム、 ADR 管理、パターン検出、SOLIDValidator を提供。 Use when generating design documents, creating C4 diagrams, managing ADRs, validating design patterns, or starting SDD Phase 2.

- Skill: `nahisaho/design-generator` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add nahisaho/design-generator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/nahisaho/design-generator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: nahisaho (https://skillmd.com/u/nahisaho)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/nahisaho/design-generator

---


# Design Generator

承認済み要件文書から SOLID 準拠の設計文書を生成・検証するスキル。
SDD ワークフロー Phase 2 の中核。

## 前提条件

- Phase 1（Requirements）が承認済みであること
- `steering/` を参照済みであること
- 要件文書（`storage/specs/REQ-*.md`）が存在すること

## ワークフロー

### 1. 設計文書生成

```
WHEN ユーザーが設計文書の生成を要求する:
1. 要件文書を読み込み（ParsedRequirement[]）
2. DesignGenerator.generate() で設計文書を生成
3. SOLIDValidator で SRP/OCP/LSP/ISP/DIP 準拠を検証
4. 各 DES にトレーサビリティリンクを付与
5. ユーザーレビュー ⏸️
```

**CLI**: `npx musubix2 design <req-file>`

### 2. C4 ダイアグラム生成

```
WHEN ユーザーが C4 ダイアグラムの生成を要求する:
1. C4Element と C4Relationship を抽出
2. Context / Container / Component レベルの Mermaid 図を生成
3. 設計文書に埋め込み
```

**CLI**: `npx musubix2 design:c4 <file> [--level context|container|component]`

### 3. ADR 管理

```
WHEN ユーザーが ADR の作成・管理を要求する:
1. DecisionManager.create() で新規 ADR 作成
2. ステータスライフサイクル: proposed → accepted → deprecated → superseded
3. DecisionManager.search() で全文検索
4. DecisionManager.index() でインデクシング
```

**CLI**: `npx musubix2 decision <create|list|get|accept|deprecate|search|index>`

### 4. 設計検証

```
WHEN ユーザーが設計文書の検証を要求する:
1. PatternDetector でデザインパターンを検出
2. SOLID 原則への準拠を検証
3. 要件との対応漏れを検出
```

**CLI**: `npx musubix2 design:verify <design-file>`

## 設計文書フォーマット

各 DES 仕様は以下の構成:

```markdown
### DES-XXX-NNN: タイトル

**トレーサビリティ**: REQ-XXX-NNN
**パッケージ**: `package-name`

**設計概要**:
（自然言語の説明）

（TypeScript インターフェース / Mermaid 図）

**CLI契約**: `npx musubix2 ...`
```

## ADR フォーマット

```markdown
# ADR-NNN: タイトル

**ステータス**: proposed | accepted | deprecated | superseded
**日付**: YYYY-MM-DD

## Context
（決定の背景）

## Decision
（決定内容）

## Consequences
（影響と結果）
```

## 品質ゲート

- [ ] 全 DES が少なくとも1つの REQ にトレース可能
- [ ] TypeScript インターフェースが定義されている
- [ ] CLI 契約が明記されている
- [ ] SOLID 原則への違反がない
- [ ] 重要な設計決定に ADR が作成されている

## Gotchas

1. **DES と REQ の N:M 関係**: 1つの DES が複数の REQ を参照する場合がある。逆も同様。全方向のリンクを維持すること。
2. **Mermaid 記法の制限**: classDiagram で `?` nullable 表記を使う場合、TypeScript 側の `| undefined` と一致させること。
3. **ADR のステータス管理**: `accept` と `deprecate` は状態遷移。直接 `superseded` にはできない（必ず `deprecated` を経由）。

## スクリプト

| スクリプト | 説明 | 使い方 |
|-----------|------|--------|
| `scripts/generate.sh` | 要件から設計生成 | `./scripts/generate.sh [args]` |
| `scripts/c4.sh` | C4 ダイアグラム生成 | `./scripts/c4.sh [args]` |
| `scripts/verify.sh` | 設計トレーサビリティ検証 | `./scripts/verify.sh [args]` |
| `scripts/decision.sh` | ADR 作成・管理 | `./scripts/decision.sh [args]` |