Skip to content

docs(agent-management): document model changes and restart paths - #1059

Open
grandamenium wants to merge 1 commit into
mainfrom
docs/agent-mgmt-model-restart
Open

grandamenium wants to merge 1 commit into
mainfrom
docs/agent-mgmt-model-restart

Conversation

@grandamenium

Copy link
Copy Markdown
Owner

Summary

Updates the agent-management skill in all 8 template and community copies to document how to change an agent's model and which restart path actually picks up the change. A soft restart can keep the previously cached model, so the skill now points agents at a full cortextos restart and at verifying the running process afterwards.

Files (docs only, no code):

  • community/skills/agent-management/SKILL.md
  • community/agents/{research-agent,security}/.claude/skills/agent-management/SKILL.md
  • templates/{agent,analyst,orchestrator}/.claude/skills/agent-management/SKILL.md
  • templates/{agent-codex,agent-opencode}/plugins/cortextos-agent-skills/skills/agent-management/SKILL.md

Test Plan

  • Independent review (fresh, unprimed reviewer): PASS after iteration, no blocking issues
  • All 8 copies carry the same change
  • No PII, instance-specific paths, IDs or credentials in added lines (grep with positive control)
  • Docs only: no TypeScript or runtime changes

Follow-ups (non-blocking, from review)

  1. The --model description is narrower than what the code accepts.
  2. The "two ways" wording also applies to Hermes/Codex runtimes; it could say so explicitly.
  3. The worker sentence could be reworded for readability.

🤖 Generated with Claude Code

Update the agent-management skill (all 8 template and community copies)
to describe how to change an agent's model and which restart path picks
up the change, so agents stop relying on a soft restart that can keep
the cached model.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@grandamenium grandamenium added the merge-ready Reviewed + sandbox-passed + bake-elapsed; only human merge remaining (paul merge-gate) label Oct 13, 2026
This was referenced Oct 14, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

merge-ready Reviewed + sandbox-passed + bake-elapsed; only human merge remaining (paul merge-gate)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants