add-config-field
Add new field to .agents.yml config schema (updates init.md templates, version, migration)
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
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:
new_field: value # Comment explaining purpose
Or for multi-line:
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:
| 1.2 | `new_field` | Description |
B) Update migration YAML block (in "Outdated config_version" section):
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
# 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
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-02-04
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!