개발자 인지 부하 관리와 팀 토폴로지: DevEx 혁신 실전 가이드

개발자 하루 인지 부하 분포 (일반적인 조직)
================================================

내재적 (Intrinsic)  : ████████░░░░░░░░░░░░  35%  <- 코딩, 설계, 디버깅
외재적 (Extraneous) : ██████████████░░░░░░  45%  <- 도구, 프로세스, 대기
본유적 (Germane)    : ████░░░░░░░░░░░░░░░░  20%  <- 학습, 코드 리뷰

이상적인 분포
================================================

내재적 (Intrinsic)  : ████████████░░░░░░░░  50%  <- 핵심 업무에 집중
외재적 (Extraneous) : ████░░░░░░░░░░░░░░░░  15%  <- 최소한의 마찰
본유적 (Germane)    : ███████░░░░░░░░░░░░░  35%  <- 충분한 학습 시간

# devex-metrics.yaml
space_framework:
  satisfaction:
    survey_metrics:
      - name: developer_satisfaction_score
        question: '현재 개발 환경에 얼마나 만족하시나요? (1-5)'
        frequency: quarterly
      - name: tool_satisfaction_score
        question: '현재 사용하는 개발 도구에 얼마나 만족하시나요? (1-5)'
        frequency: quarterly
      - name: retention_intent
        question: '1년 후에도 이 조직에서 일하고 싶으신가요? (1-5)'
        frequency: semi-annual

  performance:
    system_metrics:
      - name: deployment_frequency
        source: ci_cd_pipeline
        description: '프로덕션 배포 빈도'
      - name: change_failure_rate
        source: incident_tracker
        description: '배포로 인한 장애 비율'
      - name: mean_time_to_recovery
        source: pagerduty
        description: '장애 평균 복구 시간'

  activity:
    system_metrics:
      - name: pr_throughput
        source: github
        description: '주간 머지된 PR 수 (팀 단위)'
      - name: code_review_participation
        source: github
        description: '코드 리뷰 참여율'
    caution: '활동량 지표를 개인 평가에 사용하지 말 것'

  communication:
    survey_metrics:
      - name: knowledge_sharing_score
        question: '팀 내 지식 공유가 원활하다고 느끼시나요? (1-5)'
      - name: onboarding_effectiveness
        question: '신규 입사자가 생산적이 되기까지 얼마나 걸렸나요?'
    system_metrics:
      - name: pr_review_turnaround
        source: github
        description: 'PR 리뷰 요청부터 첫 리뷰까지 소요 시간'

  efficiency:
    system_metrics:
      - name: build_time_p50
        source: ci_cd_pipeline
        description: 'CI 빌드 시간 중앙값'
      - name: deploy_lead_time
        source: ci_cd_pipeline
        description: '커밋부터 프로덕션 배포까지 소요 시간'
    survey_metrics:
      - name: flow_state_frequency
        question: '지난 주에 2시간 이상 방해 없이 집중할 수 있었던 횟수는?'
      - name: friction_score
        question: '일상 업무에서 불필요한 마찰을 얼마나 느끼시나요? (1-5)'

# devex-survey-config.yaml
survey:
  name: '월간 DevEx 펄스 체크'
  frequency: monthly
  estimated_time: '5분'
  anonymous: true

  questions:
    - id: q1
      type: scale_1_5
      text: '지난 한 달간 개발 업무에 얼마나 몰입할 수 있었나요?'
      dimension: efficiency

    - id: q2
      type: scale_1_5
      text: 'CI/CD 파이프라인이 업무 흐름을 방해한 적이 있나요?'
      dimension: efficiency

    - id: q3
      type: scale_1_5
      text: '필요한 기술 문서를 쉽게 찾을 수 있었나요?'
      dimension: communication

    - id: q4
      type: open_text
      text: '개발 생산성을 가장 크게 저하시키는 요인 하나를 꼽는다면?'
      dimension: satisfaction

    - id: q5
      type: scale_1_5
      text: '새로운 기술이나 도메인 지식을 학습할 시간이 충분했나요?'
      dimension: satisfaction

  analysis:
    trending: true
    team_comparison: true
    benchmark: 'industry_average'

