developer-kit — Claude Code plugin: what it does, how to install
Shared core of the Developer Kit family: subagents for review, refactoring and debugging, namespaced slash commands, skills, and a hook that stops destructive Bash calls.
MIT ★ 372 updated 2026-09-10
/plugin marketplace add giuseppe-trisciuoglio/developer-kit
/plugin install developer-kit@developer-kitWhat developer-kit does
Every other plugin in the Developer Kit marketplace expects this one to be present. It supplies the pieces they call: seven subagents, sixteen commands, six skills, one hook.
Subagents run through the Agent tool with a subagent_type. general-code-explorer maps an unfamiliar codebase, general-code-reviewer keeps its report to findings it is at least 80% sure about, general-debugger chases a failure down to its cause. Commands sit behind the plugin namespace, so you type /developer-kit:devkit.refactor or /developer-kit:devkit.github.review-pr. Some of them take --lang to route work to an agent built for that language.
Skills answer to a bare name: /adr-drafting, /learn, /drawio-logical-diagrams, /github-issue-workflow. The hook is hooks/prevent-destructive-commands.py, wired up in hooks/hooks.json. It reads Bash calls before they execute and blocks rm or shred aimed outside the working directory, git push --force, git reset --hard, docker removals, and reads of .env or private keys. Cleanup scripts that reach past the project will hit that wall.
What it helps with
- trace how a feature is wired in an unfamiliar repo
- review a branch without low-confidence nitpicks
- walk a feature from plan to commit with confirmation gates
- write an ADR for a decision the team just made
- keep the agent from deleting files outside the project
Example prompts for the agent
- Run
/developer-kit:devkit.feature-developmentand add CSV export to the reports page - Use
general-code-explorerto trace the login flow and show where it breaks - Checkpoint the work:
/developer-kit:devkit.lra.checkpoint "registration done"
How to install developer-kit
Plugin marketplace
/plugin marketplace add giuseppe-trisciuoglio/developer-kit/plugin install developer-kit@developer-kitStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about developer-kit
How do I install developer-kit in Claude Code?
Add the marketplace first: /plugin marketplace add giuseppe-trisciuoglio/developer-kit. Then install the plugin itself: /plugin install developer-kit@developer-kit.
What does developer-kit do?
It bundles subagents, slash commands and skills for everyday development work: codebase analysis, review, refactoring, debugging, documentation, GitHub flows. A security hook blocking destructive Bash commands comes with it.
Do I need developer-kit for other Developer Kit plugins?
Yes. The rest of the family lists it as a requirement, since their commands lean on these subagents and skills.
Source text
developer-kit-core · MIT
# Developer Kit Core
Core agents, commands, skills, and hooks required by all Developer Kit plugins.
## Overview
The `developer-kit` plugin (directory: `developer-kit-core/`) provides the foundational components shared across all Developer Kit plugins. This plugin is **required** by all other plugins in the Developer Kit marketplace.
> **Backward Compatibility Note:** The plugin name in the manifest is `developer-kit` (not `developer-kit-core`) to maintain compatibility with the existing `devkit.*` command prefixes. The directory is named `developer-kit-core` for structural clarity.
---
## Components
| Component Type | Count | Description |
|----------------|-------|-------------|
| **Agents** | 7 | General-purpose AI assistants for code analysis, review, refactoring, architecture, debugging, documentation, and pattern learning |
| **Commands** | 16 | Reusable workflows for feature development, refactoring, debugging, documentation, GitHub integration, and long-running agent sessions |
| **Skills** | 6 | Specialized capabilities for ADR drafting, memory management, documentation updates, draw.io diagrams, GitHub issues, and project pattern learning |
| **Hooks** | 1 | Security hook that prevents destructive Bash commands |
---
## Agents
Agents are specialized AI assistants with dedicated contexts, custom prompts, and specific tool access. Invoke them using the `Agent` tool with `subagent_type`.
| Agent | Purpose | When to Use |
|-------|---------|-------------|
| `general-code-explorer` | Deep codebase analysis | Tracing execution paths, mapping architecture layers, understanding how features are implemented |
| `general-code-reviewer` | Code review | Reviewing code changes for quality, bugs, logic errors, security, and best practices (reports only issues with confidence >= 80%) |
| `general-refactor-expert` | Code refactoring | Improving code quality and maintainability while preserving functionality (SOLID patterns, clean code principles) |
| `general-software-architect` | Architecture design | Planning new features, designing system architecture, creating implementation blueprints |
| `general-debugger` | Debugging | Root cause analysis, tracing execution paths, identifying failure points, proposing targeted fixes |
| `document-generator-expert` | Documentation | Creating professional technical and business documents (assessments, specs, reports, process docs) |
| `learn-analyst` | Pattern extraction | Extracting development patterns and conventions from codebase analysis for the learn skill |
### Invocation Example
```python
Agent(
subagent_type="general-code-explorer",
prompt="Trace the user authentication flow in this codebase"
)
```
---
## Commands
Commands are reusable workflows invoked with `/developer-kit:devkit.<command-name>`. They guide Claude through specific procedures with mandatory confirmation gates.
### Core Workflows
| Command | Purpose | Arguments |
|---------|---------|-----------|
| `devkit.feature-development` | Guided feature implementation | `[--lang=...] [feature-description]` |
| `devkit.refactor` | Guided code refactoring | `[--lang=...] [--scope=...] [refactor-description]` |
| `devkit.fix-debugging` | Guided bug fixing | `[--lang=...] [issue-description]` |
| `devkit.verify-skill` | Validate skill against DevKit standards | `[skill-name]` |
### Documentation Generation
| Command | Purpose |
|---------|---------|
| `devkit.generate-document` | Generate professional documents (assessments, features, analysis, process, custom) |
| `devkit.generate-changelog` | Generate and manage changelog following Keep a Changelog standard |
| `devkit.generate-security-assessment` | Generate security assessment document after audit |
### GitHub Integration
| Command | Purpose |
|---------|---------|
| `devkit.github.create-pr` | Create GitHub pull request with branch creation and commits |
| `devkit.github.review-pr` | Comprehensive PR review with code quality, security, and best practices |
### Long-Running Agent (LRA) Workflow
| Command | Purpose |
|---------|---------|
| `devkit.lra.init` | Initialize LRA environment (feature list, progress file, init.sh) |
| `devkit.lra.add-feature` | Add a new feature to the feature list |
| `devkit.lra.checkpoint` | Create checkpoint (commit changes, update progress, leave clean state) |
| `devkit.lra.mark-feature` | Mark feature as completed (passed) or failed |
| `devkit.lra.recover` | Recover from broken state (diagnose, revert if needed) |
| `devkit.lra.start-session` | Start coding session (read progress, choose next feature, run tests) |
| `devkit.lra.status` | Show project status (features progress, recent activity, next priorities) |
### Example Usage
```bash
/developer-kit:devkit.lra.init "Chat app with user auth and AI responses"
/developer-kit:devkit.lra.start-session
/developer-kit:devkit.lra.checkpoint "Implemented user registration"
/developer-kit:devkit.github.create-pr
```
---
## Skills
Skills are specialized capabilities invoked with `/skill-name`. Each skill includes detailed reference documentation.
| Skill | Purpose | Trigger |
|-------|---------|---------|
| `adr-drafting` | Create Architecture Decision Records | User decides on architectural change, needs to document technical rationale |
| `memory-md-management` | Manage CLAUDE.md files | User asks to check, audit, update, improve, or validate project memory files |
| `docs-updater` | Update documentation | Preparing release, maintaining documentation sync, updating changelog |
| `drawio-logical-diagrams` | Create draw.io diagrams | Creating logical flow diagrams, system architecture, BPMN, UML, data flow |
| `github-issue-workflow` | Resolve GitHub issues | User asks to resolve, implement, work on, fix, or close a GitHub issue |
| `learn` | Extract project patterns | User asks to "learn from project", "extract project rules", "analyze conventions" |
### Example Usage
```bash
/adr-drafting
/docs-updater
/learn
/drawio-logical-diagrams
/github-issue-workflow GH-123
```
---
## Hooks
### prevent-destructive-commands
A security hook that prevents execution of destructive Bash commands.
**Location:** `hooks/prevent-destructive-commands.py`
**Configuration:** `hooks/hooks.json`
**Security Features:**
- Prevents `rm`, `unlink`, `rmdir`, `shred` targeting paths outside working directory
- Blocks access to sensitive files (`.env`, SSH keys, AWS credentials, private keys)
- Prevents AWS CLI destructive operations (s3 rm, ec2 terminate-instances, etc.)
- Prevents Docker destructive operations (container rm, volume rm, etc.)
- Prevents Git destructive operations (reset --hard, clean, push --force, rebase, etc.)
- Handles wrapper commands (sudo, env, nice, etc.), shell invocations (bash -c, sh -c, etc.), and find -exec delegation
---
## Language/Framework Support
Commands support `--lang` parameter to use specialized language-specific agents:
| Language | Agents Used |
|----------|-------------|
| Java/Spring Boot | `spring-boot-backend-development-expert`, `java-software-architect-review` |
| TypeScript/NestJS | `typescript-software-architect-review`, `nestjs-backend-development-expert` |
| React | `react-frontend-development-expert`, `react-software-architect-review` |
| Python | `python-software-architect-expert`, `python-code-review-expert` |
| AWS | `aws-solution-architect-expert`, `aws-cloudformation-devops-expert` |
| General | `general-code-explorer`, `general-software-architect`, `general-code-reviewer` |
---
## Dependencies
None — this is the foundational plugin upon which all other Developer Kit plugins depend.
© Giuseppe Trisciuoglio · MIT · giuseppe-trisciuoglio/developer-kit