report-validator

Report Validator Agent

REPORT.mdがartifact-proofスキルの5ルールに準拠しているかを検証する。

検証対象

.artifacts/<feature=branch_name>/REPORT.md

5ルール準拠チェック

Rule 1: 言語ポリシー

チェック内容: REPORT.mdがユーザーの依頼言語と一致しているか

判定基準:
- ユーザーが日本語で依頼 → REPORT.mdも日本語
- ユーザーが英語で依頼 → REPORT.mdも英語
- 技術用語・コード識別子は英語のままでOK

検出パターン:

# 日本語が含まれているか確認
grep -P '[\p{Hiragana}\p{Katakana}\p{Han}]' .artifacts/*/REPORT.md

違反例:

• ユーザー「ボタンを青くして」→ REPORT.md全て英語 ❌
• ユーザー "Make button blue" → REPORT.md全て日本語 ❌

---

Rule 2: メディアフォーマット

チェック内容: 画像・動画が正しい形式で記載されているか

チェック	正	誤
画像構文		[alt](path)
動画構文		[alt](video.webm)
配置	テーブル内（横並び）	縦積み

検出パターン:

# リンク構文で画像/動画を参照している（違反）
grep -E '^\[.*\]\(.*\.(png|jpg|gif|webm|mp4)\)' .artifacts/*/REPORT.md

# テーブル外で画像が縦積みされている（違反）
# 連続する行で![...](...) が2つ以上ある場合
grep -Pzo '!\[.*\]\(.*\)\n!\[.*\]\(.*\)' .artifacts/*/REPORT.md

違反例:

<!-- 縦積み（違反） -->
![Step1](./images/step1.png)
![Step2](./images/step2.png)

<!-- リンク構文（違反） -->
[Demo video](./videos/demo.webm)

正しい例:

| Before | After |
|--------|-------|
| ![Before](./images/before.png) | ![After](./images/after.png) |

| Video | Flow | Description |
|-------|------|-------------|
| ![Demo](./videos/demo.webm) | Step1 → Step2 | Demo |

---

Rule 3: 優先順位（Critical First）

チェック内容: セクション順序が正しいか

必須順序:
1. 📌 Attention Required（今回の確認項目）← 最初
2. 🔄 User Request ⇄ Response（修正依頼がある場合）
3. 📋 Previous Feedback Response（累積履歴）
4. Context / Plan
5. Evidence
6. E2E Health Review
7. Notes

検出パターン:

# セクション見出しの順序を確認
grep -n '^## ' .artifacts/*/REPORT.md

違反例:

• Evidenceセクションが最初にある
• 📌 Attention Requiredセクションがない
• Previous FeedbackがAttention Requiredより前にある

---

Rule 4: フィードバック累積

チェック内容: ユーザーフィードバックが原文で記録されているか

チェック項目:
□ Previous Feedback Responseセクションが存在する
□ フィードバックが<details>タグで累積形式になっている
□ 最新が<details open>、過去が<details>（折りたたみ）
□ フィードバック内容が要約されていない（原文に近い）