# worktreeの追加
$ git worktree add ../hotfix-v1 hotfix/v1.0.1
# → ../hotfix-v1 ディレクトリに hotfix/v1.0.1 をチェックアウト
 
# 新しいブランチを作成しつつworktreeを追加
$ git worktree add -b feature/new-ui ../new-ui main
# → main から feature/new-ui を作成し、../new-ui にチェックアウト
 
# worktreeの一覧
$ git worktree list
/home/user/project          abc1234 [main]
/home/user/hotfix-v1        def5678 [hotfix/v1.0.1]
/home/user/new-ui           789abcd [feature/new-ui]
 
# 詳細表示（porcelain形式）
$ git worktree list --porcelain
worktree /home/user/project
HEAD abc1234567890abcdef1234567890abcdef123456
branch refs/heads/main
 
worktree /home/user/hotfix-v1
HEAD def567890abcdef1234567890abcdef1234567890
branch refs/heads/hotfix/v1.0.1

# worktreeの削除
$ git worktree remove ../hotfix-v1
# → ディレクトリを削除し、.git/worktrees/ からも削除
 
# 未コミットの変更がある場合は強制削除
$ git worktree remove --force ../hotfix-v1
 
# 手動でディレクトリを削除した場合のクリーンアップ
$ rm -rf ../hotfix-v1
$ git worktree prune
# → 存在しないworktreeの参照を削除
 
# worktreeをロック（自動pruneの防止）
$ git worktree lock ../new-ui --reason "長期作業中"
$ git worktree unlock ../new-ui
 
# worktreeの移動
$ git worktree move ../new-ui ../new-ui-v2
# → ディレクトリ名を変更（Git 2.17+）

# linked worktreeの .git ファイルの中身
$ cat ../hotfix-v1/.git
gitdir: /home/user/project/.git/worktrees/hotfix-v1
 
# メインリポジトリ側のworktree情報
$ cat /home/user/project/.git/worktrees/hotfix-v1/gitdir
/home/user/hotfix-v1/.git
 
# worktree固有のHEAD
$ cat /home/user/project/.git/worktrees/hotfix-v1/HEAD
ref: refs/heads/hotfix/v1.0.1
 
# worktree固有のindex（ステージング情報）
$ ls -la /home/user/project/.git/worktrees/hotfix-v1/index

# パターン1: PRレビュー中に別の作業をする
$ git worktree add ../review-pr-42 origin/feature/pr-42
$ cd ../review-pr-42
$ npm install && npm test
$ cd ../project
# → メインの作業ディレクトリを汚さずにレビュー
 
# パターン2: ビルドの同時実行
$ git worktree add ../build-release release/v2.0
$ cd ../build-release && npm run build &
$ cd ../project && npm run dev
# → リリースビルドと開発サーバーを同時実行
 
# パターン3: 複数バージョンの動作比較
$ git worktree add ../v1 v1.0.0
$ git worktree add ../v2 v2.0.0
# → 2つのバージョンを並べて動作確認
 
# パターン4: 緊急のhotfix対応
$ git worktree add -b hotfix/critical ../hotfix main
$ cd ../hotfix
# ... 修正作業 ...
$ git commit -m "fix: critical security issue"
$ git push origin hotfix/critical
$ cd ../project
$ git worktree remove ../hotfix
# → メインの開発作業を中断せずにhotfixを完了
 
# パターン5: ドキュメントの同時編集
$ git worktree add ../docs-edit docs/main
$ cd ../docs-edit
# → ドキュメント専用のworktreeで作業
# → メインの開発worktreeのnpm install等の影響を受けない
 
# パターン6: CI用のクリーンビルド
$ git worktree add --detach ../ci-build HEAD
$ cd ../ci-build
$ npm ci && npm run build && npm test
$ cd ../project
$ git worktree remove ../ci-build
# → クリーンな状態でビルド・テストを実行

# worktree内でのブランチ操作
$ cd ../hotfix-v1
$ git branch                    # 全ブランチを表示（全worktreeで共通）
$ git fetch origin              # フェッチ（全worktreeに反映）
$ git stash                     # このworktreeの変更をstash
 
