mcpField
S
sdd-propose

sdd-propose

github.com/fearovex-labs開発57 回インストール
リポジトリ

sdd-propose について

sdd-proposeは、仕様や設計に進む前に、意図・範囲・技術方針を定める変更提案を作成するClaude Codeスキルです。複数チームに関わる変更やユーザー向けの大規模な変更では、PRDを併用できます。

主な機能

  1. 01変更の意図と範囲を定義
  2. 02技術方針を整理
  3. 03PRDとの任意の併用
  4. 04プロジェクト内または全体から解決

活用シーン

  1. 01複数チームに関わる変更を提案
  2. 02技術設計前に範囲を定める
  3. 03大規模な製品変更を文書化

MCP 対応

提案ファイルを書き込んだ後、Engram MCPでポインターと要約を保存する手順が記載されています。Engram MCPを利用できない場合も、ファイルはディスクに書き込まれます。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/fearovex-labs/agent-config --skill sdd-propose

インストール後、Claude Code で/sdd-proposeを入力して読み込まれたか確認します。

詳細

sdd-propose

明確な意図、定義されたスコープ、技術的なアプローチを含む変更提案を作成します。

トリガー：/sdd-propose <change-name>、提案を作成、変更を定義、sdd proposal

目的

提案では、技術的な詳細に入る前に、何をするのか、なぜするのかを定義します。これは変更のスコープに関する合意です。承認された提案がなければ、仕様も設計も作成されません。

大規模な提案（複数チームにまたがるスコープ、複数のステークホルダー、またはユーザー向けの製品変更）の場合、任意で docs/templates/prd-template.md を使って提案と PRD を組み合わせます。PRD には、問題の説明、対象ユーザー、ユーザーストーリー、NFR、受け入れ基準を記載し、sdd-spec フェーズに直接引き継ぎます。内部リファクタリングやステークホルダーが 1 人の変更では、PRD を省略します。

スキルの解決

プロジェクトローカル → グローバルの順：

1. .claude/skills/sdd-propose/SKILL.md     (project-local — highest priority)
2. ~/.claude/skills/sdd-propose/SKILL.md   (global catalog — fallback)

アルゴリズムの詳細は docs/SKILL-RESOLUTION.md を参照してください。

Claude の実行設定

以下の注記は、上記のツールに依存しないロジックを Claude Code ハーネスに結び付けます。これらは他のツールには移植されない実行レイヤーです。

  • Step 0a のプリロード — skills/_shared/sdd-phase-common.md の Section F （プロジェクトコンテキストの読み込み）に従います。ノンブロッキングです。
  • Step 0c のプリロード — skills/_shared/sdd-phase-common.md の Section G （仕様コンテキストのプリロード）に従います。ノンブロッキングです。
  • アーティファクトの読み込み — ハーネスの Read("docs/sdd/{change-name}/explore.md") ツールを使用します（_shared/sdd-phase-common.md の Section B に従い、ディスクを優先）。ディスク上に ファイルがない場合（レガシーな変更）、次の順にフォールバックします。 mem_search(query: "sdd/{change-name}/explore") → mem_get_observation(id)。
  • 提案の永続化 — _shared/sdd-phase-common.md の Section C に従い、ディスクを優先します。最初に Write("docs/sdd/{change-name}/proposal.md", <full markdown>) を実行し、 続いて topic_key: sdd/{change-name}/proposal、 type: architecture、project: {project} を指定してポインターと要約を mem_save します。Engram MCP に接続できない場合でも、ディスク上のアーティファクトは 書き込み、Engram のポインターのみを省略します。Step 3a-bis のゲート失敗時は、 Write や mem_save を呼び出してはいけません。
  • オーケストレーターへの出力 — オーケストレーターが期待する JSON ブロックとして、 中立的な Output Contract を返します。永続化されたポインターのアーティファクト項目は engram:sdd/{change-name}/proposal です。手動での次のステップは /sdd-spec <change-name> と /sdd-design <change-name> です（並行して実行できます）。

コメント

Markdown 対応