mcpField
D
decision-map

decision-map

github.com/light-chengエージェントワークフロー521 回インストール4 日前に更新
リポジトリ

decision-map について

decision-map は、不確実性の高い大規模作業や複数セッションにまたがる作業向けの、ユーザー起動型の計画スキルです。Markdown のマップとチケットで決定事項や未解決事項を管理し、1 セッションにつき 1 件ずつ進め、計画完了後にプロジェクト仕様策定へ引き継ぎます。

主な機能

  1. 01永続的な決定マップの作成
  2. 02質問の決定チケット化
  3. 03チケット間のブロック関係の記録
  4. 04マップ作成中の調査チケット並列実行
  5. 051 セッションにつき非調査チケットを 1 件解決

活用シーン

  1. 01不確実性の高い大規模プロジェクトの計画
  2. 02複数セッションにわたる決定事項の整理
  3. 03未解決の質問間にある依存関係の把握
  4. 04完了した計画のプロジェクト仕様策定への引き継ぎ

インストール

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

$npx skills add https://github.com/light-cheng/skills --skill decision-map

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

ATTRIBUTION.md
agents/
openai.yaml
references/
EXAMPLES.md
MAP-CONTRACT.md
WORKFLOW.md
tests/
test_decision_map_contract.py

詳細

Decision Map

decision-map は、曖昧で大規模な作業や、複数のセッションにまたがる作業のための、ユーザーが明示的に呼び出す計画段階です。明示的な $decision-map のリクエストを受けた後にのみ実行してください。ローカルの Markdown トラッカー上に永続的な意思決定マップを作成し、1 セッションにつき 1 件のチケットを解決します。

docs/agents/light-project.md が存在する場合は、課題トラッカーと作業領域のフィールドのみを読み、参照先のトラッカー規約を使用してください。ブートストラップ設定がない場合は、以下のローカル .scratch 規約を維持し、引き継ぎ時にそのデフォルトを報告してください。

Core model

.scratch/<effort>/map.md              ← canonical map
.scratch/<effort>/issues/NN-<slug>.md ← child decision tickets
  • マップ： Destination、Notes、Decisions so far、Not yet specified、Out of scope。
  • チケット： Type、Status、Blocked by を持つ、1 つの意思決定規模の質問。

正確な形式とトラッカーの操作については、 MAP-CONTRACT.md を参照してください。

Execution

  • 作成： 目的地を定め、最前線／不明点の範囲を幅優先で洗い出し、マップと仕様化可能なチケットを作成し、ブロック関係を設定し、light-research チケットを並列で実行して、終了します。
  • 作業： マップを読み込み、選択した最前線のチケットに着手し、そのチケットの能力を使って解決し、## Answer を追記してマップを更新したら、1 セッションにつき 1 件のチケットで終了します（作成時に並列で実行する light-research は例外です）。

完全なモード手順は WORKFLOW.md に、例は EXAMPLES.md にあります。

Composition

チケットは、担当する能力（light-research、light-prototype、人間の意思決定には socratic、別の人への質問票には light-to-questionnaire）を使って解決してください。1 セッションで解決する非リサーチチケットは最大 1 件です。

Handoff

未完了のチケットがゼロで、不明点がなくなり、残りの範囲が Out of scope に含まれている場合は、明示的な $project-spec を推奨して終了してください。

decision-map → project-spec

コメント

Markdown 対応