init-agents-config

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.