Problem Statement
Per-agent timeout is documented in README and docs/EXAMPLES.md, but it is not obvious that defaults.timeout, defaults.litellm_model, and defaults.temperature in rooms.settings.yaml apply to shipped personas and the orchestrator unless overridden in the wizard. New users may edit only per-agent fields in-session and miss the global settings file.
Proposed Solution
- Add a short subsection (EXAMPLES or ARCHITECTURE): “Global defaults vs per-agent overrides”.
- Include a small table:
defaults.litellm_model, defaults.timeout, defaults.temperature, defaults.orchestrator_model, and when the wizard overrides them.
- Cross-link
rooms.settings.example.yaml, python cli.py config init, and built-in fallbacks when no file exists.
- No code changes required unless a one-line CLI hint on startup is desired (optional, separate commit).
Alternatives Considered
- Rely on example YAML comments only — insufficient; example file is not read by everyone before first run.
- Duplicate full settings schema in README — too heavy; link to example + one cheat-sheet table is enough.
Priority
Low 🟢
Additional Context
Complements #28; no dependency on presets or auto_select_first issues. Good good-first-issue for contributors comfortable with Markdown only.
Problem Statement
Per-agent
timeoutis documented in README anddocs/EXAMPLES.md, but it is not obvious thatdefaults.timeout,defaults.litellm_model, anddefaults.temperatureinrooms.settings.yamlapply to shipped personas and the orchestrator unless overridden in the wizard. New users may edit only per-agent fields in-session and miss the global settings file.Proposed Solution
defaults.litellm_model,defaults.timeout,defaults.temperature,defaults.orchestrator_model, and when the wizard overrides them.rooms.settings.example.yaml,python cli.py config init, and built-in fallbacks when no file exists.Alternatives Considered
Priority
Low 🟢
Additional Context
Complements #28; no dependency on presets or
auto_select_firstissues. Goodgood-first-issuefor contributors comfortable with Markdown only.