Skip to main content
plugin

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

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add giuseppe-trisciuoglio/developer-kit
/plugin install developer-kit@developer-kit
Open on GitHub

What 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-development and add CSV export to the reports page
  • Use general-code-explorer to 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-kit

Step 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

Similar plugins

All plugins for Agent setup: memory, context, orchestration →
developer-essentials Seth Hobson developer-essentials is a Claude Code plugin with skills for Git, SQL, error handling, and other development tasks. It covers code review, E2E testing, authentication, debugging, and monorepo management. CX Codex ★ 42,780repo stars grounding-before-coding riekelt The grounding-before-coding skill makes the agent inspect code and data before changing a project or explaining a bug. It fits unfamiliar repositories and non-trivial work. CX Codex +1 25,600installs principle-fix-root-causes backnotprop principle-fix-root-causes is a Claude Code skill that traces a failure to the first wrong decision in the code. It starts with reproduction, then checks the state and recurring fault pattern. CX Codex +1 10,800installs Developer Work Analysis from Git Diff and Commit Message [email protected] Developer Work Analysis from Git Diff and Commit Message is a prompt for ChatGPT, Claude.ai, and Claude Code that reviews a git diff and commit message to assess changes, flag issues, and suggest improvements. GP ChatGPT ★ 178,201repo stars why cursor why is a Claude Code skill that recovers design rationale from git history. Triggers on questions about why specific tech was picked, regressions, postmortems, or data-backed thresholds. CX Codex +1 6,900installs ds-unstick aicodeking ds-unstick — a Claude Code skill breaks repeating failure loops by testing core assumptions. It runs when the same error returns after two failed fix attempts. CX Codex +1 566installs

From the same set191

The whole set →
github-spec-kit github-spec-kit — a plugin for verifying GitHub specifications and checking code integration against them. Ensures your implementation matches requirements before deployment. ★ 372repo stars developer-kit-project-management developer-kit-project-management adds project management and documentation commands to Claude Code. Generates structured meeting minutes directly in your CLI workflow. ★ 372repo stars developer-kit-devops The developer-kit-devops plugin adds agents for Docker and GitHub Actions. Use them to build container configurations or set up CI/CD workflows for a project. ★ 372repo stars developer-kit-python developer-kit-python is a Claude Code plugin with four Python subagents, two skills and auto-applied rules for code review, refactoring, security checks, architecture and AWS Lambda deployment. ★ 372repo stars developer-kit-php developer-kit-php adds five specialized agents, three skills, and PSR coding rules for PHP, WordPress, Laravel, and Symfony in Claude Code. ★ 372repo stars developer-kit-typescript developer-kit-typescript adds TypeScript and JavaScript agents, commands, skills, and path-based rules to Claude Code, covering tools such as NestJS, React, and React Native. ★ 372repo stars developer-kit-java developer-kit-java is a Claude Code plugin with specialized subagents, commands, and skills for Java, Spring Boot, AWS, and LangChain4J development. ★ 372repo stars developer-kit-ai The developer-kit-ai plugin adds skills for prompt design, RAG pipelines, and document chunking. Use it when building applications that rely on LLMs. ★ 372repo stars

Project sponsors

Companies that keep this analytics open