docs: sync from main (4225d80a13973a863af71b1e0b83823027b23adf)
docs: sync from main (e7f39455696e94463fe011d2792a974545911164)
Reframe wiki: drop tier 7 from Ralph; rename Fleet Deployment to Consumer-Mode Deployment
Two coordinated reframings of the integration documentation:
1. Drop "Tier 7" from the Ralph Loop page. The progressive tier
ladder (1-6) is meant to be additive — each tier builds on the
previous. Ralph doesn't fit that: it builds on Tier 4 (plugin)
only and operates orthogonally to Tiers 5 and 6. Calling it
Tier 7 implied a strict superset that doesn't exist.
- Page title: "Tier 7: Autonomous Drain — Ralph Loop" →
"Autonomous Drain — Ralph Loop"
- Prerequisites no longer carry tier numbers
- Integration-Guides.md split into two sections:
* "Progressive Tiers" (1-6, the additive ladder)
* "Specialized Patterns" (Ralph Loop, alternate operational
mode)
- Layering note rewritten to explain Ralph as alternate mode
rather than next tier
2. Reframe "Fleet Deployment" as "Consumer-Mode Deployment". The
doc covers Task Orchestrator's claim-mode consumer pattern,
which scales from a single Ralph loop to a multi-tenant fleet.
Framing it as fleet-only made it look inapplicable to single-
actor deployments — but the same identity-verification, claim-
ownership, and observability concerns apply at every scale.
- Page title: "Fleet Deployment Guide" → "Consumer-Mode
Deployment"
- URL preserved as fleet-deployment for link stability (40+
codebase references plus external links). Note at top of
page documents this.
- Intro rewritten to explain the two patterns (orchestrator
vs consumer) and the scale-agnostic primitives
- New "Scope and Audience" section maps deployment scale to
which sections to read (single Ralph → small team → fleet)
- Section intros and bodies broadened: "agents" → "workers"
where the noun applied to any consumer; "fleet" reserved
for sections explicitly addressing multi-worker scale
(Capacity Planning, etc.)
- "Operating a Live Fleet" → "Operating a Live Deployment"
with single-Ralph guidance interpolated
- Cross-references updated in Home.md, _Sidebar.md,
api-reference.md, workflow-guide.md, and the Ralph guide
itself — display text reads "Consumer-Mode Deployment" but
URL remains fleet-deployment
- workflow-guide.md "agent implementers" callout updated to
acknowledge Ralph as the bundled-plugin exception to the
"default mode only" framing
Codebase docs (current/docs/fleet-deployment.md, README, etc.)
are intentionally not touched in this commit. They are paired
project docs and can be reframed in a separate pass aligned with
a release cadence if desired.
Fix broken links and add missing integration guides
GitHub wikis are flat and links must drop the .md extension.
- Rewrite all internal links: drop .md, flatten integration-guides/ paths
- Add 7 missing integration guide pages from current/docs/integration-guides/
(overview as Integration-Guides; tier guides as integration-guides-<name>)
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
docs: sync from main (f1de72c451cb28a94fae82587e678314f5ff70ae)
docs: sync from main (8b6e24d0dd2189eaefa5bd76c7358c373fd55da3)
docs: drop broken Integration Guides links from Home and Sidebar
The integration-guides/ subdirectory was referenced in navigation
but the pages were never created in the wiki. Drop the row from
Home.md and the entire Integration Guides section from _Sidebar.md
so navigation only points to existing pages.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
docs: sync from main (9c9bd632f1daae673e1adb7ada536cfe95b06506)
docs: sync from main (6e89b0e89e24227fef8c7e568d0de2f2b980e8d0)
docs: sync from main (05994d14024e14505ebd9a4f8b99c68b8bf77f6b)