Epic: Persona System — YAML-based Actor Configuration (v3.7.0) #8601

Open
opened 2026-04-13 21:14:17 +00:00 by HAL9000 · 2 comments
Owner

Metadata

  • Commit message: feat(tui): implement YAML-based persona system for actor configuration
  • Branch name: feat/v3.7.0-persona-system

Background and Context

As part of the v3.7.0 milestone (M8: TUI Implementation) and Legendary #8135 (TUI Implementation & User Experience), the Persona System enables users to define and select actors via YAML configuration files. This is specified in ADR-045 (Persona System).

A persona is a YAML file that defines: actor type, arguments, scope, and presets. Users can select a persona when starting a new session, and the TUI will configure the actor accordingly. This enables users to have pre-configured "modes" for different tasks (e.g., a "code review" persona vs. a "refactoring" persona).

This Epic blocks the parent Legendary issue #8135.

Expected Behavior

When this Epic is complete:

  • Users can define personas as YAML files in ~/.config/cleveragents/personas/
  • Persona YAML format includes: name, actor type, args, scope, presets
  • TUI displays a persona selection overlay on new session creation
  • Selected persona configures the actor for the session
  • Personas can be listed, created, and deleted via CLI

Acceptance Criteria

  • Persona YAML schema is defined and documented (per ADR-045)
  • PersonaRegistry loads personas from ~/.config/cleveragents/personas/
  • Persona selection overlay is displayed on new session creation
  • Selected persona configures the actor (type, args, scope, presets)
  • agents persona list CLI command lists available personas
  • agents persona create CLI command creates a new persona
  • agents persona delete CLI command deletes a persona
  • Integration tests verify persona loading and selection
  • Unit tests achieve >= 97% coverage

Subtasks

  • Define persona YAML schema (per ADR-045)
  • Implement PersonaRegistry class
  • Implement persona loading from ~/.config/cleveragents/personas/
  • Implement persona selection overlay in TUI
  • Implement actor configuration from selected persona
  • Implement agents persona list CLI command
  • Implement agents persona create CLI command
  • Implement agents persona delete CLI command
  • Write integration tests for persona loading and selection
  • Write unit tests for PersonaRegistry

Child Issues / Child Epics

Child implementation issues will be linked here as they are created.

  • Implement PersonaRegistry and YAML schema — TBD
  • Implement persona selection overlay in TUI — TBD
  • Implement persona CLI commands — TBD

Definition of Done

This Epic should be closed when:

  1. All acceptance criteria above are verified and checked off
  2. All child implementation issues are closed
  3. Test coverage >= 97% is confirmed by CI for all new code
  4. Code has passed peer review and been merged to the main branch
  5. The parent Legendary issue #8135 has been updated to reflect this Epic's completion

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

## Metadata - **Commit message**: `feat(tui): implement YAML-based persona system for actor configuration` - **Branch name**: `feat/v3.7.0-persona-system` ## Background and Context As part of the v3.7.0 milestone (M8: TUI Implementation) and Legendary #8135 (TUI Implementation & User Experience), the Persona System enables users to define and select actors via YAML configuration files. This is specified in ADR-045 (Persona System). A persona is a YAML file that defines: actor type, arguments, scope, and presets. Users can select a persona when starting a new session, and the TUI will configure the actor accordingly. This enables users to have pre-configured "modes" for different tasks (e.g., a "code review" persona vs. a "refactoring" persona). This Epic blocks the parent Legendary issue #8135. ## Expected Behavior When this Epic is complete: - Users can define personas as YAML files in `~/.config/cleveragents/personas/` - Persona YAML format includes: name, actor type, args, scope, presets - TUI displays a persona selection overlay on new session creation - Selected persona configures the actor for the session - Personas can be listed, created, and deleted via CLI ## Acceptance Criteria - [ ] Persona YAML schema is defined and documented (per ADR-045) - [ ] `PersonaRegistry` loads personas from `~/.config/cleveragents/personas/` - [ ] Persona selection overlay is displayed on new session creation - [ ] Selected persona configures the actor (type, args, scope, presets) - [ ] `agents persona list` CLI command lists available personas - [ ] `agents persona create` CLI command creates a new persona - [ ] `agents persona delete` CLI command deletes a persona - [ ] Integration tests verify persona loading and selection - [ ] Unit tests achieve >= 97% coverage ## Subtasks - [ ] Define persona YAML schema (per ADR-045) - [ ] Implement `PersonaRegistry` class - [ ] Implement persona loading from `~/.config/cleveragents/personas/` - [ ] Implement persona selection overlay in TUI - [ ] Implement actor configuration from selected persona - [ ] Implement `agents persona list` CLI command - [ ] Implement `agents persona create` CLI command - [ ] Implement `agents persona delete` CLI command - [ ] Write integration tests for persona loading and selection - [ ] Write unit tests for PersonaRegistry ## Child Issues / Child Epics > Child implementation issues will be linked here as they are created. - [ ] Implement PersonaRegistry and YAML schema — _TBD_ - [ ] Implement persona selection overlay in TUI — _TBD_ - [ ] Implement persona CLI commands — _TBD_ ## Definition of Done This Epic should be closed when: 1. All acceptance criteria above are verified and checked off 2. All child implementation issues are closed 3. Test coverage >= 97% is confirmed by CI for all new code 4. Code has passed peer review and been merged to the main branch 5. The parent Legendary issue #8135 has been updated to reflect this Epic's completion --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planning-pool-supervisor
HAL9000 added this to the v3.7.0 milestone 2026-04-13 21:20:50 +00:00
Author
Owner

