docs(plans): add openclaw analysis and rollout checklists

2026-02-12 22:47:28 -08:00
parent 6e8984f788
commit 3472a0b926
13 changed files with 2090 additions and 0 deletions
@@ -0,0 +1,107 @@
+# Flynn Implementation Sequence (Phase 1 -> Phase 3)
+
+Created: 2026-02-12
+Owner: Flynn core
+
+## Objective
+
+Provide a single execution order for all planned PRs, with dependencies, risk level, and rough delivery timeline.
+
+## Subagent Model Override
+
+For implementation execution across these phases, use:
+- `zai-coding-plan/glm-4.7`
+
+Replace prior Sonnet-default subagent execution assumptions with this model for planning/implementation/review passes unless a task explicitly requires a different model.
+
+## PR Order
+
+1. Phase 1 PR #1 - Context levels
+   - File: `docs/plans/phase1-pr1-context-level-checklist.md`
+   - Why first: lowest-risk foundation for prompt behavior control.
+   - Dependencies: none.
+
+2. Phase 1 PR #2 - Fast-path command registry
+   - File: `docs/plans/phase1-pr2-command-registry-checklist.md`
+   - Why second: adds deterministic low-latency command handling.
+   - Dependencies: none (independent of PR #1).
+
+3. Phase 1 PR #3 - Memory category structure
+   - File: `docs/plans/phase1-pr3-memory-structure-checklist.md`
+   - Why third: additive memory foundation for later adaptive behavior.
+   - Dependencies: none.
+
+4. Phase 2 PR #1 - Component registry routing
+   - File: `docs/plans/phase2-pr1-component-registry-checklist.md`
+   - Why now: enables configurable intent-to-target mapping.
+   - Dependencies: ideally after Phase 1 PR #2 (shared fast-path patterns), but can run independently.
+
+5. Phase 2 PR #2 - Confidence-based routing
+   - File: `docs/plans/phase2-pr2-confidence-routing-checklist.md`
+   - Why after PR #1: consumes intent match outputs from component registry.
+   - Dependencies: Phase 2 PR #1.
+
+6. Phase 2 PR #3 - History index and topic search
+   - File: `docs/plans/phase2-pr3-history-index-checklist.md`
+   - Why here: augments routing/context with historical relevance.
+   - Dependencies: none hard; optional integration with Phase 2 PR #2 for confidence boost.
+
+7. Phase 3 PR #1 - Adaptive memory + weighted compaction
+   - File: `docs/plans/phase3-pr1-adaptive-memory-compaction-checklist.md`
+   - Why after memory structure: relies on robust memory primitives and categories.
+   - Dependencies: Phase 1 PR #3.
+
+8. Phase 3 PR #2 - Truthfulness/policy/autonomy hardening
+   - File: `docs/plans/phase3-pr2-policy-autonomy-hardening-checklist.md`
+   - Why last: cross-cutting policy changes should land after routing/memory stabilization.
+   - Dependencies: none hard; recommended final to reduce churn.
+
+## Dependency Graph (Simple)
+
+- Phase 1 PR #1 -> none
+- Phase 1 PR #2 -> none
+- Phase 1 PR #3 -> none
+- Phase 2 PR #1 -> (recommended after Phase 1 PR #2)
+- Phase 2 PR #2 -> Phase 2 PR #1
+- Phase 2 PR #3 -> none (optional hook into Phase 2 PR #2)
+- Phase 3 PR #1 -> Phase 1 PR #3
+- Phase 3 PR #2 -> recommended after all previous PRs
+
+## Suggested Parallelization
+
+Parallel lane A:
+- Phase 1 PR #1 -> Phase 1 PR #3 -> Phase 3 PR #1
+
+Parallel lane B:
+- Phase 1 PR #2 -> Phase 2 PR #1 -> Phase 2 PR #2
+
+Parallel lane C:
+- Phase 2 PR #3 (can start after session/store migration review)
+
+Final convergence:
+- Phase 3 PR #2
+
+## Estimated Timeline (Engineering Time)
+
+- Phase 1 total: ~15-21 hours
+- Phase 2 total: ~18-24 hours
+- Phase 3 total: ~16-20 hours
+- Total execution: ~49-65 hours
+
+With 2 active lanes and normal review cadence:
+- Best case: 2-3 working weeks
+- Conservative: 3-4 working weeks
+
+## Merge Policy
+
+- Merge one PR per checklist file.
+- Do not batch multiple checklist PRs into one branch.
+- Re-run full quality gates each merge:
+  - `docs/plans/remaining-phases-rollout-quality-gates.md`
+
+## State Tracking
+
+After each merged implementation PR:
+- Update `docs/plans/state.json` progress/test counts.
+- Keep feature status and gap scorecard in sync.
+- Reference merged checklist file in PR description for traceability.