idea-md

Idea.md

概要

ユーザーが初期段階のアイデアを持っているものの、まだ完全な PRD には至っていない場合に、充実した Idea.md を作成します。生のブレインストーミングと正式なプロダクト要件の橋渡しとして扱います。

Idea.md に普遍的な形式はありません。リポジトリに既存のローカル規約がある場合は、それに従ってください。ない場合は、references/what-is-idea-md.md に記載されている基本定義を採用します。問題、ユーザー、解決策、リポジトリとの適合性、リスク、次の検証手順をまとめた、簡潔で構造化されたコンセプト概要です。

開始時に次のように伝えます：I'm using the idea-md skill to create or refine the idea file.

収集する入力情報

入手可能な情報源のうち、最も内容の充実したものから次の順に確認します。

1. 既存の Idea.md／IDEA.md／関連する草案
2. 現在のリポジトリの状況：README、仕様書、ロードマップ文書、イシュー、パッケージ構成、特筆すべき制約
3. 会話履歴とユーザー提供のメモ
4. PRD、設計文書、調査メモなどの関連資料

リポジトリがある場合は、作成前に内容を確認してください。コードベースやドキュメントから把握できる技術的な背景を、推測で補わないでください。

ワークフロー

1. モードを決める

次のいずれかを選びます。

• 新規アイデアファイル：既存のアイデア文書がなく、ユーザーが新規作成を求めている
• 拡張：ユーザーがラフな草案を持っており、内容の拡充を求めている
• 書き直し：ユーザーが既存のアイデアファイルの整理と構成の改善を求めている

2. 適切な形式を推定する

• リポジトリに既存の Idea.md 規約がある場合は、それを維持します。
• ワークフローで Idea.md が上流の計画資料として使われている場合は、構造を整えつつ簡潔にまとめます。
• アイデアの記録だけが目的であれば、より軽い形式でも構いませんが、元の作成者以外にも理解できるようにします。

ローカルテンプレートがない場合は、references/idea-template.md を使用します。

3. 単に書き起こすのではなく、情報を統合する

ラフなメモを、筋の通った説明にまとめます。

• 中心となる主張を明確にする
• 重複を取り除く
• 暗黙の前提を表面化する
• 確定していることと推測を分ける
• ユーザー独自の表現や着想のうち、本質的なものを残す

4. 現実に即した内容にする

リポジトリがある場合は、リポジトリに即した具体的な情報を含めます。

• アイデアが基盤とする既存のインターフェース、パッケージ、システム
• アイデアの形を左右する制約
• 関連する統合ポイントやアーキテクチャ上の活用点

リポジトリがない場合は、事実であるかのように装わず、前提を明示します。

5. 適切な粒度を保つ

Idea.md は次のような文書にします。

• メモ書きよりも構造化されている
• PRD ほど詳細ではない
• アイデアが重要な理由を説明できる説得力がある
• 検証や次の計画を導けるだけの具体性がある

ローカルのワークフローで明示的に求められていない限り、タスクごとの実装計画にはしないでください。

標準的な出力構成

リポジトリ固有の形式がない場合は、次の構成を使用します。

1. タイトル
2. 概要（1 段落）
3. 課題
4. 対象ユーザー
5. 提案する解決策
6. 実現可能性／差別化要因
7. リポジトリまたは技術との適合性
8. MVP
9. リスクと未解決の質問
10. 検証または次のステップ

リポジトリで用語が確立されている場合は、セクション名を調整します。

品質基準

• 前置きではなく、着想の核心から始める
• 具体的な名詞と動詞を使い、誇張を避ける
• 漠然とした楽観論より、具体的なトレードオフを優先する
• 不明な点を分かりやすく示す
• 会話の断片から生まれたアイデアに矛盾がある場合は、解消するか明示する
• 既存の草案を拡張する場合は、意味を保ちながら明瞭さと有用性を高める

質問する場合

回答の欠落によって文書の内容が大きく変わる場合に限り、質問します。

• 対象ユーザーが不明確
• 中心的な課題が曖昧
• 互いに矛盾する複数の製品方針がある

それ以外は慎重に推定し、前提を明記します。

付属リファレンス

• references/what-is-idea-md.md：調査に基づく定義と、確認されたパターン
• references/idea-template.md：ローカル規約がない場合に使用する標準テンプレート