# Implementation Plan: [FEATURE] **Branch**: `[###-feature-name]` | **Date**: [DATE] | **Spec**: [link] **Input**: Feature specification from `/specs/[###-feature-name]/spec.md` **Note**: This template is filled in by the `/speckit.plan` command. See `.specify/templates/plan-template.md` for the execution workflow. ## Summary [Extract from feature spec: primary requirement + target documents + intended update approach] ## Technical Context **Primary Work Product**: [e.g., Markdown design docs, management docs, link/index governance or NEEDS CLARIFICATION] **Source of Truth Documents**: [List the authoritative docs that this change must align with] **Reference Sources**: [Archive/guides/other references allowed for verification] **Validation Commands**: [e.g., make validate-file FILE=..., make check-links, make validate-mermaid] **Target Scope**: [e.g., specific chapters, specific main docs, cross-doc governance] **Project Type**: 文档治理仓库 **Constraints**: [e.g., no new parallel formal docs, no invented business rules, relative links only] **Scale/Scope**: [e.g., single document / cross-document / structural governance] ## Constitution Check *GATE: Must pass before Phase 0 research. Re-check after Phase 1 design.* - [ ] **主文档归属已确认**:本次改动将优先落在既有主文档或治理文档,而不是新增平行正式稿。 - [ ] **范围基线已确认**:若涉及新增功能、模块、接口或外部协同,已按 `03_Summary_Design.md` 与 Archive 范围基线交集完成判定。 - [ ] **Archive 使用方式合规**:Archive 仅作为来源/核对输入,不直接替代正式口径。 - [ ] **一致性影响已列出**:已识别系统名称、数据库口径、编号、图表、链接、术语等受影响项。 - [ ] **校验与台账动作已规划**:已明确需要执行的校验命令,以及是否需要更新 `01_Project_Progress.md` / `03_Task_Checklist.md`。 ## Project Structure ### Documentation (this feature) ```text specs/[###-feature]/ ├── plan.md # This file (/speckit.plan command output) ├── research.md # Phase 0 output (/speckit.plan command) ├── data-model.md # Optional: document entities/traceability objects ├── quickstart.md # Optional: validation or review quickstart ├── contracts/ # Optional: interface or section-level artifacts └── tasks.md # Phase 2 output (/speckit.tasks command) ``` ### Repository Touchpoints ```text docs/design/ ├── 00_Management/ ├── 01_Overview/ ├── 02_Detailed_Design/ ├── 03_Technical_Design/ └── 04_Appendix/Archive/ README.md AGENTS.md .specify/templates/ ``` **Structure Decision**: [Document the exact files to be updated and the reason each file is in scope] ## Complexity Tracking > **Fill ONLY if Constitution Check has violations that must be justified** | Violation | Why Needed | Simpler Alternative Rejected Because | |-----------|------------|-------------------------------------| | [e.g., temporary appendix doc] | [current need] | [why existing main doc could not safely absorb it] | | [e.g., Archive citation exception] | [specific traceability reason] | [why normal main-doc source was insufficient] |