---
name: init-agents-config
description: Generate .agents.yml config from user answers. Provides tech stack templates for Rails, Python, Node, and Generic projects.
allowed-tools: Read Write
---

# Init Agents Config

Assemble `.agents.yml` from collected user answers during `Skill("init")`.

## Resources

| Resource | Purpose |
|----------|---------|
| `CONFIG_VERSION` | Current .agents.yml schema version |
| `assets/rails.yaml` | Rails config template |
| `assets/python.yaml` | Python config template |
| `assets/node.yaml` | Node config template |
| `assets/generic.yaml` | Generic config template |
| `references/agents-md-template.md` | AGENTS.md best practices |
| `assets/local-config-template.yaml` | Local overrides template |

## Template Selection by Tech Stack

| Tech Stack | Template |
|------------|----------|
| Rails | `assets/rails.yaml` |
| Python | `assets/python.yaml` |
| Node | `assets/node.yaml` |
| Generic | `assets/generic.yaml` |

## Assembly Instructions

1. Read the appropriate template based on detected `tech_stack`
2. Replace placeholders with collected answers:
   - `{{config_version}}` - Read from `CONFIG_VERSION` file
   - `{{owner_level}}` - beginner, intermediate, senior, expert
   - `{{task_management}}` - github, linear, beads, file, none
   - Stack-specific fields from user answers
3. Conditionally include/exclude sections:
   - Remove `extras:` section if no Solid gems selected (Rails)
   - Remove `toolbox.build_task.design_system_path` if no design system detected
   - Comment out `browser:` section unless user selected non-Chrome browser
4. Write to `.agents.yml`

## Conditional Sections

### Task Tracking
Commented out by default (opt-in). Uncomment only if user explicitly enables task tracking:
- `task_tracking.enabled` - Create Tasks during workflows for visibility
- `task_tracking.ledger` - YAML checkpoints for crash recovery
- `task_tracking.ledger_path` - Path to workflow ledger file
- `task_tracking.auto_cleanup` - Remove tasks after workflow completion

### Quality Gate Reviewers
Each stack has default reviewers. Include optional reviewers only if user enables them:
- `dhh-code-reviewer` - Rails strict style
- `data-integrity-reviewer` - Migration safety
- `codex-reviewer` / `gemini-reviewer` - External LLM

### Browser Config
Default is commented out (uses Chrome). Uncomment only if user selects Brave or Edge.

### Extras (Rails only)
Include only Solid gems the user selected:
- `solid_cache`
- `solid_queue`
- `solid_cable`

## Output

Write generated config to `.agents.yml` in project root.