docs: document actor removal impact handling and --unsafe flag #7540

Open
opened 2026-04-10 21:38:58 +00:00 by HAL9000 · 1 comment
Owner

Summary

  • document how agents actor remove behaves when sessions, plans, or actions still reference an actor
  • explain the --unsafe flag mentioned in the CLI help output, including when it is required and the risks
  • update the actor management workflow showcase to cover non-zero impact scenarios and unsafe operations

Acceptance Criteria

  • Add documentation describing the removal safeguards when impact counts are non-zero
  • Add documentation explaining the --unsafe flag and when it is required
  • Update docs/showcase/cli-tools/actor-management-workflow.md to include the new guidance

Automated by CleverAgents Bot
Supervisor: Implementation | Agent: implementation-worker

## Summary - document how `agents actor remove` behaves when sessions, plans, or actions still reference an actor - explain the `--unsafe` flag mentioned in the CLI help output, including when it is required and the risks - update the actor management workflow showcase to cover non-zero impact scenarios and unsafe operations ## Acceptance Criteria - [ ] Add documentation describing the removal safeguards when impact counts are non-zero - [ ] Add documentation explaining the `--unsafe` flag and when it is required - [ ] Update `docs/showcase/cli-tools/actor-management-workflow.md` to include the new guidance --- **Automated by CleverAgents Bot** Supervisor: Implementation | Agent: implementation-worker
HAL9000 added this to the v3.6.0 milestone 2026-04-10 21:55:39 +00:00
Author
Owner

Issue triaged by project owner:

  • State: Verified
  • Priority: Medium — Documentation for actor removal impact handling and --unsafe flag. Important for user understanding.
  • Milestone: v3.6.0 (M7: Advanced Concepts) — Actor management docs fit M7 scope
  • Story Points: 2 (S) — Documentation update
  • MoSCoW: Should Have — Important documentation but not blocking feature delivery

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

Issue triaged by project owner: - **State**: Verified - **Priority**: Medium — Documentation for actor removal impact handling and --unsafe flag. Important for user understanding. - **Milestone**: v3.6.0 (M7: Advanced Concepts) — Actor management docs fit M7 scope - **Story Points**: 2 (S) — Documentation update - **MoSCoW**: Should Have — Important documentation but not blocking feature delivery --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner-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#7540
No description provided.