Add Config Field
Add a new field to the .agents.yml config schema with proper versioning and migration support.
Files Changed
| File | Purpose |
|---|---|
plugins/majestic-engineer/commands/workflows/init.md | 4 YAML templates that generate .agents.yml |
plugins/majestic-engineer/config-schema-version | Schema version number |
plugins/majestic-engineer/agents/config-reader.md | Changelog + migration logic |
plugins/majestic-engineer/.claude-plugin/plugin.json | Plugin version |
.claude-plugin/marketplace.json | Marketplace version |
Input
- Field name: e.g.,
auto_commit - Default value: e.g.,
falseor multi-line YAML - Section: Where in template (Workflow, Quality Gate, etc.)
- Comment: Inline explanation
- Used by: Agent/command that reads this field
Steps
1. Update init.md Templates
File: plugins/majestic-engineer/commands/workflows/init.md
Add field to ALL 4 templates (Rails, Python, Node, Generic). Find the appropriate section and add:
yaml1new_field: value # Comment explaining purpose
Or for multi-line:
yaml1new_field: # Comment 2 - item1 3 - item2
2. Bump Schema Version
File: plugins/majestic-engineer/config-schema-version
Increment: 1.1 → 1.2
3. Update config-reader.md
File: plugins/majestic-engineer/agents/config-reader.md
A) Add to Version Changelog table:
markdown1| 1.2 | `new_field` | Description |
B) Update migration YAML block (in "Outdated config_version" section):
yaml1new_field: default_value
4. Bump Plugin Versions
Files:
plugins/majestic-engineer/.claude-plugin/plugin.json:3.15.0→3.16.0.claude-plugin/marketplace.json: Update majestic-engineer entry version
5. Update Consumer Docs (if needed)
If a specific agent/command reads this field, update its documentation to mention the config.
Verification
bash1# Count field in init.md (should be 4 - one per template) 2grep -c "new_field" plugins/majestic-engineer/commands/workflows/init.md 3 4# Check schema version 5cat plugins/majestic-engineer/config-schema-version 6 7# Check changelog entry 8grep "new_field" plugins/majestic-engineer/agents/config-reader.md