add-config-field

Original🇺🇸 English
Translated

Add new field to .agents.yml config schema (updates init.md templates, version, migration)

15installs

NPX Install

npx skill4agent add majesticlabs-dev/majestic-marketplace add-config-field

Tags

Translated version includes tags in frontmatter

Add Config Field

Add a new field to the
.agents.yml
config schema with proper versioning and migration support.

Files Changed

FilePurpose
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.,
    false
    or 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