# SOP: エンジニアリング運用

## 1. ブランチ・PR

- ブランチ名: `feat/REQ-xxx-short-desc` または `fix/REQ-xxx`
- PR タイトルに REQ-ID を含める
- `.github/pull_request_template.md` を埋める

## 2. レビュー（3段ゲート）

| Tier | 種別 | 実施 |
| --- | --- | --- |
| 1 | 決定的 | CI: lint / test / openapi-diff |
| 2 | 確率的 | AI レビュー（実装者≠レビュアー。Codex adversarial 等） |
| 3 | 人間 | スコープ・依頼者側合意・ゲート判定 |

**食い違いルール**: 実装 AI とレビュー AI の意見が割れた箇所だけ人が判断する。

## 3. エージェントへのコンテキスト

```
1. AGENTS.md
2. docs/requirements/REQ-xxx.md（対象1件のみ）
3. openapi/paths/xxx.yaml（API作業時のみ）
```

禁止: 全要件 zip、本番接続文字列、未マスクログ。

## 4. 情報分類（AI 投入）

| 分類 | 投入 |
| --- | --- |
| 公開情報 | 可 |
| 匿名化済み REQ-ID 仕様 | 条件付き可 |
| 当事者識別情報・契約・個人情報 | 不可 |
| 認証情報 | 禁止 |

## 5. 週次 PM（5項目）

1. `reference/baseline-open-items.md` 更新
2. `python scripts/scan_ambiguous_words.py docs/requirements reference`
3. 必要時のみレビュー用 HTML 差分共有
4. ゲート: 基本設計着手可否（`output/gate/08_gate-decision.md`）
5. 障害後: Runbook / ADR / TestDesignDoc 観点の反映確認

## 6. 変更時の同時更新

| イベント | 必須更新 |
| --- | --- |
| 要件変更 | REQ, open-items, レビュー用HTML生成元 |
| API変更 | OpenAPI, 型, テスト |
| 設計判断 | ADR, design |
| 障害 | runbook, CHANGELOG, 必要なら ADR |