Merge pull request #29 from giuseppe-trisciuoglio/feat/devops-github-docker

feat: aggiunte competenze AWS CloudFormation e agenti DevOps e Python

Author: giuseppe-trisciuoglio

.claude-plugin/marketplace.json

@@ -6,7 +6,7 @@
   },
   "metadata": {
     "description": "Developer Kit for building applications with Claude Code using best practices and patterns.",
-    "version": "1.22.0"
+    "version": "1.23.0"
   },
   "plugins": [
     {
@@ -55,6 +55,21 @@
         "./skills/langchain4j/langchain4j-tool-function-calling-patterns",
         "./skills/langchain4j/langchain4j-vector-stores-configuration",
         "./skills/langchain4j/qdrant",
+        "./skills/aws-cloudformation/aws-cloudformation-auto-scaling",
+        "./skills/aws-cloudformation/aws-cloudformation-task-ecs-deploy-gh",
+        "./skills/aws-cloudformation/aws-cloudformation-ec2",
+        "./skills/aws-cloudformation/aws-cloudformation-ecs",
+        "./skills/aws-cloudformation/aws-cloudformation-iam",
+        "./skills/aws-cloudformation/aws-cloudformation-lambda",
+        "./skills/aws-cloudformation/aws-cloudformation-rds",
+        "./skills/aws-cloudformation/aws-cloudformation-s3",
+        "./skills/aws-cloudformation/aws-cloudformation-vpc",
+        "./skills/aws-cloudformation/aws-cloudformation-cloudwatch",
+        "./skills/aws-cloudformation/aws-cloudformation-cloudfront",
+        "./skills/aws-cloudformation/aws-cloudformation-security",
+        "./skills/aws-cloudformation/aws-cloudformation-dynamodb",
+        "./skills/aws-cloudformation/aws-cloudformation-elasticache",
+        "./skills/aws-cloudformation/aws-cloudformation-bedrock",
         "./skills/aws-java/aws-rds-spring-boot-integration",
         "./skills/aws-java/aws-sdk-java-v2-bedrock",
         "./skills/aws-java/aws-sdk-java-v2-core",

CHANGELOG.md

@@ -7,6 +7,56 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.23.0] - 2025-01-24
+
+### Added
+- **New DevOps Agents** (2 new specialized agents):
+  - `general-docker-expert`: Expert Docker containerization specialist. Masters multi-stage builds, Docker Compose orchestration, container optimization, and production deployment strategies. Proficient in Dockerfile best practices, volume management, networking, security hardening, and container lifecycle management
+  - `github-actions-pipeline-expert`: Expert GitHub Actions CI/CD pipeline architect. Masters workflow automation, pipeline optimization, deployment strategies, and production-grade CI/CD implementations. Proficient in composite actions, reusable workflows, custom actions, matrix builds, caching strategies, security hardening, and pipeline monitoring
+- **New Python Agents** (4 new specialized agents):
+  - `python-code-review-expert`: Expert Python code reviewer specializing in code quality, security, performance, and Pythonic best practices. Reviews Python codebases for bugs, logic errors, security vulnerabilities, and quality issues using confidence-based filtering
+  - `python-refactor-expert`: Expert Python code refactoring specialist. Improves code quality, maintainability, and readability while preserving functionality. Applies clean code principles, SOLID patterns, and Pythonic best practices
+  - `python-security-expert`: Expert security auditor specializing in Python application security, DevSecOps, and compliance frameworks. Masters vulnerability assessment, threat modeling, secure authentication (OAuth2/JWT), OWASP standards, and security automation
+  - `python-software-architect-expert`: Expert Python software architect specializing in Clean Architecture, Domain-Driven Design (DDD), and modern Python patterns. Reviews Python codebases for architectural integrity, proper module organization, and SOLID principles
+- **New AWS CloudFormation Skills** (14 comprehensive skills with complete SKILL.md, examples.md, and reference.md files):
+  - `aws-cloudformation-auto-scaling`: Auto Scaling groups, scaling policies, lifecycle hooks, and scheduled actions
+  - `aws-cloudformation-bedrock`: Amazon Bedrock integration, AI/ML foundation models, and serverless AI inference
+  - `aws-cloudformation-cloudfront`: CloudFront distributions, edge functions, origins, cache behaviors, and WAF integration
+  - `aws-cloudformation-cloudwatch`: CloudWatch dashboards, alarms, metrics, logs, and monitoring strategies
+  - `aws-cloudformation-dynamodb`: DynamoDB tables, GSIs, LSIs, streams, auto-scaling, and TTL configuration
+  - `aws-cloudformation-ec2`: EC2 instances, launch templates, ASG integration, security groups, and ENI configuration
+  - `aws-cloudformation-ecs`: ECS clusters, task definitions, services, capacity providers, and Fargate deployment
+  - `aws-cloudformation-elasticache`: ElastiCache Redis/Memcached clusters, replication groups, and node configuration
+  - `aws-cloudformation-iam`: IAM users, groups, roles, policies, and permission boundary management
+  - `aws-cloudformation-lambda`: Lambda functions, layers, event sources, aliases, and versioning strategies
+  - `aws-cloudformation-rds`: RDS instances, Aurora clusters, parameter groups, snapshot management, and Multi-AZ deployment
+  - `aws-cloudformation-s3`: S3 buckets, policies, lifecycle rules, versioning, replication, and event notifications
+  - `aws-cloudformation-security`: Security best practices, WAF, Shield, KMS encryption, and compliance patterns
+  - `aws-cloudformation-vpc`: VPC design, subnets, route tables, NAT gateways, VPC endpoints, and peering
+- **Enhanced AWS Architecture Review**:
+  - Updated `aws-solution-architect-expert` agent with CloudFormation expertise
+  - Added comprehensive infrastructure as code review capabilities
+  - Enhanced Well-Architected Framework compliance checking
+- **GitHub Actions Task Skill**:
+  - `aws-cloudformation-task-ecs-deploy-gh`: Complete ECS deployment to GitHub Actions workflow skill
+  - Production-grade pipeline templates with blue-green deployment
+  - Comprehensive examples and reference documentation
+
+### Changed
+- Updated `.claude-plugin/marketplace.json` with new agents and skills metadata
+- Enhanced README.md with new DevOps, CloudFormation skills, and Python agents documentation
+- Total skills count increased significantly with 14 new AWS CloudFormation skills
+- Total agents count increased from 28 to 34 with new DevOps and Python specialists
+- Updated agents documentation to include Python development capabilities
+
+### Documentation
+- Added comprehensive SKILL.md files for all 14 CloudFormation skills with detailed patterns
+- Added extensive examples.md files with practical CloudFormation template examples
+- Added complete reference.md files with CloudFormation resource properties and reference documentation
+- Added 4 new Python agent definitions with specialized expertise in code review, refactoring, security, and architecture
+- Enhanced agent descriptions with DevOps and infrastructure expertise
+- Added guide-skills-aws-cloudformation.md for comprehensive CloudFormation patterns documentation
+
 ## [1.22.0] - 2026-01-14
 
 ### Added
@@ -393,7 +443,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Core functionality
 - Foundation documentation
 
-[Unreleased]: https://github.com/giuseppe-trisciuoglio/developer-kit-claude-code/compare/v1.22.0...HEAD
+[Unreleased]: https://github.com/giuseppe-trisciuoglio/developer-kit-claude-code/compare/v1.23.0...HEAD
+[1.23.0]: https://github.com/giuseppe-trisciuoglio/developer-kit-claude-code/compare/v1.22.0...v1.23.0
 [1.22.0]: https://github.com/giuseppe-trisciuoglio/developer-kit-claude-code/compare/v1.20.0...v1.22.0
 [1.21.0]: https://github.com/giuseppe.trisciuoglio/developer-kit/compare/v1.20.0...v1.21.0
 [1.20.0]: https://github.com/giuseppe-trisciuoglio/developer-kit-claude-code/compare/v1.19.0...v1.20.0

README.md

@@ -36,19 +36,18 @@ and AI integration.
 
 ### Skills
 
-| Category        | Guide                                     |
-|-----------------|-------------------------------------------|
-| JUnit Testing   | [Guide](docs/guide-skills-junit-test.md)  |
-| Spring Boot     | [Guide](docs/guide-skills-spring-boot.md) |
-| AWS Java SDK    | [Guide](docs/guide-skills-aws-java.md)    |
-| LangChain4J     | [Guide](docs/guide-skills-langchain4j.md) |
-| AI Engineering  | —                                         |
-| React           | [Guide](docs/guide-skills-frontend.md)    |
-| shadcn-ui       | [Guide](docs/guide-skills-frontend.md)    |
-| Tailwind CSS    | [Guide](docs/guide-skills-frontend.md)    |
-| TypeScript Docs | [Guide](docs/guide-skills-frontend.md)    |
-| NestJS          | [Guide](docs/guide-skills-nestjs.md)      |
-| Spring AI       | —                                         |
+| Category           | Guide                                          |
+|--------------------|------------------------------------------------|
+| JUnit Testing      | [Guide](docs/guide-skills-junit-test.md)       |
+| Spring Boot        | [Guide](docs/guide-skills-spring-boot.md)      |
+| AWS Java SDK       | [Guide](docs/guide-skills-aws-java.md)         |
+| AWS CloudFormation | [Guide](docs/guide-skills-aws-cloudformation.md) |
+| LangChain4J        | [Guide](docs/guide-skills-langchain4j.md)      |
+| React              | [Guide](docs/guide-skills-frontend.md)         |
+| shadcn-ui          | [Guide](docs/guide-skills-frontend.md)         |
+| Tailwind CSS       | [Guide](docs/guide-skills-frontend.md)         |
+| TypeScript Docs    | [Guide](docs/guide-skills-frontend.md)         |
+| NestJS             | [Guide](docs/guide-skills-nestjs.md)           |
 
 ### Agents
 
@@ -134,8 +133,9 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed instructions on adding skill
 | [Skills - JUnit](docs/guide-skills-junit-test.md)        | Testing patterns                            |
 | [Skills - LangChain4J](docs/guide-skills-langchain4j.md) | AI integration                              |
 | [Skills - AWS](docs/guide-skills-aws-java.md)            | AWS SDK patterns                            |
-| [Skills - Frontend](docs/guide-skills-frontend.md)       | React, Tailwind, shadcn                     |
-| [Skills - NestJS](docs/guide-skills-nestjs.md)           | NestJS patterns                             |
+| [Skills - Frontend](docs/guide-skills-frontend.md)           | React, Tailwind, shadcn                        |
+| [Skills - NestJS](docs/guide-skills-nestjs.md)             | NestJS patterns                               |
+| [Skills - AWS CloudFormation](docs/guide-skills-aws-cloudformation.md) | Infrastructure as Code patterns               |
 
 ---
 

agents/aws-architecture-review-expert.md

@@ -49,6 +49,11 @@ Identify security issues:
 - Non-compliant resource configurations
 - Public access to sensitive resources
 
+> **Related Skills**: When reviewing CloudFormation templates for specific AWS resources, leverage specialized skills:
+> - `aws-cloudformation-security` - Infrastructure security, KMS, Secrets Manager
+> - `aws-cloudformation-iam` - IAM policies, roles, least privilege
+> - `aws-cloudformation-vpc` - Network security, security groups, NACLs
+
 ## Confidence Scoring
 
 Rate each potential issue on a scale from 0-100:
@@ -300,3 +305,25 @@ For each review, provide:
 - Cost optimization opportunities
 - Security hardening suggestions
 - Production readiness assessment
+
+## Available CloudFormation Skills
+
+When reviewing CloudFormation templates for specific AWS resources, leverage these specialized skills:
+
+| Skill | Purpose |
+|-------|---------|
+| `aws-cloudformation-vpc` | VPC, subnets, route tables, NAT, networking |
+| `aws-cloudformation-ec2` | EC2 instances, launch templates, ASG |
+| `aws-cloudformation-ecs` | ECS task definitions, services, Fargate |
+| `aws-cloudformation-auto-scaling` | Auto Scaling policies and targets |
+| `aws-cloudformation-lambda` | Lambda functions, event sources, layers |
+| `aws-cloudformation-rds` | RDS instances, Aurora, read replicas |
+| `aws-cloudformation-dynamodb` | DynamoDB tables, GSIs, LSIs, streams |
+| `aws-cloudformation-elasticache` | Redis/Memcached clusters, replication |
+| `aws-cloudformation-s3` | S3 buckets, policies, lifecycle rules |
+| `aws-cloudformation-iam` | IAM roles, policies, users, groups |
+| `aws-cloudformation-security` | KMS, Secrets Manager, TLS/SSL, security |
+| `aws-cloudformation-cloudwatch` | CloudWatch metrics, alarms, dashboards, logs |
+| `aws-cloudformation-cloudfront` | CloudFront distributions, origins, caching |
+| `aws-cloudformation-bedrock` | Bedrock agents, knowledge bases, RAG, guardrails |
+| `aws-cloudformation-task-ecs-deploy-gh` | GitHub Actions ECS deployment CI/CD |

agents/aws-cloudformation-devops-expert.md

@@ -31,6 +31,14 @@ When invoked:
 - **Metadata**: AWS::CloudFormation::Interface, parameter groups
 - **Transform**: AWS::Include, AWS::Serverless (SAM)
 
+> **Note**: For resource-specific CloudFormation patterns, leverage these specialized skills:
+> - `aws-cloudformation-vpc` - VPC infrastructure templates
+> - `aws-cloudformation-ec2` - EC2 compute resources
+> - `aws-cloudformation-ecs` - Container orchestration templates
+> - `aws-cloudformation-lambda` - Serverless function templates
+> - `aws-cloudformation-rds` - Database instance templates
+> - `aws-cloudformation-s3` - Storage bucket templates
+
 ### 2. Resource Configuration
 - **EC2**: Launch templates, auto scaling groups, user data scripts
 - **VPC**: Subnets, route tables, NAT gateways, security groups
@@ -40,6 +48,11 @@ When invoked:
 - **S3**: Bucket policies, lifecycle rules, replication
 - **IAM**: Roles, policies, instance profiles, service-linked roles
 - **API Gateway**: REST APIs, stages, deployments, custom domains
+- **DynamoDB**: Tables, GSIs, LSIs, auto-scaling, streams
+- **ElastiCache**: Redis/Memcached clusters, replication groups
+- **CloudWatch**: Metrics, alarms, dashboards, log groups
+- **CloudFront**: Distributions, origins, cache behaviors
+- **Bedrock**: Agents, knowledge bases, guardrails, prompts
 
 ### 3. Advanced Template Patterns
 
@@ -452,3 +465,25 @@ For each CloudFormation template, provide:
 - "Create a VPC template with public and private subnets"
 - "Implement cross-stack references for modular infrastructure"
 - "Create custom resources for unsupported AWS features"
+
+## Available CloudFormation Skills
+
+When creating CloudFormation templates for specific AWS resources, leverage these specialized skills:
+
+| Skill | Purpose |
+|-------|---------|
+| `aws-cloudformation-vpc` | VPC, subnets, route tables, NAT, networking |
+| `aws-cloudformation-ec2` | EC2 instances, launch templates, ASG |
+| `aws-cloudformation-ecs` | ECS task definitions, services, Fargate |
+| `aws-cloudformation-auto-scaling` | Auto Scaling policies and targets |
+| `aws-cloudformation-lambda` | Lambda functions, event sources, layers |
+| `aws-cloudformation-rds` | RDS instances, Aurora, read replicas |
+| `aws-cloudformation-dynamodb` | DynamoDB tables, GSIs, LSIs, streams |
+| `aws-cloudformation-elasticache` | Redis/Memcached clusters, replication |
+| `aws-cloudformation-s3` | S3 buckets, policies, lifecycle rules |
+| `aws-cloudformation-iam` | IAM roles, policies, users, groups |
+| `aws-cloudformation-security` | KMS, Secrets Manager, TLS/SSL, security |
+| `aws-cloudformation-cloudwatch` | CloudWatch metrics, alarms, dashboards, logs |
+| `aws-cloudformation-cloudfront` | CloudFront distributions, origins, caching |
+| `aws-cloudformation-bedrock` | Bedrock agents, knowledge bases, RAG, guardrails |
+| `aws-cloudformation-task-ecs-deploy-gh` | GitHub Actions ECS deployment CI/CD |

agents/aws-solution-architect-expert.md

@@ -31,16 +31,20 @@ When invoked:
 - **Elastic Beanstalk**: Platform-as-a-Service patterns
 - **Outposts/Local Zones**: Hybrid and edge computing patterns
 
+> **Related Skills**: Use `aws-cloudformation-ec2` for EC2 resources, `aws-cloudformation-ecs` for container orchestration, `aws-cloudformation-lambda` for serverless functions, `aws-cloudformation-auto-scaling` for scaling policies
+
 ### 2. Networking & Content Delivery
 - **VPC Architecture**: Subnets, route tables, NAT gateways, VPC peering
 - **Transit Gateway**: Multi-VPC and hybrid connectivity
 - **Direct Connect**: Dedicated network connections to on-premises
-- **CloudFront**: CDN, edge caching, origin failover
+- **CloudFront**: CDN, edge caching, origin failover, distributions, WAF integration
 - **Global Accelerator**: Global traffic distribution and acceleration
 - **Route 53**: DNS routing policies, health checks, failover
 - **PrivateLink**: Private connectivity to AWS services
 - **Network Load Balancer/Application Load Balancer**: Traffic distribution patterns
 
+> **Related Skills**: Use `aws-cloudformation-vpc` for VPC infrastructure, `aws-cloudformation-cloudfront` for CDN distributions
+
 ### 3. Database & Storage Architecture
 - **RDS**: Multi-AZ, read replicas, Aurora Global Database
 - **DynamoDB**: Global tables, on-demand capacity, DAX caching
@@ -51,6 +55,8 @@ When invoked:
 - **Redshift**: Data warehouse, Redshift Serverless, data sharing
 - **Timestream/QLDB**: Time-series and ledger database patterns
 
+> **Related Skills**: Use `aws-cloudformation-rds` for RDS instances, `aws-cloudformation-dynamodb` for DynamoDB tables, `aws-cloudformation-elasticache` for caching clusters, `aws-cloudformation-s3` for S3 storage
+
 ### 4. Security & Identity Architecture
 - **IAM**: Roles, policies, identity federation, cross-account access
 - **AWS Organizations**: Multi-account strategy, SCPs, consolidated billing
@@ -63,6 +69,8 @@ When invoked:
 - **Macie**: Data security and privacy
 - **IAM Identity Center (SSO)**: Centralized identity management
 
+> **Related Skills**: Use `aws-cloudformation-iam` for IAM security configuration, `aws-cloudformation-security` for infrastructure security patterns
+
 ### 5. Application Integration
 - **API Gateway**: REST/HTTP/WebSocket APIs, Lambda integration
 - **SQS**: Message queuing, FIFO queues, dead-letter queues
@@ -82,6 +90,8 @@ When invoked:
 - **CloudTrail**: Audit logging and compliance
 - **CloudWatch**: Monitoring, alarms, logs, dashboards
 
+> **Related Skills**: Use `aws-cloudformation-task-ecs-deploy-gh` for GitHub Actions ECS deployment, `aws-cloudformation-cloudwatch` for monitoring and observability
+
 ### 7. Analytics & Machine Learning
 - **Athena**: Serverless query service, data lake patterns
 - **EMR**: Big data processing, Spark, Hadoop
@@ -90,6 +100,9 @@ When invoked:
 - **SageMaker**: Machine learning workflows
 - **Comprehend/Rekognition/Textract**: AI/ML services
 - **Lake Formation**: Data lake governance
+- **Bedrock**: AI agents, knowledge bases, RAG, guardrails, prompts, flows
+
+> **Related Skills**: Use `aws-cloudformation-bedrock` for Amazon Bedrock AI infrastructure
 
 ### 8. Migration & Modernization
 - **Migration Hub**: Migration tracking and planning
@@ -196,3 +209,25 @@ For each architecture design, provide:
 - "Create an event-driven architecture for real-time processing"
 - "Design a hybrid cloud connectivity solution"
 - "Evaluate this architecture for scalability improvements"
+
+## Available CloudFormation Skills
+
+When designing CloudFormation templates for specific AWS resources, leverage these specialized skills:
+
+| Skill | Purpose |
+|-------|---------|
+| `aws-cloudformation-vpc` | VPC, subnets, route tables, NAT, networking |
+| `aws-cloudformation-ec2` | EC2 instances, launch templates, ASG |
+| `aws-cloudformation-ecs` | ECS task definitions, services, Fargate |
+| `aws-cloudformation-auto-scaling` | Auto Scaling policies and targets |
+| `aws-cloudformation-lambda` | Lambda functions, event sources, layers |
+| `aws-cloudformation-rds` | RDS instances, Aurora, read replicas |
+| `aws-cloudformation-dynamodb` | DynamoDB tables, GSIs, LSIs, streams |
+| `aws-cloudformation-elasticache` | Redis/Memcached clusters, replication |
+| `aws-cloudformation-s3` | S3 buckets, policies, lifecycle rules |
+| `aws-cloudformation-iam` | IAM roles, policies, users, groups |
+| `aws-cloudformation-security` | KMS, Secrets Manager, TLS/SSL, security |
+| `aws-cloudformation-cloudwatch` | CloudWatch metrics, alarms, dashboards, logs |
+| `aws-cloudformation-cloudfront` | CloudFront distributions, origins, caching |
+| `aws-cloudformation-bedrock` | Bedrock agents, knowledge bases, RAG, guardrails |
+| `aws-cloudformation-task-ecs-deploy-gh` | GitHub Actions ECS deployment CI/CD |