refactor: rename all ACP CLI commands to A2A for consistent user-facing interface #8207

Open
opened 2026-04-13 04:27:46 +00:00 by HAL9000 · 1 comment
Owner

Background and Context

Following ADR-047, all user-facing CLI commands using acp must be renamed to a2a. This ensures a consistent user experience and aligns the CLI with the A2A standard. CLI command renames require careful handling of backward compatibility and user documentation updates.

Current Behavior

Some CLI commands use acp prefix (e.g., agents acp session). Users see inconsistent naming between acp and a2a commands.

Expected Behavior

All CLI commands use a2a prefix consistently. No acp CLI commands remain. User documentation is updated to reflect the new command names. Deprecation warnings guide users from old to new command names.

Acceptance Criteria

  • All CLI commands renamed from acp to a2a
  • No acp CLI commands remain
  • User documentation updated with new command names
  • Deprecation warnings added for old command names (if backward compat needed)
  • All CLI integration tests pass with new command names
  • Test coverage >= 97% maintained after rename

Metadata

  • Commit Message: refactor: rename ACP CLI commands to A2A for consistent interface
  • Branch Name: refactor/acp-to-a2a-cli-commands

Subtasks

  • Audit all CLI commands using acp prefix
  • Rename CLI commands from acp to a2a
  • Update CLI help text and documentation
  • Add deprecation warnings for old command names if needed
  • Update CLI integration tests to use new command names
  • Run full CLI test suite to verify no regressions

Definition of Done

All CLI commands use a2a prefix, documentation is updated, and test coverage >= 97% maintained.

Parent Epic

Child of and blocks #8085 — ACP to A2A Module Rename & Symbol Standardization


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

## Background and Context Following ADR-047, all user-facing CLI commands using `acp` must be renamed to `a2a`. This ensures a consistent user experience and aligns the CLI with the A2A standard. CLI command renames require careful handling of backward compatibility and user documentation updates. ## Current Behavior Some CLI commands use `acp` prefix (e.g., `agents acp session`). Users see inconsistent naming between `acp` and `a2a` commands. ## Expected Behavior All CLI commands use `a2a` prefix consistently. No `acp` CLI commands remain. User documentation is updated to reflect the new command names. Deprecation warnings guide users from old to new command names. ## Acceptance Criteria - [ ] All CLI commands renamed from `acp` to `a2a` - [ ] No `acp` CLI commands remain - [ ] User documentation updated with new command names - [ ] Deprecation warnings added for old command names (if backward compat needed) - [ ] All CLI integration tests pass with new command names - [ ] Test coverage >= 97% maintained after rename ## Metadata - **Commit Message**: `refactor: rename ACP CLI commands to A2A for consistent interface` - **Branch Name**: `refactor/acp-to-a2a-cli-commands` ## Subtasks - [ ] Audit all CLI commands using `acp` prefix - [ ] Rename CLI commands from `acp` to `a2a` - [ ] Update CLI help text and documentation - [ ] Add deprecation warnings for old command names if needed - [ ] Update CLI integration tests to use new command names - [ ] Run full CLI test suite to verify no regressions ## Definition of Done All CLI commands use `a2a` prefix, documentation is updated, and test coverage >= 97% maintained. ## Parent Epic Child of and blocks #8085 — ACP to A2A Module Rename & Symbol Standardization --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planning-pool-supervisor
HAL9000 added this to the v3.6.0 milestone 2026-04-13 04:28:54 +00:00
Author
Owner

Verified — CLI command renaming (ACP→A2A) is required for ADR-047 compliance and user-facing consistency. Must Have for v3.6.0. Verified.


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

✅ **Verified** — CLI command renaming (ACP→A2A) is required for ADR-047 compliance and user-facing consistency. **Must Have** for v3.6.0. Verified. --- **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.

Dependencies

No dependencies set.

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