docs: sync from main (122aad3599a1be55460a74ace847d85d3f9e0a73)
5b5d419
docs: sync from main (f3ebcfd2e218d22d0aecaa93a90a79523133eb1d)
02375ee
docs: sync from main (801cac2e34400b280233deeba3dcbf2a95630e5d)
eb1c9c2
docs: sync from main (95f77328a5bcfc410457df865ddee2099c637aab)
b536958
docs: sync from main (cd4b1f89a52f795d6347dab216a1be3cfa6e0dab)
6c14b60
docs: sync from main (840435bea4c60edee6284b6e8b39ab97e9cc742a)
b606dbf
docs: sync from main (50409f0b23a379088aeed66d32ad6e5df6f77304)
3bad48f
docs: sync from main (e926efb5d0fcd051451f808fd96039018ecc2785)
3e8be46
docs: sync from main (ca2a5c8cac6b2dd6dbd3057778809bb9048483b8)
cfd5d69
docs: sync from main (db8b522099e9f4619a569295263601faba38ccdd)
8d5b449
docs: sync from main (4225d80a13973a863af71b1e0b83823027b23adf)
dc7f04f
docs: sync from main (6b06eb4846a7a87d78e9f9922405f334dba83bbe)
720ec5a
docs: sync from main (fae288ec758227a68e6b15c7e697b590b724e3b8)
57790c5
docs: sync from main (f3b9c59c322286668986b7f5cebabb7c8b7fc66e)
8b67534
docs: sync from main (e7f39455696e94463fe011d2792a974545911164)
4b8b078
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.
1aa3f41
Add Tier 7: Autonomous Drain (Ralph Loop) integration guide
Documents the Ralph-style queue drain pattern shipped in plugin
PR #169 — the first claim-mode skill in the public plugin.
Covers:
- The four-artifact architecture (script driver, launcher skill,
iteration prompt, dedicated output style)
- Filter/bounds/model configuration with all CLI flags
- Per-iteration lifecycle (claim → /schema-workflow → commit →
RALPH_OUTCOME marker)
- Outcomes and dual-axis circuit breakers (gate-failure +
consecutive-error budgets)
- Worktree lifecycle: pid+timestamp temp naming, post-iteration
rename to UUID-based names, smart cleanup with --base-ref
- Composition with /loop and with note schemas
- When Ralph fits vs orchestrator mode (Tier 5)
- Operational notes: bypassPermissions risk-bounding, signal
forwarding, exit codes
- Troubleshooting and design notes
Also updates Integration-Guides.md (overview tier table + which-
guide-is-right-for-me + layering note) and _Sidebar.md.
Cross-references fleet-deployment.md since Ralph is the canonical
client of the claim-mode contract.
85034d5
docs: sync from main (154317f9042f26aee6d709a84106fd2431b3fe5e)
ceda313
docs: sync from main (69a01740f65e01fd0a74b3f510136cf89614e749)
67450ec
docs: sync from main (126d9fadee467531440e0eb0a5fb3ca9f36d285e)
97b3cab
docs: sync from main (c0ff5f85976c3e89063752069f1f52bec3e83dff)
2ea1161
docs: sync from main (9d7a42d75565877ac30aa6f089abac9f4246f466)
c70d6a0
docs: sync from main (6861ee5ae10d909f5e54c5e06c71c19865fed49d)
6d6773a
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>
7d4dd1b
docs: sync from main (e787bef84b2990e9bf5c7804d146c146ee024598)
b1c3b69
Updated workflow guide (markdown)
e4c52e1
docs: sync from main (d7502d830aa55a5561affaf360981cd2c7858e62)
db2b98b
docs: sync from main (f1de72c451cb28a94fae82587e678314f5ff70ae)
37658c1
docs: sync from main (8b6e24d0dd2189eaefa5bd76c7358c373fd55da3)
c6ff025
docs: delete legacy pre-v3 wiki pages
Common-Use-Cases.md and Real-World-Setup-Examples.md are leftover
from the pre-v3 system. They reference tool names that no longer
exist in the v3 13-tool API (create_feature_workflow,
task_breakdown_workflow, bug_triage_workflow, sprint_planning_workflow,
search_tasks, get_overview) and are not linked from any current
navigation. Delete them so search results don't surface stale
guidance.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
7b0c19b