# spec-structure

> SDD仕様書（overview.md, specification.md, technical-details.md, phase計画書）の構造・フォーマットガイド。以下の状況で使用する:
(1) 仕様書を作成・編集する時、テンプレートを参照したい時
(2) 「**不明**」マーク、複数案提示、調査項目状態の書き方を確認する時
(3) specs/{taskname}/ のファイル構成を理解したい時
(4) Phase計画書（tasks/phase{N}-*.md）のフォーマットを確認する時
各ファイルのテンプレートはassets/templates/に配置。

- Author: masseater
- Repository: masseater/claude-code-plugin
- Version: 20260122162309
- Stars: 1
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/masseater/claude-code-plugin
- Web: https://mule.run/skillshub/@@masseater/claude-code-plugin~spec-structure:20260122162309

---

---
name: spec-structure
description: |
  SDD仕様書（overview.md, specification.md, technical-details.md, phase計画書）の構造・フォーマットガイド。以下の状況で使用する:
  (1) 仕様書を作成・編集する時、テンプレートを参照したい時
  (2) 「**不明**」マーク、複数案提示、調査項目状態の書き方を確認する時
  (3) specs/{taskname}/ のファイル構成を理解したい時
  (4) Phase計画書（tasks/phase{N}-*.md）のフォーマットを確認する時
  各ファイルのテンプレートはassets/templates/に配置。
disable-model-invocation: true
---

# Spec Structure Guide

SDD仕様書の構造とフォーマット定義。

## 仕様書ファイル一覧

```
specs/{taskname}/
├── overview.md           # タスク概要、Phase構成、調査項目
├── specification.md      # 機能要件、非機能要件
├── technical-details.md  # 技術仕様、API設計
└── tasks/
    ├── phase1-xxx.md     # Phase 1 詳細計画
    ├── phase2-xxx.md     # Phase 2 詳細計画
    └── ...
```

## 各ファイルの役割

| ファイル | 作成コマンド | 内容 |
|----------|-------------|------|
| overview.md | `init-task` → `plan-phases` | 目的、スコープ、実装概要、調査項目、Phase構成 |
| specification.md | `define-requirements` | 機能要件、非機能要件 |
| technical-details.md | `define-technical` | 技術スタック、API設計、データ設計 |
| phase{N}-xxx.md | `breakdown-phase` | タスク一覧、依存関係、テスト戦略 |

## テンプレート

- **overview.md**: See [overview-template.md](./assets/templates/overview-template.md)
- **specification.md**: See [specification-template.md](./assets/templates/specification-template.md)
- **technical-details.md**: See [technical-details-template.md](./assets/templates/technical-details-template.md)
- **phase計画書**: See [phase-task-template.md](./assets/templates/phase-task-template.md)

## 重要な規約

### 不明点の明記
```markdown
**不明**: [質問内容]
```
- 不明な点は勝手に決めず「**不明**」とマーク
- `/sdd:clarify-spec` で解消

### 複数案の提示
```markdown
**案A**: [内容]
**案B**: [内容]
**案C**: [内容]
```
- 決定前の選択肢を明示
- ユーザー確認後に決定

### 調査項目の状態
| 状態 | 意味 |
|------|------|
| 🔴 未着手 | 調査前 |
| 🟡 進行中 | 調査中 |
| 🟢 完了 | 調査完了、結果あり |