gewuyou a6b87c23e4 docs(governance): 收敛恢复入口并补充评审示例
- 更新 documentation governance 的 active tracking 与 trace,只保留当前恢复点、风险、验证结果与归档指针

- 归档 RP-001 到 RP-016 的状态与时间线摘要,降低 boot 恢复时的噪音

- 补充 UnifiedSettingsDataRepository 的统一文件布局示例,并补齐 Godot SourceGenerators 的生命周期接法代码片段
2026-04-23 13:11:42 +08:00
..

AI-Plan Public Index

ai-plan/public/README.md is the shared startup index for boot. It should stay short, list only active topics, and help the current worktree land on the right recovery documents without scanning every public artifact.

Boot Rules

  1. Read this file before scanning ai-plan/public/<topic>/.
  2. If the current branch or worktree appears in the map below, read the listed topics in priority order.
  3. If there is no match, fall back to scanning active topic directories.
  4. Ignore ai-plan/public/archive/** by default unless the user explicitly asks for historical context.

Active Topics

  • analyzer-warning-reduction
    • Purpose: track the analyzer warning reduction branch, including the current recovery point, remaining warning hotspots, and the next safe warning-reduction slice.
    • Tracking: ai-plan/public/analyzer-warning-reduction/todos/analyzer-warning-reduction-tracking.md
    • Trace: ai-plan/public/analyzer-warning-reduction/traces/analyzer-warning-reduction-trace.md
  • ai-plan-governance
    • Purpose: govern the ai-plan/ directory model, startup index, and archive policy.
    • Tracking: ai-plan/public/ai-plan-governance/todos/ai-plan-governance-tracking.md
    • Trace: ai-plan/public/ai-plan-governance/traces/ai-plan-governance-trace.md
  • ai-first-config-system
    • Purpose: continue the AI-First config runtime, generator, and consumer DX work for GFramework.Game.
    • Tracking: ai-plan/public/ai-first-config-system/todos/ai-first-config-system-tracking.md
    • Trace: ai-plan/public/ai-first-config-system/traces/ai-first-config-system-trace.md
  • documentation-full-coverage-governance
    • Purpose: govern full-coverage documentation inventory, module-wave remediation, and the README / docs / XML / API-reference alignment baseline.
    • Tracking: ai-plan/public/documentation-full-coverage-governance/todos/documentation-full-coverage-governance-tracking.md
    • Trace: ai-plan/public/documentation-full-coverage-governance/traces/documentation-full-coverage-governance-trace.md
  • coroutine-optimization
    • Purpose: continue the coroutine semantics, host integration, observability, regression coverage, and migration-doc follow-up work.
    • Tracking: ai-plan/public/coroutine-optimization/todos/coroutine-optimization-tracking.md
    • Trace: ai-plan/public/coroutine-optimization/traces/coroutine-optimization-trace.md
  • cqrs-rewrite
    • Purpose: continue the CQRS migration, registry hardening, and related PR follow-up.
    • Tracking: ai-plan/public/cqrs-rewrite/todos/cqrs-rewrite-migration-tracking.md
    • Trace: ai-plan/public/cqrs-rewrite/traces/cqrs-rewrite-migration-trace.md
  • data-repository-persistence
    • Purpose: continue the data repository persistence hardening plus the settings / serialization follow-up backlog.
    • Tracking: ai-plan/public/data-repository-persistence/todos/data-repository-persistence-tracking.md
    • Trace: ai-plan/public/data-repository-persistence/traces/data-repository-persistence-trace.md

Worktree To Active Topic Map

  • Branch: fix/analyzer-warning-reduction-batch
    • Worktree hint: GFramework-analyzer
    • Priority 1: analyzer-warning-reduction
  • Branch: feat/ai-first-config
    • Worktree hint: GFramework-Ai-First-Config
    • Priority 1: ai-first-config-system
  • Branch: feat/cqrs-optimization
    • Worktree hint: GFramework-cqrs
    • Priority 1: ai-plan-governance
    • Priority 2: cqrs-rewrite
  • Branch: feat/coroutine-optimization
    • Worktree hint: GFramework-coroutine-optimization
    • Priority 1: coroutine-optimization
    • Priority 2: ai-plan-governance
  • Branch: feat/data-repository-persistence
    • Worktree hint: GFramework-data-repository-persistence
    • Priority 1: data-repository-persistence
  • Branch: docs/sdk-update-documentation
    • Worktree hint: GFramework-update-documentation
    • Priority 1: documentation-full-coverage-governance

Archived Topics

  • cqrs-cache-docs-hardening
    • Archive root: ai-plan/public/archive/cqrs-cache-docs-hardening/
    • Note: archived topics stay outside the default boot context until a user explicitly requests historical review.
  • documentation-governance-and-refresh
    • Archive root: ai-plan/public/archive/documentation-governance-and-refresh/
    • Note: PR #268 已合并;文档治理与 Godot 栏目刷新阶段已完成,后续仅作为历史恢复材料保留。