docs: rename agent → fleet site-wide + add template docs

[indykish]

Brings the docs site in line with the product: the deployable unit is a fleet now (matches the code — core.fleets, /v1/fleets, fleet_id, fleet-key). The website already renamed Agents → Fleets; the docs were the straggler.

What changed

Structure

• agents/ → fleets/ (9 pages, git mv).
• docs.json: nav relabeled (Fleets, Fleet keys, Fleet bundles, Fleet messages/memories/events); API-reference operation paths corrected to /fleets — they were stale against the live OpenAPI (/agents ops no longer exist in the spec); new Fleet bundles group (GET /v1/fleets/bundles, snapshots); /agents/:slug → /fleets/:slug redirect so old URLs don't 404.

Prose sweep — agent → fleet across 20+ pages. Deliberately kept: agentsfleet* brand, the AGENTS.md filename, generic host-agent references (the coding tool — Claude Code / Cursor / Amp / Codex — that drives the CLI), UZ-AGT-* error codes, and changelog history (append-only, untouched).

New content — the template flow: agentsfleet templates, install --template <id>, and --name for installing one template as several fleets. New fleets/templates.mdx leads with the first-party catalogue.

error-codes.mdx — reconciled to src/agentsfleetd/errors/error_entries*.zig: added the missing UZ-BUNDLE-001..006 section (400/404/424/502/503/429), fixed UZ-EXEC-012/013 titles ("Runner fleet init/run failed").

Verification

• make lint (mintlify validate + broken-links) passes.
• API nav: all 26 operations resolve in public/openapi.json; error codes/statuses/titles cross-checked against the Zig registry.
• /review (structural + an independent adversarial pass) caught 6 generic-agent over-sweeps (an fleet, external fleets, AI fleet, host-fleet, sub-fleet) — all fixed in 228b3af. Final whole-repo over-sweep scan is clean.

Session notes

