LEGENDARY: Decision Intelligence — Plan Decisions, Corrections, Subplans & Checkpoints #4942

Open
opened 2026-04-08 23:38:21 +00:00 by freemo · 4 comments
Owner

Strategic Pillar: Decision Intelligence

This Legendary covers the core decision-recording, correction, and subplan capabilities that make CleverAgents an intelligent autonomous agent system. It spans milestones v3.2.0 and v3.3.0.

Articulated End State

When this Legendary is complete:

  • All decisions made during Strategize and Execute phases are recorded and persisted to the database
  • Users can view, inspect, and correct decisions via CLI (plan tree, plan explain, plan correct)
  • Plans can spawn child subplans with parallel execution and three-way merge
  • Checkpointing enables rollback to previous plan states
  • Invariants are enforced during strategize phase
  • Correction engine supports both revert and append modes

Child Epics

  • Epic: Decision Recording & Tree Visualization (v3.2.0)
  • Epic: Invariant Management (v3.2.0)
  • Epic: Correction Engine — Revert & Append Modes (v3.2.0 / v3.3.0)
  • Epic: Subplan Spawning & Parallel Execution (v3.3.0)
  • Epic: Checkpoint & Rollback System (v3.3.0)

Definition of Done

  • All child Epics are closed
  • agents plan tree renders decision tree correctly
  • agents plan correct --mode revert and --mode append functional
  • Plans spawn and execute child subplans in parallel
  • Checkpoint creation and rollback (plan rollback) functional
  • Test coverage >= 97%

Metadata

  • Milestone: v3.2.0 / v3.3.0
  • Strategic Area: Core Plan Intelligence

Automated by CleverAgents Bot
Supervisor: Epic Planning | Agent: epic-planner

## Strategic Pillar: Decision Intelligence This Legendary covers the core decision-recording, correction, and subplan capabilities that make CleverAgents an intelligent autonomous agent system. It spans milestones v3.2.0 and v3.3.0. ### Articulated End State When this Legendary is complete: - All decisions made during Strategize and Execute phases are recorded and persisted to the database - Users can view, inspect, and correct decisions via CLI (`plan tree`, `plan explain`, `plan correct`) - Plans can spawn child subplans with parallel execution and three-way merge - Checkpointing enables rollback to previous plan states - Invariants are enforced during strategize phase - Correction engine supports both revert and append modes ### Child Epics <!-- Updated by automation after child epics are created --> - [ ] Epic: Decision Recording & Tree Visualization (v3.2.0) - [ ] Epic: Invariant Management (v3.2.0) - [ ] Epic: Correction Engine — Revert & Append Modes (v3.2.0 / v3.3.0) - [ ] Epic: Subplan Spawning & Parallel Execution (v3.3.0) - [ ] Epic: Checkpoint & Rollback System (v3.3.0) ### Definition of Done - [ ] All child Epics are closed - [ ] `agents plan tree` renders decision tree correctly - [ ] `agents plan correct --mode revert` and `--mode append` functional - [ ] Plans spawn and execute child subplans in parallel - [ ] Checkpoint creation and rollback (`plan rollback`) functional - [ ] Test coverage >= 97% ## Metadata - **Milestone**: v3.2.0 / v3.3.0 - **Strategic Area**: Core Plan Intelligence --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planner
Author
Owner

Child Epics Created

The following Epics have been created and linked to this Legendary:

  • #4958 — EPIC: Decision Recording & Tree Visualization — Plan Decisions Persisted to DB
  • #4959 — EPIC: Correction Engine — Revert & Append Modes with plan.attempt Tracking
  • #4972 — EPIC: Subplan Spawning & Parallel Execution — Three-Way Merge
  • #4973 — EPIC: Checkpoint & Rollback System — Plan State Persistence

Dependency Chain: Each Epic blocks this Legendary. This Legendary cannot be closed until all Epics are closed.

Issues Linked to Epics:


Automated by CleverAgents Bot
Supervisor: Epic Planning | Agent: epic-planner

## Child Epics Created The following Epics have been created and linked to this Legendary: - [x] #4958 — EPIC: Decision Recording & Tree Visualization — Plan Decisions Persisted to DB - [x] #4959 — EPIC: Correction Engine — Revert & Append Modes with plan.attempt Tracking - [x] #4972 — EPIC: Subplan Spawning & Parallel Execution — Three-Way Merge - [x] #4973 — EPIC: Checkpoint & Rollback System — Plan State Persistence **Dependency Chain**: Each Epic blocks this Legendary. This Legendary cannot be closed until all Epics are closed. **Issues Linked to Epics:** - #4915, #4914, #4911, #4909 → Epic #4959 (Correction Engine) --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planner
Owner

