practices: - id: PRAC-SSOT-001 title: Git 上 Markdown / OpenAPI を正本に集約 summary: Excel 版乱立をやめ、REQ-ID 付き MD と OpenAPI を正本とする。HTML はレビュー用生成物。 phase: cross_cutting status: confirmed confidence: high source_refs: - path: notes/01_要件定義.md section: 推奨モデル quote: HTMLを正本にしない related: chapters: [CH-DDG-OV, CH-DDG-01, CH-DDG-08] deliverables: [DEL-REQ-001, DEL-REQ-HTML-001] - id: PRAC-REQ-001 title: REQ-ID 付き Markdown 要件正本 summary: 要件は docs/requirements/REQ-*.md。用語は glossary 参照。Mermaid で分岐を記述。 phase: requirements status: confirmed confidence: high source_refs: - path: notes/01_要件定義.md section: 要件MDサンプル quote: REQ-042 受注キャンセル related: chapters: [CH-DDG-01] deliverables: [DEL-REQ-001] - id: PRAC-REQ-002 title: 社内 MD + レビュー用 HTML 二層 summary: 正本 MD から静的 HTML を生成し読み会で合意。証跡は合意ログに残す。 phase: requirements status: confirmed confidence: high source_refs: - path: notes/01_要件定義.md section: 推奨モデル quote: 経営・依頼者側向けには読みやすいHTMLを生成 related: chapters: [CH-DDG-01] deliverables: [DEL-REQ-HTML-001] - id: PRAC-ADR-001 title: 設計判断は ADR に記録 summary: 技術選択・破壊的変更は docs/adr/ に残し REQ/OpenAPI と同期。 phase: design status: confirmed confidence: high source_refs: - path: notes/08_マスタサマリー.md section: 変更時の同時更新マトリクス quote: 設計判断変更 → ADR, design.md related: chapters: [CH-DDG-02] deliverables: [DEL-ADR-001] - id: PRAC-API-001 title: OpenAPI 分割 YAML + bundle summary: paths/components を分割管理し CI で bundle・型生成の整合を取る。 phase: api status: confirmed confidence: high source_refs: - path: notes/03_API・OpenAPI.md section: "" quote: API 章 related: chapters: [CH-DDG-03] deliverables: [DEL-OAPI-001] - id: PRAC-AGENT-001 title: 薄い AGENTS.md + SOP + スキル summary: 手順は docs/sop/、ワークフローは .agents/skills/。REQ 1件のみコンテキスト投入。 phase: implementation status: confirmed confidence: high source_refs: - path: notes/08_マスタサマリー.md section: エージェント運用3原則 quote: タスク単位コンテキスト — 対象 REQ / path のみ related: chapters: [CH-DDG-04] deliverables: [DEL-AGENTS-001] - id: PRAC-AGENT-002 title: Agent-native CI/CD（プロンプト・スキル bundle の eval ゲート） summary: プロンプト・ツール定義・モデル版を bundle 化し、ゴールデンデータセット eval・コストゲート・カナリアで昇格。従来 CI に行動評価層を追加。 phase: cross_cutting status: confirmed confidence: medium source_refs: - path: notes/04_実装.md section: Agent-native CI/CD quote: ゴールデンデータセット eval ゲート - path: research/ai_phase_sources.json section: agent_native_cicd quote: five gates before production related: chapters: [CH-DDG-04, CH-DDG-05, CH-DDG-06] deliverables: [DEL-AGENTS-001] - id: PRAC-OPS-001 title: PMO AIPC — 社内ノウハウ蓄積 MCP Server（Hermes+Ollama） summary: セキュリティ担保エリア内の Hermes+Ollama MCP Server。Skill·手順·観点·プロンプト型·失敗パターンの蓄積地。開発PCは MCP Client のみ。開発PC直置き Hermes は非推奨。 phase: operations status: draft confidence: medium source_refs: - path: notes/06_運用.md section: PMO AIPC quote: 社内ノウハウ蓄積地 MCP Server - path: research/ai_phase_sources.json section: hermes_ollama quote: integrations/hermes related: chapters: [CH-DDG-04, CH-DDG-06, CH-DDG-10] deliverables: [] - id: PRAC-TEST-001 title: TestDesignDoc + traceability.csv summary: テスト観点正本と REQ-TC 対応表を Git 管理。ゲート前に validate。 phase: testing status: confirmed confidence: high source_refs: - path: notes/05_テスト・QA.md section: "" quote: テスト章 related: chapters: [CH-DDG-05] deliverables: [DEL-TEST-001, DEL-TRACE-001] - id: PRAC-PM-001 title: 週次 PM — open-items と drift チェック summary: 未決更新、drift チェック、ゲート判定を週次で実施。 phase: pm status: confirmed confidence: high source_refs: - path: notes/08_マスタサマリー.md section: 週次 PM チェックリスト quote: 未決事項を open-items から更新 related: chapters: [CH-DDG-07, CH-DDG-08] deliverables: [] - id: PRAC-CODE-QUALITY-001 title: コーディング品質 — SonarQube + Semgrep + CI品質ゲート summary: 静的解析・社内禁止ルール・品質ゲートをCIで強制。AIレビューは補助（すり抜けレベル2）。MCPは判定者ではなく接続口。 phase: implementation status: confirmed confidence: high source_refs: - path: notes/04_実装.md section: コーディング品質管理・規約チェック quote: SonarQube を品質ゲートの中心に related: chapters: [CH-DDG-04, CH-DDG-05] deliverables: [DEL-AGENTS-001] - id: PRAC-TICKET-LOOP-001 title: AIチケット起点開発ループ — 起票・品質確認・Handoff summary: 実装前にAI開発メニューで分岐。A/B/C/D判定、品質ゲート、Handoff圧縮。いきなり実装させない。 phase: implementation status: confirmed confidence: high source_refs: - path: research/ai_ticket_interview_dev_loop.md section: AI開発メニュー quote: チケット品質確認 → インタビュー → 計画 → Handoff - path: notes/04_実装.md section: AIチケット起点開発ループ quote: 実装可能性判定 A/B/C/D related: chapters: [CH-DDG-04] deliverables: [DEL-AGENTS-001] - id: PRAC-HERMES-MEMORY-001 title: 長期記憶 — Hermes 内蔵 vs 外部 Provider（Memanto 等は候補） summary: 人間承認済み文脈レジストリとして設計。記憶ランク A/B/C/D、Git 正本との責務分担、棚卸し。Memanto 採用は UNRESOLVED。 phase: operations status: draft confidence: medium source_refs: - path: research/hermes_memanto_memory_evaluation.md section: 結論 quote: 人間承認済み文脈レジストリ related: chapters: [CH-DDG-04, CH-DDG-10] deliverables: [] - id: PRAC-ANCHOR-001 title: 品質アンカー — ADR/REQで判断構造を固定（Gram Anchoring 的運用） summary: 長期AI作業で合意済み判断を見落とすリスクに対し、ADR Quality Anchor · Must Preserve · Drift Signals を参照するPoC仮説。5層（ルール·スキル·アンカー·評価·ログ）で有効性を検証する。 phase: cross-cutting status: draft confidence: medium source_refs: - path: research/quality_anchor_ai_ops.md section: 5層モデル quote: アンカーは個別の正解行ではなく対応関係を固定 - path: notes/02_基本設計・ADR.md section: 品質アンカー quote: ADR Quality Anchor related: chapters: [CH-DDG-02, CH-DDG-04, CH-DDG-07] deliverables: [DEL-ADR-001] - id: PRAC-AI-OPS-FEEDBACK-001 title: AI運用ログの週次レビューと改善還流 summary: Human Gateで止めた理由を最小4項目で記録し、週次でGit正本・ADR・rules・FAQ・承認ルールの改善候補へ戻す。集計自動化は分類安定後。 phase: operations status: draft confidence: medium source_refs: - path: notes/06_運用.md section: AI運用ログから正本へ改善を還流する quote: Human Gateで人間確認へ戻した理由を記録 - path: notes/07_PM・情報共有.md section: AI運用ログから正本へ改善を還流する quote: 週次レビュー related: chapters: [CH-DDG-06, CH-DDG-07, CH-DDG-08, CH-DDG-11] deliverables: [] - id: PRAC-QUALITY-SIGNALS-001 title: Quality Signals Loop summary: PR理由分類、CI hard gate、代表eval、週次KPI、重大時ポストモーテムを接続し、人の記録漏れだけに依存せず品質問題を検知する。 phase: cross-cutting status: draft confidence: high source_refs: - path: notes/11_Quality_Signals_Loop.md section: 最小構成 quote: PR理由分類 -> CI Gate -> 小さなeval related: chapters: [CH-DDG-04, CH-DDG-05, CH-DDG-06, CH-DDG-07, CH-DDG-11] deliverables: []