開発者の認知負荷管理とチームトポロジー：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: '2つのチームが緊密に協力して新しいものを作る'
    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'
      - 'イメージ署名検証'