mcpField
S
spec-loop-write-adr

spec-loop-write-adr

github.com/dpolivaev開発3550 回インストール2 週間前に更新
リポジトリ

spec-loop-write-adr について

spec-loop-write-adrは、ユーザーの依頼またはSpec Loopのワークフローを受けてADRを作成・更新するスキルです。未決の重要事項を確認し、根拠を所定のセクションに整理します。

主な機能

  1. 01ADRの作成と更新
  2. 02重要な未決事項の確認
  3. 03入力のセクション別分類
  4. 04Analysisへの判断根拠の記録

活用シーン

  1. 01依頼に基づくADRの起草
  2. 02新たな判断事項が出た際の確認依頼

インストール

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

$npx skills add https://github.com/dpolivaev/spec-loop --skill spec-loop-write-adr

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

同梱ファイルadr-format.md

詳細

このスキルは、ADR の作成にのみ使用してください。

作業を始める前に、adr-format.md を読み、 その内容を適用してください。

AGENTS.md などのプロジェクト指示がある場合は、読み、適用してください。

このスキルは ADR を作成します。ADR が必要かどうかを、それ自体で判断するものではありません。ADR の作業は、ユーザーから依頼された場合、または Spec Loop ワークフローで ADR に引き継がれた場合に開始します。

作成または更新する ADR が、このスキルの基準となる成果物です。

タスク成果物があるかどうかにかかわらず、同じ ADR 形式を使用してください。

必須の確認ゲート

ADR を現在の確定事項として作成または改訂する前に、決定、その基準、トレードオフ、妥当な選択肢、または決定の範囲について、重要な未決事項が残っていないか確認してください。

残っている場合は、論点と現時点の根拠を安全に記録できる最低限の ADR 構成だけを作成し、 spec-loop-clarify-task/SKILL.md を使用して、作業を続ける前にユーザーに確認してください。ユーザーから明示的に確認を求められるまで待ってはいけません。また、この引き継ぎを、構造化されていない基準の議論やブレインストーミングに置き換えてはいけません。

その後の ADR 作成で新たな重要な未決事項が明らかになった場合は、その都度このゲートを再実行してください。

作成または改訂の前に、各入力項目を適切なセクションに分類してください。

  • Context = ほかの妥当な選択肢を採用しても変わらない、決定前の事実。要件、制約、現状の調査結果、スコープの境界、明示的な先送り事項などが該当します。
  • Alternatives = 競合する妥当な選択肢。
  • Analysis = 明確化された推論、合意された基準、トレードオフ、選択肢の比較、および選択した案が採用された簡潔な理由。
  • Decision = 選択した結論の要約。決定に含まれる明示的な先送り事項や、主要な維持対象の境界も含みます。

Analysis を、ADR における決定とその根拠の正式な記録として扱ってください。 Analysis の論点を、決定とその根拠としてほかの箇所で繰り返してはいけません。

タスク成果物がある場合は、その Research、Analysis、および ADR に関連するその他のセクション（Constraints、Design、該当する場合は Scenario など）を、ADR の主な入力として使用してください。タスク成果物がない場合は、確認済みのチャットでの明確化内容と、ほかの最新の根拠を使用してください。

コメント

Markdown 対応