Architecture Design

Create a Discipline (道 - Do) Plugin

Create a new discipline plugin for: $ARGUMENTS

What is a Discipline Plugin?

Discipline plugins represent "the way" or path of mastery in the Han marketplace. They provide specialized agents that embody expertise in specific development disciplines. Each discipline contains one or more agents with deep domain knowledge.

Plugin Structure

Create the following directory structure:

plugins/disciplines/{discipline-name}/
├── .claude-plugin/
│   └── plugin.json          # Plugin metadata (ONLY plugin.json goes here)
├── agents/
│   └── {agent-name}.md     # Agent definition
├── han-plugin.yml           # Han configurations (at plugin root)
├── hooks/
│   └── hooks.json           # Claude Code hooks (optional)
├── skills/
│   └── {skill-name}/
│       └── SKILL.md        # Skill documentation (optional)
└── README.md               # Plugin documentation

IMPORTANT:

• Only plugin.json goes inside .claude-plugin/
• hooks.json goes in the hooks/ directory
• han-plugin.yml stays at the plugin root (NOT in hooks/)
• Discipline names should be descriptive (e.g., frontend-development, api-engineering, security-engineering)

Step 1: Create plugin.json

Create .claude-plugin/plugin.json:

{
  "name": "{discipline-name}",
  "version": "1.0.0",
  "description": "Specialized agents for {discipline area} including {key responsibilities}.",
  "author": {
    "name": "The Bushido Collective",
    "url": "https://thebushido.co"
  },
  "homepage": "https://github.com/thebushidocollective/han",
  "repository": "https://github.com/thebushidocollective/han",
  "license": "MIT",
  "keywords": [
    "{discipline}",
    "{specialty}",
    "agent",
    "{related-area}"
  ]
}

Step 2: Create han-plugin.yml

Create han-plugin.yml at the plugin root:

# {discipline-name} plugin configuration
# This plugin provides specialized agents for {discipline area}

# No hooks for agent-focused plugins (unless needed)
hooks: {}

# No MCP server (unless this discipline provides one)
mcp: null

# Memory provider (optional)
memory: null

Step 3: Create Agent Definitions

For each specialized role, create an agent markdown file.

Agent File: agents/{agent-name}.md

---
name: {agent-name}
description: |
  {One-paragraph description of the agent's expertise, focus areas, and when to invoke them.}
model: inherit
color: {purple|blue|green|red|yellow|cyan|magenta}
---

# {Agent Title}

## Role

{Detailed description of the agent's role and expertise}

## Core Responsibilities

### {Responsibility Area 1}
- {Specific capability}
- {Specific capability}

## Approach

1. **{Step 1}**: {What the agent does}
2. **{Step 2}**: {What the agent does}

## When to Invoke

- {Specific scenario}
- {Specific scenario}

Agent Color Guidelines

• purple: Design, UI/UX, presentation
• blue: Architecture, planning, infrastructure
• green: Testing, quality, reliability
• red: Security, performance, critical systems
• yellow: Documentation, communication
• cyan: Data, analytics, integration
• magenta: Creative, experimental, research

Step 4: Write README.md

# {Discipline Name}

{Description of the discipline and what these agents provide}

## Specialized Agents

### {Agent 1 Name}
{Description} | **Invoke when**: {Specific scenarios}

### {Agent 2 Name}
{Description} | **Invoke when**: {Specific scenarios}

## Installation

\`\`\`bash
han plugin install {discipline-name}
\`\`\`

Step 5: Register in Marketplace

Add your plugin to .claude-plugin/marketplace.json:

{
  "name": "{discipline-name}",
  "description": "Specialized agents for {discipline area} including {key responsibilities}.",
  "source": "./plugins/disciplines/{discipline-name}",
  "category": "Discipline",
  "keywords": [
    "{discipline}",
    "{specialty}",
    "agent"
  ]
}

Naming Guidelines

Discipline names should be descriptive and specific:

Examples of Well-Structured Discipline Plugins

• frontend-development: Excellent agent definitions with clear roles
• security-engineering: Strong technical depth
• system-architecture: Good balance of strategy and implementation

Questions?

See the Han documentation or ask in GitHub Discussions.