CapaKraken/.agents/sprints/widget-field-refactor/GPT-5.4-README.md

GPT-5.4 Sprint Variant

This is the OpenAI/Codex-oriented variant of the widget + field refactor sprint setup.

Files

• .agents/config.gpt-5.4.toml
• .agents/sprints/widget-field-refactor/start-gpt-5.4.sh

What It Does

The launcher:

1. switches the active Claude Flow config to the GPT-5.4 variant
2. verifies that ~/.codex/config.toml is using an Azure provider
3. verifies that AZURE_OPENAI_API_KEY is exported
4. initializes the swarm with hierarchical topology
5. spawns the named sprint agents
6. prints the prompt files and startup order

Agent Type Mapping

Claude Flow does not expose an orchestrator agent type in the CLI. The sprint launcher therefore maps:

• O1 orchestrator role -> CLI coordinator type

The role behavior still comes from O1-orchestrator.md, which explicitly forbids implementation work.

Azure Requirement

This launcher is intended to run against Azure OpenAI-backed Codex. It will fail fast unless:

• ~/.codex/config.toml exists
• model_provider starts with azure
• the config references AZURE_OPENAI_API_KEY
• AZURE_OPENAI_API_KEY is present in the shell environment

See docs/azure_codex_setup.md.

Start

bash .agents/sprints/widget-field-refactor/start-gpt-5.4.sh

Restore Prior Config

If you want the previous active config back:

cp .agents/config.toml.pre-gpt-5.4.bak .agents/config.toml