@guanlin4924/devflow-pi 0.1.0

package/plugins/devflow-core/skills/workflow-project-context/assets/agents-md-template.md

@@ -0,0 +1,25 @@
+# {{project_name}}
+
+## Getting Started
+
+Before any operation, read these files in order:
+
+1. `.planning/rules/INDEX.md` — project rule index (gate entry point)
+2. `.context/spec/index.md` — design and codebase specification entry
+{{#if codebase_count}}
+3. `.planning/navigation/INDEX.md` — codebase registry and navigation files
+4. `.planning/code-index/` — machine code facts generated by `workflow-code-index` during full initialization unless fast mode skipped it
+{{/if}}
+
+## Codebases
+
+This project has {{codebase_count}} codebase(s):
+{{#codebases}}
+- **{{name}}** ({{type}}): {{path}}
+{{/codebases}}
+
+## Key Directories
+
+- `.planning/` — workflow state, navigation, rules, execution contract
+- `.context/spec/` — design and codebase specifications (MUST/SHOULD/OBSERVED rules)
+- `.context/lessons/` — accumulated project experience and regression prevention

package/plugins/devflow-core/skills/workflow-project-context/assets/codebase-backend-spec-template.md

@@ -0,0 +1,68 @@
+# {{name}} Backend Codebase Specification
+
+This file describes project-instance rules for one backend/service codebase. Stack-level defaults are in `.context/spec/stacks/{{stack_key}}.md`.
+
+## Version
+
+- Generated at: {{generated_at}}
+- Codebase: `{{name}}`
+- Navigation: `.planning/navigation/{{name}}.md`
+- Stack spec: `.context/spec/stacks/{{stack_key}}.md`
+- Source manifests: {{manifest_sources}}
+- Dependency fingerprint: {{dependency_fingerprint}}
+- Regenerate when:
+  - A source manifest changes
+  - The framework major version changes
+  - A key library is added, removed, or replaced
+  - The codebase directory structure or call-chain structure changes materially
+
+## Identity
+
+| Field | Value |
+|-------|-------|
+| Root | {{root}} |
+| Type | {{type}} |
+| Role | {{role}} |
+| Stack key | {{stack_key}} |
+
+## Layer Model
+
+| Layer | Directory | Responsibility | Dependency Direction | Source |
+|-------|-----------|----------------|----------------------|--------|
+| {{layer}} | {{directory}} | {{responsibility}} | {{dependency_direction}} | {{source}} |
+
+## Entry Points And Interfaces
+
+{{entry_points_interfaces}}
+
+## Data Model And Conversion Rules
+
+{{data_model_conversion_rules}}
+
+## Auth, Permission, Errors, And Logging
+
+{{auth_permission_errors_logging}}
+
+## Persistence, Jobs, And Integrations
+
+{{persistence_jobs_integrations}}
+
+## Testing And Verification
+
+{{testing_verification}}
+
+## Explicit Rules
+
+Rules from `AGENTS.md`, `CLAUDE.md`, `.cursorrules`, existing `.context/spec/`, or equivalent files.
+
+- {{explicit_rule}}
+
+## Code-Inferred Conventions
+
+Conventions inferred from consistent code patterns. These are weaker than explicit rules.
+
+- {{inferred_rule}}
+
+## Pending Confirmation
+
+- {{pending_item}}

package/plugins/devflow-core/skills/workflow-project-context/assets/codebase-frontend-spec-template.md

@@ -0,0 +1,64 @@
+# {{name}} Frontend Codebase Specification
+
+This file describes project-instance rules for one frontend codebase. Stack-level defaults are in `.context/spec/stacks/{{stack_key}}.md`.
+
+## Version
+
+- Generated at: {{generated_at}}
+- Codebase: `{{name}}`
+- Navigation: `.planning/navigation/{{name}}.md`
+- Stack spec: `.context/spec/stacks/{{stack_key}}.md`
+- Source manifests: {{manifest_sources}}
+- Dependency fingerprint: {{dependency_fingerprint}}
+- Regenerate when:
+  - A source manifest changes
+  - The framework major version changes
+  - A key library is added, removed, or replaced
+  - The codebase directory structure or route/component graph changes materially
+
+## Identity
+
+| Field | Value |
+|-------|-------|
+| Root | {{root}} |
+| Type | {{type}} |
+| Role | {{role}} |
+| Stack key | {{stack_key}} |
+
+## Structure And Component Model
+
+| Layer | Directory | Responsibility | Source |
+|-------|-----------|----------------|--------|
+| {{layer}} | {{directory}} | {{responsibility}} | {{source}} |
+
+## Routes, Pages, And Data Flow
+
+{{routes_pages_data_flow}}
+
+## API Client, State, And Permission Rules
+
+{{api_state_permission_rules}}
+
+## UI, Forms, Tables, Dialogs, And Feedback
+
+{{ui_interaction_rules}}
+
+## Testing And Verification
+
+{{testing_verification}}
+
+## Explicit Rules
+
+Rules from `AGENTS.md`, `CLAUDE.md`, `.cursorrules`, existing `.context/spec/`, or equivalent files.
+
+- {{explicit_rule}}
+
+## Code-Inferred Conventions
+
+Conventions inferred from consistent code patterns. These are weaker than explicit rules.
+
+- {{inferred_rule}}
+
+## Pending Confirmation
+
+- {{pending_item}}

package/plugins/devflow-core/skills/workflow-project-context/assets/codebase-navigation-template.md

@@ -0,0 +1,168 @@
+# {{codebase_name}} Navigation
+
+## Identity
+
+| Field | Value |
+|-------|-------|
+| Name | {{codebase_name}} |
+| Root | {{codebase_root}} |
+| Type | {{codebase_type}} |
+| Role | {{codebase_role}} |
+| Location | {{codebase_location}} |
+| Scan Status | {{scan_status}} |
+
+## Stack
+
+| Item | Value | Notes |
+|------|-------|-------|
+| Framework | {{framework}} | {{framework_notes}} |
+| Runtime / Language | {{runtime}} | {{runtime_notes}} |
+| Package / Build Tool | {{build_tool}} | {{build_tool_notes}} |
+{{#is_frontend}}
+| UI Library | {{ui_library}} | {{ui_library_notes}} |
+| State Management | {{state_management}} | {{state_management_notes}} |
+| Request Library | {{request_library}} | {{request_library_notes}} |
+{{/is_frontend}}
+{{#is_backend}}
+| Database Access | {{database_access}} | {{database_access_notes}} |
+| API Style | {{api_style}} | {{api_style_notes}} |
+{{/is_backend}}
+
+## Application Entry Points
+
+| Item | Value | Notes |
+|------|-------|-------|
+| App Entry | {{app_entry}} | {{app_entry_notes}} |
+{{#is_frontend}}
+| Router | {{router}} | {{router_notes}} |
+| Pages / Views | {{pages}} | {{pages_notes}} |
+| Layouts | {{layouts}} | {{layouts_notes}} |
+| API Client | {{api_client}} | {{api_client_notes}} |
+| Auth / Permission | {{frontend_auth}} | {{frontend_auth_notes}} |
+| Styles / Theme | {{styles}} | {{styles_notes}} |
+| Env Config | {{frontend_env}} | {{frontend_env_notes}} |
+{{/is_frontend}}
+{{#is_backend}}
+| Routes / Controllers | {{routes}} | {{routes_notes}} |
+| Middleware / Filters | {{middleware}} | {{middleware_notes}} |
+| Auth / Permission | {{backend_auth}} | {{backend_auth_notes}} |
+| Env Config | {{backend_env}} | {{backend_env_notes}} |
+| API Docs | {{api_docs}} | {{api_docs_notes}} |
+{{/is_backend}}
+
+## Structure
+
+### Directory Map
+
+```
+{{directory_tree}}
+```
+
+| Directory | Purpose | Notes |
+|-----------|---------|-------|
+{{#directory_rows}}
+| `{{path}}` | {{purpose}} | {{notes}} |
+{{/directory_rows}}
+
+### Call Chain Map
+
+{{#is_backend}}
+#### API Modules
+
+| Route Group | Handler | Routes | Service → Repository → DAO |
+|-------------|---------|--------|---------------------------|
+{{#api_modules}}
+| {{route_group}} | {{handler_file}} | {{routes}} | {{call_chain}} |
+{{/api_modules}}
+
+#### Scheduled Jobs
+
+| Job | Cron | Trigger Type | Call Chain | Notes |
+|-----|------|-------------|------------|-------|
+{{#jobs}}
+| {{job_name}} | {{cron}} | {{trigger_type}} | {{call_chain}} | {{notes}} |
+{{/jobs}}
+
+#### External Integrations
+
+| Integration | Path | Direction | Notes |
+|-------------|------|-----------|-------|
+{{#integrations}}
+| {{name}} | {{path}} | {{direction}} | {{notes}} |
+{{/integrations}}
+{{/is_backend}}
+
+{{#is_frontend}}
+#### Route-Component Map
+
+| Route | Page Component | Child Components | Composables | API Calls |
+|-------|---------------|------------------|-------------|-----------|
+{{#route_component_rows}}
+| `{{route}}` | {{page_component}} | {{child_components}} | {{composables}} | {{api_calls}} |
+{{/route_component_rows}}
+
+#### Data Flow
+
+| Composable / Store | API Client | State Shape | Consumed By |
+|--------------------|-----------|-------------|-------------|
+{{#data_flow_rows}}
+| {{composable}} | {{api_client}} | {{state_shape}} | {{consumed_by}} |
+{{/data_flow_rows}}
+{{/is_frontend}}
+
+### Conventions
+
+{{#is_backend}}
+| Category | Rule | Source |
+|----------|------|--------|
+{{#backend_conventions}}
+| {{category}} | {{rule}} | {{source}} |
+{{/backend_conventions}}
+
+Convention categories: Layer order, Conversion (VO↔Domain↔Model), Interface/DI, Error handling, Naming, Swagger/API docs
+{{/is_backend}}
+
+{{#is_frontend}}
+| Category | Rule | Source |
+|----------|------|--------|
+{{#frontend_conventions}}
+| {{category}} | {{rule}} | {{source}} |
+{{/frontend_conventions}}
+
+Convention categories: Component hierarchy, Data flow (composable/store), Route naming, Style/theme, API client, State management
+{{/is_frontend}}
+
+## Commands
+
+| Type | Command | Source |
+|------|---------|--------|
+| Install | {{install_cmd}} | {{install_source}} |
+| Dev | {{dev_cmd}} | {{dev_source}} |
+| Build | {{build_cmd}} | {{build_source}} |
+| Test | {{test_cmd}} | {{test_source}} |
+| Lint | {{lint_cmd}} | {{lint_source}} |
+{{#codegen_cmds}}
+| {{codegen_name}} | {{codegen_cmd}} | {{codegen_source}} |
+{{/codegen_cmds}}
+
+## Rule Sources
+
+See `.planning/rules/INDEX.md` for the full project rule index. This codebase's relevant rule files:
+
+| Rule | Path | Status |
+|------|------|--------|
+{{#rule_sources}}
+| {{rule_name}} | {{rule_path}} | {{rule_status}} |
+{{/rule_sources}}
+
+## Requirement-Relevant Areas
+
+{{requirement_areas}}
+
+## Notes
+
+{{notes}}
+
+## Missing Information
+
+{{missing_information}}

package/plugins/devflow-core/skills/workflow-project-context/assets/context-domain-index-template.md

@@ -0,0 +1,43 @@
+# {{domain_title}} Spec Index
+
+Generated during project initialization.
+
+## Generation Metadata
+
+- Run ID: `{{run_id}}`
+- Generated at: {{generated_at}}
+- Regenerate when: navigation facts, topic discovery evidence, or depth spec paths change.
+
+## Specs
+
+| Name | Type | Stack Key | Spec | Navigation |
+|------|------|-----------|------|------------|
+| {{name}} | {{type}} | {{stack_key}} | {{spec_path}} | {{navigation_path}} |
+
+## Read Order
+
+1. `.planning/rules/INDEX.md`
+2. `.context/spec/index.md`
+3. Matching stack spec
+4. Matching codebase spec
+5. Applicable depth specs from the registry below
+6. Matching navigation file
+7. `.planning/code-index/` machine symbols/relations for source-level relation facts; if fast mode skipped generation, refresh through `workflow-code-index` or record fallback
+8. Actual source files selected from navigation/spec/code-index evidence
+
+## Depth Spec Registry
+
+| Codebase | Topic | Status | Spec |
+|----------|-------|--------|------|
+| {{codebase_name}} | {{topic}} | {{present_or_not_applicable}} | {{depth_spec_path_or_none}} |
+
+{{depth_spec_markers}}
+
+## Pending Templates
+
+Record discovered topics whose matching depth spec template is missing as `PENDING_TEMPLATE`.
+Mirror the same blocker in `.planning/STATE.md` front matter.
+
+## Pending Confirmation
+
+- {{pending_item}}

package/plugins/devflow-core/skills/workflow-project-context/assets/context-spec-index-template.md

@@ -0,0 +1,45 @@
+# Context Spec Index
+
+Generated during project initialization. This file is a registry and read-order contract for project technical specifications.
+
+## Version
+
+- Generated at: {{generated_at}}
+- Regenerate when: any codebase manifest changes, a framework major version changes, key libraries change, or navigation/call-chain structure changes materially.
+
+## Read Order
+
+Downstream skills must read rule sources in this order:
+
+1. `.planning/rules/INDEX.md`
+2. `.context/spec/index.md`
+3. Matching `.context/spec/stacks/{stack_key}.md`
+4. Matching `.context/spec/frontend|backend/{codebase}.md`
+5. Matching `.context/spec/{domain}/index.md` and applicable depth specs
+6. `.planning/navigation/{codebase}.md`
+7. `.planning/code-index/` machine symbols/relations for source-level relation facts; if fast mode skipped generation, refresh through `workflow-code-index` or record fallback
+8. Actual source files
+
+Priority when rules conflict:
+
+1. User-explicit requirement
+2. Explicit project rules (`AGENTS.md`, `CLAUDE.md`, `.cursorrules`, existing `.context/spec/`)
+3. Codebase spec
+4. Stack spec
+5. Code-inferred convention
+
+## Stack Specs
+
+| Stack Key | Spec | Codebases | Manifest Sources | Fingerprint |
+|-----------|------|-----------|------------------|-------------|
+| {{stack_key}} | `.context/spec/stacks/{{stack_key}}.md` | {{codebases}} | {{manifest_sources}} | {{fingerprint}} |
+
+## Codebase Specs
+
+| Codebase | Type | Navigation | Stack Key | Spec |
+|----------|------|------------|-----------|------|
+| {{name}} | {{type}} | `.planning/navigation/{{name}}.md` | {{stack_key}} | `.context/spec/{{domain}}/{{name}}.md` |
+
+## Missing Or Pending
+
+- {{pending_item}}

package/plugins/devflow-core/skills/workflow-project-context/assets/execution-contract-template.md

@@ -0,0 +1,57 @@
+# Execution Contract
+
+## Layer Model
+
+Each codebase has its own layer conventions documented in `.planning/navigation/{name}.md`. This section consolidates the layer rules that downstream skills must follow.
+
+{{#backend_codebases}}
+### {{name}} ({{role}})
+
+| Layer | Directory | Responsibility | Dependency Direction |
+|-------|-----------|----------------|---------------------|
+| {{layer_1_name}} | {{layer_1_dir}} | {{layer_1_responsibility}} | {{layer_1_depends}} |
+| {{layer_2_name}} | {{layer_2_dir}} | {{layer_2_responsibility}} | {{layer_2_depends}} |
+| {{layer_3_name}} | {{layer_3_dir}} | {{layer_3_responsibility}} | {{layer_3_depends}} |
+| {{layer_4_name}} | {{layer_4_dir}} | {{layer_4_responsibility}} | {{layer_4_depends}} |
+
+**Conversion rules**: {{conversion_rules}}
+
+**Interface rules**: {{interface_rules}}
+
+{{/backend_codebases}}
+
+{{#frontend_codebases}}
+### {{name}} ({{role}})
+
+| Layer | Directory | Responsibility |
+|-------|-----------|----------------|
+| Pages / Views | {{pages_dir}} | Route-level page components |
+| Page Components | {{page_components_dir}} | Page-private business components |
+| Common Components | {{common_components_dir}} | Shared/reusable components |
+| Layout Components | {{layout_dir}} | Layout, menu, header, container |
+| Hooks / Composables | {{hooks_dir}} | Shared stateful logic |
+
+**Component rules**: {{component_rules}}
+
+{{/frontend_codebases}}
+
+## TDD Strategy
+
+Tests can be written before code (TDD) or incrementally within the same task, but must not be deferred to a standalone final test wave. Each code task in the change plan must include a test strategy before execution begins. See `workflow-change-plan` "测试策略强制规则" for the test selection matrix and skip classification.
+
+## Code Generation
+
+{{code_generation_rules}}
+
+## Verification Gates
+
+All code tasks must pass three gates before marking complete:
+1. **Test gate**: task-level tests must be added/updated and pass (or skip classified as acceptable/needs-review).
+2. **Spec Compliance gate**: every MUST rule from the relevant `.context/spec/` depth spec file must be satisfied or explicitly waived.
+3. **Verification Iron Law**: before claiming completion: IDENTIFY the verification command → RUN it → READ the output → VERIFY against expected results → ONLY THEN mark complete.
+
+For task-level test strategy requirements, see `workflow-execute-phase` "验证铁律" and `workflow-change-plan` "测试策略强制规则" and "跳过自动化测试分级".
+
+---
+
+*Generated during project initialization. Update as project conventions evolve.*

package/plugins/devflow-core/skills/workflow-project-context/assets/navigation-index-template.md

@@ -0,0 +1,40 @@
+# Navigation Index
+
+<!-- project_context_run_id: {{run_id}}; code_index_status: {{code_index_status}}; code_index_skip_reason: {{code_index_skip_reason}} -->
+
+## Codebase Registry
+
+| Name | Path | Type | Role | Navigation | Scan Status |
+|------|------|------|------|------------|-------------|
+{{#codebases}}
+| {{name}} | {{path}} | {{type}} | {{role}} | `.planning/navigation/{{name}}.md` | {{scan_status}} |
+{{/codebases}}
+
+## Project Rule Package
+
+The project rule index is at `.planning/rules/INDEX.md`. Downstream skills should read it first, then use `.context/spec/index.md` to resolve stack/codebase specs and each domain index to resolve applicable depth specs before using codebase navigation files for coarse routing. Use `.planning/code-index/` before reading actual source evidence when source-level relation facts are needed; if fast mode skipped index generation, refresh it through `workflow-code-index` first or record the fallback.
+
+| Rule Source | Path | Status |
+|-------------|------|--------|
+| Rules Index | `.planning/rules/INDEX.md` | {{rules_index_status}} |
+| Execution Contract | `.planning/execution-contract.md` | {{execution_contract_status}} |
+| Toolchain Contract | `.planning/toolchain.md` | {{toolchain_status}} |
+| Planning Lessons | `.planning/lessons/README.md` | {{lessons_status}} |
+| Context Spec Index | `.context/spec/index.md` | {{context_spec_index_status}} |
+| Stack Specs | `.context/spec/stacks/` | {{stack_specs_status}} |
+| Context Specs | `.context/spec/` | {{context_spec_status}} |
+| Code Index | `.planning/code-index/` | {{code_index_status}} |
+| Design Rule Pack | `.context/spec/design/` | {{design_rule_pack_status}} |
+| Context Workflow | `.context/workflow/` | {{context_workflow_status}} |
+| Context Lessons | `.context/lessons/README.md` | {{context_lessons_status}} |
+| Root Instructions | `AGENTS.md` / `CLAUDE.md` | {{root_instructions_status}} |
+
+## Downstream Read Contract
+
+| Skill | Should Read |
+|-------|-------------|
+| `workflow-requirement-baseline` | `.planning/PROJECT.md`, this INDEX.md, relevant codebase navigation files, and `.planning/code-index/` for source-level relation checks |
+| `workflow-feature-breakdown` | `.planning/PROJECT.md`, this INDEX.md, and codebase navigation files for codebases relevant to the feature |
+| `workflow-frontend-tech-spec` | `.planning/rules/INDEX.md` → `.context/spec/index.md` → matching stack spec → matching frontend codebase spec → frontend domain index/applicable depth specs → this INDEX.md/navigation → code-index → source evidence |
+| `workflow-backend-tech-spec` | `.planning/rules/INDEX.md` → `.context/spec/index.md` → matching stack spec → matching backend codebase spec → backend domain index/applicable depth specs → this INDEX.md/navigation → code-index → source evidence |
+| `workflow-change-plan` | `.planning/rules/INDEX.md` + `.context/spec/index.md` for task gates, this INDEX.md for output locations and source navigation |

package/plugins/devflow-core/skills/workflow-project-context/assets/project-initialization-template.md

@@ -0,0 +1,109 @@
+# {{Project Name}}
+
+<!-- project_context_run_id: {{run_id}}; code_index_status: {{code_index_status}}; code_index_skip_reason: {{code_index_skip_reason}} -->
+
+## Project Basics
+
+- **Name**: {{project_name}}
+- **Type**: {{project_type}}
+- **What This Is**: {{what_this_is}}
+- **Primary Users / Domain**: {{primary_users_or_domain}}
+- **Core Value**: {{core_value_or_pending}}
+
+## Project Locations
+
+| Name | Path | Type | Role | Scan Status | Notes |
+|------|------|------|------|-------------|-------|
+{{#codebases}}
+| {{name}} | {{path}} | {{type}} | {{role}} | {{scan_status}} | {{notes}} |
+{{/codebases}}
+
+## Current Structure
+
+- **Repository Type**: {{repo_type}}
+- **Planning Root**: `.planning/`
+- **Navigation Root**: `.planning/navigation/`
+- **Code Index Root**: `.planning/code-index/`（generated by default through `workflow-code-index`; skipped only in fast mode）
+- **Code Index Status**: `{{code_index_status}}`
+- **Code Index Skip Reason**: {{code_index_skip_reason}}
+- **Design Rule Pack Status**: `{{design_rule_pack_status}}`
+- **Design Rule Pack Reason**: {{design_rule_pack_reason}}
+
+```text
+{{directory_map}}
+```
+
+## Navigation
+
+Detailed code navigation is split by codebase so later skills can load only what they need:
+
+- `.planning/navigation/INDEX.md` — codebase registry and quick pointers
+{{#codebases}}
+- `.planning/navigation/{{name}}.md` — {{role}} structure, entries, conventions, commands
+{{/codebases}}
+- `.planning/code-index/` — machine facts for symbols, relations, entrypoints, and data flow; generated during full initialization unless fast mode skipped it
+
+## Project Rule Package
+
+Record generated rule snapshots, existing project-specific rules, and workflow contracts. Generated rules must preserve source labels (`显式规则`, `代码推断`, `待确认`) and must not promote inconsistent legacy code to hard rules.
+
+| Rule Source | Path | Status | Notes |
+|-------------|------|--------|-------|
+| Planning Rules | `.planning/rules/INDEX.md` | {{planning_rules_status}} | {{planning_rules_notes}} |
+| Execution Contract | `.planning/execution-contract.md` | {{execution_contract_status}} | {{execution_contract_notes}} |
+| Toolchain Contract | `.planning/toolchain.md` | {{toolchain_status}} | {{toolchain_notes}} |
+| Planning Lessons | `.planning/lessons/README.md` | {{planning_lessons_status}} | {{planning_lessons_notes}} |
+| Planning Milestones | `.planning/milestones/` | {{planning_milestones_status}} | {{planning_milestones_notes}} |
+| Planning Requirements | `.planning/requirements/` | {{planning_requirements_status}} | {{planning_requirements_notes}} |
+| Context Spec Index | `.context/spec/index.md` | {{context_spec_index_status}} | {{context_spec_index_notes}} |
+| Stack Specs | `.context/spec/stacks/` | {{stack_specs_status}} | {{stack_specs_notes}} |
+| Context Specs | `.context/spec/` | {{context_spec_status}} | {{context_spec_notes}} |
+| Context Workflow | `.context/workflow/` | {{context_workflow_status}} | {{context_workflow_notes}} |
+| Context Lessons | `.context/lessons/README.md` | {{context_lessons_status}} | {{context_lessons_notes}} |
+| Root Instructions | `AGENTS.md` / `CLAUDE.md` | {{root_instructions_status}} | {{root_instructions_notes}} |
+
+## History Model
+
+This workflow uses planning and milestone artifacts as the primary project memory. Do not assume outbound-call style `features/*.spec.md` history exists.
+
+| History Source | Role | Status | Notes |
+|----------------|------|--------|-------|
+| `.planning/milestones/` | 已归档里程碑和交付结果 | {{planning_milestones_status}} | {{planning_milestones_notes}} |
+| `.planning/requirements/` | 当前或历史需求基线 | {{planning_requirements_status}} | {{planning_requirements_notes}} |
+| `.planning/lessons/` | 跨里程碑经验教训 | {{planning_lessons_status}} | {{planning_lessons_notes}} |
+| `.planning/*/CONTEXT.md` | 阶段上下文与决策记录 | {{planning_context_status}} | {{planning_context_notes}} |
+| `features/` | Legacy feature docs, only if present | {{features_history_status}} | {{features_history_notes}} |
+| `.context/lessons/` | Legacy/project-rule lessons, only if present | {{context_lessons_status}} | {{context_lessons_notes}} |
+
+## Shared References
+
+| Item | Path | Notes |
+|------|------|-------|
+| Project Context | `.planning/PROJECT.md` | 项目总览、结构、约束、关键决策 |
+| Workflow State | `.planning/STATE.md` | 初始化状态和后续建议 |
+| Navigation Index | `.planning/navigation/INDEX.md` | 后续 skill 的快捷入口 |
+| Code Index | `.planning/code-index/` | 机器事实索引，细粒度调用/符号/数据流追踪；fast mode 可跳过 |
+| Requirements Baseline | `.planning/requirements/baseline.md` | 需求讨论后生成，不在初始化阶段创建 |
+| Feature Breakdown | `.planning/features/{功能名}/功能点梳理.md` | 需求基线后生成的测试可读功能点梳理 |
+| Frontend Tech Doc | `.planning/features/{功能名}/前端技术方案.md` | 前端技术方案输出 |
+| Backend Tech Doc | `.planning/features/{功能名}/后端技术方案.md` | 后端技术方案输出 |
+| Change List | `.planning/features/{功能名}/变更清单.md` | 变更清单输出 |
+| Codebase Map | `.planning/codebase/` | 可选，深度代码库扫描结果 |
+
+## Constraints
+
+{{constraints}}
+
+## Key Decisions
+
+| Decision | Rationale | Outcome |
+|----------|-----------|---------|
+| {{decision}} | {{rationale}} | {{outcome}} |
+
+## Missing Information
+
+{{missing_information}}
+
+---
+
+*Last updated: {{date}} after project initialization.*