majesticlabs-dev/majestic-marketplace

add-config-field

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

Voir la source
Document Skill original

Rendu depuis le dépôt source en conservant titres, exemples, code, tableaux, liens et images.

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.md4 YAML templates that generate .agents.yml
plugins/majestic-engineer/config-schema-versionSchema version number
plugins/majestic-engineer/agents/config-reader.mdChangelog + migration logic
plugins/majestic-engineer/.claude-plugin/plugin.jsonPlugin version
.claude-plugin/marketplace.jsonMarketplace 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.11.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.03.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
du même dépôt

Autres Skills

Tous les Skills