writing-plans

計画の作成

基本原則

意欲はあるものの、センスも判断力もプロジェクトの背景知識もなく、テストを嫌うジュニアエンジニアが従えるほど明確な計画を作成します。

計画の構成

計画の保存先：docs/plans/YYYY-MM-DD-<feature-name>.md

# [Feature Name] Implementation Plan

> **For Claude:** Use executing-plans skill to implement this plan task-by-task.

## Overview
Brief description of what we're building and why.

## Prerequisites
- [ ] Dependency 1 installed
- [ ] Service 2 running
- [ ] Access to X configured

## Tasks

### Task 1: [Descriptive Name]
**File:** `path/to/file.ts`
**Test:** `path/to/file.test.ts`

#### Test First (RED)
```typescript
// Exact test code to write
describe('FeatureName', () => {
  it('should do specific thing', () => {
    // Arrange
    // Act  
    // Assert
  });
});

実装（GREEN）

// Exact implementation code
export function featureName() {
  // Implementation
}

検証

npm test -- --grep "FeatureName"
# Expected: 1 passing

タスク 2：[次のタスク]

...

統合テスト

すべてのタスクの完了後：

# Commands to run
npm run test:integration

手動検証

機能が正しく動作することを手動で検証する手順：

1. 手順 1
2. 手順 2
3. 期待される結果

ロールバック計画

問題が発生した場合：

1. git revert HEAD
2. ...

## Plan Quality Checklist

### Every Task Must Have:
- [ ] Exact file paths
- [ ] Complete code (not "add validation")
- [ ] Test written BEFORE implementation
- [ ] Verification command with expected output
- [ ] Clear success criteria

### Plan Must Include:
- [ ] Prerequisites listed
- [ ] Tasks in dependency order
- [ ] Integration test at end
- [ ] Rollback instructions

## Writing Guidelines

### Be Explicit
❌ "Add error handling"
✅ "Wrap the API call in try/catch, log errors with context, return null on failure"

### Be Complete
❌ "Update the config"
✅ ```json
{
  "setting": "value",
  "newSetting": "newValue"
}

順序を守る

タスクは順番に実行できるようにします：

1. 先行するタスクへの依存関係がない
2. 各タスクは前のタスクを基盤とする
3. 各タスクの完了後にテストが通る

実行の引き継ぎ

計画を保存した後、実行方法を選べるようにします：

「計画が完成し、保存されました。実行方法は 2 つあります：

1. サブエージェント駆動（このセッション）

• タスクごとに新しいサブエージェントを使用
• タスク間でレビュー
• 素早く反復

2. 並行セッション（別セッション）

• 実行計画スキルを使って新しいセッションを開始
• チェックポイントを設けてまとめて実行

どちらの方法にしますか？」

DRY、YAGNI、TDD に関する注意事項

すべての計画の冒頭に含めます：

## Remember
- Exact file paths always
- Complete code in plan (not "add validation")
- Exact commands with expected output
- DRY, YAGNI, TDD, frequent commits

アンチパターン

しないこと

• 曖昧なタスクの説明
• ファイルパスの欠落
• 不完全なコードスニペット
• テストより先に実装する
• 検証手順がない
• 背景知識があることを前提にする