# team-interactions.yaml
interactions:
  collaboration:
    description: '두 팀이 긴밀하게 협력하여 새로운 것을 만듦'
    duration: '일시적 (수 주 ~ 수 개월)'
    example: '플랫폼 팀과 스트림 팀이 함께 새 배포 파이프라인 설계'
    cognitive_load: '높음 - 양쪽 팀 모두 상대 영역 이해 필요'

  x_as_a_service:
    description: '한 팀이 다른 팀에게 서비스를 제공'
    duration: '지속적'
    example: '플랫폼 팀이 셀프서비스 배포 도구 제공'
    cognitive_load: '낮음 - 소비 팀은 API/인터페이스만 이해하면 됨'

  facilitating:
    description: '한 팀이 다른 팀의 역량 개발을 지원'
    duration: '일시적 (수 주)'
    example: 'SRE 팀이 스트림 팀에게 관찰 가능성 구축 코칭'
    cognitive_load: '중간 - 활성화 팀이 주도하되 학습 팀의 참여 필요'

팀 인지 부하 평가 매트릭스
============================================

              쉬움    보통    어려움
도메인 지식   [ ]     [ ]     [x]     -> 복잡한 비즈니스 로직
기술 스택     [ ]     [x]     [ ]     -> 적절한 수준의 기술 다양성
운영 부담     [ ]     [ ]     [x]     -> 과도한 온콜, 수동 작업
외부 의존성   [x]     [ ]     [ ]     -> 잘 정의된 API 경계

총 인지 부하: 높음 -> 팀 분리 또는 플랫폼 팀 지원 필요

Level 1: 수동 (Manual)
  - 티켓 기반 인프라 요청
  - 수동 배포 스크립트
  - 개인별 다른 로컬 환경

Level 2: 표준화 (Standardized)
  - CI/CD 파이프라인 템플릿
  - 컨테이너화된 개발 환경
  - 기본 모니터링 대시보드

Level 3: 셀프서비스 (Self-Service)
  - 서비스 카탈로그 (Backstage 등)
  - 원클릭 환경 프로비저닝
  - 골든 패스 (Golden Path) 제공

Level 4: 최적화 (Optimized)
  - AI 기반 코드 리뷰, 자동 취약점 탐지
  - 예측적 스케일링, 자동 성능 최적화
  - 개발자 생산성 데이터 기반 지속적 개선

# golden-path-new-service.yaml
name: '신규 마이크로서비스 생성 골든 패스'
version: '2.0'
target_audience: 'stream-aligned teams'

steps:
  - step: 1
    name: '서비스 스캐폴딩'
    tool: 'backstage-software-template'
    description: 'Backstage 템플릿으로 프로젝트 구조 자동 생성'
    includes:
      - '표준 디렉토리 구조'
      - 'Dockerfile (최적화된 멀티스테이지 빌드)'
      - 'CI/CD 파이프라인 설정'
      - '기본 헬스체크 엔드포인트'
      - 'OpenTelemetry 계측 코드'

  - step: 2
    name: '인프라 프로비저닝'
    tool: 'crossplane-compositions'
    description: '필요한 클라우드 리소스 선언적 프로비저닝'
    includes:
      - 'Kubernetes 네임스페이스'
      - '데이터베이스 (RDS/CloudSQL)'
      - '메시지 큐 (SQS/Pub-Sub)'
      - '시크릿 관리 (External Secrets)'

  - step: 3
    name: '관찰 가능성 설정'
    tool: 'grafana-operator'
    description: '모니터링, 로깅, 트레이싱 자동 구성'
    includes:
      - '서비스별 Grafana 대시보드'
      - 'SLO 기반 알림 규칙'
      - '분산 트레이싱 설정'

  - step: 4
    name: '보안 설정'
    tool: 'policy-engine'
    description: '보안 정책 자동 적용'
    includes:
      - '네트워크 정책'
      - 'Pod Security Standards'
      - '이미지 서명 검증'