Implement Plugin

Implement plugin-level packaging, manifest wiring, structure checks, runtime load checks, and distribution guidance.

Workflow

1. •Define plugin metadata and distribution scope.
2. •Update .claude-plugin/plugin.json and component path mappings.
3. •Validate manifest and directory structure.
4. •Verify runtime load with --plugin-dir and optional install flow.
5. •Run CI-parity smoke tests before distribution.

Project-Specific Patterns (dbt-heros)

When working in this repository:

Pre-Implementation Checklist

• •Review CLAUDE.md for architectural philosophy and safety requirements
• •Check repository rules in .claude/rules/ (auto-loaded context)
• •Review related ADRs in docs/adr/ for architectural decisions
• •Verify safety mode enforcement is planned if plugin has destructive tools

Plugin Structure Requirements

• •Follow canonical layout (see .claude/rules/plugin-patterns.md)
• •Use lowercase-with-hyphens naming (e.g., lightdash-development)
• •Include safety hooks for any destructive tools (see ADR-0005)
• •Place plugin-specific components in plugins/{name}/
• •Place shared components in .claude/skills/ (not in plugin directories)

Safety Mode Integration

If the plugin includes destructive operations:

1. •Define safety mode requirements in tool descriptions
2. •Add PreToolUse hooks in hooks/hooks.json
3. •Implement deterministic safety checks (not just LLM prompts)
4. •Document safety modes in plugin README

Testing Requirements

Before finalizing plugin:

• •Run make format and make lint
• •Run make test-integration-docker successfully
• •Validate manifest: ./integration_tests/validate-manifest.sh
• •Test plugin loading: ./integration_tests/test-plugin-loading.sh
• •Document test evidence

Documentation Requirements

• •Create/update plugin README in plugins/{name}/README.md
• •Add entry to main README.md plugin table
• •Create plugin documentation in docs/plugins/
• •Create ADR if plugin introduces new architectural patterns

Monorepo Coordination

• •Check if other plugins have similar patterns (avoid duplication)
• •Consider extracting shared logic to .claude/skills/
• •Verify symlink topology remains intact (.agents/skills, .claude/agents)
• •Ensure plugin works independently (no tight coupling to other plugins)

Progressive Disclosure

• •

  Manifest schema and field rules: references/manifest-schema.md

• •

  Directory conventions and anti-patterns: references/directory-structure.md

• •

  Test strategy across local/CI: references/testing-strategies.md

• •

  Distribution checklist and channels: references/plugin-distribution.md

• •

  Scope and install context guidance: references/plugin-scopes.md

• •

  Manifest validator: scripts/validate-manifest.sh

• •

  Layout validator: scripts/check-structure.sh

• •

  Runtime load check: scripts/test-plugin-load.sh

• •

  Minimal manifest template: assets/templates/minimal-plugin.json

• •

  Complete manifest template: assets/templates/complete-plugin.json

• •

  Manifest with components template: assets/templates/plugin-with-components.json

Component Skills

• •Hooks: ../implement-hooks/SKILL.md
• •Agent Skills: ../implement-agent-skills/SKILL.md
• •Sub-Agents: ../implement-sub-agents/SKILL.md
• •Agent Teams: ../implement-agent-teams/SKILL.md
• •Umbrella selection guide: ../implement-claude-extensions/SKILL.md

Sources

• •https://code.claude.com/docs/en/plugins
• •https://code.claude.com/docs/en/plugins-reference