Skip to content

docs: explain global defaults and per-agent overrides - #64

Merged
rosspeili merged 2 commits into
ARPAHLS:mainfrom
Kangwenqiao:docs/issue-33-global-defaults
Jul 30, 2026
Merged

docs: explain global defaults and per-agent overrides#64
rosspeili merged 2 commits into
ARPAHLS:mainfrom
Kangwenqiao:docs/issue-33-global-defaults

Conversation

@Kangwenqiao

Copy link
Copy Markdown
Contributor

Summary

  • add a focused global-defaults vs per-agent-overrides table to the settings guide
  • clarify which wizard choices are session-only and document the current timeout and orchestrator temperature behavior
  • link the examples cheat sheet to the new section and cross-reference settings initialization, the example YAML, and built-in fallbacks

Testing

  • uv run --with pytest --with-requirements requirements.txt python -m pytest -q (77 passed)

Closes #33

@rosspeili

Copy link
Copy Markdown
Contributor

Thanks @Kangwenqiao, this looks good to merge.

Minor gaps I would include in the same PR to avoid follow ups

  • docs/README.md still says settings semantics are “tracked separately”, a one-line update pointing to this new section would close the loop.
  • Maybe a cross-link from ARCHITECTURE.md user-settings section.

LGTM overall, will merge after these are in, nice first contribution. <3

@Kangwenqiao

Copy link
Copy Markdown
Contributor Author

Thanks for the review. I addressed both follow-ups in a338a13:

  • updated docs/README.md to link directly to the new global-defaults vs per-agent-overrides section instead of saying the semantics are tracked separately
  • added the same precedence cross-link to the user-settings section in docs/ARCHITECTURE.md

Validation: documentation tests pass (19), and the full suite passes (77).

@rosspeili

Copy link
Copy Markdown
Contributor

Thanks @Kangwenqiao, follow-up LGTM, merging as is. Closes #33. Nice work. ❤️

@rosspeili
rosspeili merged commit 7935359 into ARPAHLS:main Jul 30, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document global YAML defaults vs per-agent overrides in settings docs

2 participants