品質ゲート — 合格基準と自己評価 ​

Layer 1: 機械的合格基準（必須） ​

bash
node scripts/verify-agent-docs.js
npm run docs:build
# 記事変更時は追加で
npm run lint:prose -- doc/blog/...

npm run check は verify-agent-docs + docs:build を一括実行します。

チェック内容
verify-agent-docs.jsAGENTS.md 正本・ラッパー整合
lint-prose.jsAI 表現（現状 WARN のみ・exit 0）
validate-contentカテゴリ・タグ整合
VitePress ビルド内部リンク切れ検知

Layer 2: エージェント自己評価 ​

記事変更時 ​

  • [ ] フロントマターが正しい
  • [ ] カテゴリページへのリンクを更新した
  • [ ] blog-writing.md の AI 表現チェック

scripts / 基盤変更時 ​

  • [ ] code-review.md のチェックリスト
  • [ ] WF 変更時は paths フィルタ漏れなし

パス別レビュー（ai-review） ​

変更パス参照ガイド
doc/blog/**blog-writing.md + lint-prose
scripts/**, .vitepress/**, workflowscode-review.md
AGENTS.md, doc/agent/**verify-agent-docs

AI 表現クイックチェック ​

  • [ ] 文末コロン（：）なし
  • [ ] 「これにより」「本質的」「書籍レベル」なし
  • [ ] 太字の乱用なし

CI 構成 ​

ワークフロートリガー内容
pr-check.ymlPRverify-agent-docs + lint:prose + docs:build
deploy.ymlpush main/developdocs:build + Pages デプロイ
claude-pr-automation.ymlPR ai-reviewレビュー修正 + 最終 docs:build

ai-review 自己評価ループ ​

  1. AGENTS.md とこのファイルを参照
  2. 差分を最小限修正
  3. 各ラウンド後 CI が docs:build を実行
  4. 最大 3 ラウンド、差分なしで打ち切り