agentic-sdlc 1.0.0 → 1.5.0

package/.agent/knowledge-base/role-guides/DEVOPS-KB-Guide.md

@@ -0,0 +1,491 @@
+# 🚀 DevOps - Knowledge Base Guide
+
+## Role: @DEVOPS (DevOps Engineer)
+
+---
+
+## 🎯 Your Auto-Learning Responsibilities
+
+As DEVOPS, you capture knowledge about:
+- Deployment failures and fixes
+- Infrastructure issues
+- Configuration problems
+- CI/CD pipeline challenges
+- Performance bottlenecks
+- Monitoring and alerting patterns
+
+---
+
+## 🔄 Auto-Learning Triggers for DEVOPS
+
+### Mandatory KB Entry Creation
+
+| Trigger | When | Category | Example |
+|---------|------|----------|---------|
+| **Deployment Failure** | Deployment fails | Platform | KB-[date]-###-deployment-failure |
+| **Rollback Event** | Production rollback | Platform | KB-[date]-###-rollback-incident |
+| **Infrastructure Issue** | Server/container problem | Platform | KB-[date]-###-infrastructure-issue |
+| **Configuration Error** | Config causes failure | Platform | KB-[date]-###-config-error |
+| **Performance Issue** | Production performance problem | Performance | KB-[date]-###-performance-issue |
+| **Security Incident** | Security breach/vulnerability | Security | KB-[date]-###-security-incident |
+| **Monitoring Alert** | Critical alert triggered | Platform | KB-[date]-###-monitoring-alert |
+| **Scaling Issue** | Auto-scaling problem | Performance | KB-[date]-###-scaling-issue |
+
+---
+
+## 📝 KB Entry Template for DEVOPS
+
+```markdown
+# KB-[YYYY-MM-DD]-[###] - [Infrastructure Issue Title]
+
+## Document Info
+| Field | Value |
+|-------|-------|
+| ID | KB-[YYYY-MM-DD]-[###] |
+| Date | [YYYY-MM-DD] |
+| Author | @DEVOPS |
+| Category | Platform / Performance / Security |
+| Severity | [Critical/High/Medium/Low] |
+| Auto-Generated | Yes |
+| Source Task | [Task ID] |
+| Sprint | [N] |
+| Tags | #devops #deployment #infrastructure #auto-learned |
+
+---
+
+## Incident Description
+
+### Issue
+[Clear description of the infrastructure/deployment issue]
+
+### Impact
+- **Downtime:** [Duration]
+- **Users Affected:** [Number/Percentage]
+- **Services Affected:** [List]
+- **Data Loss:** [Yes/No]
+
+### Timeline
+- **Detected:** [Timestamp]
+- **Investigation Started:** [Timestamp]
+- **Root Cause Found:** [Timestamp]
+- **Fix Applied:** [Timestamp]
+- **Resolved:** [Timestamp]
+- **Total Duration:** [Duration]
+
+---
+
+## Context
+
+### Environment
+- **Environment:** [Dev/Staging/Production]
+- **Platform:** [AWS/Azure/GCP/Vercel/etc.]
+- **Region:** [Region]
+- **Infrastructure:** [Kubernetes/Docker/Serverless/etc.]
+
+### Configuration
+```yaml
+# Relevant configuration
+[config snippet]
+```
+
+### Monitoring Data
+```
+# Logs/metrics showing the issue
+[log entries or metrics]
+```
+
+---
+
+## Root Cause Analysis
+
+### Investigation Steps
+1. [Step 1 - What was checked]
+2. [Step 2 - What was found]
+3. [Step 3 - Root cause identified]
+
+### Root Cause
+[Detailed technical explanation]
+
+### Why It Happened
+- [Reason 1]
+- [Reason 2]
+- [Contributing factors]
+
+### Warning Signs Missed
+- [Early indicator 1]
+- [Early indicator 2]
+
+---
+
+## Solution Applied
+
+### Immediate Fix
+```bash
+# Commands executed to fix
+[commands]
+```
+
+### Configuration Changes
+```yaml
+# Updated configuration
+[config changes]
+```
+
+### Infrastructure Changes
+- [Change 1]
+- [Change 2]
+
+### Verification
+```bash
+# Verification commands
+[commands to verify fix]
+```
+
+---
+
+## Prevention Measures
+
+### Monitoring Updates
+```yaml
+# New alerts added
+alerts:
+  - name: [Alert name]
+    condition: [Condition]
+    threshold: [Threshold]
+    action: [Action]
+```
+
+### Automation Added
+```bash
+# Automated checks/fixes
+[automation scripts]
+```
+
+### Runbook Created
+```markdown
+## Runbook: [Issue Type]
+
+### Detection
+- [How to detect]
+
+### Investigation
+1. [Step 1]
+2. [Step 2]
+
+### Resolution
+1. [Step 1]
+2. [Step 2]
+
+### Verification
+- [How to verify]
+```
+
+### Infrastructure as Code Updates
+```terraform
+# Updated IaC
+[terraform/cloudformation/etc.]
+```
+
+---
+
+## Deployment Checklist Updates
+
+### Pre-Deployment
+- [ ] [New check 1]
+- [ ] [New check 2]
+
+### During Deployment
+- [ ] [New check 1]
+- [ ] [New check 2]
+
+### Post-Deployment
+- [ ] [New check 1]
+- [ ] [New check 2]
+
+### Rollback Procedure
+1. [Step 1]
+2. [Step 2]
+
+---
+
+## Performance Impact
+
+### Metrics Before
+- **Response Time:** [Value]
+- **Throughput:** [Value]
+- **Error Rate:** [Value]
+- **Resource Usage:** [Value]
+
+### Metrics After
+- **Response Time:** [Value]
+- **Throughput:** [Value]
+- **Error Rate:** [Value]
+- **Resource Usage:** [Value]
+
+### Improvement
+- [Metric]: [Percentage] improvement
+
+---
+
+## Cost Impact (if applicable)
+
+### Cost Before
+- [Service]: $[Amount]/month
+
+### Cost After
+- [Service]: $[Amount]/month
+
+### Savings/Increase
+- [Percentage] [decrease/increase]
+
+---
+
+## Lessons Learned
+
+### What Worked Well
+- [Success 1]
+- [Success 2]
+
+### What Didn't Work
+- [Failed approach 1]
+- [Failed approach 2]
+
+### Key Takeaways
+1. [Takeaway 1]
+2. [Takeaway 2]
+
+### Process Improvements
+- [Improvement 1]
+- [Improvement 2]
+
+---
+
+## Related Entries
+- KB-[ID]: [Related infrastructure issue]
+- KB-[ID]: [Related deployment pattern]
+
+---
+
+## References
+- Incident Report: [Link]
+- Monitoring Dashboard: [Link]
+- Documentation: [Link]
+- Post-Mortem: [Link]
+
+---
+
+#knowledge-base #devops #infrastructure #deployment #auto-learned
+```
+
+---
+
+## 🔍 Pre-Deployment KB Search
+
+Before deployment, search KB for:
+
+```markdown
+### DEVOPS KB Search Checklist
+- [ ] Similar deployment issues
+- [ ] Known infrastructure problems
+- [ ] Configuration gotchas
+- [ ] Performance considerations
+- [ ] Rollback procedures
+- [ ] Monitoring requirements
+
+**Search Keywords:**
+- Platform (AWS, Vercel, etc.)
+- Service (Lambda, EC2, etc.)
+- Environment (production, staging)
+- Technology stack
+```
+
+---
+
+## 📊 DEVOPS-Specific Metrics
+
+Track in your DevOps Plan and Log:
+
+```markdown
+## DevOps Knowledge Metrics
+
+### Deployment Stats
+- **Total Deployments:** [X]
+- **Successful:** [Y]
+- **Failed:** [Z]
+- **Rollbacks:** [W]
+- **KB Entries Created:** [Number]
+
+### Incident Response
+- **Incidents:** [X]
+- **MTTR (Mean Time To Resolve):** [Y] minutes
+- **KB Entries:** [List KB-IDs]
+
+### Infrastructure Changes
+- **Changes Made:** [X]
+- **Issues Prevented:** [Y]
+- **KB Entries Referenced:** [Z]
+
+### Knowledge Reuse
+- **Time Saved:** [Estimate]
+- **Incidents Prevented:** [Number]
+- **Runbooks Created:** [Number]
+```
+
+---
+
+## 🎯 Integration with DevOps Plan
+
+Add this section to every DevOps Plan and Log:
+
+```markdown
+## Knowledge Base Integration
+
+### KB Entries Referenced
+| KB-ID | Title | How It Helped |
+|-------|-------|---------------|
+| KB-[ID] | [Title] | [Description] |
+
+### Deployment Patterns Applied from KB
+1. [Pattern 1 from KB-ID]
+2. [Pattern 2 from KB-ID]
+
+### New KB Entries Created
+| KB-ID | Title | Category | Trigger |
+|-------|-------|----------|---------|
+| KB-[ID] | [Title] | [Category] | [Deployment failure/etc.] |
+
+### Runbooks from KB
+| Runbook | Source KB | Status |
+|---------|-----------|--------|
+| [Name] | KB-[ID] | [Active/Updated] |
+```
+
+---
+
+## 🚀 Quick Actions
+
+### After Deployment Failure
+```markdown
+1. Immediate rollback if critical
+2. Capture logs and metrics
+3. Document timeline
+4. Create KB entry
+5. Update deployment checklist
+6. Add monitoring alerts
+```
+
+### After Rollback
+```markdown
+1. Document rollback reason
+2. Create KB entry (mandatory)
+3. Analyze root cause
+4. Update rollback procedure
+5. Add prevention measures
+6. Notify stakeholders
+```
+
+### After Performance Issue
+```markdown
+1. Capture performance metrics
+2. Identify bottleneck
+3. Create KB entry
+4. Implement fix
+5. Add performance monitoring
+6. Update capacity planning
+```
+
+---
+
+## 📚 Example KB Entries for DEVOPS
+
+### Example 1: Deployment Failure
+**KB-2026-01-01-040-vercel-build-timeout.md**
+- Pattern: Build times out on large projects
+- Solution: Optimize build process, increase timeout
+- Prevention: Monitor build times, optimize dependencies
+
+### Example 2: Infrastructure Issue
+**KB-2026-01-01-041-docker-memory-leak.md**
+- Pattern: Container memory grows until OOM
+- Solution: Add memory limits, fix leak in code
+- Prevention: Memory monitoring, regular restarts
+
+### Example 3: Configuration Error
+**KB-2026-01-01-042-env-var-missing.md**
+- Pattern: Missing environment variable causes crash
+- Solution: Add validation, use defaults
+- Prevention: Config validation in CI/CD
+
+### Example 4: Scaling Issue
+**KB-2026-01-01-043-auto-scaling-delay.md**
+- Pattern: Auto-scaling too slow for traffic spike
+- Solution: Adjust scaling thresholds, pre-warm
+- Prevention: Load testing, predictive scaling
+
+---
+
+## 🎓 DEVOPS Best Practices
+
+1. **Search KB Before Deployment**
+   - Check for known issues
+   - Review deployment patterns
+   - Verify configuration
+
+2. **Document Incidents Immediately**
+   - Capture timeline
+   - Save logs and metrics
+   - Create KB entry
+
+3. **Build Runbooks**
+   - Every incident gets runbook
+   - Link to KB entry
+   - Keep updated
+
+4. **Automate Prevention**
+   - Add monitoring alerts
+   - Create automated checks
+   - Update CI/CD pipeline
+
+5. **Share Infrastructure Patterns**
+   - Document IaC patterns
+   - Create reusable modules
+   - Update documentation
+
+---
+
+## 🔄 DevOps Workflow with KB
+
+```markdown
+### KB-Integrated DevOps Flow
+
+1. **Pre-Deployment**
+   - Search KB for similar deployments
+   - Review deployment checklist
+   - Check for known issues
+
+2. **During Deployment**
+   - Monitor metrics
+   - Watch for alerts
+   - Track deployment progress
+
+3. **Post-Deployment**
+   - Verify deployment success
+   - Check performance metrics
+   - Monitor for issues
+
+4. **Incident Response**
+   - Search KB for similar incidents
+   - Follow runbook if available
+   - Document new incidents
+
+5. **Prevention**
+   - Create KB entry
+   - Update monitoring
+   - Add automation
+   - Share lessons learned
+```
+
+---
+
+#devops #infrastructure #deployment #knowledge-base
+