init-agents-config

Init Agents Config

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

Resources

Template Selection by Tech Stack

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

1. 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

1. 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.