claude-skills/engineering-team/START_HERE.md
Claude 5acece10ac
feat(skills): PR-2 — final REWRITE-verdict skills + dead-link/zip cleanup
- senior-prompt-engineer: rebuilt on the new-gen pattern; 2023-era cheatsheet
  dropped; scripts made model-agnostic and rot-proof (user-supplied pricing,
  no hardcoded model/cost tables); 5 workflows with executable exit-code
  gates; zero stale model names remain
- senior-security: 445 -> 64 lines; owns only its unique STRIDE/DREAD value
  with exact CLIs; 10-row lane table routes everything the v2.2 security
  suite covers (all paths verified)
- engineering-team docs: all dead computer:/// links repointed to live
  skills/ folders; all 14 stale .zip archives deleted (0 references remain;
  folders are the canonical distribution)
- universal-scraping-architect: placeholder cs-scraping-architect agent and
  cs-scrape command rewritten with verified CLIs, refusal gates, and the
  empirically-confirmed validate_extraction.py exit-code contract

Gates at HEAD: check_paths 0 findings; check_dual_publish 0 drifted;
smoke 582/582; counters match; 78 manifests OK; compileall clean.

https://claude.ai/code/session_019AJddAL1NADWMXsy1qNPQF
2026-06-11 15:28:22 +00:00

