verify-changes

変更を検証する — コードが動作することを証明する

「コードが存在する」≠「コードが動作する」。このスキルでは、実行を通じて変更が検証されるようにします。

基本原則

❌ Verification by inspection:  "I can see the function exists, it should work"
❌ Verification by assumption:  "The types check out, so it's correct"
✅ Verification by execution:   "I ran it, here's the output, it works because [evidence]"

---

検証プロトコル

ステップ 1：変更内容を特定する

- Which files were modified?
- What behavior should be different now?
- What was the original bug/requirement?

ステップ 2：検証方法を決定する

変更の種類	検証方法
バグ修正	元のバグが発生する状況を再現する → バグが再発しないことを確認する
新機能	機能を実行する → 期待される出力を確認する
リファクタリング	既存のテストを実行する → 問題が発生していないことを確認する
API の変更	エンドポイントを呼び出す → レスポンスの形式を確認する
UI の変更	コンポーネントをレンダリングする → 表示結果を確認する
設定の変更	設定を読み込む → 値が適用されていることを確認する
ビルド／インフラ	ビルドコマンドを実行する → 成功を確認する

ステップ 3：検証を実行する

# For Node.js projects
npm run build          # Does it compile?
npm run test           # Do tests pass?
npm run dev            # Does it start?

# For specific files
node -e "require('./path/to/module'); console.log('✅ Loads correctly')"

# For API endpoints
curl http://localhost:3000/api/endpoint

# For scripts
python script.py --test

ステップ 4：証拠を報告する

## Verification Report

### What was changed
- [File list and summary]

### How it was verified
- [Exact commands run]

### Evidence
- Build: ✅ Compiled without errors
- Tests: ✅ 42/42 passing
- Runtime: ✅ Server starts, endpoint returns expected JSON
- Edge case: ✅ Empty input handled correctly

### Not yet verified
- [Anything that couldn't be tested automatically]

---

プロジェクトの種類別検証チェックリスト

Web アプリケーション

• npm run build — エラーなしでコンパイルされる
• npm run lint — リントエラーがない
• npm run test — すべてのテストに合格する
• 開発サーバーが正常に起動する
• 変更したページが正しくレンダリングされる
• ブラウザーのコンソールにエラーがない

API／バックエンド

• サーバーがエラーなしで起動する
• 変更したエンドポイントが正しく応答する
• エラーケースで適切なステータスコードが返される
• データベースクエリが正常に実行される

CLI／スクリプト

• スクリプトがエラーなしで実行される
• 期待される出力と実際の出力が一致する
• エラー処理が機能する（不正な入力をテストする）
• ヘルプ／使用方法のテキストが正しい

---

アンチパターン

アンチパターン	問題点	対処法
「動くはずです」	証拠がありません	実行して出力を示す
正常系だけを確認する	エッジケースにバグが潜んでいます	エラーケースもテストする
コンパイルの確認だけで済ませる	コンパイルできても正しいとは限りません	実行時の動作をテストする
「些細な」変更の検証を省略する	些細な変更が重大なバグを引き起こすことがあります	すべて検証する

---

他のスキルとの連携

使用後のスキル	検証方法
frontend-design → UI の変更	ブラウザーでレンダリングし、コンソールを確認する
backend-specialist → API の変更	curl でエンドポイントを呼び出し、レスポンスを確認する
database-design → スキーマの変更	マイグレーションを実行し、データをクエリする
testing-patterns → 新しいテスト	テストスイートを実行し、カバレッジを確認する