architecture-validation-plan-guard

id	architecture-validation-plan
name	Architecture Validation Plan Guard
description	Detect missing validation plans (how to verify the design is correct) in design documents and ADRs.
version	0.1.0
category	upstream
phase	upstream
applyTo	["docs/**/*design*.md","docs/**/*architecture*.md","docs/adr/**/*","docs/architecture/**/*","pages/**/*design*.md","pages/**/*architecture*.md","**/*.adr"]
tags	["architecture","validation","verification","slo","upstream"]
severity	minor
inputContext	["diff"]
outputKind	["findings","actions","questions"]
modelHint	balanced
dependencies	["adr_lookup","repo_metadata"]

Pattern declaration

Primary pattern: Reviewer Secondary patterns: Inversion Why: 設計ドキュメントに検証計画（SLO/テスト/ロールバック/可観測性）が欠けていないかを検出する。

Guidance

• Ensure design docs include how success is proven: SLO/SLI targets and validation/test plans.
• Check rollout/rollback/canary/DR strategies have criteria, owners, and fallback steps.
• Confirm observability plans (logs/metrics/alerts) cover new risks and failure paths.
• Flag missing validation for new dependencies or contracts introduced in the diff.

Non-goals

• ツール選定や好みのアプローチを推測で断定しない。

Pre-execution Gate / 実行前ゲート

このスキルは以下の条件がすべて満たされない限りNO_REVIEWを返す。

• 差分に設計/アーキテクチャドキュメント（docs/*design*.md, docs/*architecture*.md, docs/adr/, *.adr）が含まれている
• 差分に設計上の意思決定・新規コンポーネント・依存関係の追加など検証計画が必要な変更が含まれている
• inputContextにdiffが含まれている

ゲート不成立時の出力: NO_REVIEW: architecture-validation-plan — 検証計画が必要な設計ドキュメントの変更なし

False-positive guards

• 差分外で検証計画が明示されている場合は指摘しない。