docs: refresh user-facing guide + reference for current code state

Audit pass against root AGENTS.md (regenerated 2026-05-08) and the
canonical sources in src/shared/model-requirements.ts,
src/features/team-mode/, src/cli/, src/config/schema/. Each touched file
keeps its existing tone but corrects stale facts:

- guide/overview.md: project name + dual-package transition reality
- guide/installation.md: bun-only invocation, dual oh-my-openagent /
  oh-my-opencode CLI surface, current doctor categories
- guide/orchestration.md: 11 agents, category routing through
  sisyphus-junior, background concurrency, team-mode link
- guide/agent-model-matching.md: Metis primary -> claude-sonnet-4-6
  (matches src/shared/model-requirements.ts fallback chain)
- guide/team-mode.md: full schema, member eligibility tiers, 12 team_*
  tools added when enabled
- reference/cli.md: trim to current Commander surface (install, doctor,
  run, mcp-oauth, refresh-model-capabilities, get-local-version)
- reference/configuration.md: trim to schema-driven reference, JSONC
  rules, multi-level merge order, mcp_env_allowlist user-only constraint
- reference/features.md: 5-tier hook composition counts, 3-tier MCPs,
  hashline edit, IntentGate, OpenClaw bidirectional dispatcher

Cross-cutting: every `oh-my-opencode.schema.json` URL replaced with
the canonical `oh-my-openagent.schema.json` (legacy package name in
text bodies preserved where it documents the dual-publish transition).

docs/guide/team-mode.md

@@ -14,7 +14,7 @@ OFF by default. Enable via JSONC config.
 
 ## Enable
 
-Add to `~/.config/opencode/oh-my-opencode.jsonc` (or project `.opencode/oh-my-opencode.jsonc`):
+Add to user config `~/.config/opencode/oh-my-openagent.jsonc` or project config `.opencode/oh-my-openagent.jsonc`:
 
 ```jsonc
 {
@@ -29,9 +29,25 @@ Add to `~/.config/opencode/oh-my-opencode.jsonc` (or project `.opencode/oh-my-op
 
 After enabling, restart opencode. The 12 `team_*` tools become available.
 
+## Config schema (11 fields)
+
+All fields live under `team_mode`:
+
+- `enabled` (boolean, default `false`)
+- `tmux_visualization` (boolean, default `false`)
+- `max_parallel_members` (int, `1..8`, default `4`)
+- `max_members` (int, `1..8`, default `8`)
+- `max_messages_per_run` (int, `>=1`, default `10000`)
+- `max_wall_clock_minutes` (int, `>=1`, default `120`)
+- `max_member_turns` (int, `>=1`, default `500`)
+- `base_dir` (optional string; default resolves to `~/.omo`)
+- `message_payload_max_bytes` (int, `>=1024`, default `32768`)
+- `recipient_unread_max_bytes` (int, `>=1024`, default `262144`)
+- `mailbox_poll_interval_ms` (int, `>=500`, default `3000`)
+
 ## Define a team
 
-Teams live as directories under `~/.omo/teams/{name}/config.json`:
+Team specs live under `~/.omo/teams/{name}/config.json` (user scope) or `<project>/.omo/teams/{name}/config.json` (project scope):
 
 ```json
 {
@@ -45,7 +61,7 @@ Teams live as directories under `~/.omo/teams/{name}/config.json`:
 }
 ```
 
-Project-scoped variant: `<project>/.omo/teams/{name}/config.json` (project beats user on collisions).
+When both scopes define the same team name, project scope wins.
 
 `version`, `createdAt`, and `leadAgentId` are optional in config files. The loader fills them automatically. You can either write a top-level `lead: {...}` shorthand, mark one member with `isLead: true`, or omit both when the team has exactly one member.
 
@@ -56,7 +72,11 @@ Project-scoped variant: `<project>/.omo/teams/{name}/config.json` (project beats
 
 ## Eligible agents
 
-Only **sisyphus, atlas, sisyphus-junior, hephaestus** can be members. Read-only and orchestration-only agents (`oracle`, `librarian`, `explore`, `multimodal-looker`, `metis`, `momus`, `prometheus`) are rejected at parse time. Use `delegate-task` for those.
+- **Eligible:** `sisyphus`, `atlas`, `sisyphus-junior`.
+- **Conditional:** `hephaestus` (needs teammate permission `teammate: "allow"`; otherwise use `subagent_type: "sisyphus"`).
+- **Hard-reject:** `oracle`, `librarian`, `explore`, `multimodal-looker`, `metis`, `momus`, `prometheus`.
+
+Hard-reject agents fail TeamSpec parsing because they cannot write mailbox state. Use `delegate-task` for those agents.
 
 ## Lifecycle