# Writing Plans

> 実装計画作成スキル。マルチステップ開発タスク向けの詳細な計画を生成する。

- Skill: `haru-llc/writing-plans` (Agent Skill)
- Install (CLI): `npx skillmds@latest add haru-llc/writing-plans`
- Raw SKILL.md: https://api.skillmd.com/api/skills/haru-llc/writing-plans/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: HaRu-LLC (https://skillmd.com/u/haru-llc)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/haru-llc/writing-plans

---


## 目的

マルチステップ開発タスク向けの詳細な実装計画を生成。コードベース不慣れなエンジニアでも実行可能な、一口サイズのタスクに分解。

---

## トリガー語

- 「実装計画を作成」
- 「開発プランを書く」
- 「タスク分解」
- 「TDD計画」

---

## 計画構造

### 必須ヘッダー

- ゴール
- アーキテクチャ
- テックスタック

### タスク構成

- 番号付きタスク
- 正確なファイルパス
- TDD進行順序：
  1. 失敗テスト作成
  2. 失敗確認
  3. 実装
  4. パス確認
  5. コミット

---

## タスク粒度

各ステップは**2-5分**で完了し、1つのアトミックアクションを表す。

> 「失敗テストを書く」は1ステップ
> 「失敗することを確認するために実行する」は別ステップ

---

## ドキュメント標準

| 要件 | 詳細 |
|------|------|
| コードサンプル | 完全で実行可能（擬似コードではない） |
| コマンド | 正確なコマンド + 期待出力 |
| スキル参照 | @構文を使用 |
| 原則 | DRY, YAGNI, 頻繁なコミット |

---

## 実行オプション

計画完了後、2つのパスを提示：

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

タスクごとに新しいサブエージェント、レビューサイクル付き

### 2. 並列セッション（別セッション）

executing-plansスキルを使用した専用セッション

---

## 計画保存先

```
docs/plans/YYYY-MM-DD-<feature-name>.md
```

---

## 重要原則

詳細なドキュメントと達成可能なタスク境界により、新チームメンバーのコンテキストオーバーヘッドを削減。

---

## ライセンス

MIT License (superpowers repository)