# アーキテクチャレビューガイド

## 対象範囲
このチェックリストは本リポジトリ（WordPress プラグイン `pochipp`）向けです。  
まず差分ファイルを重点的に確認し、その後に横断影響を確認します。

## 構成の基準
- エントリーポイント: `pochipp.php`
- 実行時PHPロジック: `inc/`
- 共通クラス/トレイト: `class/`
- エディタ/UIソース: `src/`（`blocks`/`js`/`scss`/`toolbar`）
- ビルド成果物: `dist/`, `assets/`

## レビューチェックリスト
1. 責務分離が維持されている
- 業務ロジック・データ処理は PHP（`inc/`, `class/`）に寄せる
- エディタ専用処理は `src/` に閉じる
2. WordPress セキュリティの基本が守られている
- PHPファイルに `ABSPATH` ガードがある
- AJAX/管理操作で nonce・権限チェックがある
- 入力サニタイズと出力エスケープの責務が適切
3. 後方互換性が維持されている
- 既存の meta/option キー、hook 名、block 属性を破壊しない
- 返却データ形式の変更は利用側まで反映されている
4. データフローが一貫している
- AJAXハンドラの成功/失敗レスポンス構造が安定している
- block 属性更新が意図的に行われている
5. 変更範囲に応じた品質チェックが通っている

## 検証コマンド
```bash
npm run build
npm run fix
./vendor/bin/phpcs --standard=phpcs.xml
```

## レビュー結果テンプレート
- 指摘サマリ
- 必須修正（blocking）
- 改善提案（non-blocking）
- 実行コマンドと手動確認結果
- リスクとロールバック方針