[P5.3] Docs sweep: README provider matrix, setup guides, CLAUDE.md, templates

[frankbria]

Phase 5 — Cross-cutting. Final documentation pass once providers land.

Scope

• README: provider matrix, --provider usage, per-provider quick-starts, feature-support
  table (which Ralph features work per provider).
• CLAUDE.md: new lib/agents/ architecture section, AGENT_PROVIDER config, exit-detection
  portability notes, per-provider capability caveats.
• templates/ and .ralphrc generation: AGENT_PROVIDER documented.
• Ensure each docs/providers/<NAME>.md is linked and consistent.

Acceptance

• Docs match shipped behavior; no stale claude-only assumptions remain in user docs.

Depends on: [P4.1]–[P4.5], [P5.1], [P5.2].

[github-actions]

Triage: Documentation

Categorized this as a documentation task and applied the documentation label (in addition to the existing multi-provider epic label).

Why: The issue is explicitly a final docs sweep — updating the README provider matrix, CLAUDE.md architecture/config sections, templates/ + .ralphrc generation, and ensuring docs/providers/<NAME>.md files are linked and consistent. It carries clear scope and a single acceptance criterion (docs match shipped behavior; no stale claude-only assumptions remain). It is not a bug or a support question.

Not a duplicate: This is the unique [P5.3] work item within the multi-provider epic (#310–#325). Each phase issue covers distinct scope, so no consolidation is warranted.

Recommended next steps:

• This is a cross-cutting Phase 5 task with stated dependencies on [P4.1]–[P4.5] ([P4.1] Gemini adapter — build + parse + capabilities + tests + docs #318–[P4.5] Copilot adapter (text-only, degraded) — build + parse + capabilities + tests + docs #322), [P5.1] ([P5.1] Sandbox provider-awareness (docker/e2b wrap any provider) #323), and [P5.2] ([P5.2] Monitor + status.json provider surfacing #324). It should stay blocked until those provider adapters and surfacing tasks land, so the docs describe actually-shipped behavior.
• No category-change action needed beyond labeling; left open and assigned to the epic owner's workflow.

Not assigned to @frankbria via the bug path, since this is documentation rather than a bug report.

Generated by Issue Triage Assistant for issue #325 · opus48 378.3K · ◷