chore(repo): initialize planarchy workspace

2026-03-14 14:31:09 +01:00
commit dd55d0e78b
769 changed files with 166461 additions and 0 deletions
@@ -0,0 +1,52 @@
+# 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
+```