Módulo 2: Workflows e Comandos Customizados

# debug-analyze-error.md
# Bug Detective Workflow

You are an expert debugging assistant. Analyze the {'{{error_type}}'} error in {'{{tech_stack}}'} application:

**Error Details:**
**Error Message:** {'{{error_message}}'}
**Stack Trace:** {'{{stack_trace}}'}
**Context:** {'{{context}}'}
**Reproduction Steps:** {'{{repro_steps}}'}

## Analysis Framework

### 1. Root Cause Investigation
- Examine stack trace for exact failure point
- Identify primary and secondary causes
- Check for common patterns in {'{{tech_stack}}'}
- Look for environmental factors (dependencies, config, etc.)

### 2. Impact Assessment  
- Severity level (Critical/High/Medium/Low)
- User experience impact
- Business logic affected
- Data integrity concerns

### 3. Solution Strategy
- Immediate hotfix if critical
- Comprehensive fix approach
- Code changes required with examples
- Testing strategy to validate fix

### 4. Prevention Measures
- Code patterns that caused this
- Monitoring/alerts to catch early
- Code review checkpoints
- Documentation updates needed

## Output Format
Provide clear, actionable steps with:
- **Root Cause**: One sentence explanation
- **Fix**: Step-by-step implementation  
- **Test Plan**: How to verify the fix
- **Prevention**: Avoid similar issues

Focus on {'{{priority}}'} priority and {'{{focus_area}}'} if specified.

# refactor-component-smart.md
Refactor {'{{component_type}}'} component with focus on:

{'{{#if performance_focused}}'}
**Performance Optimization:**
- Memoization opportunities
- Render optimization
- Bundle size reduction
{'{{/if}}'}

{'{{#if accessibility_focused}}'}
**Accessibility Improvements:**
- ARIA attributes addition
- Keyboard navigation support
- Screen reader compatibility
{'{{/if}}'}

{'{{#if testing_focused}}'}
**Testing Enhancement:**
- Unit test coverage
- Integration test scenarios
- Mock strategies
{'{{/if}}'}

{'{{#unless has_tests}}'}
**Critical:** This component lacks tests. Priority should be:
1. Add basic test coverage first
2. Then proceed with refactoring
{'{{/unless}}'}

Base Requirements (always applies):
- Code quality improvement
- TypeScript strict mode compliance
- Error handling enhancement

{'{{#if tech_stack}}'}
Stack-specific considerations for {'{{tech_stack}}'}:
{'{{#switch tech_stack}}'}
  {'{{#case "React"}}'}
  - Hook optimization
  - Component composition
  - Prop drilling elimination
  {'{{/case}}'}
  {'{{#case "Vue"}}'}
  - Composition API usage
  - Reactive patterns
  - Performance optimizations
  {'{{/case}}'}
  {'{{#case "Angular"}}'}
  - Change detection strategy
  - OnPush optimization
  - RxJS patterns
  {'{{/case}}'}
{'{{/switch}}'}
{'{{/if}}'}

# security-audit-multi.md
Perform security audit on multiple {'{{file_type}}'} files:

## Files to Analyze:
{'{{#each file_list}}'}
### {'{{this.name}}'} ({'{{this.size}}'})
**Risk Level:** {'{{this.risk_level}}'}
**Last Modified:** {'{{this.modified}}'}

{'{{#if this.high_risk}}'}
⚠️ **PRIORITY**: This file shows high-risk patterns
{'{{/if}}'}
{'{{/each}}'}

## Security Checklist:
{'{{#each security_checks}}'}
- [ ] {'{{this.category}}'}: {'{{this.description}}'}
  {'{{#if this.automated}}'}
  - Tool: {'{{this.tool}}'}
  - Command: {'{{this.command}}'}
  {'{{/if}}'}
{'{{/each}}'}

## Analysis Framework:
{'{{#each analysis_types}}'}
### {'{{@index}}'}.{'{{this.name}}'}
{'{{this.description}}'}

**Detection Patterns:**
{'{{#each this.patterns}}'}
- {'{{this}}'}
{'{{/each}}'}
{'{{/each}}'}

{'{{#if include_remediation}}'}
## Remediation Steps:
For each vulnerability found:
1. Classify severity (Critical/High/Medium/Low)
2. Provide fix code example  
3. Update security tests
4. Document prevention measures
{'{{/if}}'}

# deploy-strategy-smart.md
{'{{validate required: environment, app_type, scale}}'}
{'{{transform scale: uppercase}}'}
{'{{default region: "us-east-1"}}'}

Create deployment strategy for {'{{app_type}}'} in {'{{environment}}'} environment:

## Environment Configuration:
**Target:** {'{{environment | capitalize}}'}
**Scale:** {'{{scale}}'} 
**Region:** {'{{region}}'}
{'{{#if custom_domain}}'}
**Domain:** {'{{custom_domain}}'}
{'{{/if}}'}

