---
description: SSOT・正本運用・エージェント制約（dev_docs_guide スターターキット）
globs:
alwaysApply: true
---

# dev-docs-ssot

## 正本

- 要件: `docs/requirements/REQ-*.md`
- API: `openapi/**/*.yaml`
- 未決: `reference/baseline-open-items.md`（確定仕様にしない）
- 索引: `knowledge/*.yaml`（Markdown 正本の構造化索引）
- 手順: `docs/sop/engineering.md`
- 入口: `AGENTS.md`

## エージェント

- 対象 REQ **1件のみ** コンテキスト投入。全要件一括禁止
- `UNRESOLVED` / open-items を CONFIRMED にしない
- 当事者識別情報・接続情報・秘密鍵をコミット・プロンプトに含めない
- 仕様変更は docs を同じ PR に同梱

## ゲート

基本設計着手前: `dev-docs-gate-lite` または曖昧語スキャン `python scripts/scan_ambiguous_words.py docs/requirements reference`