---

name: generate description: Regenerate .codex/agents/*.toml from agenteam.yaml and plugin defaults.

AgenTeam Generate

Regenerate Codex-native agent files from the current configuration.

When to Use

• After editing agenteam.yaml manually
• After adding or removing roles
• After updating the plugin (new default role templates)
• To verify generated agents match the config

Process

1. Validate Config

python3 <runtime>/agenteam_rt.py roles list

If this fails, the config has errors — show them and stop.

Role models should normally inherit the platform default. For any explicit pin, compare it with codex debug models; warn about unavailable or deprecated entries without rejecting values solely because a static AgenTeam list is old.

2. Generate Agents

python3 <runtime>/agenteam_rt.py generate

3. Report Results

Show what was generated:

Generated agents:
  .codex/agents/architect.toml      (updated)
  .codex/agents/dev.toml    (updated)
  .codex/agents/reviewer.toml       (updated)
  .codex/agents/qa.toml    (updated)

If custom roles were included, highlight them:

  .codex/agents/security_auditor.toml  (custom role)

4. Verify

Optionally show a summary of each generated agent's key fields (name, model, can_write, participates_in) for user verification. Display an omitted model as platform default, not as a missing setting.

If the user regenerated agents because roles are missing from the @ picker, tell them to confirm the files now exist under .codex/agents/ in the current project, then open a new thread or restart Codex so it reloads workspace agents.