# worktreeでチェックアウトできないケース
$ git worktree add ../test main
# fatal: 'main' is already checked out at '/home/user/project'
# → 同じブランチを複数worktreeでチェックアウトすることは不可
 
# 回避策: detached HEADで同じコミットを参照
$ git worktree add --detach ../test HEAD
# → ブランチではなくコミットを直接チェックアウト

# worktreeでサブモジュールを初期化する例
$ git worktree add ../review origin/feature/review
$ cd ../review
$ git submodule update --init --recursive
# → worktreeごとにサブモジュールの初期化が必要
 
# worktreeで依存関係をインストールする例
$ git worktree add ../test-branch test-branch
$ cd ../test-branch
$ npm install
# → node_modulesはworktreeごとに独立

#!/bin/bash
# review-pr.sh - PRレビュー用worktreeを自動作成
set -euo pipefail
 
PR_NUMBER=$1
BRANCH="origin/pr/${PR_NUMBER}"
WORKTREE_DIR="../review-pr-${PR_NUMBER}"
 
# リモートの最新を取得
git fetch origin
 
# worktreeを作成
git worktree add "$WORKTREE_DIR" "$BRANCH"
 
# 依存関係のインストールとテスト
cd "$WORKTREE_DIR"
if [ -f package.json ]; then
    npm install
    npm test
fi
 
echo "Review worktree created at: $WORKTREE_DIR"
echo "To clean up: git worktree remove $WORKTREE_DIR"

#!/bin/bash
# cleanup-worktrees.sh - 不要なworktreeを一括削除
set -euo pipefail
 
echo "Current worktrees:"
git worktree list
 
# マージ済みブランチのworktreeを検出
git worktree list --porcelain | while read -r line; do
    if [[ "$line" == "branch refs/heads/"* ]]; then
        branch="${line#branch refs/heads/}"
        if git branch --merged main | grep -q "$branch" && [ "$branch" != "main" ]; then
            echo "Removing merged worktree for branch: $branch"
            worktree_path=$(git worktree list | grep "$branch" | awk '{print $1}')
            git worktree remove "$worktree_path" 2>/dev/null || true
        fi
    fi
done
 
# 存在しないworktreeのクリーンアップ
git worktree prune
echo "Cleanup complete."

# サブモジュールの追加
$ git submodule add https://github.com/lib/utils.git vendor/utils
# → .gitmodules ファイルが作成される
# → vendor/utils/ にリポジトリがクローンされる
# → 特定のcommit SHA-1がインデックスに記録される
 
# .gitmodulesの内容
$ cat .gitmodules
[submodule "vendor/utils"]
    path = vendor/utils
    url = https://github.com/lib/utils.git

# クローン時にサブモジュールも取得
$ git clone --recurse-submodules https://github.com/user/project.git
 
# クローン後にサブモジュールを初期化
$ git submodule init
$ git submodule update
# または一括で
$ git submodule update --init --recursive
 
# 全サブモジュールの状態確認
$ git submodule status
 789abcdef1234567890abcdef1234567890abcdef vendor/utils (v2.3.0)
+fedcba9876543210fedcba9876543210fedcba98 vendor/auth (heads/main)
-0123456789abcdef0123456789abcdef01234567 vendor/ui

# 親リポジトリが記録しているcommitに合わせる
$ git submodule update
# → detached HEAD状態になる
 
# リモートの最新を取得してサブモジュールを更新
$ git submodule update --remote
# → .gitmodulesのbranch設定（デフォルトmain）の最新commitに更新
# → 親リポジトリのインデックスも更新される
 
# 特定のサブモジュールだけ更新
$ git submodule update --remote vendor/utils
$ git add vendor/utils
$ git commit -m "chore: update vendor/utils to latest"
 
# マージ戦略を指定して更新
$ git submodule update --remote --merge
# → 現在のブランチにリモートの変更をmerge
 
$ git submodule update --remote --rebase
# → 現在の作業をリモートの最新に対してrebase

# サブモジュール内で作業する場合
$ cd vendor/utils
$ git checkout main               # detached HEADからブランチに切替
$ vim src/index.js                # 修正
$ git add . && git commit -m "fix: bug in utils"
$ git push origin main            # サブモジュールのリモートにpush
 
# 親リポジトリに戻って記録を更新
$ cd ../..
$ git add vendor/utils
$ git commit -m "chore: update vendor/utils submodule"

# 特定のタグにサブモジュールを固定
$ cd vendor/utils
$ git fetch --tags
$ git checkout v2.3.0
$ cd ../..
$ git add vendor/utils
$ git commit -m "chore: pin vendor/utils to v2.3.0"
 
# 特定のコミットに固定
$ cd vendor/utils
$ git checkout abc123def456
$ cd ../..
$ git add vendor/utils
$ git commit -m "chore: pin vendor/utils to known-good commit"
 
# ブランチのHEADに追従する設定
$ git config -f .gitmodules submodule.vendor/utils.branch develop
$ git submodule update --remote vendor/utils

# サブモジュールの完全な削除（3段階必要）
$ git submodule deinit -f vendor/utils   # 1. 設定の無効化
$ git rm -f vendor/utils                  # 2. ファイルとインデックスから削除
$ rm -rf .git/modules/vendor/utils        # 3. キャッシュの削除
$ git commit -m "chore: remove vendor/utils submodule"

# URLの変更
$ git config -f .gitmodules submodule.vendor/utils.url git@github.com:org/utils.git
$ git submodule sync
$ git submodule update --init
 
# パスの変更（サブモジュールの移動）
$ git mv vendor/utils lib/utils
# → .gitmodulesのパスも自動更新（Git 2.17+）
$ git commit -m "chore: move vendor/utils to lib/utils"
 
# URLの一括書き換え（HTTPS → SSH）
$ git config --global url."git@github.com:".insteadOf "https://github.com/"
# → 全てのHTTPS URLがSSHに変換される

# subtree addでの外部リポジトリ統合
$ git subtree add --prefix=vendor/utils \
    https://github.com/lib/utils.git main --squash
 
# subtreeの更新
$ git subtree pull --prefix=vendor/utils \
    https://github.com/lib/utils.git main --squash
 
# subtreeからの変更を上流にpush
$ git subtree push --prefix=vendor/utils \
    https://github.com/lib/utils.git develop

# subtree add（初回追加）
$ git subtree add --prefix=lib/shared \
    git@github.com:org/shared-lib.git main --squash
# → lib/shared/ に外部リポジトリの内容を配置
# → --squash で外部リポジトリの履歴を1つのコミットにまとめる
 
# subtree pull（更新）
$ git subtree pull --prefix=lib/shared \
    git@github.com:org/shared-lib.git main --squash
# → 最新の変更を取り込む
 
# subtree push（上流への貢献）
$ git subtree push --prefix=lib/shared \
    git@github.com:org/shared-lib.git feature/my-fix
# → lib/shared/ への変更を外部リポジトリのブランチにpush
 
# subtree split（履歴の抽出）
$ git subtree split --prefix=lib/shared --branch=shared-only
# → lib/shared/ に関する履歴だけを抽出してブランチを作成

# 全サブモジュールで同じコマンドを実行
$ git submodule foreach 'git fetch origin && git checkout main && git pull'
 
# ネストされたサブモジュールも含む
$ git submodule foreach --recursive 'git clean -fdx'
 
# 条件付き実行
$ git submodule foreach '
  if [ -f package.json ]; then
    npm install
  fi
'
 
# サブモジュールの名前やパスを使用
$ git submodule foreach 'echo "Processing: $name at $sm_path (toplevel: $toplevel)"'
# $name:     サブモジュール名（.gitmodulesのセクション名）
# $sm_path:  サブモジュールのパス
# $toplevel: 親リポジトリのトップレベルディレクトリ
# $sha1:     サブモジュールの現在のcommit SHA-1
# $displaypath: 表示用パス
 
# 全サブモジュールのステータスサマリー
$ git submodule foreach 'echo "$sm_path: $(git describe --always --dirty)"'
 
# 全サブモジュールで未コミットの変更があるか確認
$ git submodule foreach 'git status --porcelain | grep -q . && echo "$sm_path has changes" || echo "$sm_path is clean"'

#!/bin/bash
# update-all-submodules.sh - 全サブモジュールを安全に更新
set -euo pipefail
 
echo "=== Fetching all submodules ==="
git submodule foreach 'git fetch origin 2>/dev/null'
 
echo ""
echo "=== Status before update ==="
git submodule status
 
echo ""
echo "=== Updating to remote HEAD ==="
git submodule update --remote
 
echo ""
echo "=== Status after update ==="
git submodule status
 
# 変更があればコミット
if ! git diff --cached --quiet; then
    echo ""
    echo "=== Committing submodule updates ==="
    git add -A
    git commit -m "chore: update all submodules to latest"
else
    echo ""
    echo "All submodules are up to date."
fi

# ブランチの指定（update --remote 時に使用）
$ git config -f .gitmodules submodule.vendor/utils.branch develop
 
# shallow clone（高速化）
$ git config -f .gitmodules submodule.vendor/utils.shallow true
 
# URLの書き換え（プライベートリポジトリ対応）
$ git config url."git@github.com:".insteadOf "https://github.com/"
 
# 特定のサブモジュールのfetch設定
$ git config -f .gitmodules submodule.vendor/utils.fetchRecurseSubmodules false
 
# update戦略の設定
$ git config -f .gitmodules submodule.vendor/utils.update merge
# → update時にmergeを使用（デフォルトはcheckout）
 
# .gitmodulesの最終形
$ cat .gitmodules
[submodule "vendor/utils"]
    path = vendor/utils
    url = https://github.com/lib/utils.git
    branch = develop
    shallow = true
[submodule "vendor/auth"]
    path = vendor/auth
    url = git@github.com:org/auth-lib.git
    branch = main
    update = merge
[submodule "vendor/ui"]
    path = vendor/ui
    url = https://github.com/org/ui-components.git
    branch = stable
    shallow = true
    fetchRecurseSubmodules = false

# .github/workflows/ci.yml
name: CI
on: [push, pull_request]
 
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout with submodules
        uses: actions/checkout@v4
        with:
          submodules: recursive    # サブモジュールを再帰的にclone
          token: ${{ secrets.PAT_TOKEN }}  # プライベートサブモジュール用
 
      # shallow submodule（高速化）
      # - name: Checkout with shallow submodules
      #   uses: actions/checkout@v4
      #   with:
      #     submodules: recursive
      #     fetch-depth: 1         # shallow clone
 
      - name: Build
        run: npm run build
 
      - name: Test
        run: npm test

# .gitlab-ci.yml
variables:
  GIT_SUBMODULE_STRATEGY: recursive   # サブモジュールを再帰的に取得
  GIT_SUBMODULE_DEPTH: 1              # shallow clone
 
build:
  script:
    - npm install
    - npm run build
 
# プライベートサブモジュールの場合
# Settings > CI/CD > Variables に CI_JOB_TOKEN を設定
# .gitmodulesのURLを相対パスに変更:
# [submodule "lib/shared"]
#     path = lib/shared
#     url = ../../group/shared-lib.git

// Jenkinsfile
pipeline {
    agent any
    stages {
        stage('Checkout') {
            steps {
                checkout([
                    $class: 'GitSCM',
                    extensions: [
                        [$class: 'SubmoduleOption',
                         disableSubmodules: false,
                         parentCredentials: true,
                         recursiveSubmodules: true,
                         reference: '',
                         trackingSubmodules: false]
                    ],
                    userRemoteConfigs: [[
                        url: 'https://github.com/org/project.git',
                        credentialsId: 'github-credentials'
                    ]]
                ])
            }
        }
        stage('Build') {
            steps {
                sh 'npm install && npm run build'
            }
        }
    }
}

# エラー1: "fatal: reference is not a tree: <sha1>"
# 原因: 親リポジトリが参照するcommitがサブモジュールのリモートに存在しない
$ cd vendor/utils
$ git fetch origin
$ git log --oneline --all | head -5
# → 参照先のcommitが存在するか確認
# 対処: サブモジュールの開発者がpushし忘れている可能性がある
 
# エラー2: "fatal: No url found for submodule path 'vendor/utils'"
# 原因: .gitmodulesに設定があるがgit submodule initされていない
$ git submodule init
$ git submodule update
 
# エラー3: サブモジュールがdetached HEADになる
# 原因: git submodule updateはデフォルトでcheckout（detached HEAD）
$ cd vendor/utils
$ git checkout main   # ブランチに切り替え
# または、update戦略をmergeに変更
$ git config -f .gitmodules submodule.vendor/utils.update merge
 
# エラー4: "Submodule path 'vendor/utils' already exists in the index"
# 原因: 不完全な削除後に再追加しようとしている
$ git rm -f vendor/utils
$ rm -rf .git/modules/vendor/utils
$ git submodule add <url> vendor/utils
 
# エラー5: ネストされたサブモジュールが初期化されない
$ git submodule update --init --recursive
# --recursive を忘れるとネストされたサブモジュールは初期化されない

# エラー1: "fatal: '<branch>' is already checked out"
# 対処: 別のworktreeで使用中のブランチは使えない
$ git worktree list  # どのworktreeがそのブランチを使っているか確認
# → そのworktreeを削除するか、別のブランチ名を使う
 
# エラー2: worktreeが壊れた（参照先が見つからない）
$ git worktree repair
# → 壊れたworktreeのリンクを修復（Git 2.30+）
 
# エラー3: worktreeの.gitファイルが破損
$ cat ../hotfix-v1/.git
# → "gitdir: ..." の内容を確認
# → パスが正しくない場合は手動で修正
 
# エラー4: worktreeを移動した後にリンクが壊れた
$ git worktree repair ../new-location
# → 移動先のパスでリンクを修復

# NG: サブモジュールの変更をpushせずに親リポジトリをpush
$ cd vendor/utils
$ git commit -m "fix: critical bug"
# vendor/utilsのリモートにpushし忘れ
$ cd ../..
$ git add vendor/utils
$ git commit -m "update submodule"
$ git push origin main
# → 他のメンバーが submodule update すると、存在しないcommitを参照してエラー
 
# OK: 常にサブモジュール側を先にpush
$ cd vendor/utils && git push origin main
$ cd ../.. && git add vendor/utils && git commit && git push
# または push時に自動チェック
$ git push --recurse-submodules=check origin main
$ git push --recurse-submodules=on-demand origin main  # 自動push

# NG: 絶対パスをハードコード
BUILD_DIR="/home/user/build-release"
git worktree add "$BUILD_DIR" release/v2.0
 
# OK: 相対パスや変数を使用
PROJECT_ROOT=$(git rev-parse --show-toplevel)
BUILD_DIR="${PROJECT_ROOT}/../build-release"
git worktree add "$BUILD_DIR" release/v2.0

# NG: --remote で常に最新を追従、テストなしで統合
$ git submodule update --remote
$ git add -A && git commit -m "update submodules" && git push
# → 破壊的変更が自動的に取り込まれる可能性
 
# OK: バージョンを明示的に管理
$ cd vendor/utils
$ git fetch origin
$ git log --oneline origin/main..HEAD  # 差分を確認
$ git checkout v2.4.0                   # 特定バージョンに固定
$ cd ../..
$ git add vendor/utils
$ git commit -m "chore: update vendor/utils to v2.4.0"

# NG: worktreeを作成するだけで放置
$ git worktree add ../review-1 feature/a
$ git worktree add ../review-2 feature/b
$ git worktree add ../review-3 feature/c
# ... 数週間放置 ...
# → ディスク容量を圧迫、ブランチの削除もできなくなる
 
# OK: 定期的にクリーンアップ
$ git worktree list
$ git worktree remove ../review-1
$ git worktree prune

# サブモジュールの変更をサマリーで表示
$ git diff --submodule=short
# → サブモジュールのcommit変更を表示
 
$ git diff --submodule=log
# → サブモジュールの変更されたcommitのlog一覧を表示
 
$ git diff --submodule=diff
# → サブモジュール内の実際のdiffを表示
 
# デフォルトの差分表示形式を設定
$ git config --global diff.submodule log

# 全サブモジュールで特定のブランチに切り替え
$ git submodule foreach 'git checkout develop || true'
 
# 全サブモジュールの状態をdetached HEADからブランチに変更
$ git submodule foreach '
  branch=$(git config -f $toplevel/.gitmodules submodule.$name.branch || echo main)
  git checkout $branch 2>/dev/null || git checkout -b $branch
'
 
# サブモジュール内のブランチを一括表示
$ git submodule foreach 'echo "$sm_path: $(git branch --show-current || echo DETACHED)"'

# fsck でサブモジュールのURLが安全か検証
$ git config --global protocol.file.allow always
# → fileプロトコルを明示的に許可（Git 2.38.1+のセキュリティ修正以降）
 
# サブモジュールのURLに対する制限
$ git config --global submodule.fetchJobs 4
# → 並列fetchのジョブ数を制限
 
# URLの検証
$ git submodule foreach 'echo "$name: $(git remote get-url origin)"'
# → 全サブモジュールのURLを一括確認

# 演習1: 基本実装のテンプレート
class Exercise1:
    """基本的な実装パターンの演習"""
 
    def __init__(self):
        self.data = []
 
    def validate_input(self, value):
        """入力値の検証"""
        if value is None:
            raise ValueError("入力値がNoneです")
        return True
 
    def process(self, value):
        """データ処理のメインロジック"""
        self.validate_input(value)
        self.data.append(value)
        return self.data
 
    def get_results(self):
        """処理結果の取得"""
        return {
            'count': len(self.data),
            'data': self.data
        }
 
# テスト
def test_exercise1():
    ex = Exercise1()
    assert ex.process(1) == [1]
    assert ex.process(2) == [1, 2]
    assert ex.get_results()['count'] == 2
 
    try:
        ex.process(None)
        assert False, "例外が発生するべき"
    except ValueError:
        pass
 
    print("全テスト合格!")
 
test_exercise1()

# 演習2: 応用パターン
from typing import List, Dict, Optional
from datetime import datetime
 
class AdvancedExercise:
    """応用パターンの演習"""
 
    def __init__(self, max_size: int = 100):
        self._items: List[Dict] = []
        self._max_size = max_size
        self._created_at = datetime.now()
 
    def add(self, key: str, value: any) -> bool:
        """アイテムの追加（サイズ制限付き）"""
        if len(self._items) >= self._max_size:
            return False
        self._items.append({
            'key': key,
            'value': value,
            'timestamp': datetime.now().isoformat()
        })
        return True
 
    def find(self, key: str) -> Optional[Dict]:
        """キーによる検索"""
        for item in reversed(self._items):
            if item['key'] == key:
                return item
        return None
 
    def remove(self, key: str) -> bool:
        """キーによる削除"""
        for i, item in enumerate(self._items):
            if item['key'] == key:
                self._items.pop(i)
                return True
        return False
 
    def stats(self) -> Dict:
        """統計情報"""
        return {
            'total_items': len(self._items),
            'max_size': self._max_size,
            'usage_percent': len(self._items) / self._max_size * 100,
            'uptime': str(datetime.now() - self._created_at)
        }
 
# テスト
def test_advanced():
    ex = AdvancedExercise(max_size=3)
    assert ex.add("a", 1) == True
    assert ex.add("b", 2) == True
    assert ex.add("c", 3) == True
    assert ex.add("d", 4) == False  # サイズ制限
    assert ex.find("b")['value'] == 2
    assert ex.remove("b") == True
    assert ex.find("b") is None
    stats = ex.stats()
    assert stats['total_items'] == 2
    print("応用テスト全合格!")
 
test_advanced()

# 演習3: パフォーマンス最適化
import time
from functools import lru_cache
 
# 最適化前（O(n^2)）
def slow_search(data: list, target: int) -> int:
    """非効率な検索"""
    for i in range(len(data)):
        for j in range(i + 1, len(data)):
            if data[i] + data[j] == target:
                return (i, j)
    return (-1, -1)
 
# 最適化後（O(n)）
def fast_search(data: list, target: int) -> tuple:
    """ハッシュマップを使った効率的な検索"""
    seen = {}
    for i, num in enumerate(data):
        complement = target - num
        if complement in seen:
            return (seen[complement], i)
        seen[num] = i
    return (-1, -1)
 
