mcpField
A
add-config-field

add-config-field

github.com/majesticlabs-devDevelopment5082 installsUpdated 7w ago
Repository

About add-config-field

add-config-field is a development skill for adding fields to the majestic-engineer plugin's `.agents.yml` schema. It covers templates, schema versioning, migration logic, plugin versions, and verification steps.

Key features

  1. 01Add fields to four config templates
  2. 02Increment the schema version
  3. 03Update changelog and migration defaults
  4. 04Sync plugin and marketplace versions
  5. 05Verify changes with shell commands

Use cases

  1. 01Add a setting to `.agents.yml`
  2. 02Maintain configuration schema migrations
  3. 03Update docs for agents or commands that read a new field

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/majesticlabs-dev/majestic-marketplace --skill add-config-field

After installing, type/add-config-fieldin Claude Code to confirm it loaded.

Details

From the project README

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:

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

Comments

Markdown supported