{'{{#validate_enum environment: ["development", "staging", "production"]}}'}
## Environment-Specific Settings:
{'{{#switch environment}}'}
  {'{{#case "development"}}'}
  - Single instance deployment
  - Hot reloading enabled
  - Debug logging on
  - Mock external services
  {'{{/case}}'}
  {'{{#case "staging"}}'}  
  - Load balancer with 2+ instances
  - Production-like data
  - Performance monitoring
  - Integration tests required
  {'{{/case}}'}
  {'{{#case "production"}}'}
  - Auto-scaling enabled
  - Circuit breakers active
  - Comprehensive monitoring
  - Blue-green deployment
  - Rollback strategy required
  {'{{/case}}'}
{'{{/switch}}'}
{'{{else}}'}
❌ Error: Environment must be one of: development, staging, production
{'{{/validate_enum}}'}

{'{{#validate_number scale: {min: 1, max: 100}}}'}
## Scaling Configuration:
- Initial instances: {'{{scale}}'}
- Max instances: {'{{scale | multiply: 3}}'}
- CPU threshold: 70%
- Memory threshold: 80%
{'{{else}}'}
❌ Error: Scale must be between 1 and 100
{'{{/validate_number}}'}

## Technology Stack:
{'{{#if tech_stack}}'}
{'{{#each tech_stack}}'}
- {'{{this.name}}'}: {'{{this.version}}'}
  {'{{#if this.config}}'}
  Config: {'{{this.config}}'}
  {'{{/if}}'}
{'{{/each}}'}
{'{{else}}'}
**Note:** No specific tech stack provided. Using generic deployment patterns.
{'{{/if}}'}

{'{{#require_when environment="production": ["security_scan", "performance_tests", "monitoring_setup"]}}'}
## Production Requirements Met:
{'{{#each required_checks}}'}
✅ {'{{this}}'}
{'{{/each}}'}
{'{{/require_when}}'}

~/.config/claude-desktop/workflows/
├── core/                      # Workflows essenciais
│   ├── debugging/
│   │   ├── debug-analyze-error.md
│   │   ├── debug-memory-leak.md
│   │   └── debug-race-condition.md
│   ├── performance/
│   │   ├── perf-optimize-queries.md
│   │   ├── perf-frontend-bundle.md
│   │   └── perf-api-latency.md
│   ├── testing/
│   │   ├── test-generate-cases.md
│   │   ├── test-e2e-scenarios.md
│   │   └── test-api-contracts.md
│   └── architecture/
│       ├── arch-microservice-design.md
│       ├── arch-database-design.md
│       └── arch-security-review.md
├── project-specific/          # Por projeto
│   ├── project-alpha/
│   │   ├── deploy-alpha.md
│   │   ├── test-alpha-api.md
│   │   └── monitor-alpha.md
│   └── project-beta/
│       ├── migrate-beta-db.md
│       └── scale-beta.md
├── experimental/              # Workflows em teste
│   ├── ai-code-review.md
│   ├── automated-refactor.md
│   └── smart-deploy.md
├── shared/                    # Para equipe
│   ├── team-code-review.md
│   ├── team-deploy-checklist.md
│   └── team-security-audit.md
├── archived/                  # Workflows obsoletos
│   └── legacy/
└── templates/                 # Templates base
    ├── _workflow-template.md
    ├── _debugging-template.md
    └── _performance-template.md

# debug-analyze-error.md
# Bug Detective Workflow v2.1.0
# Created: 2025-01-15
# Last Updated: 2025-01-25  
# Author: CrazyStack Team
# Stability: Stable

## Changelog
### v2.1.0 (2025-01-25)
- Added memory leak detection patterns
- Improved error categorization
- Added TypeScript-specific analysis

### v2.0.0 (2025-01-20) 
- BREAKING: Changed variable names for consistency
- Added conditional logic for different tech stacks
- Improved output formatting

### v1.2.1 (2025-01-18)
- Fixed template variable validation
- Minor improvements to stack trace analysis

## Compatibility
- Claude Code: >= 1.2.0
- Requires: error_type, tech_stack, error_message
- Optional: priority, focus_area, context

## Usage Examples
```bash
# Basic usage
claude --workflow debug-analyze-error --error_type="Runtime" --tech_stack="React"

# Advanced usage with all parameters
claude --workflow debug-analyze-error \
  --error_type="Memory Leak" \
  --tech_stack="Node.js Express" \
  --error_message="Heap growing by 50MB/hour" \
  --priority="critical" \
  --focus_area="database connections"
```

## Testing Status
- ✅ Tested with React errors
- ✅ Tested with Node.js errors  
- ✅ Tested with database errors
- 🔄 Testing with Go errors (in progress)

---
# Workflow Content Starts Here

# Inicializar repositório de workflows
cd ~/.config/claude-desktop/workflows
git init
git remote add origin https://github.com/your-team/claude-workflows.git

# Estrutura de branches
git checkout -b main          # Workflows estáveis
git checkout -b develop       # Novos workflows
git checkout -b experimental  # Testes e experimentos

# Fluxo de desenvolvimento
git checkout develop
# ... criar/editar workflows
git add .
git commit -m "feat: add performance optimization workflow v1.0.0"

# Merge para main após testes
git checkout main
git merge develop

# Tags para releases
git tag -a v1.5.0 -m "Release v1.5.0: Performance workflows collection"
git push origin v1.5.0

# .gitignore para workflows
echo "# Ignore personal/sensitive workflows" > .gitignore
echo "personal/" >> .gitignore
echo "*.private.md" >> .gitignore
echo ".env" >> .gitignore