krypton-planning について
Krypton Planning は、依頼を目標計画パッケージにまとめるエージェントスキルです。コーディング前に目標、担当範囲、境界、受け入れ条件を定めたいチーム向けで、アーキテクチャの範囲と切り替え経路を整理してタスク化します。
主な機能
- 01目標、現状、期待結果の定義
- 02事実の担当者と契約境界の明確化
- 03対象ファイルと読み書き経路の整理
- 04PLAN.md、GOAL.md、EVIDENCE.md の作成
- 05タスク分割と計画レビュー
活用シーン
- 01曖昧な依頼を実行可能な計画に変換
- 02旧動作の置き換えに伴う切り替えと終了条件の計画
- 03検証コマンドと受け入れ証拠の指定
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/krypton-planningを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yamlplan-reviewer-prompt.md
詳細
Krypton Planning
Krypton Planning は、誰かがコードを書く前に、成果、真実の責任者、契約、切り替え、受け入れの証拠を明示したゴールパッケージにリクエストを変換します。
基本ルール
タスクリストを計画として扱ってはいけません。次の問いに答えられる場合にのみ、Krypton の計画は完成です。
What outcome are we serving?
What current behavior is being replaced, redirected, deleted, or demoted?
Who owns the truth?
What contract crosses the boundary?
What is the smallest high-value slice?
What proves the result from the target person's perspective?
What kill criteria stop duplicate paths from living forever?
責任者、切り替え、契約、または証拠が曖昧な場合は、計画を立てる前に作業を止め、マッピングしてください。
ワークフロー
- 成果契約を記述します。
Plan title:
Intent:
Current behavior:
Expected outcome:
Target-perspective output:
Truth owner:
Contract boundary:
Cutover:
Displaced path:
Value density:
Evidence gate:
Acceptance evidence:
Evidence lane:
Kill criteria:
Non-goals:
Risk if wrong:
- タスクに取りかかる前に、アーキテクチャの対象範囲をマッピングします。
Files to create:
Files to modify:
Files to avoid:
Source of truth:
Read path:
Write path:
Contract boundary:
Integration points:
Migration/cutover:
Displaced path:
Acceptance evidence gate:
リポジトリの範囲が広い場合や不明確な場合は、ハーネスがエージェントに対応していれば、読み取り専用の調査担当を割り当てます。「信頼できる情報源、読み書きの経路、安全でないファイル、証拠のゲートをマッピングする」など、範囲を限定した質問を1つします。実行セッションでは、同じ対象範囲を再調査するのではなく、このマップを使用してください。
- ユーザーが別の場所を指定しない限り、ゴールパッケージを保存します。
docs/goals/<goal-slug>/PLAN.md
docs/goals/<goal-slug>/GOAL.md
docs/goals/<goal-slug>/EVIDENCE.md
PLAN.md には計画全体を記載します。GOAL.md は、計画を複製するのではなく計画を参照する、短い実行プロンプトです。EVIDENCE.md は空の状態で作成し、実行中に、対象の視点から取得した実際の証拠を記入します。
PLAN.mdは次の形式のヘッダーで始めます。
# [Outcome Title] Implementation Plan
**Intent:** ...
**Current Behavior:** ...
**Expected Outcome:** ...
**Target-Perspective Output:** ...
**Truth Owner:** ...
**Contract Boundary:** ...
**Cutover:** ...
**Displaced Path:** ...
**Value Density:** ...
**Evidence Gate:** ...
**Acceptance Evidence:** ...
**Evidence Lane:** ...
**Kill Criteria:** ...
**Architecture Slice:** ...
**Plan Review Gate:** Requires PRE review before execution.
-
作業を小さなタスクに分割します。各タスクには、対象となる正確なファイル、許可された範囲、期待される出力、検証コマンド、受け入れの証拠、および並行して実行できるかどうかを明記します。
-
可能であれば、PRE 計画レビューを実施します。個別のプロンプトテンプレートとして
plan-reviewer-prompt.mdを使用します。阻害要因となる指摘を修正するか、ユーザーが明示的に受け入れるまでは、実行しないでください。
GOAL.md の形式
次の簡潔な引き継ぎ形式を使用します。これは、担当者が Codex または Claude に貼り付ける /goal プロンプト、または次のセッション用のプロンプトです。
# Goal: [Outcome Title]
Use Krypton Execution to execute `docs/goals/<goal-slug>/PLAN.md`.
Core rules:
- Treat PLAN.md as the source plan.
- Preserve intent, ownership, contract, cutover, evidence, and kill criteria.
- Do not add a new dominant path without deleting, redirecting, demoting, or shimming the displaced path.
- Capture acceptance evidence from the target perspective and record it in EVIDENCE.md.
- Say "implemented but unproven" if that evidence cannot be captured.
EVIDENCE.md の形式
ゴールパッケージとともにこのファイルを作成し、実行中に更新します。
# [Outcome Title] Evidence
## Acceptance Evidence
Record the real artifact that proves the outcome from the target perspective.
## Verification
Record the focused check that passed, including the command and relevant output.
## Review Notes
Record reviewer, maintainer, or verifier findings that changed the result.