step_01-02_requirements.md

  • Ver.20260329a
  • Claude Code(Model:Opus 4.6)
  • .md ファイルの内容は末尾

ステップ1-2: 要件の理解

このドキュメントは実装フローのステップ1-2の詳細手順を説明します。


ステップ1: 要件説明

概要

ユーザーが実装したい内容やバグ修正をClaude Codeに説明する。

Claude Codeの役割

  • ユーザーの説明を注意深く聞く
  • 不明点があれば質問する
  • 要件の全体像を理解する

実施内容

  1. ユーザーからの要件説明を受ける
  2. 要件の概要を理解する
  3. 実装の目的を理解する
  4. 期待される成果物を理解する
  5. requirements-analyzer エージェントを使用して、関連する既存コードの調査と影響範囲の分析を行う

ステップ2: 質問と回答の繰り返し

概要

Claude Codeがユーザーに質問し、ユーザーが回答する。要件が明確になるまで繰り返す。

質問すべき項目

機能要件の確認

  • この機能の目的は何ですか?
  • 誰がこの機能を使いますか?
  • どのような場面で使われますか?
  • 既存の機能と関連はありますか?

技術要件の確認

  • どのファイルを修正する必要がありそうですか?
  • 既存のコードを参考にできますか?
  • 外部ライブラリが必要ですか?
  • パフォーマンスの要件はありますか?

UI/UXの確認(該当する場合)

  • ユーザーインターフェースはどうあるべきですか?
  • ボタンやダイアログが必要ですか?
  • 色や配置の指定はありますか?

テストの確認

  • どのようにテストすべきですか?
  • 正常系のテストケースは?
  • 異常系のテストケースは?
  • GUI操作のテストが必要ですか?

優先度とスコープの確認

  • 最低限必要な機能は何ですか?
  • 将来的に拡張する可能性はありますか?
  • 今回のスコープに含めないものは何ですか?

ステップ2完了の基準

以下が全て明確になったら、ステップ3へ進む:

  • [ ] 実装する機能の目的が明確
  • [ ] 実装の範囲(スコープ)が明確
  • [ ] 修正対象のファイルが特定できている(または、候補を列挙し優先度/調査方針に合意)
  • [ ] テスト方法が明確
  • [ ] 不明点がない(または、実装しながら確認することで合意)

ステップ2完了後の次のアクション

ステップ2が完了したら、ユーザーに以下を確認:

要件の理解が完了しました。
次はステップ3(Redmineチケット説明欄の作成)に進みます。
ステップ3に進んでよろしいですか?

使用するエージェント

  • requirements-analyzer: 要件に関連する既存コードを調査し、修正対象ファイルの候補と影響範囲を分析する

注意事項

  • 焦って実装を始めない
  • 要件が曖昧なまま先に進まない
  • ユーザーの期待と自分の理解にズレがないか常に確認
  • 質問は遠慮せず、何度でも聞く

# ステップ1-2: 要件の理解

このドキュメントは実装フローのステップ1-2の詳細手順を説明します。

---

## ステップ1: 要件説明

### 概要
ユーザーが実装したい内容やバグ修正をClaude Codeに説明する。

### Claude Codeの役割
- ユーザーの説明を注意深く聞く
- 不明点があれば質問する
- 要件の全体像を理解する

### 実施内容
1. ユーザーからの要件説明を受ける
2. 要件の概要を理解する
3. 実装の目的を理解する
4. 期待される成果物を理解する
5. **requirements-analyzer** エージェントを使用して、関連する既存コードの調査と影響範囲の分析を行う

---

## ステップ2: 質問と回答の繰り返し

### 概要
Claude Codeがユーザーに質問し、ユーザーが回答する。要件が明確になるまで繰り返す。

### 質問すべき項目

#### 機能要件の確認
- この機能の目的は何ですか?
- 誰がこの機能を使いますか?
- どのような場面で使われますか?
- 既存の機能と関連はありますか?

#### 技術要件の確認
- どのファイルを修正する必要がありそうですか?
- 既存のコードを参考にできますか?
- 外部ライブラリが必要ですか?
- パフォーマンスの要件はありますか?

#### UI/UXの確認(該当する場合)
- ユーザーインターフェースはどうあるべきですか?
- ボタンやダイアログが必要ですか?
- 色や配置の指定はありますか?

#### テストの確認
- どのようにテストすべきですか?
- 正常系のテストケースは?
- 異常系のテストケースは?
- GUI操作のテストが必要ですか?

#### 優先度とスコープの確認
- 最低限必要な機能は何ですか?
- 将来的に拡張する可能性はありますか?
- 今回のスコープに含めないものは何ですか?

### ステップ2完了の基準
以下が全て明確になったら、ステップ3へ進む:
- [ ] 実装する機能の目的が明確
- [ ] 実装の範囲(スコープ)が明確
- [ ] 修正対象のファイルが特定できている(または、候補を列挙し優先度/調査方針に合意)
- [ ] テスト方法が明確
- [ ] 不明点がない(または、実装しながら確認することで合意)

---

## ステップ2完了後の次のアクション

ステップ2が完了したら、ユーザーに以下を確認:

```
要件の理解が完了しました。
次はステップ3(Redmineチケット説明欄の作成)に進みます。
ステップ3に進んでよろしいですか?
```

---

## 使用するエージェント

- **requirements-analyzer**: 要件に関連する既存コードを調査し、修正対象ファイルの候補と影響範囲を分析する

## 注意事項

- 焦って実装を始めない
- 要件が曖昧なまま先に進まない
- ユーザーの期待と自分の理解にズレがないか常に確認
- 質問は遠慮せず、何度でも聞く