🤖 Child Implementation Issues Created

The following child implementation issues have been created for this Epic and are now tracked in the v3.7.0 milestone:

# Issue Labels
#8641 feat(tui): implement PersonaRegistry and YAML persona schema (ADR-045) Type/Feature Priority/High MoSCoW/Must have State/Verified
#8643 feat(tui): implement persona selection overlay for new session creation Type/Feature Priority/High MoSCoW/Must have State/Verified
#8644 feat(tui): implement agents persona list/create/delete CLI commands Type/Feature Priority/High MoSCoW/Must have State/Verified

Dependency Order

#8641 (PersonaRegistry + YAML schema)  ← implement first
    ↓ blocks
#8643 (Persona selection overlay TUI)  ← depends on #8641
#8644 (Persona CLI commands)           ← depends on #8641
    ↓ all block
Epic #8601 (this issue)

All 3 child issues block this Epic and are assigned to milestone v3.7.0 (ID: 130).


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

## 🤖 Child Implementation Issues Created The following child implementation issues have been created for this Epic and are now tracked in the v3.7.0 milestone: | # | Issue | Labels | |---|-------|--------| | #8641 | [feat(tui): implement PersonaRegistry and YAML persona schema (ADR-045)](https://git.cleverthis.com/cleveragents/cleveragents-core/issues/8641) | `Type/Feature` `Priority/High` `MoSCoW/Must have` `State/Verified` | | #8643 | [feat(tui): implement persona selection overlay for new session creation](https://git.cleverthis.com/cleveragents/cleveragents-core/issues/8643) | `Type/Feature` `Priority/High` `MoSCoW/Must have` `State/Verified` | | #8644 | [feat(tui): implement agents persona list/create/delete CLI commands](https://git.cleverthis.com/cleveragents/cleveragents-core/issues/8644) | `Type/Feature` `Priority/High` `MoSCoW/Must have` `State/Verified` | ### Dependency Order ``` #8641 (PersonaRegistry + YAML schema) ← implement first ↓ blocks #8643 (Persona selection overlay TUI) ← depends on #8641 #8644 (Persona CLI commands) ← depends on #8641 ↓ all block Epic #8601 (this issue) ``` All 3 child issues block this Epic and are assigned to milestone **v3.7.0** (ID: 130). --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planning-pool-supervisor
Author
Owner

[AUTO-EPIC] New Child Issue Identified — Cycle 7

A new child issue has been identified for this Epic by AUTO-GUARD:

  • #8751: [AUTO-GUARD-3] Load first-run actor selection from the A2A actor registry

This issue addresses an architecture violation where the actor selection overlay hard-codes actor IDs instead of loading from the A2A actor registry. It is a core requirement for the persona selection overlay implementation.


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

## [AUTO-EPIC] New Child Issue Identified — Cycle 7 A new child issue has been identified for this Epic by AUTO-GUARD: - **#8751**: [AUTO-GUARD-3] Load first-run actor selection from the A2A actor registry This issue addresses an architecture violation where the actor selection overlay hard-codes actor IDs instead of loading from the A2A actor registry. It is a core requirement for the persona selection overlay implementation. --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planning-pool-supervisor
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Reference
cleveragents/cleveragents-core#8601
No description provided.