adr-skills

アーキテクチャ・仕様に関わる決定を ADR (Architecture Decision Record) として記録する。superpowers の design spec (docs/superpowers/specs/*-design.md) が書かれた直後、またはフレームワーク・ライブラリ・境界・プロトコル・データ構造の選定で代替案を伴う決定が確定した場面、または「ADR を書いて」と明示依頼された場面で発火する。バグ修正・リファクタリング・ドキュメント更新など決定を伴わない作業では発火しない。

ADR (Architecture Decision Record) の置き場を Sphinx プロジェクトに用意する。「ADR 管理を始めたい」「ADR を初期化」と依頼された場面で発火する。既存 Sphinx プロジェクトがあればその配下に ADR セクションを追加し、無ければ ADR 専用の Sphinx プロジェクトを新規生成する。