docs(m92-004): changelog — agentsfleet rebrand + breaking changes

[indykish]

Adds the Jun 15 changelog <Update> for the usezombie→agentsfleet cutover shipping in agentsfleet/agentsfleet#412 (M92_004): CLI zombiectl→agentsfleet, host api.agentsfleet.net, env ZOMBIE_*→AGENTSFLEET_*, routes /zombies→/agents + zombie_id→agent_id, error codes UZ-ZMB-*→UZ-AGT-*, token prefixes agt_a/agt_t/agt_r, npm @agentsfleet/cli.

Also flips the changelog's own current-product references (frontmatter, stealth Tip, support mail) to agentsfleet. Historical <Update> entries are left unchanged (they document zombie-era releases accurately, per the changelog history-append rule).

Not included: the broader docs prose rebrand (error-codes/cli/billing/README, ~37 files / ~1055 hits) — the textual rebrand M92_002/M92_003 deferred to a follow-up. Tracked separately.

🤖 Generated with Claude Code

Greptile Summary

This PR lands the Jun 15 changelog entry for the usezombie→agentsfleet hard cutover (M92_004), documenting CLI rename (zombiectl→agentsfleet), API host, env var, route, error code, token prefix, and npm package changes. It also flips the changelog's own top-level references (frontmatter description, stealth <Tip>, support email) to agentsfleet branding; historical entries are left intact except for link rewrites that prevent 404s against deleted /zombies/ pages.

• Jun 15 changelog entry covers all six operator-facing breaking changes with the old and new values named inline; the re-mint bullet now correctly lists all three old prefixes (zmb_a, zmb_t, zmb_r).
• AGENTS.md terminology section has a copy-paste inversion that makes the rule self-contradictory, and retains zmb_ as a "stays" token despite the PR retiring that prefix — both will misdirect future authors and AI agents using the file.
• Command name discrepancy: the changelog names the agent-key management surface agentsfleet agent-key add|list|delete, but the updated cli/agentsfleet.mdx uses agentsfleet agent add/list/delete for the same feature.

Confidence Score: 3/5

Safe to merge for the changelog entry itself, but AGENTS.md ships two actively misleading instructions that will propagate into future AI-authored doc changes.

The changelog entry is well-formed and the top-level rebrand touches are correct. However AGENTS.md — the file that guides both human authors and AI agents making future edits — now tells authors that "agent" is legacy terminology (the opposite of the truth) and lists zmb_ as a token that stays (contradicting the very cutover this PR documents). A second concrete defect is the command name mismatch between the changelog (agentsfleet agent-key add|list|delete) and the CLI reference (agentsfleet agent add/list/delete), leaving operators uncertain which name to actually run.

AGENTS.md (terminology rule and lead-repo list) and the agent-key command name alignment between changelog.mdx and cli/agentsfleet.mdx.

Important Files Changed

Filename	Overview
AGENTS.md	Terminology section is self-contradictory ("agent" marked as legacy), zmb_ listed as a retained token despite being retired in this PR, and the lead-repo list has duplicate agentsfleet entries.
changelog.mdx	Jun 15 breaking-change entry added correctly; however the CLI section references `agentsfleet agent-key add
cli/agentsfleet.mdx	CLI reference fully renamed from zombiectl to agentsfleet; token prefixes updated to agt_*; command surface looks consistent internally but command names for agent-key diverge from the changelog.
api-reference/introduction.mdx	Base URL updated to api.agentsfleet.net, bearer token prefixes (agt_t…) correctly reflect the new naming, no issues found.
api-reference/error-codes.mdx	Error codes updated to UZ-AGT-* domain, docs_uri updated to docs.agentsfleet.net, no issues found.
.mlc-config.json	URL ignore patterns updated from usezombie.com to agentsfleet.net, straightforward and correct.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[usezombie / zombiectl era] --> B[M92_004 hard cutover]
    B --> C["CLI: zombiectl → agentsfleet\nnpm: @usezombie/zombiectl → @agentsfleet/cli"]
    B --> D["API host: api.usezombie.com → api.agentsfleet.net"]
    B --> E["Env vars: ZOMBIE_* → AGENTSFLEET_*"]
    B --> F["Routes: /zombies/zombie_id → /agents/agent_id"]
    B --> G["Error codes: UZ-ZMB-* → UZ-AGT-*"]
    B --> H["Token prefixes: zmb_a/zmb_t/zmb_r → agt_a/agt_t/agt_r"]
    B --> I["Docs: changelog entry + top-level rebrand"]
    I --> J["AGENTS.md: 'agent' marked legacy, zmb_ listed as retained"]
    I --> K["CLI ref: agent add vs changelog: agent-key add"]

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[usezombie / zombiectl era] --> B[M92_004 hard cutover]
    B --> C["CLI: zombiectl → agentsfleet\nnpm: @usezombie/zombiectl → @agentsfleet/cli"]
    B --> D["API host: api.usezombie.com → api.agentsfleet.net"]
    B --> E["Env vars: ZOMBIE_* → AGENTSFLEET_*"]
    B --> F["Routes: /zombies/zombie_id → /agents/agent_id"]
    B --> G["Error codes: UZ-ZMB-* → UZ-AGT-*"]
    B --> H["Token prefixes: zmb_a/zmb_t/zmb_r → agt_a/agt_t/agt_r"]
    B --> I["Docs: changelog entry + top-level rebrand"]
    I --> J["AGENTS.md: 'agent' marked legacy, zmb_ listed as retained"]
    I --> K["CLI ref: agent add vs changelog: agent-key add"]

Loading

_{Reviews (3): Last reviewed commit: "docs(m92-004): resolve greptile feedback..." | Re-trigger Greptile}

[mintlify]

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

Project	Status	Preview	Updated (UTC)
megam	🟢 Ready	View Preview	Jun 15, 2026, 1:31 PM

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

[indykish]

Review feedback resolved + branch updated (5ed098f)

Greptile inline comments — all 4 addressed:

• P1 api-reference/introduction.mdx — tenant API key prefix → agt_t…
• P1 cli/agentsfleet.mdx — agentsfleet agent add raw key → agt_a…
• P2 changelog.mdx — re-mint step now names the old prefixes (agt_a was zmb_a, agt_t was zmb_t, agt_r was zmb_r) so operators can grep their environment
• P2 changelog.mdx — API-reference block tagged with the http language specifier

Also in this push:

• Merge conflict resolved — merged origin/main (the logo wordmark refresh), taking the refreshed transparent wordmark.
• Continuous Integration (CI) lint is green — fixed the openapi-drift failure (docs.json agent-keys path param {agent_id} → {agent_key_id}, matching the upstream OpenAPI and the agent_key_id model), and the broken-links check (repointed 8 moved-page links /zombies/* → /agents/* and /cli/zombiectl → /cli/agentsfleet).
• Entity-id examples are now version-7 Universally Unique Identifiers (UUIDv7) across the current-state docs — agent_id, workspace_id, grant_id, agent_key_id, request_id, approval_id — matching the validator built into the agentsfleet Command-Line Interface (CLI) and the api-reference "IDs are UUIDv7" convention. event_id is intentionally left as a caller-supplied example (it is the upstream provider's id, not one we issue). Also fixed an agent_key_id-vs-agent_id conflation in the agent delete example + heading.

Changelog history preserved — historic entries keep their original zombie-era branding (append-only); only the current Jun-15 rebrand entry carries the P2 fixes, and dead links were repointed to the moved pages.