# 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](/home/hartmut/Documents/Copilot/planarchy/.agents/sprints/widget-field-refactor/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](/home/hartmut/Documents/Copilot/planarchy/docs/azure_codex_setup.md).

## Start

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

## Restore Prior Config

If you want the previous active config back:

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