mirror of
https://github.com/giuseppe-trisciuoglio/developer-kit.git
synced 2026-09-14 18:22:07 +08:00
f6110879f9
Replaced unclaimed @my-org/internal-lib example with real, claimed scope (@microsoft) and explicit example disclaimer. Added guidance to never reference unclaimed package names in documentation. Reported by Noam at Blue Bear Security. Bumps version to 3.0.1.
Developer Kit Python Plugin
Comprehensive Python development capabilities for Claude Code.
Overview
The developer-kit-python plugin provides specialized Python development tools including code review, refactoring, security assessment, architectural guidance, and production-ready patterns. It supports modern Python (3.11+) with focus on clean architecture, AWS Lambda integration, and best practices.
Components
Agents (4)
| Agent | Purpose |
|---|---|
python-code-review-expert |
Code quality review and PEP standards compliance |
python-refactor-expert |
Clean code refactoring and design patterns |
python-security-expert |
Security vulnerability assessment (OWASP, CVEs) |
python-software-architect-expert |
Architecture design and scalability evaluation |
Skills (2)
| Skill | Purpose |
|---|---|
clean-architecture |
Clean Architecture, Hexagonal Architecture, and DDD patterns |
aws-lambda-python-integration |
AWS Lambda deployment with Chalice and raw Python approaches |
Rules (4)
Rules activate automatically for all **/*.py files:
| Rule | Purpose |
|---|---|
error-handling |
Exception hierarchies, logging, and recovery patterns |
language-best-practices |
Modern Python (3.11+) patterns, type hints, async |
naming-conventions |
PEP 8 naming standards for modules, classes, functions |
project-structure |
Modular project organization and layer separation |
LSP Servers
The plugin includes LSP configuration for Python IDE support:
- pyright-langserver: Fast, Microsoft TypeScript-based language server
- pylsp: Python Language Server Protocol implementation
Note: LSP binaries must be installed separately. Install with:
pip install pyrightorpip install python-lsp-server
Installation
This plugin requires developer-kit-core:
claude plugin install ./plugins/developer-kit-python --scope project
Quick Start
- Review Python code: Claude automatically invokes
python-code-review-expertfor code reviews - Refactor Python code: Use
python-refactor-expertfor clean code improvements - Security audit: Invoke
python-security-expertfor vulnerability assessment - Design architecture: Use
python-software-architect-expertfor architectural decisions - Apply patterns: Use
/clean-architectureskill for layered architecture guidance - Deploy to AWS: Use
/aws-lambda-python-integrationfor Lambda deployment patterns
Documentation
| Guide | Content |
|---|---|
| Agent Guide | Detailed documentation for all 4 agents |
| Skills Guide | Architecture patterns for both skills |
| Rules Reference | Python coding rules and best practices |
Key Features
Code Quality
- PEP 8 and PEP 484 compliance
- Python 3.8+ idioms and patterns
- Code complexity assessment
- Type hints validation
Refactoring
- Clean code principles
- Design pattern implementation
- Legacy code migration
- Complexity reduction
Security
- OWASP Top 10 vulnerability detection
- CVE scanning for dependencies
- Authentication/authorization review
- Secure coding practices
Architecture
- Clean Architecture implementation
- Hexagonal Architecture (Ports & Adapters)
- Domain-Driven Design patterns
- Dependency injection patterns
AWS Lambda
- AWS Chalice framework integration
- Raw Python minimal handlers
- Cold start optimization (< 100ms)
- SAM and Serverless Framework deployment
Technology Stack
- Python: 3.11+ (recommended), 3.8+ (minimum)
- Web Frameworks: FastAPI, Flask, Django
- AWS: Lambda, API Gateway, Chalice, boto3
- ORM: SQLAlchemy (async), Django ORM
- Validation: Pydantic
- Testing: pytest, pytest-asyncio, moto
See Also
- Core Plugin Documentation - Core guides and shared patterns
- TypeScript Plugin Documentation - NestJS, React, and Next.js
- Java Plugin Documentation - Spring Boot and JVM patterns
- AI Plugin Documentation - RAG and prompt engineering