sdd-verify-evidence-recorder

SDD Verify 証跡レコーダー

使用するタイミング

• チェックやアセスメント後に 05_verify/<request-folder>/ 配下文書を更新するとき。
• 12カテゴリで証跡フォーマットを統一したいとき。
• 具体リンク付きの追記専用検証記録を残したいとき。

使用しないタイミング

• 要件定義やアーキテクチャ設計をしているとき。
• 実際の検証結果や証跡がまだ存在しないとき。

必須入力

• カテゴリの verify パス（categories/<category>/05_verify/<request-folder>/）
• 対象文書（例: acceptance-criteria.md, assessment-sheet.md, gap-list.md）
• 証跡参照（コマンド出力、クエリ結果ファイル、ログ、スクリーンショット、レポートパス）

出力契約

以下の順序で必ず出力すること:

1. 検証記録サマリー
2. 追記内容（追記専用）
3. 証跡リンク一覧
4. 未充足項目

記録ルール

1. 再利用テンプレート + 実行追記:

• 固定テンプレートブロックは再利用可能な状態を維持する。
• 新規実行記録は日時と担当者つきで追記する。

2. 具体証跡必須:

• 証跡リンクまたはパスのない主張は記録しない。
• 各 Pass/Fail は最低1つの証跡項目に対応付ける。

3. ステータス固定:

• ステータスは Pass, Fail, Blocked, N/A のみを使用する。

4. Gap 連携:

• Failed 項目は gap-list.md のエントリに必ず紐付ける。

5. カテゴリ境界安全性:

• verify 成果物を同一カテゴリ外へ配置しない。

6. 受入動作検証の必須化（再発防止）:

• 実行可能成果物（Web UI / CLI / バッチ / スクリプト）がある場合、起動コマンドを実行した実ログを必ず記録する。
• Web UI の場合、初回アクセス（http://localhost:<port>）可否を確認し、確認結果を記録する。
• 未実行・未確認の項目は Pass を付けない（Blocked または Fail を使用）。
• 失敗した場合は、修正内容と再実行結果を同一セクションで追記する。

7. 実行記録の最小証跡セット:

• 実行コマンド
• 実行ディレクトリ
• 終了コード
• 主要出力（成功/失敗を判定できる行）
• 判定と根拠

手順

1. 既存の 05_verify/<request-folder>/* 対象文書を読む。
2. 明示的要求がない限り、再利用ヘッダと判定基準は変更しない。
3. 起動検証ログと（Web UIの場合）初回アクセス確認結果を取得する。
4. 新規実行ブロックのみを追記する。
5. 証跡リンクを追加し、ステータス項目へ対応付ける。
6. Fail/Blocked に対応する gap レコードを追加または更新する。

すぐ使えるプロンプト例

• 「カテゴリ01の verify に sdd-verify-evidence-recorder を実行して、今日の結果を追記して」
• 「カテゴリ08に証跡対応付きで検証記録を追記し、gapリンクも付けて」

実行ブロックテンプレート

## 実行記録 - YYYY-MM-DD HH:MM (JST)
- 担当者: <name>
- 対象範囲: <何を検証したか>
- 結果: Pass|Fail|Blocked|N/A

### チェック項目
- <check id>: <status>
- 証跡: <相対パスまたは参照>
- 補足: <短い根拠>

### フォローアップ
- Gap ID: <id or N/A>
- 次アクション: <担当者 + 期限>