Crews Reference

7 crews ship with agents-fleet. A crew is a named bundle of agents (each a role + optional skills) plus a coordinator role, a default workflow, a messaging topology, and an optional MCP allowlist. Activate one with /crew <name>. Bundled and user crews are always loaded; project .fleet/crews/ are opt-in with --trust-project-skills. save_crew writes project by default (or user), updates the live registry, and does not activate it; use activate_crew separately after user confirmation. After manual edits use reload_registry. See Composition, Authoring crews, and Roles.

Generated for agents-fleet v0.60.0 · 7 bundled crews.

---

Serialized .crew.md schema

save_crew accepts members in its tool input and serializes that array as agents. Canonical files use block-form YAML; inline object entries are not supported by the frontmatter parser.

Serialized field	Type	Required / default	Behavior
name	string	Required	Kebab-case for save_crew; must match the .crew.md filename when loaded.
description	string	Required by save_crew; parser default: first body heading or ""	One-line summary of the crew.
topology	"silent" | "hub" | "mesh"	Required by save_crew; parser default: "hub"	Runtime-owned worker communication policy; prompt text cannot widen it.
workflow	string	Required by save_crew; parser default: "freeform"	Default workflow resolved and validated when the crew activates.
workflows	map<string, string>	Optional; manual file authoring only	Per-command workflow overrides. save_crew does not currently accept or emit this map.
version	string or number	Serializer-managed; parser default: "1"	Starts at 1 and increments when save_crew overwrites the canonical file.
coordinator	object	Required	Requires role; optional model overrides the coordinator role model.
agents	CrewAgent[]	At least one required by save_crew	Worker roster serialized from the tool input members.
synthesis	CrewAgent	Optional	Final synthesis member. Canonical parser fields are role, after, and model.
mcpServers	string[]	Optional	Crew-wide MCP allowlist enabled for the coordinator at activation.
Markdown body	Markdown	Optional	Descriptive content; crew wiring comes from frontmatter.

CrewAgent fields

Field	Required / default	Behavior
role	Required	Registry role reference. Its agent_type selects the worker runtime permission baseline.
skills	Optional; default []	Atomic skills composed into the role prompt; skills cannot grant runtime permissions.
parallel	Optional; default false	Marks a member eligible to run with other parallel members.
after	Optional	"all" or a list of role names that must complete first.
model	Optional	Member-specific model override.
mcpServers	Optional	Member-specific MCP allowlist; does not bypass runtime MCP or permission policy.
name	Optional	Display name distinct from the referenced role.

Minimal serialized crew

---
name: docs-crew
description: Drafts project documentation
topology: hub
workflow: freeform
version: 1
coordinator:
  role: default-coordinator
agents:
  - role: docs-writer
---

# docs-crew

Drafts project documentation

Activation validates coordinator, worker role, skill, and workflow references before updating fleet state. It installs the coordinator persona plus active-crew/workflow overlays, applies the coordinator model override, and enables declared crew MCP servers. activate_crew schedules this swap for the coordinator's next message; /crew <name> is the direct user command. Activating a crew does not rewrite role permission profiles.

save_crew updates the running registry but deliberately does not activate the crew. Manual edits require reload_registry; in-flight workflow runs retain their existing snapshot. Reload reapplies trust, so default-off project crews require --trust-project-skills, AGENTS_FLEET_TRUST_PROJECT_SKILLS=1, or the equivalent config setting. Saving a project crew in one session does not opt future sessions into trust.

Bundled crews

Crew	Topology	Workflow	Members	Description
agents-fleet-crew	hub	planning	9: fleet-coder, fleet-tester, fleet-architect, fleet-security-reviewer, fleet-correctness-reviewer, fleet-minimalism-reviewer, fleet-explorer, fleet-researcher, test-reviewer	Default development crew for agents-fleet. Composes ponytail-minimalism on fleet-coder and adds a fleet-minimalism-reviewer member.
code-review-crew	hub	code-review	4: architecture-reviewer, correctness-reviewer, performance-reviewer, security-reviewer	Multi-perspective code review crew (4 reviewers + synthesis)
init-crew	hub	init-investigation	9: init-arch-explorer, init-build-explorer, init-pattern-explorer, init-decision-explorer, init-dep-explorer, init-api-explorer, init-security-explorer, init-critic, init-synthesizer	Codebase investigation crew for /init command
minimal-dev-crew	hub	freeform	5: ponytail-coder, default-reviewer, fleet-ci-engineer, fleet-ci-reviewer, fleet-report-writer	Minimalist dev crew — ponytail coder implements, reviewer audits for over-engineering, CI engineer builds pipelines, CI reviewer guards green builds, report-writer produces interactive HTML/PDF reports
research-crew	hub	adversarial-research	5: primary-researcher, counter-researcher, context-researcher, edge-case-researcher, research-critic	Adversarial research crew — 4 angles + critic
security-crew	hub	security-autopilot	12: sec-recon-mapper, sec-vuln-hunter, sec-triage-analyst, sec-exploit-poc-engineer, sec-fixer, sec-verifier, sec-reporter, sec-vm-validator, sec-msrc-reporter, sec-binary-analyst, sec-fuzzing-engineer, sec-crash-triage-analyst	Application-security audit crew — recon → hunt → triage → PoC → fix → verify → report
workflow-authoring-crew	hub	freeform	1: fleet-workflow-architect	Authoring crew — a workflow architect composes the workflow-authoring skill to design, validate, and save new .workflow.md files.