# AGENTS.md — AI品質安定化（副操縦士運用）

> 本ファイルは **bonus_kit** 同梱。AIは代替ではなく**品質ゲートの副操縦士**（調査第1章）。判断の正本は人間 + 第12章 KPI + 第13章ガバナンス。

## Commands

```bash
# プロジェクトに合わせて書き換える
npm ci
npm test
npm run lint
```

## 読む順（セッション開始）

1. `reference/poc-theme-register.md` — 今の PoC テーマと KPI
2. `reference/baseline-open-items.md` — 未決（仕様確定に使わない）
3. 作業対象の資料 **1件のみ**（REQ・設計・PR diff 等。一括投入しない）
4. `docs/sop/ai-usage.md` · `docs/sop/poc-governance.md`
5. 該当スキル: `.agents/skills/<name>/SKILL.md`

## 役割分担（推奨）

| 作業 | 役割 | 例 |
| --- | --- | --- |
| 実装・修正案 | メインエンジン | Claude Code |
| PR / 設計の一次監査 | **別モデル** | Codex adversarial-review 等 |
| 俯瞰・差分確認 | コックピット | Cursor |
| 軽い質問 | 高速工具 | Composer（長セッションを汚さない） |

実装者と同じモデルに「これでいい？」と聞かない（第6章）。

## NEVER

- 仕様不明点を AI に勝手に補完させる（第1章・第4章）
- open-items / `UNRESOLVED` を確定仕様として実装する
- 当事者識別情報・契約・接続情報・秘密鍵・個人情報をプロンプト投入
- AI 出力を無審査で本番・顧客提出物にする
- 効果測定（KPI）なしにスキル・ツールを全社展開する

## PR / レビュー Done

- [ ] テスト・lint 通過
- [ ] `.github/pull_request_template.md` の AI 利用欄を記入
- [ ] 別モデル or 人間によるレビュー（業務仕様の最終判断は人間）
- [ ] AI 指摘の採否を説明できる

## スキル呼び出し

| 呼び出し | 用途 |
| --- | --- |
| `$ai-quality-pr-review` | PR 前セルフレビュー・敵対的チェック |
| `$ai-poc-weekly-kpi` | 週次 KPI・中止条件（第19章 19.5b） |
| `$dev-docs-gate-lite` | 軽量要件ゲート |
| `$requirements-definition-gate` | 本格要件ゲート |
| `$semantic-drift-lite` / `$requirements-semantic-drift-audit` | 意味逸脱 |
| `$doc-pr-gate` | PR docs 同梱 |
| `$test-traceability-gate` | トレーサビリティ |

## 出力先

| 種別 | パス |
| --- | --- |
| ゲート結果 | `output/gate/` |
| drift 監査 | `output/drift/` |
| 週次 KPI | `output/poc-kpi/` |
| AI 利用ログ | `docs/templates/AI_USAGE_LOG.md` を複製して記録 |

## セッション境界

`AGENTS.md`・スキル・`.cursor/rules` 更新後は **新チャット推奨**。