developer-kit

Why Developer Kit?

Developer Kit is a modular plugin marketplace for Claude Code that teaches Claude how to perform development tasks in a repeatable, high-quality way. Instead of generic AI responses, you get domain-specific expertise for your exact tech stack.

• 🧩 Modular by Design — Install only what you need. Java developer? Grab developer-kit-java. Full-stack TypeScript? Add developer-kit-typescript.
• 🎯 Domain Experts — 45+ specialized agents for code review, refactoring, security audits, architecture design, and testing across 7+ languages.
• 📚 150+ Skills — Reusable capabilities from Spring Boot CRUD generation to CloudFormation templates, all with best practices built-in.
• 🔄 Multi-CLI Support — Works with Claude Code, GitHub Copilot CLI, OpenCode CLI, and Codex CLI.
• ⚡ Auto-Activation — Path-scoped rules automatically activate when you open relevant files. No configuration needed.

Installation

Quick Install (Recommended)

Claude Code

# Install from marketplace
/plugin marketplace add giuseppe-trisciuoglio/developer-kit

# Or install from local directory
/plugin install /path/to/developer-kit

Claude Desktop

Enable Skills in Settings → Add giuseppe-trisciuoglio/developer-kit

Manual Installation

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

# Install via Makefile (auto-detects your CLI)
cd developer-kit
make install

# Or install for specific CLI
make install-claude      # Claude Code
make install-opencode    # OpenCode CLI
make install-copilot     # GitHub Copilot CLI
make install-codex       # Codex CLI

Quick Start

# After installation, start your CLI
claude

# Check available commands
/help

# Use a Developer Kit command
/devkit.refactor

# Or invoke a specs workflow
/specs:brainstorm

Example Prompts

Generate a complete CRUD module for User entity with NestJS and Drizzle ORM
Review this Java Spring Boot service for security issues
Create a CloudFormation template for ECS with auto-scaling
Help me refactor this monolithic class into clean architecture
Generate unit tests for this TypeScript service with 100% coverage

Usage

Developer Kit provides four layers of capabilities:

1. Skills

Reusable capabilities loaded on-demand. Example:

[Skill: spring-boot-crud-patterns activated]

Skills automatically provide patterns, templates, and best practices for specific tasks.

2. Agents

Specialized sub-agents for complex workflows:

# Invoke via natural language
"Review this code as a Spring Boot expert"

# Or use commands
/devkit.java.code-review
/devkit.typescript.code-review

3. Specifications-Driven Development (SDD)

Transform ideas into production-ready code through a structured workflow:

Phase 0: Constitution (First-Time Setup)

The constitution defines the architectural DNA: approved stack, AI guardrails, security constraints (CWE mappings), and non-negotiable rules that govern all subsequent code generation.

Phase 1: Specification Creation

The specification lives in docs/specs/[id]/YYYY-MM-DD--feature-name.md

Phase 2: Task Generation

Tasks are generated in docs/specs/[id]/tasks/ with individual task files.

Phase 3: Implementation

Each task implementation updates the Knowledge Graph for context preservation.

Phase 4: Quality Assurance

Additional Workflow Commands

4. Rules

Path-scoped rules auto-activate based on file patterns:

# Auto-activates for *.java files
globs: ["**/*.java"]
---
Always use constructor injection. Never use field injection with @Autowired.

📋 Note on Rules Installation

Plugins do not automatically install rules into your project. To use the rules, you can copy them manually or use the Makefile command:

hljs language-bash

Copy

# Copy rules from a specific plugin
make copy-rules PLUGIN=developer-kit-java

# Or manually copy .md files from the plugin's rules/ folder
mkdir -p .claude/rules
cp plugins/developer-kit-[language]/rules/*.md .claude/rules/

The rules will be automatically activated based on the globs: patterns defined in the header of each file.

Available Plugins

Total: 150+ Skills | 45+ Agents | 20+ Commands | 45+ Rules

Plugin Architecture

developer-kit/
├── plugins/
│   ├── developer-kit-core/          # Required base
│   │   ├── agents/                  # Agent definitions (.md)
│   │   ├── commands/                # Slash commands (.md)
│   │   ├── skills/                  # Reusable skills (SKILL.md)
│   │   ├── rules/                   # Auto-activated rules
│   │   └── .claude-plugin/
│   │       └── plugin.json          # Plugin manifest
│   ├── developer-kit-java/          # Java ecosystem
│   ├── developer-kit-typescript/    # TypeScript ecosystem
│   └── ...
├── .skills-validator-check/         # Validation system
└── Makefile                         # Installation commands

Each plugin is self-contained with its own manifest, components, and dependencies.

Configuration

Plugin Selection

Install only the plugins you need:

# Core + Java + AWS
make install-claude
# Then enable: developer-kit-core, developer-kit-java, developer-kit-aws

# Full-stack TypeScript
# Enable: developer-kit-core, developer-kit-typescript, developer-kit-aws

Rules Auto-Activation

Rules automatically activate based on file patterns:

---
globs: ["**/*.java"]
---
# This rule activates for all Java files
- Use constructor injection
- Follow naming conventions

LSP Integration

Language plugins include LSP server configurations (.lsp.json):

Language Support Matrix

Validation & Quality

Developer Kit includes a comprehensive validation system:

# Validate all components
python .skills-validator-check/validators/cli.py --all

# Security scan (MCP compliance)
make security-scan

# Pre-commit hooks
.skills-validator-check/install-hooks.sh

Ecosystem

Listed on:

• context7 — Skills marketplace
• skills.sh — AI skills directory

Related Projects:

• Claude Code — AI-powered terminal from Anthropic
• OpenCode — Open-source AI coding assistant
• GitHub Copilot CLI — AI pair programming
• Codex CLI — OpenAI's coding agent

Contributing

We welcome contributions! See CONTRIBUTING.md for:

• Adding new skills, agents, and commands
• Plugin development guidelines
• Validation requirements
• Branch strategy and versioning

Security

Skills can execute code. Review all custom skills before deploying:

• ✅ Only install from trusted sources
• ✅ Review SKILL.md before enabling
• ✅ Test in non-production environments first
• ✅ Run make security-scan before releases

Security scans run automatically via GitHub Actions on every PR.

License

MIT License — Open source and free to use.

Acknowledgments

• Claude Code by Anthropic — The foundation this plugin system extends
• Qwen Code — README design inspiration
• Contributors — Thank you to everyone who has contributed skills and plugins