Verification Loop
6 段階検証フロー
Step 1: Build Check 🏗️
ビルドが成功することを確認。
pnpm build
# または
npm run buildチェック項目:
- コンパイルエラーなし
- バンドルサイズが適切
- 警告の確認
Step 2: Type Check 📝
TypeScript の型エラーがないことを確認。
pnpm typecheck
# または
npx tsc --noEmitチェック項目:
- 型エラーなし
- strict mode 準拠
- any 使用なし
Step 3: Lint Check 🔍
コーディング規約に準拠していることを確認。
pnpm lint
# 自動修正
pnpm lint --fixチェック項目:
- ESLint エラーなし
- 警告の確認と対応
- Prettier フォーマット
Step 4: Test Check ✅
すべてのテストがパスすることを確認。
pnpm test
# カバレッジ付き
pnpm test --coverageチェック項目:
- 全テストグリーン
- カバレッジ 80%以上
- 新機能のテストあり
Step 5: Security Check 🔒
セキュリティ脆弱性がないことを確認。
npm audit --audit-level=moderateチェック項目:
- 依存関係の脆弱性なし
- 機密情報のハードコードなし
- OWASP Top 10 準拠
Step 6: Diff Check 📊
変更が適切にコミットされていることを確認。
git diff --stat HEAD~1
git diff HEAD~1 --name-onlyチェック項目:
- 未コミットの変更なし
- 適切なコミットメッセージ
- 不要なファイルの除外
証拠ベース完了判定（Iron Law）
検証コマンドを実行せずに「パス」を宣言することは許されない。
各ステップの判定には、同一ターン内でコマンドを実行した出力が必須。過去の実行結果、キャッシュされた結果、「通るはず」という推測は証拠として認めない。
| 主張 | 必要な証拠 | 証拠にならないもの |
|---|---|---|
| 「ビルド成功」 | 同一ターンの pnpm build 出力（exit code 0） | 「ビルドに影響する変更はしていない」 |
| 「型エラーなし」 | 同一ターンの pnpm typecheck 出力 | 「型を修正したので大丈夫」 |
| 「lintパス」 | 同一ターンの pnpm lint 出力 | 「前回通った」 |
| 「テスト全パス」 | 同一ターンのテスト実行出力（0 failures） | 「変更していないから通る」「should pass」 |
| 「脆弱性なし」 | 同一ターンの npm audit 出力 | 「依存は変更していない」 |
Red Flags: レポート内に以下の表現があればルール違反:
- 「〜のはず」「おそらく通る」「前回パスしている」「変更していないので影響なし」
- 実行出力を伴わない ✅ 判定
検証結果フォーマット
【6 段階検証結果】
✅ Step 1: Build - パス
✅ Step 2: Type - パス
⚠️ Step 3: Lint - 警告 3 件
✅ Step 4: Test - パス（カバレッジ: 85%）
✅ Step 5: Security - パス
✅ Step 6: Diff - 変更 5 ファイル
【アクション必要】
- lint 警告を修正: `pnpm lint --fix`CI/CD 統合
# GitHub Actions 例
jobs:
verify:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- run: pnpm install
- run: pnpm build
- run: pnpm typecheck
- run: pnpm lint
- run: pnpm test --coverage
- run: npm audit --audit-level=moderate