map-observable-boundaries
Installation
SKILL.md
観測可能な境界を台帳化する
手順
- 変更要求、対象コード、既存テスト、運用資料を収集する。
- 変更が外部へ見せる入口、出力、永続状態、副作用、失敗、依存、所有者を抽出する。
assets/boundary-ledger-template.mdを複製し、CHG-*とBND-*の安定ID、各項目に根拠とobserved、inferred、unknownのいずれかを記録する。- 入口と出力の組ごとに、成功時、失敗時、再試行時、部分成功時の振る舞いを記録する。
- 外部副作用、データ正本、認可境界、または rollback 方針を扱う変更なら、
references/stop-rules.mdを読んで停止条件を適用する。停止条件を満たす場合は、実装案を出さずblockedと不足情報を記録する。 - 完成した台帳を
scripts/validate-boundary-ledger.py <台帳ファイル>で検査する。検査失敗時は stderr の不足項目を補完するか、根拠不在ならunknownとして停止する。 - 台帳から、変更可能な範囲、不明な範囲、次の調査または確認依頼を簡潔に出力する。
出力規約
- 観測した事実、推論、未確認事項を混在させない。
- 推論で外部契約、データ正本、権限、rollback を埋めない。
- 「安全」「完了」「影響なし」は、根拠欄と検証結果なしに記録しない。