julian
17c08e6392
- 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>
200 lines
6.5 KiB
Markdown
200 lines
6.5 KiB
Markdown
# Agent Configuration Prompts
|
|
|
|
---
|
|
|
|
## 🚨 PREREQUISITE (MUST BE MET BEFORE DISPLAYING)
|
|
|
|
Before showing agent configuration prompts, you MUST have:
|
|
|
|
1. ✅ **Complexity Matrix displayed** - User has seen the story complexity breakdown
|
|
2. ✅ **`stories_json` populated** - Programmatic complexity data from `scripts/story-automator parse-story --rules`
|
|
3. ✅ **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_automate` is **false**: show the **WITH auto** table
|
|
- If `skip_automate` is **true**: show the **WITHOUT auto** table
|
|
|
|
**IMPORTANT:** Before displaying options, check for saved presets:
|
|
```bash
|
|
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).
|
|
|
|
```bash
|
|
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:**
|
|
```bash
|
|
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:
|
|
```bash
|
|
"{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:**
|
|
```bash
|
|
"{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):
|
|
```
|