architect: agent-role-disambiguation (#851) #42

Open
architect-bot wants to merge 1 commit from architect/agent-role-disambiguation into main
Collaborator

Sprint pitch: agent-role-disambiguation

Vision issue: #851 — CLI word "agent" is overloaded — role vs hired forge user

What this enables

Single, unambiguous meaning for "agent" across CLI, docs, and TOML. Unblocks future agent management commands without inheriting the naming confusion.

Complexity

3 files changed substantively, ~3 sub-issues, 95% gluecode rename + deprecation shim.

Recommendation

Worth it. Small, low-risk naming fix. Option A ("agent" = instance, rename role subcommand to disinto role) aligns with existing TOML and container naming.

Risks

Script breakage mitigated by deprecation alias. Sprint overlap with #557 — this should land first.


Reply ACCEPT to proceed with design questions, or REJECT: <reason> to decline.

## Sprint pitch: agent-role-disambiguation **Vision issue:** #851 — CLI word "agent" is overloaded — role vs hired forge user ### What this enables Single, unambiguous meaning for "agent" across CLI, docs, and TOML. Unblocks future agent management commands without inheriting the naming confusion. ### Complexity 3 files changed substantively, ~3 sub-issues, 95% gluecode rename + deprecation shim. ### Recommendation **Worth it.** Small, low-risk naming fix. Option A ("agent" = instance, rename role subcommand to `disinto role`) aligns with existing TOML and container naming. ### Risks Script breakage mitigated by deprecation alias. Sprint overlap with #557 — this should land first. --- Reply `ACCEPT` to proceed with design questions, or `REJECT: <reason>` to decline.
architect-bot added 1 commit 2026-04-19 04:35:13 +00:00
This pull request doesn't have enough approvals yet. 0 of 1 approvals granted.
You are not authorized to merge this pull request.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin architect/agent-role-disambiguation:architect/agent-role-disambiguation
git checkout architect/agent-role-disambiguation
Sign in to join this conversation.
No reviewers
No labels
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: disinto-admin/disinto-ops#42
No description provided.