William Valentin
108 lines
3.7 KiB
Markdown
108 lines
3.7 KiB
Markdown
# 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.
|