# ベンチマーク
def benchmark():
    import random
    data = list(range(5000))
    random.shuffle(data)
    target = data[100] + data[4000]
 
    start = time.time()
    result1 = slow_search(data, target)
    slow_time = time.time() - start
 
    start = time.time()
    result2 = fast_search(data, target)
    fast_time = time.time() - start
 
    print(f"非効率版: {slow_time:.4f}秒")
    print(f"効率版:   {fast_time:.6f}秒")
    print(f"高速化率: {slow_time/fast_time:.0f}倍")
 
benchmark()

# 設計判断の記録テンプレート
class ArchitectureDecisionRecord:
    """ADR (Architecture Decision Record) の作成"""
 
    def __init__(self, title: str):
        self.title = title
        self.context = ""
        self.decision = ""
        self.consequences = []
        self.alternatives = []
 
    def set_context(self, context: str):
        """背景と課題の記述"""
        self.context = context
        return self
 
    def set_decision(self, decision: str):
        """決定内容の記述"""
        self.decision = decision
        return self
 
    def add_consequence(self, consequence: str, positive: bool = True):
        """結果の追加"""
        self.consequences.append({
            'description': consequence,
            'type': 'positive' if positive else 'negative'
        })
        return self
 
    def add_alternative(self, name: str, reason_rejected: str):
        """却下した代替案の追加"""
        self.alternatives.append({
            'name': name,
            'reason_rejected': reason_rejected
        })
        return self
 
    def to_markdown(self) -> str:
        """Markdown形式で出力"""
        md = f"# ADR: {self.title}\n\n"
        md += f"## 背景\n{self.context}\n\n"
        md += f"## 決定\n{self.decision}\n\n"
        md += "## 結果\n"
        for c in self.consequences:
            icon = "✅" if c['type'] == 'positive' else "⚠️"
            md += f"- {icon} {c['description']}\n"
        md += "\n## 却下した代替案\n"
        for a in self.alternatives:
            md += f"- **{a['name']}**: {a['reason_rejected']}\n"
        return md

# チーム間のAPI契約定義
from dataclasses import dataclass
from typing import List, Optional
from enum import Enum
 
class Priority(Enum):
    LOW = "low"
    MEDIUM = "medium"
    HIGH = "high"
    CRITICAL = "critical"
 
@dataclass
class APIContract:
    """チーム間のAPI契約"""
    endpoint: str
    method: str
    owner_team: str
    consumers: List[str]
    sla_ms: int  # レスポンスタイムSLA
    priority: Priority
 
    def validate_sla(self, actual_ms: int) -> bool:
        """SLA準拠の確認"""
        return actual_ms <= self.sla_ms
 
    def to_openapi(self) -> dict:
        """OpenAPI形式で出力"""
        return {
            'path': self.endpoint,
            'method': self.method,
            'x-owner': self.owner_team,
            'x-consumers': self.consumers,
            'x-sla-ms': self.sla_ms
        }
 
# 使用例
contracts = [
    APIContract(
        endpoint="/api/v1/users",
        method="GET",
        owner_team="user-team",
        consumers=["order-team", "notification-team"],
        sla_ms=200,
        priority=Priority.HIGH
    ),
    APIContract(
        endpoint="/api/v1/orders",
        method="POST",
        owner_team="order-team",
        consumers=["payment-team", "inventory-team"],
        sla_ms=500,
        priority=Priority.CRITICAL
    )
]

# 1. .gitmodulesを編集
$ git config -f .gitmodules submodule.vendor/utils.url git@github.com:org/utils.git
 
# 2. ローカル設定を同期
$ git submodule sync
 
# 3. サブモジュールを再初期化
$ git submodule update --init
 
# 4. 変更をコミット
$ git add .gitmodules
$ git commit -m "chore: update submodule URL for vendor/utils"

# 安全なクリーンアップ手順
$ git worktree prune          # 壊れたworktree参照を削除
$ git gc --prune=now          # 不要オブジェクトを削除

# sparse-checkout（Git 2.25+）
$ git clone --filter=blob:none --sparse https://github.com/org/monorepo.git
$ cd monorepo
$ git sparse-checkout set lib/utils lib/auth
# → lib/utils/ と lib/auth/ だけがチェックアウトされる
# → 他のディレクトリのファイルはダウンロードされない
 
# サブモジュールとの違い:
# - sparse-checkout: 1つのリポジトリの一部を取得
# - submodule: 別のリポジトリを参照