Skip to content

refactor(agents): Move five Sol agents to Claude Sonnet 5.5 - #758

Merged
jonathan-vella merged 3 commits into
mainfrom
chore/move-sol-agents-to-sonnet-5-5
Oct 12, 2026
Merged

jonathan-vella merged 3 commits into
mainfrom
chore/move-sol-agents-to-sonnet-5-5

Conversation

@jonathan-vella

Copy link
Copy Markdown
Owner

Description

Moves 02-Requirements, 03-Architect, 05-IaC Planner, 10-Challenger and 11-Context Optimizer from GPT-6.1 Sol (copilot) to Claude Sonnet 5.5 (copilot). The five keep reasoning-effort: high, so the effort policy now names them as an exception to the Sonnet default of medium.

Type of Change

  • 🤖 Agent definition update (.github/agents/)
  • ⚙️ Configuration/workflow change

Token / latency impact

This change affects input-token budget / per-call latency:

  • YES (provide a magnitude estimate below)

The Claude hard checkpoint (>=160K input) now applies to these five agents instead of >=300K. No measurement was taken.

Workflow Used

  • Direct implementation (simple change)

Changes Made

Files modified:

  • .github/agents/{02,03,05,10,11}-*.agent.md: model switched; bodies rewritten to the Claude contract (## Role, <scope_fencing>, <output_contract>, <stop_conditions>, <context_awareness>). 03, 05 and 11 gain <investigate_before_answering>; 02 omits it because it is one-shot. 03 and 05 were trimmed of duplicated sections to stay within the 600-line body limit.
  • tools/registry/agent-registry.json, tools/registry/architecture-explorer-graph.json, .github/model-catalog.json: assignments updated (catalog assignments and graph regenerated by their scripts).
  • Effort policy: agent-authoring.instructions.md, model-policy.md, test_skill_consolidation.mjs.
  • Wording: "Sol step" replaced with model-neutral text in apex-host-workflow-start, apex-workflow-engine references and cost-estimate-parent-contract.md; matching test assertions updated.

Unchanged: the four utility prompts stay on GPT-6.1 Sol, so the label and the gpt-6-sol family remain authorized.

Testing Performed

Code Quality

  • Pre-commit hook passed (npm run lint:md)
  • Agent YAML frontmatter validates

npm run validate:all, npm run validate:agents, npm run lint:vendor-prompting, validate-models.mjs, validate:agent-registry, generate-model-catalog.mjs --check and the touched node --test files all pass. Pre-push checks pass.

Docs follow-up: a changelog entry in jonathan-vella/apex-docs.

Requirements, Architect, IaC Planner, Challenger and Context Optimizer now use

Claude Sonnet 5.5 at high effort and follow the Claude body contract. Registry, catalog,

explorer graph, effort policy, skill wording and tests are updated.

The utility prompts keep GPT-6.1 Sol.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Changes recommended

Converted Claude agents need consistent untrusted-content fencing, and the policy test does not protect all five exceptions.

4 open findings
What changed in this PR

Moves five workflow agents from GPT-6.1 Sol to Claude Sonnet 5.5 while preserving high reasoning effort.

Changes:

  • Converts five agent bodies to the Claude contract.
  • Synchronizes model registries and routing references.
  • Updates effort-policy and model-assignment tests.
File Description
.github/​agents/​02-requirements.agent.md Converts Requirements to Claude.
.github/​agents/​03-architect.agent.md Converts and restructures Architect.
.github/​agents/​05-iac-planner.agent.md Converts and streamlines IaC Planner.
.github/​agents/​10-challenger.agent.md Converts Challenger to Claude.
.github/​agents/​11-context-optimizer.agent.md Converts Context Optimizer to Claude.
.github/​instructions/​agent-authoring.instructions.md Defines high-effort Sonnet exceptions.
.github/​model-catalog.json Updates model inventory and assignments.
.github/​skills/​apex-agent-authoring/​references/​model-policy.md Documents the revised effort policy.
.github/​skills/​apex-azure-defaults/​references/​cost-estimate-parent-contract.md Updates Architect routing.
.github/​skills/​apex-host-workflow-start/​SKILL.md Makes routing language model-neutral.
.github/​skills/​apex-workflow-engine/​references/​operational-safety.md Generalizes specialist-step restrictions.
.github/​skills/​apex-workflow-engine/​references/​review-imported-iac.md Generalizes imported-IaC routing language.
.github/​skills/​apex-workflow-engine/​references/​workflow-entry.md Generalizes workflow-entry restrictions.
tools/​registry/​agent-registry.json Mirrors new model assignments.
tools/​registry/​architecture-explorer-graph.json Regenerates explorer metadata.
tools/​tests/​scripts/​test_host_adapters.mjs Updates routing assertion wording.
tools/​tests/​scripts/​test_post_write_validation.mjs Updates Architect model assertion.
tools/​tests/​scripts/​test_skill_consolidation.mjs Tests revised effort policy.
tools/​tests/​vendor-prompting/​run.test.mjs Tests canonical agent assignments.

🧠 Review effort: Balanced

Comment thread .github/agents/03-architect.agent.md
Comment thread .github/agents/05-iac-planner.agent.md
Comment thread .github/agents/10-challenger.agent.md Outdated
Comment thread tools/tests/scripts/test_skill_consolidation.mjs Outdated
The tool-contracts test asserts the phrase in 03-Architect. The earlier trim dropped it.
Wrap Learn results, worker output and artifacts in pasted_content in 03, 05 and 10.

Assert the full five-agent high-effort exception in the policy test.
@jonathan-vella
jonathan-vella merged commit 1ccf57c into main Oct 12, 2026
10 checks passed
@jonathan-vella
jonathan-vella deleted the chore/move-sol-agents-to-sonnet-5-5 branch October 12, 2026 17:30
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.

2 participants