# AGENTS.md — プロジェクト入口

> 薄く保つ。手順は `docs/sop/`、UI は `docs/design/DESIGN.md`、ワークフローは `.agents/skills/`。

## Commands

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

## Rules — 読む順

1. `reference/baseline-agreements.md` — 合意済み / 未決の索引
2. `reference/baseline-open-items.md` — 確認待ち（仕様確定に使わない）
3. 作業対象の `docs/requirements/REQ-xxx.md` **のみ**（全要件一括投入しない）
4. API 作業時: `openapi/root.yaml`（bundle 後）の該当 path のみ
5. 設計判断: `docs/adr/`
6. 手順: `docs/sop/engineering.md` · `docs/sop/ai-usage.md` · `docs/sop/weekly-pm.md`
7. フロント作業: `docs/design/DESIGN.md`
8. ゲート: `.agents/skills/dev-docs-gate-lite/SKILL.md`
9. 索引: `knowledge/README.md` — REQ 更新時に YAML 索引を同期（推測で `confirmed` にしない）

## Rules — 正本

| 種別 | 正本パス |
| --- | --- |
| 要件 | `docs/requirements/REQ-*.md` |
| API | `openapi/**/*.yaml` |
| 意思決定 | `docs/adr/ADR-*.md` |
| テスト観点 | `docs/testing/TestDesignDoc-*.md` |
| 運用 | `docs/runbooks/RUNBOOK-*.md` |
| 合意索引 | `reference/baseline-agreements.md` |
| 未決 | `reference/baseline-open-items.md` |
| 構造化索引 | `knowledge/*.yaml`（Markdown 正本の索引。正本の代替ではない） |

レビュー用 HTML / PDF は **生成物**。正本は常に Git 上の Markdown / OpenAPI。

## Rules — PR

- 仕様変更は **REQ / OpenAPI / ADR / TestDesignDoc** を同じ PR に同梱
- `open-items` 未解消項目を確定仕様として実装しない
- 破壊的 API 変更は ADR または PR 説明に影響範囲を明記

## NEVER

- 当事者識別情報・契約条件・接続情報・秘密鍵をコミット・プロンプト投入しない
- 個人情報・勤怠・評価をエージェントに渡さない
- `UNRESOLVED` / open-items を依頼者側確認なしに `CONFIRMED` にしない
- 仕様と無関係な大規模リファクタを要件 PR に混ぜない

## Done（マージ条件）

- [ ] `npm test` / `npm run lint` が通る（Commands をプロジェクトに合わせる）
- [ ] 関連 REQ-ID の docs 更新済み
- [ ] OpenAPI 変更時は bundle / 型生成物の整合
- [ ] テスト追加または TestDesignDoc / traceability 更新
- [ ] 別モデルレビュー（可能なら）: 実装者≠レビュアー

## スキル呼び出し

| スキル | 用途 |
| --- | --- |
| `dev-docs-gate-lite` | 軽量要件ゲート・着手判定 |
| `requirements-definition-gate` | 本格要件ゲート（MODE A–D） |
| `requirements-semantic-drift-audit` | 版間・資料間の意味逸脱 |
| `semantic-drift-lite` | 軽量 drift チェック |
| `doc-pr-gate` | PR docs 同梱チェック |
| `test-traceability-gate` | トレーサビリティ検証 |

## セッション境界

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