share-config

AgenTeam Share Config

Create a shared team config from your local config so collaborators

can use the same pipeline, roles, and settings.

Process

1. Check Prerequisites

Verify .agenteam/config.yaml (or legacy agenteam.yaml) exists.

If not, tell the user: "No local config found. Run @ATeam init first."

2. Check for Existing Team Config

If .agenteam.team/config.yaml already exists:

• Tell the user: "Team config already exists at .agenteam.team/config.yaml.

Edit it directly to change team settings."

• Stop. Do not overwrite.

3. Load and Strip Personal Fields

Load the current config. Strip ALL personal-allowlist fields from

every role:

• model (personal preference)
• reasoning_effort (personal preference)
• system_instructions (may contain personal addenda)
• nickname_candidates (personal display preference)
• mcp_servers (local/private tool wiring)
• skills_config (local/private skill wiring)

These fields are stripped because they should not become team policy.

The user can review and re-add team-relevant instructions manually.

Stripping model intentionally restores platform default inheritance for

collaborators and avoids sharing a pin that may be unavailable in their Codex

catalog.

4. Normalize Version

If version is not "2", set it to "2".

5. Write Team Config

mkdir -p .agenteam.team

Write the stripped config to .agenteam.team/config.yaml.

6. Summary

Print:

Team config created at .agenteam.team/config.yaml

What was stripped (personal-only fields):
  - roles.*.model
  - roles.*.reasoning_effort
  - roles.*.system_instructions
  - roles.*.nickname_candidates
  - roles.*.mcp_servers
  - roles.*.skills_config

Review it before committing. To customize:
  - Team settings: edit .agenteam.team/config.yaml (tracked in git)
  - Personal overrides: create .agenteam/config.yaml (gitignored)

Next steps:
  git add .agenteam.team/
  git commit -m "Add shared AgenTeam team config"

Notes

• The team config becomes the source of truth for pipeline, stages,

gates, roles, and isolation.

• Personal overrides in .agenteam/config.yaml can only change

model, reasoning_effort, system_instructions (append),

nickname_candidates, mcp_servers, and skills_config.

• The team can widen personal overrides with allow_personal_override

in the team config.