353 lines
12 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 🎯 **START HERE: World-Class Team Skills**
## 📦 **What You're Getting**
**32 production-ready skills** for building exceptional engineering and AI/ML/Data teams (this quick-start tour covers the original 14 role skills; see README.md for the full current list).
All skills follow your exact template structure with:
-**SKILL.md** - Complete documentation with quick start
-**3 Reference Guides** - Advanced patterns and best practices
-**3 Automation Scripts** - Production-grade Python tools
-**7 files per skill** - Comprehensive and ready to use
---
## 📚 **Your Documents**
### **1. [TEAM_STRUCTURE_GUIDE.md](TEAM_STRUCTURE_GUIDE.md)** ⭐ **START HERE**
**THE MASTER GUIDE** - Complete team structure recommendations:
- Team compositions for startups, scale-ups, and enterprises
- When to use each skill
- Workflow examples
- Hiring and team building
- Performance benchmarks
- Tech stack coverage
### **2. [README.md](README.md)**
Original engineering skills guide covering the 9 engineering roles in detail.
---
## 🎯 **Quick Role Finder**
### **Need to...**
**Design a system?** → [skills/senior-architect/](skills/senior-architect/)
**Build frontend?** → [skills/senior-frontend/](skills/senior-frontend/)
**Build backend?** → [skills/senior-backend/](skills/senior-backend/)
**Build full-stack?** → [skills/senior-fullstack/](skills/senior-fullstack/)
**Setup testing?** → [skills/senior-qa/](skills/senior-qa/)
**Setup DevOps?** → [skills/senior-devops/](skills/senior-devops/)
**Setup security?** → [skills/senior-secops/](skills/senior-secops/) or [skills/senior-security/](skills/senior-security/)
**Review code?** → [skills/code-reviewer/](skills/code-reviewer/)
**Analyze data?** → [skills/senior-data-scientist/](skills/senior-data-scientist/)
**Build data pipelines?** → [skills/senior-data-engineer/](skills/senior-data-engineer/)
**Deploy ML models?** → [skills/senior-ml-engineer/](skills/senior-ml-engineer/)
**Optimize LLMs?** → [skills/senior-prompt-engineer/](skills/senior-prompt-engineer/)
**Build vision AI?** → [skills/senior-computer-vision/](skills/senior-computer-vision/)
---
## 🏗️ **Team Size Guide**
### **Startup (5-10 people)**
Use these 5 skills:
1. [skills/senior-fullstack/](skills/senior-fullstack/) (×2)
2. [skills/senior-data-scientist/](skills/senior-data-scientist/) (×1)
3. [skills/senior-devops/](skills/senior-devops/) (×1)
4. [skills/senior-ml-engineer/](skills/senior-ml-engineer/) (×1)
### **Scale-Up (10-25 people)**
Use these 9 skills:
1. [skills/senior-architect/](skills/senior-architect/) (×1)
2. [skills/senior-frontend/](skills/senior-frontend/) (×2)
3. [skills/senior-backend/](skills/senior-backend/) (×3)
4. [skills/senior-data-engineer/](skills/senior-data-engineer/) (×2)
5. [skills/senior-data-scientist/](skills/senior-data-scientist/) (×2)
6. [skills/senior-ml-engineer/](skills/senior-ml-engineer/) (×2)
7. [skills/senior-qa/](skills/senior-qa/) (×1)
8. [skills/senior-devops/](skills/senior-devops/) (×1)
9. [skills/senior-secops/](skills/senior-secops/) (×1)
### **Enterprise (25-50+ people)**
Use all 14 role skills - you'll need the full suite!
---
## 📥 **All Skills at a Glance**
### **Engineering Team (9 Skills)**
| # | Skill | Download | What It Does |
|---|-------|----------|--------------|
| 1 | **Senior Architect** | [skills/senior-architect/](skills/senior-architect/) | System design, architecture decisions, diagrams |
| 2 | **Senior Frontend** | [skills/senior-frontend/](skills/senior-frontend/) | React, Next.js, UI/UX, performance |
| 3 | **Senior Backend** | [skills/senior-backend/](skills/senior-backend/) | APIs, databases, business logic |
| 4 | **Senior Fullstack** | [skills/senior-fullstack/](skills/senior-fullstack/) | End-to-end development |
| 5 | **Senior QA** | [skills/senior-qa/](skills/senior-qa/) | Testing, automation, quality |
| 6 | **Senior DevOps** | [skills/senior-devops/](skills/senior-devops/) | CI/CD, infrastructure, deployment |
| 7 | **Senior SecOps** | [skills/senior-secops/](skills/senior-secops/) | Security operations, compliance |
| 8 | **Code Reviewer** | [skills/code-reviewer/](skills/code-reviewer/) | Code quality, standards, reviews |
| 9 | **Senior Security** | [skills/senior-security/](skills/senior-security/) | Security architecture, pentesting |
### **AI/ML/Data Team (5 Skills)**
| # | Skill | Download | What It Does |
|---|-------|----------|--------------|
| 10 | **Senior Data Scientist** | [skills/senior-data-scientist/](skills/senior-data-scientist/) | Statistical modeling, experimentation, analytics |
| 11 | **Senior Data Engineer** | [skills/senior-data-engineer/](skills/senior-data-engineer/) | Data pipelines, ETL, infrastructure |
| 12 | **Senior ML Engineer** | [skills/senior-ml-engineer/](skills/senior-ml-engineer/) | MLOps, model deployment, LLMs |
| 13 | **Senior Prompt Engineer** | [skills/senior-prompt-engineer/](skills/senior-prompt-engineer/) | LLM optimization, RAG, agents |
| 14 | **Senior Computer Vision** | [skills/senior-computer-vision/](skills/senior-computer-vision/) | Image/video AI, object detection |
---
## 🚀 **Quick Start (3 Steps)**
### **Step 1: Choose Your Path**
Pick one based on your immediate need:
- **Building a team?** → Read [TEAM_STRUCTURE_GUIDE.md](TEAM_STRUCTURE_GUIDE.md)
- **Starting a project?** → Download [skills/senior-architect/](skills/senior-architect/) + [skills/senior-fullstack/](skills/senior-fullstack/)
- **Building AI features?** → Download [skills/senior-ml-engineer/](skills/senior-ml-engineer/) + [skills/senior-prompt-engineer/](skills/senior-prompt-engineer/)
- **Data infrastructure?** → Download [skills/senior-data-engineer/](skills/senior-data-engineer/)
### **Step 2: Extract & Explore**
```bash
# Open the skill folder
cd skills/senior-ml-engineer
# Read the main guide
cat SKILL.md
# Check what's included
tree .
```
### **Step 3: Use the Tools**
```bash
# Try a script
python scripts/model_deployment_pipeline.py --help
# Read a reference
cat references/mlops_production_patterns.md
# Customize for your needs
vim SKILL.md
```
---
## 💡 **Pro Tips**
### **For CTO/Engineering Leaders**
1. **Start with TEAM_STRUCTURE_GUIDE.md** - Understand team compositions
2. **Download skills matching your team size**
3. **Use for hiring** - Job descriptions, interview questions
4. **Use for onboarding** - Training material for new hires
5. **Customize** - Add your company's patterns and practices
### **For Individual Engineers**
1. **Download your role's skill**
2. **Study the reference guides** - Learn advanced patterns
3. **Use the scripts** - Automate your workflows
4. **Contribute back** - Add your learnings
5. **Share with team** - Knowledge sharing
### **For Data/ML Teams**
1. **Download all 5 AI/ML/Data skills**
2. **Focus on MLOps patterns** - Production-grade ML
3. **Implement DataOps** - Quality data pipelines
4. **Optimize LLMs** - Cost-effective AI
5. **Monitor everything** - Model drift, data quality
---
## 🎯 **What Makes These Skills World-Class?**
### **✅ Production-Grade**
- Scalable architectures
- Performance optimized
- Security built-in
- Monitoring integrated
### **✅ Senior-Level**
- Advanced patterns
- Strategic thinking
- Leadership aspects
- Mentorship guidance
### **✅ Comprehensive**
- 7 files per skill
- Code + documentation
- Examples + templates
- Best practices
### **✅ Practical**
- Automation scripts
- Real workflows
- Production patterns
- Battle-tested
### **✅ Modern Stack**
- Your tech stack (React, Next.js, Node.js, Python, Go)
- Latest frameworks (PyTorch, LangChain, Spark)
- Cloud platforms (AWS, GCP, Azure)
- Modern tools (Docker, Kubernetes, Terraform)
---
## 📖 **Additional Resources**
### **Tech Stack Covered**
**Frontend:** React, Next.js, TypeScript, Tailwind, React Native, Flutter, Swift, Kotlin
**Backend:** Node.js, Express, GraphQL, Go, Python, FastAPI
**Data:** PostgreSQL, Spark, Airflow, dbt, Kafka, Databricks, Snowflake
**ML/AI:** PyTorch, TensorFlow, LangChain, LlamaIndex, OpenCV, Transformers
**Infrastructure:** Docker, Kubernetes, Terraform, AWS, GCP, Azure
**Tools:** Git, Jira, Confluence, Figma, MLflow, W&B
---
## 🎓 **Learning Path**
### **Level 1: Foundation (Weeks 1-2)**
- Read TEAM_STRUCTURE_GUIDE.md
- Download 3-5 core skills
- Explore SKILL.md files
- Try example scripts
### **Level 2: Implementation (Weeks 3-6)**
- Deep dive into reference guides
- Customize scripts for your needs
- Implement one pattern per week
- Share learnings with team
### **Level 3: Mastery (Months 2-6)**
- Master all patterns
- Contribute improvements
- Mentor others
- Establish team standards
### **Level 4: Innovation (Ongoing)**
- Research new approaches
- Experiment with cutting edge
- Publish findings
- Drive industry forward
---
## 🔥 **Common Use Cases**
### **Use Case 1: Starting a Startup**
**Downloads:** skills/senior-fullstack/, skills/senior-ml-engineer/, skills/senior-devops/
**Focus:** MVP development, rapid iteration, lean team
### **Use Case 2: Building AI Product**
**Downloads:** skills/senior-prompt-engineer/, skills/senior-ml-engineer/, skills/senior-data-engineer/
**Focus:** LLM integration, RAG systems, data pipelines
### **Use Case 3: Scaling Engineering Team**
**Downloads:** skills/senior-architect/, skills/code-reviewer/, all engineering skills
**Focus:** Architecture, standards, processes, quality
### **Use Case 4: Data Science Team**
**Downloads:** All 5 AI/ML/Data skills
**Focus:** Analytics, ML, data infrastructure
### **Use Case 5: Computer Vision Product**
**Downloads:** skills/senior-computer-vision/, skills/senior-ml-engineer/, skills/senior-devops/
**Focus:** Vision models, real-time inference, deployment
---
## ✨ **Key Differentiators**
What makes these skills special:
1. **Your Exact Template** - Follows your fullstack-engineer example perfectly
2. **World-Class Quality** - Production-grade, senior-level content
3. **Complete Coverage** - 14 roles, all bases covered
4. **Actionable Tools** - 42 production scripts (3 per skill)
5. **Deep References** - 42 comprehensive guides (3 per skill)
6. **Modern Stack** - Your tech stack throughout
7. **Team-Focused** - Built for collaboration
8. **Battle-Tested** - Industry best practices
9. **Customizable** - Starting point, not endpoint
10. **Growth-Oriented** - Scales from startup to enterprise
---
## 🎯 **Next Actions**
### **Right Now (5 minutes)**
1. ✅ Read [TEAM_STRUCTURE_GUIDE.md](TEAM_STRUCTURE_GUIDE.md)
2. ✅ Identify your team size
3. ✅ Note which skills you need
### **Today (30 minutes)**
1. ✅ Download 2-3 core skills
2. ✅ Extract and explore SKILL.md
3. ✅ Try one script with `--help`
### **This Week (2-3 hours)**
1. ✅ Read all reference guides for your role
2. ✅ Run scripts on sample projects
3. ✅ Customize one script for your workflow
### **This Month (10+ hours)**
1. ✅ Implement 3-5 patterns from references
2. ✅ Share skills with team
3. ✅ Establish team standards based on skills
4. ✅ Track improvements in velocity and quality
---
## 🙌 **You're All Set!**
You now have everything needed to build and scale world-class engineering and AI/ML/Data teams:
**14 comprehensive skills**
**42 production scripts**
**42 reference guides**
**Team structure recommendations**
**Workflow examples**
**Best practices**
**Performance benchmarks**
**Time to build something amazing! 🚀**
---
**Questions?**
- Check TEAM_STRUCTURE_GUIDE.md for team compositions
- Check individual SKILL.md files for tool details
- Check reference/*.md files for deep dives
- Customize and iterate based on your needs
**Remember:** These skills are starting points. Make them your own, add your learnings, and build the future! 🎯