Skip to main content

ICW-E4S08T07-Implementation-Plan: FR-011 Multi-Epic Task Splitting

Task: E4:S08:T07
Related FR: FR-011
Host Task: T07-task-splitting-across-multiple-canonical-epics-fr-011.md
Created: 2026-04-09

Build Plan​

  1. Implement split-candidate detection

    • Add multi-epic eligibility evaluation for partial-match scenarios.
    • Persist candidate metadata for downstream assignment and reporting.

  2. Implement task-level assignment engine

    • Analyze task content for canonical epic assignment.
    • Apply deterministic tie-break strategy for equal-confidence outcomes.

  3. Implement split-plan reporting

    • Emit per-task mapping plus rationale bundle.
    • Include summary diagnostics for operator review.

  4. Implement deterministic ID remap

    • Allocate target IDs in canonical destinations.
    • Enforce deterministic ordering and collision handling.

  5. Implement reference rewrite/update

    • Rewrite structured references to remapped IDs.
    • Emit unresolved-reference report for ambiguous prose targets.

  6. Run test suite and refine

    • Execute tests defined in ICW-E4S08T07-test-design.md.
    • Resolve failing guards and confirm regression stability.

Integration Touchpoints​

  • Migration orchestration paths that currently use single-best-match epic mapping.
  • Semantic matching outputs used by canonical adoption flow.
  • Reference update mechanisms used for E:S:T rewrite operations.

Rollback and Recovery​

  • Feature-flag split behavior until validation set passes.
  • Preserve pre-split mapping snapshots for deterministic rollback.
  • On validation failure, revert to snapshot and surface unresolved diagnostics.

Exit Criteria​

  • FR-011 FR-1..FR-6 each mapped to implemented behavior and passing tests.
  • FR-011 AC-1..AC-6 evidenced by repeatable test results.
  • Deterministic replay confirms stable split assignment and ID remap.
  • Reference rewrite leaves no stale structured IDs in scoped targets.

Evidence Checklist​

  • Split-candidate detection tests passing.
  • Task assignment tests passing.
  • Explainability output tests passing.
  • Deterministic remap replay tests passing.
  • Reference rewrite integrity tests passing.
  • Handoff notes captured for RW-ready implementation release.

Handoff Notes​

Use this package as the planning SoT for implementation-cycle execution. Track any scope deviations in task notes and keep FR/Task/Story links synchronized in the same change set.