• Decision: full structural rename incl. URL changes + redirects (not prose-only) — the code and website already moved to fleet, so the docs follow.
• Root cause of the over-sweeps: the term-swap and article-grammar (an→a) passes covered different file subsets, so cli/agentsfleet.mdx got the swap but not the grammar fix. The adversarial review cross-checked against live source and caught the residue.
• Flagged separately (done): the global AGENTS.md entities/API line was stale (agent//agents/core.agent_*); reconciled to fleet//fleets/core.fleet_* and pushed to dotfiles master.

🤖 Generated with Claude Code

Greptile Summary

This PR renames the primary product unit from "agent" to "fleet" across 25 docs files, matching the renamed website and API (/v1/fleets, fleet_id, fleet-key). It also adds new template documentation (fleets/templates.mdx) and reconciles error-codes.mdx with the live Zig error registry (adding UZ-BUNDLE-001..006, fixing UZ-EXEC-012/013 titles).

• The agents/ directory is renamed to fleets/ (9 pages), with a Mintlify redirect "/agents/:slug" → "/fleets/:slug" preserving old URLs. The changelog is deliberately left untouched (the redirect handles its historical /agents/ links).
• API nav in docs.json is updated from stale /agents operation paths to the live /fleets paths, and three new Fleet Bundle operations are added.

Confidence Score: 4/5

Safe to merge — this is a docs-only rename with a properly configured redirect; no code paths are affected.

The rename is thorough and the redirect in docs.json correctly handles old /agents/:slug URLs. The one inconsistency — delegate and spawn still say "sub-agent"/"subagent" in the Fleet orchestration table while schedule and the section intro were updated — is a minor terminology mismatch that doesn't break navigation or mislead users about functionality.

fleets/tools.mdx — the delegate and spawn rows in the Fleet orchestration table still use "sub-agent"/"subagent".

Important Files Changed

Filename	Overview
docs.json	Navigation groups, API operation paths, and fleet-key endpoint references all updated to fleets/; redirect added for /agents/:slug; three new Fleet Bundle API pages added.
fleets/tools.mdx	Fleet orchestration section heading and intro updated to "fleet", but delegate and spawn tool rows still say "sub-agent" and "subagent" — inconsistent within the same table.
api-reference/error-codes.mdx	UZ-AGENT-001 renamed to UZ-FLEETKEY-001; UZ-AGT-* code names preserved with fleet-renamed titles; new UZ-BUNDLE-001..006 section added; UZ-EXEC-012/013 titles fixed; link to /fleets/tools updated.
fleets/templates.mdx	New page documenting the first-party template catalogue, --template flag, --name override, local-directory install, and sharing guidance. Well-structured and consistent with CLI docs.
cli/agentsfleet.mdx	Fleet-related commands updated (fleet-key, fleet update, install --template, templates); --name flag documented; all --agent flags renamed to --fleet; links updated to /fleets/*.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[PR: agent → fleet rename] --> B[docs.json]
    A --> C[agents/ directory]
    A --> D[Prose sweep ~20 pages]
    A --> E[New content]
    A --> F[error-codes.mdx]

    B --> B1[Nav groups renamed\nAgents → Fleets]
    B --> B2[API paths\n/agents → /fleets]
    B --> B3[Redirect added\n/agents/:slug → /fleets/:slug]
    B --> B4[Fleet Bundle group added\nGET /v1/fleets/bundles]

    C --> C1[git mv agents/ → fleets/\n9 pages]

    D --> D1[concepts.mdx\nbilling/ workspaces/\ncli/ quickstart/ memory/\napi-reference/introduction.mdx]

    E --> E1[fleets/templates.mdx\nCatalogue + --template flag\n+ --name override]

    F --> F1[UZ-BUNDLE-001..006 added]
    F --> F2[UZ-EXEC-012/013 titles fixed]
    F --> F3[UZ-AGENT-001 → UZ-FLEETKEY-001]

Loading

%%{init: {'theme': 'base', 'themeVariables': {"darkMode": true, "background": "#0d1117", "primaryColor": "#21262d", "primaryTextColor": "#e6edf3", "primaryBorderColor": "#8b949e", "lineColor": "#8b949e", "textColor": "#e6edf3", "edgeLabelBackground": "#161b22", "actorBkg": "#21262d", "actorBorder": "#8b949e", "actorTextColor": "#e6edf3", "actorLineColor": "#8b949e", "signalColor": "#8b949e", "signalTextColor": "#e6edf3", "noteBkgColor": "#373320", "noteBorderColor": "#d4a72c", "noteTextColor": "#f0e6c0", "labelBoxBkgColor": "#21262d", "labelBoxBorderColor": "#8b949e", "labelTextColor": "#e6edf3", "loopTextColor": "#e6edf3", "activationBkgColor": "#30363d", "activationBorderColor": "#8b949e"}}}%%
flowchart TD
    A[PR: agent → fleet rename] --> B[docs.json]
    A --> C[agents/ directory]
    A --> D[Prose sweep ~20 pages]
    A --> E[New content]
    A --> F[error-codes.mdx]

    B --> B1[Nav groups renamed\nAgents → Fleets]
    B --> B2[API paths\n/agents → /fleets]
    B --> B3[Redirect added\n/agents/:slug → /fleets/:slug]
    B --> B4[Fleet Bundle group added\nGET /v1/fleets/bundles]

    C --> C1[git mv agents/ → fleets/\n9 pages]

    D --> D1[concepts.mdx\nbilling/ workspaces/\ncli/ quickstart/ memory/\napi-reference/introduction.mdx]

    E --> E1[fleets/templates.mdx\nCatalogue + --template flag\n+ --name override]

    F --> F1[UZ-BUNDLE-001..006 added]
    F --> F2[UZ-EXEC-012/013 titles fixed]
    F --> F3[UZ-AGENT-001 → UZ-FLEETKEY-001]

Loading

Prompt To Fix All With AI

Fix the following 1 code review issue. Work through them one at a time, proposing concise fixes.

---

### Issue 1 of 1
fleets/tools.mdx:63-64
The Fleet orchestration section heading and intro were updated to "fleet" terminology, but `delegate` and `spawn` still say "sub-agent" and "subagent" in their descriptions while the adjacent `schedule` row was correctly updated. These two entries are now internally inconsistent with the section they live in.

```suggestion
| `delegate` | Delegate a subtask to a specialized sub-fleet (potentially a different model). Synchronous — the parent waits for the result. | The subtask benefits from a stronger model, a different system prompt, or fresh context. |
| `spawn` | Launch a background sub-fleet asynchronously. Returns a task ID immediately; results arrive as system messages later. | Long-running fanout that shouldn't block the current run. |
```

_{Reviews (1): Last reviewed commit: "docs: fix agent→fleet over-sweeps caught..." | Re-trigger Greptile}

Greptile also left 1 inline comment on this PR.

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
agentsfleet	🟢 Ready	View Preview	Jun 22, 2026, 2:22 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.