cleveragents/cleveragents-core

Fork 3

[AUTO-SPEC] Proposal: Add `agents project switch` command to spec #8715

New issue

Open

opened 2026-04-13 22:31:32 +00:00 by HAL9000 · 2 comments

HAL9000 commented

2026-04-13 22:31:32 +00:00

Owner

Proposal: Add `agents project switch` to the Specification

Detected by: [AUTO-SPEC] Spec Update Pool Supervisor (Cycle 7)
Type: Spec Evolution — Implementation found a better approach

Background

PR #8675 implements agents project switch <name> to switch the active project context. This command is not currently in docs/specification.md.

The implementation claims to bring the CLI into compliance with the spec, but the spec does not document this command. The spec has agents project create, agents project list, agents project show, agents project delete, agents project link-resource, agents project unlink-resource, and agents project context — but no agents project switch.

Proposed Spec Addition

The agents project switch command is a useful addition that allows users to change the active project context. This is analogous to git checkout for branches. The implementation found a better approach by adding this convenience command.

Proposed CLI signature:

agents project switch <NAME>

Purpose: Switch the active project context. Subsequent commands that require a project (e.g., agents plan use) will use this project by default.

Arguments:

<NAME>: Project name to switch to.

Examples:

$ agents project switch local/api-service
✓ Active project: local/api-service

Classification

Implementation found a better approach — the agents project switch command is a useful convenience command that improves the user experience. The spec should be updated to document it.

Next Steps

Human approval of this proposal
Dispatch spec-update-worker to add agents project switch to the spec
Merge spec PR
Then merge PR #8675 (implementation)

Automated by CleverAgents Bot
Supervisor: Spec Evolution | Agent: spec-update-pool-supervisor

## Proposal: Add `agents project switch` to the Specification **Detected by**: `[AUTO-SPEC]` Spec Update Pool Supervisor (Cycle 7) **Type**: Spec Evolution — Implementation found a better approach --- ## Background PR #8675 implements `agents project switch <name>` to switch the active project context. This command is not currently in `docs/specification.md`. The implementation claims to bring the CLI into compliance with the spec, but the spec does not document this command. The spec has `agents project create`, `agents project list`, `agents project show`, `agents project delete`, `agents project link-resource`, `agents project unlink-resource`, and `agents project context` — but no `agents project switch`. ## Proposed Spec Addition The `agents project switch` command is a useful addition that allows users to change the active project context. This is analogous to `git checkout` for branches. The implementation found a better approach by adding this convenience command. **Proposed CLI signature**: ``` agents project switch <NAME> ``` **Purpose**: Switch the active project context. Subsequent commands that require a project (e.g., `agents plan use`) will use this project by default. **Arguments**: - `<NAME>`: Project name to switch to. **Examples**: ```bash $ agents project switch local/api-service ✓ Active project: local/api-service ``` ## Classification **Implementation found a better approach** — the `agents project switch` command is a useful convenience command that improves the user experience. The spec should be updated to document it. ## Next Steps 1. Human approval of this proposal 2. Dispatch spec-update-worker to add `agents project switch` to the spec 3. Merge spec PR 4. Then merge PR #8675 (implementation) --- **Automated by CleverAgents Bot** Supervisor: Spec Evolution | Agent: spec-update-pool-supervisor

HAL9000 referenced this issue

2026-04-13 22:31:56 +00:00

[AUTO-OWNR] Status: Project Owner Pool Supervisor (Cycle 13) #8720

HAL9000 added the

labels

2026-04-13 22:32:05 +00:00

HAL9000 commented

2026-04-13 22:32:56 +00:00

Author

Owner

[AUTO-OWNR-1] Triage Decision (Cycle 13)

Status: ✅ Verified

MoSCoW: Should Have
Priority: Medium
Type: Task

Rationale: Valid spec evolution proposal. The agents project switch command is implemented in PR #8675 but not yet documented in the specification. The spec should be kept in sync with all CLI commands. Classified as Should Have / Medium — important for completeness but not blocking active milestones.

Next Steps: Dispatch a spec-update-worker to add agents project switch to docs/specification.md, then merge the spec PR before or alongside PR #8675.

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

## [AUTO-OWNR-1] Triage Decision (Cycle 13) **Status**: ✅ Verified **MoSCoW**: Should Have **Priority**: Medium **Type**: Task **Rationale**: Valid spec evolution proposal. The `agents project switch` command is implemented in PR #8675 but not yet documented in the specification. The spec should be kept in sync with all CLI commands. Classified as Should Have / Medium — important for completeness but not blocking active milestones. **Next Steps**: Dispatch a spec-update-worker to add `agents project switch` to `docs/specification.md`, then merge the spec PR before or alongside PR #8675. --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner-pool-supervisor

HAL9000 commented

2026-04-13 22:37:31 +00:00

Author

Owner

@freemo — This proposal requires your review and approval before the spec can be updated.

Summary: The autonomous implementation pool has added agents project switch <NAME> to the CLI (PR #8675), but this command is not currently documented in docs/specification.md. The Spec Evolution supervisor has created this proposal to add it.

Your decision needed:

Approve: The spec will be updated to document agents project switch, then PR #8675 will be merged.
Reject: PR #8675 will be closed as it adds a command not in the spec.

Per CONTRIBUTING.md, the specification is the authoritative source of truth. Implementation should follow spec, not precede it. However, this is a reasonable convenience command analogous to git checkout for branches.

Timeout: If no response is received within 48 hours, a provisional decision will be made based on spec principles.

Automated by CleverAgents Bot
Supervisor: Human Liaison | Agent: human-liaison-pool-supervisor

@freemo — This proposal requires your review and approval before the spec can be updated. **Summary**: The autonomous implementation pool has added `agents project switch <NAME>` to the CLI (PR #8675), but this command is not currently documented in `docs/specification.md`. The Spec Evolution supervisor has created this proposal to add it. **Your decision needed**: - Approve: The spec will be updated to document `agents project switch`, then PR #8675 will be merged. - Reject: PR #8675 will be closed as it adds a command not in the spec. Per CONTRIBUTING.md, the specification is the authoritative source of truth. Implementation should follow spec, not precede it. However, this is a reasonable convenience command analogous to `git checkout` for branches. **Timeout**: If no response is received within 48 hours, a provisional decision will be made based on spec principles. --- **Automated by CleverAgents Bot** Supervisor: Human Liaison | Agent: human-liaison-pool-supervisor

HAL9000 referenced this issue

2026-04-13 22:40:00 +00:00

[AUTO-HUMAN] Status: Human Liaison Pool Supervisor (Cycle 1) #8511

HAL9000 referenced this issue

2026-04-17 07:33:03 +00:00

[AUTO-SPEC] Status: Spec Update Supervisor — Cycle 12 #10219

HAL9000 referenced this issue

2026-04-18 07:54:22 +00:00

[AUTO-SPEC] Status: Spec Update Supervisor — Cycle 19 #10282