claude-skills-reference/engineering-team/CLAUDE.md

Engineering Team Skills - Claude Code Guidance

This guide covers the 29 production-ready engineering skills and their Python automation tools.

Engineering Skills Overview

Core Engineering (16 skills):

• senior-architect, senior-frontend, senior-backend, senior-fullstack
• senior-qa, senior-devops, senior-secops
• code-reviewer, senior-security
• aws-solution-architect, ms365-tenant-manager, google-workspace-cli, tdd-guide, tech-stack-evaluator, epic-design
• a11y-audit — WCAG 2.2 accessibility audit and fix (a11y_scanner.py, contrast_checker.py)
• azure-cloud-architect — Azure infrastructure design, ARM/Bicep templates, landing zones
• gcp-cloud-architect — GCP infrastructure design, Terraform modules, cloud-native patterns
• security-pen-testing — Penetration testing methodology, vulnerability assessment, exploit analysis

AI/ML/Data (5 skills):

• senior-data-scientist, senior-data-engineer, senior-ml-engineer
• senior-prompt-engineer, senior-computer-vision

Total Tools: 34+ Python automation tools

Core Engineering Tools

1. Project Scaffolder (senior-fullstack/scripts/project_scaffolder.py)

Purpose: Production-ready project scaffolding for modern stacks

Supported Stacks:

• Next.js + GraphQL + PostgreSQL
• React + REST + MongoDB
• Vue + GraphQL + MySQL
• Express + TypeScript + PostgreSQL

Features:

• Docker Compose configuration
• CI/CD pipeline (GitHub Actions)
• Testing infrastructure (Jest, Cypress)
• TypeScript + ESLint + Prettier
• Database migrations

Usage:

# Create new project
python senior-fullstack/scripts/project_scaffolder.py my-project --type nextjs-graphql

# Start services
cd my-project && docker-compose up -d

2. Code Quality Analyzer (senior-fullstack/scripts/code_quality_analyzer.py)

Purpose: Comprehensive code quality analysis and metrics

Features:

• Security vulnerability scanning
• Performance issue detection
• Test coverage assessment
• Documentation quality
• Dependency analysis
• Actionable recommendations

Usage:

# Analyze project
python senior-fullstack/scripts/code_quality_analyzer.py /path/to/project

# JSON output
python senior-fullstack/scripts/code_quality_analyzer.py /path/to/project --json

Output:

Code Quality Report:
- Overall Score: 85/100
- Security: 90/100 (2 medium issues)
- Performance: 80/100 (3 optimization opportunities)
- Test Coverage: 75% (target: 80%)
- Documentation: 88/100

Recommendations:
1. Update lodash to 4.17.21 (CVE-2020-8203)
2. Optimize database queries in UserService
3. Add integration tests for payment flow

3. Fullstack Scaffolder (senior-fullstack/scripts/fullstack_scaffolder.py)

Purpose: Rapid fullstack application generation

Usage:

python senior-fullstack/scripts/fullstack_scaffolder.py my-app --stack nextjs-graphql

AI/ML/Data Tools

Data Science Tools

Experiment Designer (senior-data-scientist/scripts/experiment_designer.py)

• A/B test design
• Statistical power analysis
• Sample size calculation

Feature Engineering Pipeline (senior-data-scientist/scripts/feature_engineering_pipeline.py)

• Automated feature generation
• Correlation analysis
• Feature selection

Statistical Analyzer (senior-data-scientist/scripts/statistical_analyzer.py)

• Hypothesis testing
• Causal inference
• Regression analysis

Data Engineering Tools

Pipeline Orchestrator (senior-data-engineer/scripts/pipeline_orchestrator.py)

• Airflow DAG generation
• Spark job templates
• Data quality checks

Data Quality Validator (senior-data-engineer/scripts/data_quality_validator.py)

• Schema validation
• Null check enforcement
• Anomaly detection

ETL Generator (senior-data-engineer/scripts/etl_generator.py)

• Extract-Transform-Load workflows
• CDC (Change Data Capture) patterns
• Incremental loading

ML Engineering Tools

Model Deployment Pipeline (senior-ml-engineer/scripts/model_deployment_pipeline.py)

• Containerized model serving
• REST API generation
• Load balancing config

