Karthick-Ramachandran/recall-os

スキル: ADRの作成

目的

将来の人間やエージェントがアーキテクチャ上の決定を再発見したり矛盾したりしないよう、耐久性のあるアーキテクチャ決定を記録します。

入力

• 決定トピック
• コンテキストと制約条件
• 検討した選択肢
• 推奨または選択された決定

必須参照資料

• docs/10-architecture/ARCHITECTURE.md
• docs/10-architecture/FILE_WRITE_POLICY.md
• docs/20-security/SECURITY_MODEL.md
• docs/adrs/ 内の既存ADR

出力ファイル

• docs/adrs/ADR-####-<slug>.md

プロセス

1. 変更にADRが必要かどうかを判断します。
2. 既存の番号を再利用せずに、次のADR番号を決定します。
3. コンテキスト、決定、代替案、結果、関連ドキュメントを記述します。
4. 人間が決定を承認していない限り、ステータスを Proposed に設定します。
5. 影響を受けるPRD、アーキテクチャドキュメント、機能ドキュメント、セキュリティドキュメントにリンクします。

停止条件

以下の場合、処理を停止し、人間の判断を仰ぎます：

• 決定がセキュリティポスチャ、ネットワーク動作、テレメトリ、ファイル書き込み、認証、シークレット、クラウド、またはランタイムMCPを変更する場合。
• 要求された決定が承認済みADRと矛盾する場合。
• 決定が実際にまだ行われておらず、提案として残すべき場合。

品質基準

• ADRは「何が変わったか」だけでなく、「なぜその決定が存在するか」を説明していること。
• 代替案と結果が正直に記述されていること。
• ステータスが明確であること。
• 関連ドキュメントがリンクされていること。