- Nx 22.7 monorepo (pnpm 11.1, TypeScript 5.9, Node 24) - apps/api: NestJS 11 (CJS conforme CODING-RULES.md PGD-DB-004) - apps/web: React 19 + Vite 8 (ESM) - libs/shared/api-interface: Zod contract base - Docker Compose dev: Postgres 18, Valkey 8, MinIO, Mailpit - WDS artifacts: - design-artifacts/A-Product-Brief/ (5 docs canônicos + 16 dialogs) - design-artifacts/B-Trigger-Map/ (hub + 4 personas + feature impact) - Stack canon: STACK.md v2.2 + CODING-RULES.md v2.0 + brand.md - AGENTS.md + README.md como entrada para devs/agentes Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
6.5 KiB
Agent Configuration Prompts
🚨 PREREQUISITE (MUST BE MET BEFORE DISPLAYING)
Before showing agent configuration prompts, you MUST have:
- ✅ Complexity Matrix displayed - User has seen the story complexity breakdown
- ✅
stories_jsonpopulated - Programmatic complexity data fromscripts/story-automator parse-story --rules - ✅ Complexity summary available - Counts of Low/Medium/High stories
If these are not met, DO NOT proceed with agent configuration. Go back and complete step 3.
Agent Configuration Display (v6.0.0)
IMPORTANT: This prompt MUST reference the actual complexity data. Do not show generic prompts.
IMPORTANT: Select the correct table variant based on skip_automate:
- If
skip_automateis false: show the WITH auto table - If
skip_automateis true: show the WITHOUT auto table
IMPORTANT: Before displaying options, check for saved presets:
presets_result=$("{buildStateDoc}" agent-config list --file "{agentConfigPresets}")
preset_count=$(echo "$presets_result" | jq -r '.count')
- If
preset_count > 0: include [L]oad saved option in the menu - If
preset_count == 0: omit [L] option (show only S/U/C)
Variant A: WITH auto column (skip_automate=false)
**AI Agent Configuration (Based on Your Complexity Analysis)**
Your stories by complexity:
- Low: {low_count} stories
- Medium: {medium_count} stories
- High: {high_count} stories
**Agent Details:**
- **Claude:** `claude --dangerously-skip-permissions` + natural language skill prompt
- **Codex:** `codex exec --full-auto` + natural language prompt (no command prefix)
**Suggested Complexity-Based Configuration:**
| Complexity | create | dev | auto | review | Rationale |
|------------|--------|-----|------|--------|-----------|
| Low | claude | claude | claude | claude | Claude handles simple tasks well |
| Medium | codex | codex | codex | codex | Codex for moderate complexity (Claude fallback) |
| High | codex | codex | codex | codex | Codex for complex work (Claude fallback) |
| Retro | inherits default | - | - | - | Retrospectives follow the configured primary agent unless overridden |
**Options:**
1. **[S]uggested** - Apply complexity-based defaults above
2. **[U]niform** - Same agent for ALL stories (you specify which)
3. **[C]ustom** - Define your own per-complexity or per-task settings
{IF_PRESETS}4. **[L]oad saved** - Use a previously saved configuration{END_IF_PRESETS}
Enter choice ({IF_PRESETS}S/U/C/L{ELSE}S/U/C{END_IF}) or provide custom overrides:
Conditional display rule: {IF_PRESETS} blocks render only when preset_count > 0.
Variant B: WITHOUT auto column (skip_automate=true)
**AI Agent Configuration (Based on Your Complexity Analysis)**
Your stories by complexity:
- Low: {low_count} stories
- Medium: {medium_count} stories
- High: {high_count} stories
**Agent Details:**
- **Claude:** `claude --dangerously-skip-permissions` + natural language skill prompt
- **Codex:** `codex exec --full-auto` + natural language prompt (no command prefix)
**Suggested Complexity-Based Configuration:**
| Complexity | create | dev | review | Rationale |
|------------|--------|-----|--------|-----------|
| Low | claude | claude | claude | Claude handles simple tasks well |
| Medium | codex | codex | codex | Codex for moderate complexity (Claude fallback) |
| High | codex | codex | codex | Codex for complex work (Claude fallback) |
| Retro | inherits default | - | - | Retrospectives follow the configured primary agent unless overridden |
**Options:**
1. **[S]uggested** - Apply complexity-based defaults above
2. **[U]niform** - Same agent for ALL stories (you specify which)
3. **[C]ustom** - Define your own per-complexity or per-task settings
{IF_PRESETS}4. **[L]oad saved** - Use a previously saved configuration{END_IF_PRESETS}
Enter choice ({IF_PRESETS}S/U/C/L{ELSE}S/U/C{END_IF}) or provide custom overrides:
Load Saved Preset Prompt (Option L)
Prerequisite: preset_count > 0 (checked before displaying main menu).
presets_result=$("{buildStateDoc}" agent-config list --file "{agentConfigPresets}")
Display:
**Saved Agent Configurations:**
{numbered list from presets_result, e.g.:}
1. all-claude (saved 2026-03-10)
2. codex-heavy (saved 2026-03-08)
[D]elete a preset
Enter preset number to load, or [B]ack to return to options:
Wait.
IF number selected:
preset_name="{selected preset name}"
loaded=$("{buildStateDoc}" agent-config load --file "{agentConfigPresets}" --name "$preset_name")
agent_config_json=$(echo "$loaded" | jq -r '.config')
Display loaded config summary, then proceed with this as agent_config_json.
IF D selected: Ask which preset number to delete, then:
"{buildStateDoc}" agent-config delete --file "{agentConfigPresets}" --name "$delete_name"
Redisplay this prompt (or return to main options if no presets remain).
IF B selected: Return to main S/U/C/L menu.
Save Configuration Prompt
When to show: After the user completes a [C]ustom or [U]niform configuration (NOT after [S]uggested or [L]oad).
**Save this configuration for future runs?**
Enter a name to save (e.g., `all-claude`, `codex-heavy`) or [N]o to skip:
Wait.
IF name provided:
"{buildStateDoc}" agent-config save --file "{agentConfigPresets}" --name "$save_name" --config-json "$agent_config_json"
Display: "Configuration saved as {save_name}."
IF N or empty: Skip, continue.
Uniform Agent Prompt (Option U)
**Uniform Agent Configuration**
Use the same agent for ALL {total_count} stories regardless of complexity.
Which agent for all tasks?
- `claude` - Claude for everything (more capable, slower)
- `codex` - Codex for everything (faster, simpler)
- `claude, false` - Claude only, no fallback
- `codex, claude` - Codex primary, Claude fallback
Enter agent config:
Custom Configuration Prompt (Option C)
**Custom Agent Configuration**
Define agents per complexity level and/or per task.
**Per-Complexity Format:** `complexity.task: primary, fallback`
- `low.dev: claude, false` → Claude for low-complexity dev, no fallback
- `medium.create: codex, claude` → Codex for medium-complexity create
- `high.review: claude, false` → Claude for high-complexity review
**Per-Task Format (applies to all complexities):** `task: primary, fallback`
- `review: claude, false` → Claude for ALL reviews
- `dev: codex, claude` → Codex for ALL dev
**Complexity levels:** low, medium, high
**Tasks:** create, dev, auto, review
Enter overrides (comma-separated):