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:
yaml
new_field: value # Comment explaining purpose
Or for multi-line:
yaml
new_field: # Comment - item1 - 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:
markdown
| 1.2 | `new_field` | Description |
B) Update migration YAML block (in "Outdated config_version" section):
yaml
new_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
bash
# Count field in init.md (should be 4 - one per template) grep -c "new_field" plugins/majestic-engineer/commands/workflows/init.md # Check schema version cat plugins/majestic-engineer/config-schema-version # Check changelog entry grep "new_field" plugins/majestic-engineer/agents/config-reader.md