---

name: planning-docs description: 企画・設計・アイデア出し・ブレインストーミング・要件定義など、プロジェクトの企画フェーズに関する会話をしているときに自動発動。会話の内容を自動的にdocs/ディレクトリにタイムスタンプ付きドキュメントとして保存する。

企画ドキュメント自動作成スキル

このスキルは、企画フェーズの会話内容を自動的にドキュメント化します。

発動条件

以下のような会話を検出したら、自動的にドキュメントを作成してください：

• プロジェクトの企画や提案を話し合っている
• 新機能のアイデアを出し合っている
• システム設計やアーキテクチャを議論している
• 要件定義や仕様を整理している
• 技術調査の結果を共有している
• ブレインストーミングをしている
• 会議メモを残したい内容を話している

実行手順

1. ディレクトリの確認・作成

まず docs/ ディレクトリが存在するか確認してください。存在しない場合は作成します。

2. ファイル名の生成

以下の形式でファイル名を生成してください：

Copydocs/YYYYMMDD_HHMM_タイトル.md

• YYYYMMDD: 現在の日付（例: 20250113）
• HHMM: 現在の時刻（例: 1430）
• タイトル: 会話内容から適切なタイトルを生成（日本語、20文字以内）

タイトル生成の例：

• 企画書の話 → 初期企画案
• API設計の話 → API設計メモ
• ユーザー要件の話 → ユーザー要件定義
• 技術調査の話 → 技術調査_ライブラリ比較

3. ドキュメントの作成

以下の構成でMarkdownドキュメントを作成してください：

Copy# [タイトル]

**日時**: YYYY年MM月DD日 HH:MM
**カテゴリ**: [企画/設計/要件定義/技術調査/会議メモ など]

## 概要

[会話内容の要約を2-3文で]

## 詳細

[会話の内容を構造化して記録]

### [適切なセクション見出し]

- 箇条書きや段落で整理
- 重要なポイントを強調
- 図やコード例があれば含める

## 次のアクション

[もしあれば、次に取るべきアクションを箇条書きで]

## 参考リンク・メモ

[関連するURLや追加メモがあれば]

---

*このドキュメントはClaude Code planning-docsスキルにより自動生成されました*

4. ユーザーへの通知

ドキュメントを作成したら、以下のように簡潔に通知してください：

Copy会話内容を docs/20250113_1430_初期企画案.md に保存しました。

重要な注意事項

保存タイミングの判断基準（重要！）

ドキュメントを作成する前に、以下の条件を全てチェックしてください：

1. 十分な情報量があるか？

   • 会話が5ターン以上続いている
   • 具体的な内容（機能、要件、設計など）が話されている
   • 後で振り返る価値がある内容である

2. 重複していないか？

   • docs/ ディレクトリを確認し、今日の日付で同じトピックのファイルが既に存在しないか確認
   • 既に存在する場合は、新規作成せず既存ファイルを更新する
   • 例：docs/20250113_1430_API設計.md が既にある場合、docs/20250113_1500_API設計.md は作らない

3. 会話が一区切りついたか？

   • ユーザーが「じゃあ次は...」「とりあえずこれで...」などと区切りを示している
   • トピックが変わった（企画の話 → コーディングの話）
   • ユーザーが「まとめて」「記録して」と明示的に言った
   • 会話が10ターン以上続き、ある程度まとまった内容になった

これら3つの条件を満たす場合のみドキュメントを作成してください。

やること

• 上記の判断基準を厳守する
• 重要な内容は漏らさず記録する
• 読みやすく構造化された形式で保存する
• タイトルは具体的でわかりやすいものにする
• 既存ファイルがある場合は新規作成ではなく更新する

やらないこと

• 些細な雑談まで保存しない
• 会話の途中で性急に保存しない（一区切りつくまで待つ）
• 同じトピックで複数のドキュメントを作らない
• ユーザーが明示的に「保存しないで」と言った場合は保存しない
• コーディング中の会話は保存しない（企画フェーズのみ）

既存ドキュメントの更新方法

同じトピックで既にドキュメントがある場合：

Copy# 既存: docs/20250113_1430_API設計.md
# 新しい情報が追加された場合 → 既存ファイルを更新
# 新規作成はしない

更新時は以下のように追記してください：

Copy---

## 追加議論（HH:MM更新）

[新しく話された内容]

カスタマイズ

このスキルの動作は以下のファイルで設定できます：

• ~/.claude/CLAUDE.md - ドキュメント作成のルールをさらに詳しく定義
• このSKILL.mdファイル - スキルの発動条件や動作をカスタマイズ

使用例

ユーザー: 新しいアプリのアイデアなんだけど、天気予報とToDoリストを組み合わせたやつ。雨の日は室内タスクを優先的に表示するみたいな。

Claude: いいアイデアですね！天気連動型ToDoアプリという感じですね。

[会話が続く...]

Claude: 会話内容を docs/20250113_1430_天気連動ToDoアプリ企画.md に保存しました。

---

このスキルの場所: ~/.claude/skills/planning-docs/SKILL.md 編集方法: テキストエディタで直接編集するか、claude-setup リポジトリのテンプレートを更新して再インストールしてください