Technical Leadership Skill

Purpose

Provide structured technical leadership guidance including architecture reviews, mentoring frameworks, and decision facilitation for engineering teams.

Parameters

| Parameter | Type | Required | Validation | Default | |-----------|------|----------|------------|---------| | context | string | ✅ | min: 30 chars | - | | guidance_type | enum | ⚪ | review|mentoring|decision|standards | review | | team_size | integer | ⚪ | 1-100 | 5 | | decision_stakes | enum | ⚪ | low|medium|high|critical | medium | | output_format | enum | ⚪ | checklist|narrative|action_items | action_items |

Execution Flow

┌──────────────────────────────────────────────────────────┐
│ 1. VALIDATE: Check context and guidance type             │
│ 2. ANALYZE: Understand leadership challenge              │
│ 3. FRAMEWORK: Select appropriate framework               │
│ 4. APPLY: Apply framework to context                     │
│ 5. SYNTHESIZE: Generate recommendations                  │
│ 6. STRUCTURE: Format output appropriately                │
│ 7. DELIVER: Return guidance with action items            │
└──────────────────────────────────────────────────────────┘

Retry Logic

| Error | Retry | Backoff | Max Attempts | |-------|-------|---------|--------------| | VALIDATION_ERROR | No | - | 1 | | FRAMEWORK_ERROR | Yes | 1s | 2 | | CONTEXT_UNCLEAR | Yes | - | 2 |

Logging & Observability

log_points:
  - event: guidance_requested
    level: info
    data: [guidance_type, decision_stakes]
  - event: framework_applied
    level: info
    data: [framework_name, context_type]
  - event: guidance_delivered
    level: info
    data: [action_items_count, confidence]

metrics:
  - name: guidance_requests
    type: counter
    labels: [guidance_type]
  - name: response_time_ms
    type: histogram
  - name: action_items_generated
    type: counter

Error Handling

| Error Code | Description | Recovery | |------------|-------------|----------| | E501 | Missing context | Request specific situation | | E502 | Invalid guidance type | Show available types | | E503 | Conflicting requirements | Highlight trade-offs | | E504 | Stakes not specified | Default to medium |

Unit Test Template

test_cases:
  - name: "Architecture review"
    input:
      context: "Review microservices migration proposal"
      guidance_type: "review"
      decision_stakes: "high"
    expected:
      has_checklist: true
      has_findings: true
      has_recommendation: true

  - name: "Mentoring guidance"
    input:
      context: "Senior engineer wants to grow into tech lead"
      guidance_type: "mentoring"
    expected:
      has_grow_framework: true
      has_action_items: true
      has_timeline: true

  - name: "Decision facilitation"
    input:
      context: "Team split on REST vs GraphQL"
      guidance_type: "decision"
    expected:
      has_rapid_model: true
      has_decision_matrix: true
      has_recommendation: true

Troubleshooting

Common Issues

| Symptom | Root Cause | Resolution | |---------|------------|------------| | Vague recommendations | Context too broad | Narrow scope | | No clear decision | Missing decision framework | Apply RAPID | | Review bottleneck | Too many reviews | Delegate, set SLAs |

Debug Checklist

□ Is the leadership challenge clear?
□ Is the appropriate framework selected?
□ Are stakeholders identified?
□ Are decision criteria explicit?
□ Are action items specific and actionable?

Frameworks Quick Reference

| Framework | Use Case | |-----------|----------| | RAPID | Complex decisions with multiple stakeholders | | GROW | Mentoring and coaching conversations | | RFC | Technical design decisions | | ADR | Architecture decision documentation |

Integration

| Component | Trigger | Data Flow | |-----------|---------|-----------| | Agent 07 | Leadership request | Receives context, returns guidance | | All Agents | Coordination | Synthesizes recommendations |

Quality Standards

Actionable: All guidance includes next steps
Fair: Unbiased, considers all perspectives
Documented: Decisions and rationale recorded

Version History

| Version | Date | Changes | |---------|------|---------| | 2.0.0 | 2025-01 | Production-grade: RAPID, GROW, review checklists | | 1.0.0 | 2024-12 | Initial release |