Init Agents Config

Assemble .agents.yml from collected user answers during /majestic: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

• Read the appropriate template based on detected tech_stack

• 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

• 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

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