# 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

- `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`
- `semantic-release-versioning`
  - Purpose: migrate release version calculation from fixed patch bumps to semantic-release while keeping the existing tag-driven NuGet publish flow.
  - Tracking: `ai-plan/public/semantic-release-versioning/todos/semantic-release-versioning-tracking.md`
  - Trace: `ai-plan/public/semantic-release-versioning/traces/semantic-release-versioning-trace.md`
- `godot-logging-core-sink`
  - Purpose: evaluate and implement the next Godot logging stage by unifying Godot output with the Core logging
    appender / sink model instead of expanding a separate Godot-only logging pipeline.
  - Tracking: `ai-plan/public/godot-logging-core-sink/todos/godot-logging-core-sink-tracking.md`
  - Trace: `ai-plan/public/godot-logging-core-sink/traces/godot-logging-core-sink-trace.md`

## Worktree To Active Topic Map

- 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: `feat/semantic-release-versioning`
  - Worktree hint: `GFramework`
  - Priority 1: `semantic-release-versioning`
- Branch: `feat/godot-logging-core-sink`
  - Worktree hint: `GFramework`
  - Priority 1: `godot-logging-core-sink`
- Branch: `docs/sdk-update-documentation`
  - Worktree hint: `GFramework-update-documentation`
  - Priority 1: `documentation-full-coverage-governance`

## Archived Topics

- `analyzer-warning-reduction`
  - Archive root: `ai-plan/public/archive/analyzer-warning-reduction/`
  - Note: 长期 warning-reduction 分支已收尾；PR #301 的最终 review follow-up 已本地闭环，后续仅作为历史恢复材料保留。
- `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 栏目刷新阶段已完成，后续仅作为历史恢复材料保留。
- `godot-logging-compliance-polish`
  - Archive root: `ai-plan/public/archive/godot-logging-compliance-polish/`
  - Note: PR #314 已合并到 `origin/main`；Godot logging 宿主集成、热重载、结构化输出和 review follow-up 已收尾，后续 Core appender / sink 统一评估应新建 active topic。