# 1. bisect開始
$ git bisect start
 
# 2. 現在のHEAD（バグあり）をbadとマーク
$ git bisect bad
 
# 3. 正常だったコミットをgoodとマーク
$ git bisect good v1.0.0
# Bisecting: 512 revisions left to test after this (roughly 9 steps)
# [abc123...] feat: some commit message
 
# 4. テストして結果をマーク（繰り返し）
$ npm test
# テスト失敗
$ git bisect bad
# Bisecting: 256 revisions left to test after this (roughly 8 steps)
 
$ npm test
# テスト成功
$ git bisect good
# Bisecting: 128 revisions left to test after this (roughly 7 steps)
 
# ... 繰り返し ...
 
# 5. 原因コミットが特定される
# abc123def456789abcdef is the first bad commit
# commit abc123def456789abcdef
# Author: Developer <dev@example.com>
# Date:   Mon Feb 10 15:30:00 2025 +0900
#
#     feat: add caching layer
 
# 6. bisect終了（元のHEADに戻る）
$ git bisect reset

# bisectの現在の状態を確認
$ git bisect log
# git bisect start
# # bad: [abc123...] feat: latest
# git bisect bad abc123...
# # good: [def456...] v1.0.0
# git bisect good def456...
# # bad: [789abc...] feat: caching
# git bisect bad 789abc...
 
# 残りのコミット数と予想ステップ数
$ git bisect visualize
# → gitk等でbisect範囲のコミットを視覚化
 
# bisect範囲のコミットを一覧表示
$ git bisect visualize --oneline
# → テキスト形式で残りのコミット一覧を表示
 
# 現在のbisect位置の確認
$ git log --oneline -1

# テストスクリプトを指定して自動実行
$ git bisect start HEAD v1.0.0
$ git bisect run npm test
# → 自動的にテストを実行し、exit code 0=good, 非0=bad として判定
 
# カスタムスクリプトでの自動bisect
$ git bisect run ./test-specific-bug.sh
 
# test-specific-bug.sh の例:
#!/bin/bash
npm run build 2>/dev/null || exit 125  # ビルド失敗はスキップ
node -e "
  const result = require('./dist/auth').validate('test@example.com');
  process.exit(result ? 0 : 1);
"

# パターン1: 特定のテストケースのみ実行
#!/bin/bash
# bisect-specific-test.sh
npm run build 2>/dev/null || exit 125
npm test -- --testPathPattern="auth.test" --bail 2>/dev/null
exit $?

# パターン2: コンパイルエラーの検出
#!/bin/bash
# bisect-compile.sh
make clean 2>/dev/null
make 2>/dev/null
exit $?
# → コンパイルが失敗するコミットを特定

