# dev-docs-ssot スターターキット

工程別ドキュメント運用ガイド（`dev_docs_guide`）に対応する、**そのままリポジトリにコピーして使える**正本テンプレート一式です。

## 導入手順（15分）

1. 本フォルダをプロジェクトルートへコピー（または `starter_kit/*` をマージ）
2. `AGENTS.md` の **Commands** をプロジェクトのビルドコマンドに合わせて編集
3. `docs/requirements/REQ-TEMPLATE.md` を複製し `REQ-001` から起票
4. `reference/baseline-open-items.md` に未決を集約（推測で仕様確定しない）
5. Cursor: `.cursor/rules/` を有効化。Codex/Cursor スキルは `.agents/skills/` を参照
6. 週次: `python scripts/scan_ambiguous_words.py docs/requirements reference`
7. ゲート前: `$dev-docs-gate-lite` または `$requirements-definition-gate`
8. PR前: `$doc-pr-gate` · テスト前: `$test-traceability-gate`
9. REQ 更新後: `knowledge/` 索引を `tools/extract_knowledge_from_markdown.md` に従い更新
10. AI利用PoC: `docs/templates/AI-OPS-LOG-TEMPLATE.md` を週次レビューに使用

## ディレクトリ

| パス | 用途 |
| --- | --- |
| `AGENTS.md` | エージェント入口（Commands / Rules / Done） |
| `docs/sop/engineering.md` | PR・レビュー・AI投入・週次PM |
| `docs/design/DESIGN.md` | UI案件のみ（フロント） |
| `docs/requirements/` | REQ 正本 |
| `docs/adr/` | 意思決定記録 |
| `docs/testing/` | TestDesignDoc |
| `docs/runbooks/` | 障害手順 |
| `docs/templates/AI-OPS-LOG-TEMPLATE.md` | Human Gate理由と改善還流の最小ログ |
| `reference/` | 合意索引・未決・用語 |
| `openapi/` | API 契約（分割YAML） |
| `knowledge/` | **構造化索引**（REQ/未決/トレーサ — Markdown 正本の索引） |
| `schemas/` · `tools/` · `reports/` | 索引スキーマ・抽出手順・レビューレポート |
| `.agents/skills/` | ゲート・drift・PR・トレーサ（本格＋軽量） |
| `.cursor/rules/` | Cursor 常時ルール |
| `scripts/` | 曖昧語スキャン・トレーサビリティ |

## ガイド本編

HTML: 同梱 `../index.html`

## ライセンス

社内プロジェクト向けテンプレート。当事者識別情報・接続情報をサンプルに書かないこと。