Metadata-Version: 2.4
Name: claude-validator
Version: 1.0.0
Summary: Pre-commit validation system for Claude Code components (Skills, Agents, Commands)
Author-email: Giuseppe Trisciuoglio <giuseppe.trisciuoglio@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/giuseppe-trisciuoglio/developer-kit
Project-URL: Issues, https://github.com/giuseppe-trisciuoglio/developer-kit/issues
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: PyYAML>=6.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0; extra == "dev"
Requires-Dist: black>=23.0; extra == "dev"
Requires-Dist: mypy>=1.0; extra == "dev"
Requires-Dist: types-PyYAML>=6.0; extra == "dev"
Dynamic: license-file

# Developer Kit for Claude Code

> A modular plugin system of reusable skills, agents, and commands for automating development tasks in Claude Code

**Developer Kit for Claude Code** teaches Claude how to **perform development tasks in a repeatable way** across
multiple languages and frameworks. Built as a modular marketplace, you can install only the plugins you need.

## Quick Start

```bash
# Install from marketplace (recommended)
/plugin marketplace add giuseppe-trisciuoglio/developer-kit

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

**Claude Desktop**: [Enable Skills in Settings](https://claude.ai/settings/capabilities)

---

## Architecture

Developer Kit is organized as a **modular marketplace** with 10 independent plugins:

```
plugins/
├── developer-kit-core/            # Core agents/commands (required)
├── developer-kit-java/            # Java/Spring Boot/LangChain4J/AWS SDK
├── developer-kit-typescript/      # NestJS/React/React Native
├── developer-kit-python/          # Python development
├── developer-kit-php/             # PHP/WordPress
├── developer-kit-aws/             # AWS CloudFormation
├── developer-kit-ai/              # Prompt Engineering/RAG/Chunking
├── developer-kit-devops/          # Docker/GitHub Actions
├── developer-kit-project-management/  # LRA workflow/Meetings
└── github-spec-kit/               # GitHub specification integration
```

---

## Available Plugins

### developer-kit-core (Required)

Core agents and commands used by all other plugins.

| Component                    | Description                            |
|------------------------------|----------------------------------------|
| `general-code-explorer`      | Deep codebase exploration and analysis |
| `general-code-reviewer`      | Code quality and security review       |
| `general-refactor-expert`    | Code refactoring specialist            |
| `general-software-architect` | Feature architecture design            |
| `general-debugger`           | Root cause analysis and debugging      |
| `document-generator-expert`  | Professional document generation       |

**Commands**: `/devkit.brainstorm`, `/devkit.refactor`, `/devkit.feature-development`, `/devkit.fix-debugging`,
`/devkit.generate-document`, `/devkit.generate-changelog`, `/devkit.github.create-pr`, `/devkit.github.review-pr`,
`/devkit.lra.*`, `/devkit.verify-skill`, `/devkit.generate-security-assessment`

---

### developer-kit-java

Comprehensive Java development toolkit with Spring Boot, testing, LangChain4J, and AWS SDK integration.

**Agents**: `spring-boot-backend-development-expert`, `spring-boot-code-review-expert`,
`spring-boot-unit-testing-expert`, `java-refactor-expert`, `java-security-expert`, `java-software-architect-review`,
`java-documentation-specialist`, `java-tutorial-engineer`, `langchain4j-ai-development-expert`

**Commands**: `/devkit.java.code-review`, `/devkit.java.generate-crud`, `/devkit.java.refactor-class`,
`/devkit.java.architect-review`, `/devkit.java.dependency-audit`, `/devkit.java.generate-docs`,
`/devkit.java.security-review`, `/devkit.java.upgrade-dependencies`, `/devkit.java.write-unit-tests`,
`/devkit.java.write-integration-tests`

**Skills**:

- **Spring Boot**: actuator, cache, crud-patterns, dependency-injection, event-driven-patterns, openapi-documentation,
  rest-api-standards, saga-pattern, security-jwt, test-patterns, resilience4j
- **Spring Data**: jpa, neo4j
- **Spring AI**: mcp-server-patterns
- **JUnit Testing**: application-events, bean-validation, boundary-conditions, caching, config-properties,
  controller-layer, exception-handler, json-serialization, mapper-converter, parameterized, scheduled-async,
  security-authorization, service-layer, utility-methods, wiremock-rest-api
- **LangChain4J**: ai-services-patterns, mcp-server-patterns, rag-implementation-patterns, spring-boot-integration,
  testing-strategies, tool-function-calling-patterns, vector-stores-configuration, qdrant
- **AWS SDK**: rds-spring-boot-integration, bedrock, core, dynamodb, kms, lambda, messaging, rds, s3, secrets-manager

---

### developer-kit-typescript

TypeScript/JavaScript full-stack development with NestJS, React, and React Native.

**Agents**: `nestjs-backend-development-expert`, `nestjs-code-review-expert`, `nestjs-database-expert`,
`nestjs-security-expert`, `nestjs-testing-expert`, `nestjs-unit-testing-expert`, `react-frontend-development-expert`,
`react-software-architect-review`, `typescript-refactor-expert`, `typescript-security-expert`,
`typescript-software-architect-review`, `typescript-documentation-expert`, `expo-react-native-development-expert`

**Commands**: `/devkit.typescript.code-review`, `/devkit.react.code-review`, `/devkit.ts.security-review`

**Skills**: `nestjs`, `react-patterns`, `shadcn-ui`, `tailwind-css-patterns`, `typescript-docs`

---

### developer-kit-python

Python development capabilities for Django, Flask, and FastAPI projects.

**Agents**: `python-code-review-expert`, `python-refactor-expert`, `python-security-expert`,
`python-software-architect-expert`

---

### developer-kit-php

PHP and WordPress development capabilities.

**Agents**: `php-code-review-expert`, `php-refactor-expert`, `php-security-expert`, `php-software-architect-expert`,
`wordpress-development-expert`

**Skills**: `wordpress-sage-theme` (Sage theme development)

---

### developer-kit-aws

AWS infrastructure and CloudFormation expertise for Infrastructure as Code.

**Agents**: `aws-solution-architect-expert`, `aws-cloudformation-devops-expert`, `aws-architecture-review-expert`

**Skills** (15 total): `vpc`, `ec2`, `lambda`, `iam`, `s3`, `rds`, `dynamodb`, `ecs`, `auto-scaling`, `cloudwatch`,
`cloudfront`, `security`, `elasticache`, `bedrock`, `task-ecs-deploy-gh`

---

### developer-kit-ai

AI/ML capabilities including prompt engineering, RAG, and chunking strategies.

**Agents**: `prompt-engineering-expert`

**Commands**: `/devkit.prompt-optimize`

**Skills**: `prompt-engineering`, `chunking-strategy`, `rag`

---

### developer-kit-devops

DevOps and containerization expertise.

**Agents**: `github-actions-pipeline-expert`, `general-docker-expert`

---

### developer-kit-project-management

Project management and workflow commands.

**Commands**: `/devkit.write-a-minute-of-a-meeting`

---

### github-spec-kit

GitHub specification integration and verification.

**Commands**: `/speckit.check-integration`, `/speckit.optimize`, `/speckit.verify`

---

## Key Features

- **Modular** — Install only the plugins you need for your tech stack
- **Specialized** — Domain-specific agents for code review, testing, AI development, and full-stack development
- **Composable** — Skills stack together automatically based on task context
- **Portable** — Use across Claude.ai, Claude Code CLI, Claude Desktop, and Claude API
- **Efficient** — Skills load on-demand, consuming minimal tokens until actively used

---

## Language Support

| Language           | Plugin                     | Components               |
|--------------------|----------------------------|--------------------------|
| Java/Spring Boot   | `developer-kit-java`       | Skills, Agents, Commands |
| TypeScript/Node.js | `developer-kit-typescript` | Skills, Agents, Commands |
| Python             | `developer-kit-python`     | Agents                   |
| PHP/WordPress      | `developer-kit-php`        | Skills, Agents           |
| AWS CloudFormation | `developer-kit-aws`        | Skills, Agents           |
| AI/ML              | `developer-kit-ai`         | Skills, Agents, Commands |

---

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed instructions on adding skills, agents, and commands.

---

## 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

---

## License

See [LICENSE](LICENSE) file.

---

## Support

- **Questions?** [Open an issue](https://github.com/giuseppe-trisciuoglio/developer-kit/issues)
- **Contributions?** [Submit a PR](https://github.com/giuseppe-trisciuoglio/developer-kit/pulls)

## Changelog

See [CHANGELOG.md](CHANGELOG.md) for complete history.

---

**Made with care for Developers using Claude Code**
**Also works with OpenCode, Github Copilot CLI and Codex**