# パターン3: パフォーマンスリグレッションの検出
#!/bin/bash
# bisect-performance.sh
npm run build 2>/dev/null || exit 125
RESULT=$(node -e "
  const start = Date.now();
  require('./dist/app').processData(testData);
  const elapsed = Date.now() - start;
  console.log(elapsed);
")
# 500ms以上かかるようになったら bad
if [ "$RESULT" -gt 500 ]; then
  exit 1
else
  exit 0
fi

# パターン4: 特定の文字列が存在するかチェック
#!/bin/bash
# bisect-string-check.sh
# 特定のファイルに特定の文字列が含まれているか確認
grep -q "deprecated_function" src/auth.js
if [ $? -eq 0 ]; then
  exit 1  # deprecated_functionが存在 → bad
else
  exit 0  # 存在しない → good
fi

# パターン5: Dockerを使った環境構築付きテスト
#!/bin/bash
# bisect-docker.sh
docker build -t bisect-test . 2>/dev/null || exit 125
docker run --rm bisect-test npm test 2>/dev/null
EXIT_CODE=$?
docker rmi bisect-test 2>/dev/null
exit $EXIT_CODE

# 特定のパスに限定してbisect
$ git bisect start -- src/auth/ tests/auth/
# → 指定パスに変更があるコミットのみを対象にする
 
# 用語のカスタマイズ（新旧で使う場合）
$ git bisect start --term-old=slow --term-new=fast
$ git bisect slow v1.0.0
$ git bisect fast HEAD
# → パフォーマンス改善コミットの特定にも使える
 
# bisectログの保存と再実行
$ git bisect log > bisect-log.txt
$ git bisect replay bisect-log.txt
 
# 特定のコミットをスキップ
$ git bisect skip
# → ビルドできないコミットなどをスキップ
 
# 範囲指定でスキップ
$ git bisect skip abc123..def456
# → 指定範囲のコミットを全てスキップ
 
# first-parent のみをbisect（Git 2.29+）
$ git bisect start --first-parent HEAD v1.0.0
# → マージコミットの第一親のみを辿る
# → featureブランチのコミットをスキップ
# → マージ単位での二分探索が可能

# ファイル全体のblame
$ git blame src/auth.js
a1b2c3d4 (Gaku    2025-01-15 10:30:00 +0900  1) const bcrypt = require('bcrypt');
d4e5f6a7 (Tanaka  2025-02-01 14:20:00 +0900  2) const jwt = require('jsonwebtoken');
a1b2c3d4 (Gaku    2025-01-15 10:30:00 +0900  3)
b7c8d9e0 (Suzuki  2025-02-10 09:15:00 +0900  4) async function login(email, password) {
d4e5f6a7 (Tanaka  2025-02-01 14:20:00 +0900  5)   const user = await User.findByEmail(email);
 
# 行範囲を指定
$ git blame -L 10,20 src/auth.js
$ git blame -L '/function login/,/^}/' src/auth.js  # 正規表現で範囲指定
 
# 詳細表示（コミットメッセージの1行目も表示）
$ git blame --show-description src/auth.js

# porcelain形式（スクリプト処理用）
$ git blame --porcelain src/auth.js
# 出力:
# a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0 1 1 3
# author Gaku
# author-mail <gaku@example.com>
# author-time 1705282200
# author-tz +0900
# committer Gaku
# committer-mail <gaku@example.com>
# committer-time 1705282200
# committer-tz +0900
# summary feat: initial auth module
# filename src/auth.js
# 	const bcrypt = require('bcrypt');
 
# line-porcelain形式（各行に完全なcommit情報）
$ git blame --line-porcelain src/auth.js
 
# 最小限の出力
$ git blame -s src/auth.js
# → 著者名と日付を省略、SHA-1と行番号のみ
 
# メールアドレスも表示
$ git blame -e src/auth.js

# -M: 同一ファイル内のコード移動を検出
$ git blame -M src/auth.js
# → 同じファイル内で移動された行の元のコミットを表示
 
# -C: ファイル間のコード移動を検出
$ git blame -C src/auth.js
# → 別ファイルからコピーされた行の元のコミットを表示
 
# -C -C: さらに広範囲のコピー検出（同一コミット内）
$ git blame -C -C src/auth.js
 
# -C -C -C: 全コミットにわたるコピー検出
$ git blame -C -C -C src/auth.js

# -M のデフォルト閾値は 20文字
# 移動とみなす最小文字数を変更
$ git blame -M40 src/auth.js
# → 40文字以上の連続する同一テキストを移動として検出
 
# -C のデフォルト閾値も 40文字
$ git blame -C40 src/auth.js
# → 40文字以上のコピーを検出
 
# 閾値を小さくすると:
# - より多くの移動/コピーを検出できる
# - 偽陽性（実際にはコピーでない部分を検出）が増える
# - 処理時間が長くなる

# 大規模なコードフォーマット変更のコミットを除外
$ git blame --ignore-rev abc123def456
$ git blame --ignore-revs-file .git-blame-ignore-revs
 
# .git-blame-ignore-revs ファイルの作成
$ cat .git-blame-ignore-revs
# Prettier導入による全ファイルフォーマット
abc123def456789abcdef1234567890abcdef1234
 
# ESLint auto-fix
def456789abcdef1234567890abcdef1234567890
 
# タブ→スペース変換
789abcdef1234567890abcdef1234567890abcdef
 
# gitの設定で自動的に読み込む
$ git config blame.ignoreRevsFile .git-blame-ignore-revs
 
# GitHub上でも自動的に認識される（リポジトリルートに配置）

# 特定のコミット時点でのblame
$ git blame abc123 -- src/auth.js
 
# 特定の行が変更される前のコミットを追跡
$ git log -p -L 15,25:src/auth.js
# → 指定行範囲の変更履歴を全て表示（logベースの追跡）
 
# 特定の行の変更履歴を1つずつ遡る
$ git blame src/auth.js     # → 最新のblameでcommit Xを発見
$ git blame X~1 -- src/auth.js  # → X以前のblameでcommit Yを発見
$ git blame Y~1 -- src/auth.js  # → Y以前の変更を確認
 
# 特定の日時以降の変更のみ表示
$ git blame --since="2025-01-01" src/auth.js
# → 2025-01-01以降に変更された行のみblame表示
# → それ以前の行は ^abc123 のように ^ プレフィックス付きで表示

# VS Code のGitLens拡張
# → エディタ内でインラインblameを表示
# → カーソル行のblame情報が自動表示される
 
# GitHub上のblame
# URLパターン: https://github.com/user/repo/blame/main/src/auth.js
# → Webブラウザで対話的にblameを確認
# → 各行のコミットリンクから詳細を辿れる
 
# git gui blame
$ git gui blame src/auth.js
# → GUIでblameを表示（Git標準のGUIツール）
 
# tig（コンソールUIツール）
$ tig blame src/auth.js
# → コンソール上で対話的にblameを操作
# → Enterキーでコミット詳細に移動

# 特定の文字列を追加または削除したコミットを検索
$ git log -S "bcrypt" --oneline
# → "bcrypt"という文字列の出現回数が変化したコミット一覧
 
# 正規表現での検索
$ git log -G "function\s+login" --oneline
# → 正規表現にマッチする行が変更されたコミット一覧
 
# 差分も表示
$ git log -S "bcrypt" -p -- src/auth.js

# -S に正規表現を使用（--pickaxe-regex と組み合わせ）
$ git log -S "validate[A-Z]\w+" --pickaxe-regex --oneline
# → validateEmail, validatePassword等のパターンにマッチ
 
# 全ブランチにわたって検索
$ git log --all -S "deprecated_function" --oneline
# → 全ブランチの全コミットから検索
 
# 特定のファイルに限定
$ git log -S "bcrypt" -- src/auth/ lib/security/
# → 指定パス内のファイルのみ対象
 
# 差分のコンテキストも表示
$ git log -S "bcrypt" -p --word-diff
# → 変更箇所を単語単位でハイライト表示

# 特定の行範囲の変更履歴
$ git log -L 10,20:src/auth.js
# → 10行目から20行目の変更を含む全コミットを表示
 
# 関数定義の変更履歴
$ git log -L ':function login:src/auth.js'
# → login関数の定義全体の変更履歴を追跡
# → Git が関数の開始と終了を自動検出
 
# 正規表現で範囲指定
$ git log -L '/^async function login/,/^}/':src/auth.js
# → 指定パターンで範囲を指定
 
# -p オプションと組み合わせてパッチ表示
$ git log -L 10,20:src/auth.js -p
# → 各コミットの具体的な差分を表示

# Step 1: bisectでバグ混入コミットを特定
$ git bisect start HEAD v1.0.0
$ git bisect run npm test
# → commit abc123 が原因と判明
 
# Step 2: 原因コミットの詳細を確認
$ git show abc123 --stat
# → 変更されたファイルの一覧
 
$ git show abc123 -p
# → 具体的な変更内容
 
# Step 3: blameで関連するコードの履歴を確認
$ git blame -L '/function validate/,/^}/' src/auth.js
# → validate関数の各行がいつ・誰に変更されたか
 
# Step 4: pickaxeで関連する変更を全て洗い出す
$ git log -S "validate" --oneline -- src/auth.js
# → validate関連の全変更履歴

# シナリオ: ログイン機能が壊れている
 
# Phase 1: いつから壊れたかを特定
$ git bisect start HEAD v2.0.0 -- src/auth/
$ git bisect run ./test-login.sh
# → commit def456 が最初の bad commit
 
# Phase 2: 何が変わったかを確認
$ git show def456 --stat
# src/auth/login.js  | 15 ++++++-----
# src/auth/session.js | 8 ++++----
# 2 files changed, 11 insertions(+), 12 deletions(-)
 
$ git show def456 -p
# → 具体的なコード変更を確認
 
# Phase 3: 変更の背景を理解
$ git log --oneline def456~5..def456
# → 前後のコミットのコンテキスト
 
$ git blame -L '/function createSession/,/^}/' src/auth/session.js
# → セッション関連コードの変更履歴
 
# Phase 4: 関連する変更を全て洗い出し
$ git log -S "createSession" --oneline
# → createSession関数に関わる全コミット
 
$ git log -G "session.*expire" --oneline -- src/auth/
# → セッションの有効期限に関わる変更
 
# Phase 5: 修正方針の決定
$ git diff def456~1 def456 -- src/auth/
# → バグを導入した変更の具体的な差分
# → この差分を元に修正方法を決定

# Step 1: パフォーマンスが低下した時期を特定
$ git bisect start HEAD v2.0.0
$ git bisect run ./benchmark.sh
# benchmark.shの中身:
#!/bin/bash
npm run build 2>/dev/null || exit 125
TIME=$(node -e "
  const start = Date.now();
  require('./dist/app').processLargeDataset();
  console.log(Date.now() - start);
")
[ "$TIME" -lt 1000 ] && exit 0 || exit 1
 
# Step 2: 原因コミットの分析
$ git show <first-bad-commit> --stat
# → どのファイルが変更されたか
 
$ git diff <first-bad-commit>~1 <first-bad-commit>
# → 具体的な変更内容
 
# Step 3: 変更された関数の履歴を確認
$ git log -L ':function processData:src/data-processor.js'
# → processData関数の変更履歴

# Step 1: 特定の関数が削除されたコミットを特定
$ git log -S "function deprecatedAuth" --oneline
# abc123 feat: remove deprecated auth (← 削除)
# def456 feat: initial auth module    (← 追加)
 
# Step 2: 削除直前のバージョンを確認
$ git show abc123~1:src/auth.js
# → 削除される前のファイル全体
 
$ git blame abc123~1 -- src/auth.js
# → 削除直前の各行のblame
 
# Step 3: 関連する変更を追跡
$ git log -S "deprecatedAuth" -p
# → 追加と削除の両方のコミットの差分を表示

# annotateはblameのエイリアス（出力形式が若干異なる）
$ git annotate src/auth.js
 
# ファイル名の変更を追跡するblame
$ git log --follow -p -- src/auth.js
# → ファイル名が変更されていても変更履歴を追跡
 
# blameでの--follow相当
$ git log --follow --diff-filter=R -- src/auth.js
# → リネームを検出して元のファイル名を特定
$ git blame <旧ファイル名のcommit> -- <旧ファイル名>

# 著者別のコミット数
$ git shortlog -sn
    145  Gaku
     87  Tanaka
     53  Suzuki
 
# 特定期間の著者別統計
$ git shortlog -sn --since="2025-01-01" --until="2025-03-01"
 
# ファイル別の変更回数ランキング
$ git log --name-only --pretty=format: | sort | uniq -c | sort -rn | head -20
 
# 著者別の変更行数
$ git log --author="Gaku" --numstat --pretty=format: | \
  awk '{added+=$1; deleted+=$2} END {print "Added:", added, "Deleted:", deleted}'
 
# 月別のコミット数推移
$ git log --format="%ai" | cut -d'-' -f1,2 | uniq -c

# 戦略1: パス限定
$ git bisect start HEAD v1.0.0 -- src/auth/ tests/auth/
# → 関連パスの変更があるコミットのみテスト
 
# 戦略2: first-parent
$ git bisect start --first-parent HEAD v1.0.0
# → マージコミットの第一親のみ辿る
# → featureブランチのコミットをスキップ
 
# 戦略3: 自動bisect + スキップ
$ git bisect run ./smart-test.sh
# smart-test.sh:
#!/bin/bash
# 依存関係のインストール（キャッシュ使用）
npm ci --cache /tmp/npm-cache 2>/dev/null || exit 125
npm run build 2>/dev/null || exit 125
npm test -- --bail --testPathPattern="auth" 2>/dev/null
exit $?
 
# 戦略4: 範囲の事前絞り込み
$ git log --oneline --first-parent v1.0.0..HEAD | wc -l
# 500 コミット
$ git log --oneline --first-parent v1.0.0..HEAD -- src/auth/ | wc -l
# 30 コミット → パス限定でテスト回数を大幅削減

# 大規模ファイルのblameを高速化
$ git blame --incremental src/auth.js
# → 結果をインクリメンタルに出力（パイプラインに適す）
 
# 特定の行のみblame（全行をblameしない）
$ git blame -L 100,120 src/auth.js
# → 必要な行範囲のみ処理（高速）
 
# .git-blame-ignore-revs で不要なコミットを除外
# → フォーマット変更のコミットをスキップして高速化
 
# diff.renameLimit を調整
$ git config diff.renameLimit 10000
# → リネーム検出の精度と速度のバランスを調整

# NG: bisect中に作業ディレクトリのファイルを修正
$ git bisect start HEAD v1.0.0
$ vim src/auth.js         # ← ファイルを修正してしまう
$ git bisect good         # ← 修正した状態でテストした結果を報告
# → 結果が不正確になり、誤ったコミットが原因として報告される
 
# OK: bisect中はコードを変更しない。テストのみ行う
$ git bisect start HEAD v1.0.0
$ npm test                # テストのみ実行
$ git bisect bad          # 結果を正確に報告

# NG: blameの表示コミットが必ずしもバグの原因とは限らない
$ git blame src/auth.js
# Line 15: abc123 (Tanaka) ... ← "Tanakaがバグを入れた"と判断
# → 実際にはTanakaはフォーマット変更しただけ。本当の原因は別のコミット
 
# OK: --ignore-revs-fileとlog -Lで深掘りする
$ git blame --ignore-revs-file .git-blame-ignore-revs src/auth.js
$ git log -p -L 15,15:src/auth.js
# → フォーマット変更を除外し、実質的な変更履歴を追跡

# NG: ビルドエラーをbadとして報告
#!/bin/bash
npm run build
npm test
exit $?
# → ビルドが壊れているコミットもbadとして報告
# → 実際のバグ混入コミットと区別できない
# → bisectの結果が不正確になる
 
# OK: ビルドエラーはexit 125（skip）にする
#!/bin/bash
npm run build 2>/dev/null || exit 125  # ビルド失敗はスキップ
npm test
exit $?
# → ビルドできないコミットはスキップ
# → テスト結果のみで正確にgood/badを判定

# NG: プロジェクトの最初のコミットからbisect
$ git bisect start HEAD $(git rev-list --max-parents=0 HEAD)
# → 数千〜数万コミットが対象になり、テスト環境の変化も大きい
# → 古いコミットではビルドすらできない可能性が高い
 
# OK: 範囲を適切に絞り込んでから開始
$ git log --oneline --since="2025-01-01" | tail -1
# def456 最古のコミット
$ git bisect start HEAD def456
# → 直近の変更に限定してbisect
 
# さらに良い: パス限定も追加
$ git bisect start HEAD def456 -- src/auth/
# → 関連ファイルの変更のみを対象

# 演習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()

# デバッグ用ユーティリティ
import logging
import traceback
from functools import wraps
 
# ロガーの設定
logging.basicConfig(
    level=logging.DEBUG,
    format='%(asctime)s [%(levelname)s] %(name)s: %(message)s'
)
logger = logging.getLogger(__name__)
 
def debug_decorator(func):
    """関数の入出力をログ出力するデコレータ"""
    @wraps(func)
    def wrapper(*args, **kwargs):
        logger.debug(f"呼び出し: {func.__name__}(args={args}, kwargs={kwargs})")
        try:
            result = func(*args, **kwargs)
            logger.debug(f"戻り値: {func.__name__} -> {result}")
            return result
        except Exception as e:
            logger.error(f"例外発生: {func.__name__}: {e}")
            logger.error(traceback.format_exc())
            raise
    return wrapper
 
@debug_decorator
def process_data(items):
    """データ処理（デバッグ対象）"""
    if not items:
        raise ValueError("空のデータ")
    return [item * 2 for item in items]

# 設計判断の記録テンプレート
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: pickaxeで文字列の追加・削除コミットを検索
$ git log -S "削除された行の内容" --all -p
 
# 方法2: 特定行範囲の変更履歴をlog -Lで追跡
$ git log -p -L '15,20:src/auth.js'
# → 過去に存在した行を含む変更履歴が表示される
 
# 方法3: 削除前のコミットでblame
$ git blame <削除直前のcommit>~1 -- src/auth.js
 
# 方法4: git log --diff-filter=D で削除されたファイル自体を検索
$ git log --diff-filter=D --summary -- src/deprecated/
# → 削除されたファイルの一覧

$ git bisect start --first-parent HEAD v1.0.0 -- src/auth/
$ git bisect run ./test-auth-bug.sh
# → 対象を絞り込み、自動実行で高速に特定

# デフォルトの関数検出パターンの確認
$ git config diff.javascript.xfuncname
# → JavaScriptの関数定義を検出する正規表現
 
# カスタムパターンの設定
$ cat .gitattributes
*.js diff=javascript
*.py diff=python
*.rs diff=rust
 
# カスタム言語の関数パターンを定義
$ git config diff.myLang.xfuncname "^\\s*(function|class|def)\\s+.*$"

# 安定したテストスクリプトの例
#!/bin/bash
npm ci 2>/dev/null || exit 125           # 依存関係を確実にインストール
npm run build 2>/dev/null || exit 125     # ビルド失敗はスキップ
# 3回テストして2回以上成功ならgood
PASS=0
for i in 1 2 3; do
  npm test -- --bail --testPathPattern="login" 2>/dev/null && PASS=$((PASS+1))
done
[ "$PASS" -ge 2 ] && exit 0 || exit 1