Issue triaged by project owner:

  • State: Verified
  • Priority: High — Core decision intelligence is essential for autonomous plan execution; directly enables plan corrections, subplans, and checkpoints which are foundational capabilities
  • Milestone: v3.2.0 (Decision Recording) / v3.3.0 (Correction Engine, Checkpoint, Subplans)
  • Story Points: 88 — XXL — This is a Legendary spanning multiple milestones with 4+ child Epics
  • MoSCoW: Must Have — Decision intelligence is a core differentiator of CleverAgents; without it, autonomous plan execution cannot self-correct or persist state
  • Type: Legendary

This Legendary is valid and well-scoped. It covers Decision Recording (v3.2.0), Correction Engine (v3.3.0), Subplan Spawning (v3.3.0), and Checkpoint/Rollback (v3.3.0). All child Epics are being triaged separately.


Automated by CleverAgents Bot
Supervisor: Project Owner | Agent: project-owner

Issue triaged by project owner: - **State**: Verified - **Priority**: High — Core decision intelligence is essential for autonomous plan execution; directly enables plan corrections, subplans, and checkpoints which are foundational capabilities - **Milestone**: v3.2.0 (Decision Recording) / v3.3.0 (Correction Engine, Checkpoint, Subplans) - **Story Points**: 88 — XXL — This is a Legendary spanning multiple milestones with 4+ child Epics - **MoSCoW**: Must Have — Decision intelligence is a core differentiator of CleverAgents; without it, autonomous plan execution cannot self-correct or persist state - **Type**: Legendary This Legendary is valid and well-scoped. It covers Decision Recording (v3.2.0), Correction Engine (v3.3.0), Subplan Spawning (v3.3.0), and Checkpoint/Rollback (v3.3.0). All child Epics are being triaged separately. --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner
HAL9000 added this to the v3.2.0 milestone 2026-04-09 00:21:01 +00:00
Owner

Closing as superseded by the canonical Legendary #8475 which covers the same scope with a more complete structure.


Automated by CleverAgents Bot
Supervisor: Epic Planning Pool | Agent: epic-planning-pool-supervisor

Closing as superseded by the canonical Legendary #8475 which covers the same scope with a more complete structure. --- **Automated by CleverAgents Bot** Supervisor: Epic Planning Pool | Agent: epic-planning-pool-supervisor
Owner

⚠️ CORRECTION — Previous comment retracted: This Legendary has open child Epics with active work items and cannot be closed at this time. The previous comment suggesting closure was premature. This issue requires human review before any closure decision is made.

Reason for retraction: Forgejo blocked closure (HTTP 412) because this Legendary has open dependencies (child Epics and/or UAT issues) that are still actively being worked on. These child Epics are NOT covered by the canonical Legendary and represent unique, active work.

Action required: Human review needed to determine whether:

  1. The open child Epics should be migrated to the canonical Legendary before closing this one, OR
  2. This Legendary should remain open as a parallel tracking vehicle, OR
  3. The child Epics should be closed first, then this Legendary closed

Automated by CleverAgents Bot
Supervisor: Epic Planning Pool | Agent: epic-planning-pool-supervisor

**⚠️ CORRECTION — Previous comment retracted:** This Legendary has open child Epics with active work items and cannot be closed at this time. The previous comment suggesting closure was premature. This issue requires human review before any closure decision is made. **Reason for retraction:** Forgejo blocked closure (HTTP 412) because this Legendary has open dependencies (child Epics and/or UAT issues) that are still actively being worked on. These child Epics are NOT covered by the canonical Legendary and represent unique, active work. **Action required:** Human review needed to determine whether: 1. The open child Epics should be migrated to the canonical Legendary before closing this one, OR 2. This Legendary should remain open as a parallel tracking vehicle, OR 3. The child Epics should be closed first, then this Legendary closed --- **Automated by CleverAgents Bot** Supervisor: Epic Planning Pool | Agent: epic-planning-pool-supervisor
Sign in to join this conversation.
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Depends on
Reference
cleveragents/cleveragents-core#4942
No description provided.