Skip to content
Buck Bronson

Adding Presets & Plugins

Adding a new preset

Section titled “Adding a new preset”

1. Add setup steps to the code review workflow

Section titled “1. Add setup steps to the code review workflow”

If the preset needs dev environment setup, add conditional setup steps in .github/workflows/bucky-code-review.yml:

- name: Setup <name>
  if: steps.preset.outputs.setup-action == 'setup-<name>'
  run: |
    # your setup steps

2. Update presets.json

Section titled “2. Update presets.json”

Add the new preset to presets.json at the repo root:

{
  "mypreset": {
    "setup_action": "setup-mypreset",
    "plugins": [
      "common@buck-bronson",
      "mypreset@buck-bronson"
    ],
    "secrets": {
      "sourcegraph-token": "SOURCEGRAPH_TOKEN"
    }
  }
}

Set setup_action to null if no dev environment setup is needed.

3. Add detection logic

Section titled “3. Add detection logic”

Update cli/src/detect.rs to detect the new project type by checking for a marker file.

4. Update the CLI preset enum

Section titled “4. Update the CLI preset enum”

Add the new preset to the Preset enum in cli/src/preset.rs.

5. Add conditional setup in the code review workflow

Section titled “5. Add conditional setup in the code review workflow”

Update .github/workflows/bucky-code-review.yml to add a conditional step for the new preset:

- name: Setup mypreset
  if: steps.preset.outputs.setup-action == 'setup-mypreset'
  run: |
    # setup commands

6. Update documentation

Section titled “6. Update documentation”
  • Update CLAUDE.md with the new preset details
  • Update README.md presets table
  • Update the Presets docs page

Adding a new plugin

Section titled “Adding a new plugin”

1. Create the plugin directory

Section titled “1. Create the plugin directory”
plugins/<name>/
├── .claude-plugin/
│   └── plugin.json
├── .mcp.json
└── README.md

2. Write plugin.json

Section titled “2. Write plugin.json”
{
  "name": "<name>",
  "version": "1.0.0",
  "description": "Description of what this plugin provides"
}

3. Configure MCP servers in .mcp.json

Section titled “3. Configure MCP servers in .mcp.json”
{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "@some/mcp-server"],
      "env": {
        "API_TOKEN": "{{SOME_TOKEN}}"
      }
    }
  }
}

4. Add to presets

Section titled “4. Add to presets”

Update presets.json to include the new plugin in the relevant preset(s):

{
  "web": {
    "plugins": [
      "common@buck-bronson",
      "web@buck-bronson",
      "myPlugin@buck-bronson"
    ]
  }
}

5. Add secrets if needed

Section titled “5. Add secrets if needed”

If the plugin requires secrets:

  1. Add the secret mapping to the preset in presets.json
  2. Document the new secret in Configuring Secrets
  3. Add the secret injection in the shared workflows

6. Update documentation

Section titled “6. Update documentation”
  • Update CLAUDE.md with the new plugin details
  • Update README.md plugins table
  • Update the Plugins docs page