remove-agent

Remove Council Agent

Remove an agent from the evaluation council. Deletes the agent definition, its documentation, and updates the council plan if one exists.

Step 1: Discover Roster

Glob the agents directory and group by wave:

Glob agents/data-*.md → Wave 1 (Data Gathering)
Glob agents/eval-*.md → Wave 2 (Evaluation)
Glob agents/synth-*.md → Wave 3 (Synthesis)

For each file, read the frontmatter name and description.

If $ARGUMENTS provided

Check if agents/$ARGUMENTS.md exists. If yes, skip to Step 2 with that agent pre-selected. If no, show the roster and ask.

If no argument

Present the roster and ask which agent to remove:

AskUserQuestion:
  question: "Which agent should be removed?"
  header: "Remove Agent"
  options:
    [One option per agent, grouped by wave]:
    - label: "[name]"
      description: "Wave N — [description]"
      preview: |
        File: agents/[name].md
        Wave: [N] — [Data Gathering | Evaluation | Synthesis]
        Role: [description]

        Removing this agent means the council will no longer:
        [1-line summary of what will be lost]

Store the selected agent as $AGENT.

Step 2: Last-Agent Guard

Before confirming, check if this is the last agent of its wave type:

Glob agents/$PREFIX-*.md → count agents of same type

If this is the last synth agent, show a hard warning:

AskUserQuestion:
  question: "This is the only synthesis agent. Removing it means the council will produce NO final report. Continue?"
  header: "Warning"
  options:
    - label: "Remove anyway"
      description: "I'll add a replacement later"
    - label: "Cancel"
      description: "Keep the agent"

If "Cancel" → stop, report "No changes made."

If this is the last data agent or last eval agent, show a softer warning in the confirmation (Step 3) noting that the wave will be empty.

Step 3: Confirm with Impact Preview

Read the agent file to understand its role, then confirm:

AskUserQuestion:
  question: "Confirm removal of $AGENT?"
  header: "Confirm"
  options:
    - label: "Remove"
      description: "Delete agent and documentation"
      preview: |
        Removing: $AGENT
        Wave: [N] — agents remaining: [M-1]

        Impact:
        - The council will no longer assess: [what this agent evaluates/gathers]
        - [Wave-specific impact]:
          - Data agent: evaluators will have less data to work with
          - Eval agent: the synthesis will have fewer perspectives
          - Synth agent: the council output format will change

        Files to delete:
        - agents/$AGENT.md
        - docs/$AGENT.md (if exists)
    - label: "Cancel"
      description: "Keep the agent"