MLOps Setup Tool (senior-ml-engineer/scripts/mlops_setup_tool.py)

• MLflow configuration
• Model versioning
• Drift monitoring

LLM Integration Builder (senior-ml-engineer/scripts/llm_integration_builder.py)

• OpenAI API integration
• Prompt templates
• Response parsing

Prompt Engineering Tools

Prompt Optimizer (senior-prompt-engineer/scripts/prompt_optimizer.py)

• Prompt A/B testing
• Token optimization
• Few-shot example generation

RAG System Builder (senior-prompt-engineer/scripts/rag_system_builder.py)

• Vector database setup
• Embedding generation
• Retrieval strategies

Agent Orchestrator (senior-prompt-engineer/scripts/agent_orchestrator.py)

• Multi-agent workflows
• Tool calling patterns
• State management

Computer Vision Tools

Vision Model Trainer (senior-computer-vision/scripts/vision_model_trainer.py)

• Object detection (YOLO, Faster R-CNN)
• Semantic segmentation
• Transfer learning

Inference Optimizer (senior-computer-vision/scripts/inference_optimizer.py)

• Model quantization
• TensorRT optimization
• ONNX export

Video Processor (senior-computer-vision/scripts/video_processor.py)

• Frame extraction
• Object tracking
• Scene detection

Tech Stack Patterns

Frontend (React/Next.js)

• TypeScript strict mode
• Component-driven architecture
• Atomic design patterns
• State management (Zustand/Jotai)
• Testing (Jest + React Testing Library)

Backend (Node.js/Express)

• Clean architecture
• Dependency injection
• Repository pattern
• Domain-driven design
• Testing (Jest + Supertest)

Fullstack Integration

• GraphQL for API layer
• REST for external services
• WebSocket for real-time
• Redis for caching
• PostgreSQL for persistence

Development Workflows

Workflow 1: New Project Setup

# 1. Scaffold project
python senior-fullstack/scripts/project_scaffolder.py my-app --type nextjs-graphql

# 2. Start services
cd my-app && docker-compose up -d

# 3. Run migrations
npm run migrate

# 4. Start development
npm run dev

Workflow 2: Code Quality Check

# 1. Analyze codebase
python senior-fullstack/scripts/code_quality_analyzer.py ./

# 2. Fix security issues
npm audit fix

# 3. Run tests
npm test

# 4. Build production
npm run build

Workflow 3: ML Model Deployment

# 1. Setup MLOps infrastructure
python senior-ml-engineer/scripts/mlops_setup_tool.py

# 2. Deploy model
python senior-ml-engineer/scripts/model_deployment_pipeline.py model.pkl

# 3. Monitor performance
# Check MLflow dashboard

Quality Standards

All engineering tools must:

• Support modern tech stacks (Next.js, React, Vue, Express)
• Generate production-ready code
• Include testing infrastructure
• Provide Docker configurations
• Support CI/CD integration

Integration Patterns

GitHub Actions CI/CD

All scaffolders generate GitHub Actions workflows:

.github/workflows/
├── test.yml          # Run tests on PR
├── build.yml         # Build and lint
└── deploy.yml        # Deploy to production

Docker Compose

Multi-service development environment:

services:
  - app (Next.js)
  - api (GraphQL)
  - db (PostgreSQL)
  - redis (Cache)

Additional Resources

• Quick Start: START_HERE.md
• Team Structure: TEAM_STRUCTURE_GUIDE.md
• Engineering Roadmap: engineering_skills_roadmap.md (if exists)
• Main Documentation: ../CLAUDE.md

---

Last Updated: March 18, 2026 Skills Deployed: 29 engineering skills production-ready Total Tools: 39+ Python automation tools across core + AI/ML/Data + epic-design + a11y

---

epic-design

Build cinematic 2.5D interactive websites with scroll storytelling, parallax depth, and premium animations. Includes asset inspection pipeline, 45+ techniques across 8 categories, and accessibility built-in.

Key features:

• 6-layer depth system with automatic parallax
• 13 text animation techniques, 9 scroll patterns
• Asset inspection with background judgment rules
• Python tool for automated image analysis
• WCAG 2.1 AA compliant (reduced-motion)

Use for: Product launches, portfolio sites, SaaS marketing pages, event sites, Apple-style animations

Live demo: epic-design-showcase.vercel.app