Installation Guide

Installation instructions for the Developer Kit Core plugin and the complete Developer Kit across multiple CLI tools.

Table of Contents

1. Developer Kit Core Plugin
2. Claude Code CLI
3. Multi-CLI Support
4. Local Project Installation
5. Management Commands

Developer Kit Core Plugin

The developer-kit-core plugin is the foundational component required by all other Developer Kit plugins. It provides:

• 7 Agents — Code exploration, review, refactoring, architecture, debugging, documentation, pattern learning
• 16 Commands — Feature development, refactoring, debugging, documentation, GitHub, LRA workflow
• 6 Skills — ADR drafting, memory management, docs updates, draw.io diagrams, GitHub issues, pattern learning
• 1 Security Hook — Prevents destructive Bash commands

Claude Code CLI

Quick Install (Marketplace)

/plugin marketplace add giuseppe-trisciuoglio/developer-kit

Install from Local Directory

/plugin install /path/to/developer-kit

Claude Desktop

1. Go to Settings > Capabilities
2. Enable Skills toggle
3. Browse available skills or upload custom skills

Multi-CLI Support

The Developer Kit supports installation across multiple AI-powered development environments through a unified multi-plugin Makefile interface.

Prerequisites

jq (JSON Processor) — Required for plugin discovery:

# macOS
brew install jq

# Linux (Ubuntu/Debian)
sudo apt-get install jq

# Verify
jq --version

Quick Start with Makefile

# Clone the repository
git clone https://github.com/giuseppe-trisciuoglio/developer-kit.git
cd developer-kit

# Check dependencies
make check-deps

# See all available options
make help

# Install for your CLI
make install-claude       # Claude Code (interactive, project-local)
make install-opencode     # OpenCode CLI (global)
make install-copilot      # GitHub Copilot CLI (global)
make install-codex        # Codex CLI (global)
make install              # Auto-install for all detected CLIs

Multi-Plugin Architecture

The Developer Kit uses a plugin-based architecture with 12 separate plugins:

Plugin Discovery: The Makefile automatically scans plugins/*/.claude-plugin/plugin.json files to discover all available plugins and their components.

CLI-Specific Installation

GitHub Copilot CLI

make install-copilot

• Installs agents and skills (commands not supported)
• Multi-plugin support from all 12 plugins
• Usage: /agent to select agents or mention in prompts

OpenCode CLI

make install-opencode

• Installs agents, commands, and skills
• Full multi-plugin support
• Usage: @agent-name for agents, /command-name for commands

Codex CLI

make install-codex

• Installs skills only (agents and commands not supported)
• Auto-generates AGENTS.md index
• Skills auto-discovered by Codex CLI

Local Project Installation

Install skills, agents, and commands directly into your local project for team-based development.

Interactive Claude Code Installation

# Run interactive installer
make install-claude

Interactive Features:

• Environment validation
• Plugin selection (choose which plugins to install)
• Component selection (agents, commands, skills from each plugin)
• Conflict handling (overwrite/skip/rename)
• Progress tracking and summary report

What Gets Installed

my-project/
├── .claude/
│   ├── skills/                      # Complete skill directories
│   │   └── [skill-name]/
│   │       ├── SKILL.md
│   │       └── references/          # Supporting documentation
│   ├── agents/                      # Agent definitions
│   │   ├── general-code-explorer.md
│   │   ├── general-code-reviewer.md
│   │   └── ...
│   └── commands/                    # Commands (subdirectories preserved)
│       ├── devkit.feature-development.md
│       ├── documentation/
│       │   └── devkit.generate-document.md
│       └── lra/
│           ├── devkit.lra.init.md
│           └── ...

Team-Based Development

1. Install Once: Use make install-claude in the project root
2. Git Integration: All .claude/ files are version-controlled
3. Team Consistency: Everyone gets the same tools and patterns
4. Quick Onboarding: New team members get all tools immediately

Management Commands

Status & Information

make status                    # Check installation status
make list-plugins             # List all discovered plugins
make list-components PLUGIN=developer-kit-core  # Components of core plugin
make list-agents              # List all agents
make list-commands            # List all commands
make list-skills              # List all skills

Backup & Uninstall

make backup                    # Create timestamped backup
make uninstall                # Remove all Developer Kit installations
make check-deps               # Verify dependencies

Verification

# Check installed components
ls -1 .claude/agents/ | wc -l
ls -1 .claude/commands/ | wc -l
ls -1d .claude/skills/*/ | wc -l

# Verify specific plugin
make list-components PLUGIN=developer-kit-core

Quick Reference