hypothesis-logger

name	hypothesis-logger
description	WF-07 探索的デバッグの仮説を記録・追跡する。Use when: 探索的デバッグ（WF-07）の Phase E-1 で仮説を定義・結果記録・AC 更新するとき。「仮説を記録して」「次の仮説に進む」「検証結果を記録して」。

Hypothesis Logger

正本: .claude/skills/hypothesis-logger/SKILL.md 関連: docs/workflows/07_exploratory_debug.md Phase E-1

WF-07 探索的デバッグの仮説→検証→学習→AC 更新サイクルを構造化して記録する。

手順

Step 1: 仮説番号の採番

docs/working/<TASK-XXXX>/status.md のすべての「仮説-N:」プレフィックスのエントリ（完了済み - [x]・未完了 - [ ] 問わず）を走査し、最大の N を特定して N+1 を採番する（存在しない場合は 仮説-1 から始める）。完了済み仮説をカウントから除外すると番号が重複するため、完了状態に関わらず全件を対象にする。

Step 2: status.md への仮説記録

docs/working/<TASK-XXXX>/status.md の残タスクに以下の形式で追記する:

- [ ] 仮説-N: <仮説の説明（1 行）>
    prediction: <検証すれば何が分かるか>
    verification: <どうやって検証するか（コマンド / ビルド / 手順）>
    waiting_external_verification: <true|false>

waiting_external_verification: true の場合は BLOCKED 状態として扱う（working-context.md §BLOCKED 状態 準拠）。

Step 3: evidence ディレクトリへの詳細記録

docs/working/<TASK-XXXX>/evidence/exploratory/hypothesis-N.md を作成する:

# 仮説-N: <タイトル>

## 仮説
<詳細な仮説の説明>

## 検証手順
<再現性のある手順>

## 予測結果
<成功 / 失敗の判断基準>

## 検証結果
<!-- 検証完了後に記入 -->
- 結果: <RESOLVED|REJECTED|DEFERRED>
- 判明した事実: <text>
- 次の仮説: <text or なし>

## AC への影響
<!-- 前提変更があれば記入 -->
- 影響 AC: <ID or なし>
- 変更内容: <text>

Step 4: 検証結果の記録（検証完了後）

検証が完了したら以下を実施する:

1. evidence/exploratory/hypothesis-N.md の「検証結果」セクションを記入
2. status.md の - [ ] 仮説-N: を - [x] に更新し、結果を 1 行追記
3. AC への影響がある場合（Phase E-3 発動条件）:
   • pbi-input.md の Notes に「前提変更 (仮説-N 由来)」として追記
   • test-cases.md の該当 AC を更新
   • 影響が Out of scope を超える場合は人間に C-3 再承認を求める

完了状態

状態	意味
RESOLVED	仮説が正しく、問題が解消された
REJECTED	仮説が外れた（問題は別の原因）→ 次の仮説へ
DEFERRED	外部依存で検証待ち（BLOCKED 状態に移行）

使用例

入力: 「EAS ビルドが失敗する原因として .gitignore の glob 誤マッチが怪しい。仮説を記録して」

出力イメージ (status.md への追記):

- [ ] 仮説-3: .gitignore の `pr*.json` glob が `primitive.json` を誤マッチしている
    prediction: glob を修正すれば EAS が primitive.json を含める
    verification: .gitignore を修正して EAS production build を再実行
    waiting_external_verification: true

関連

• WF-07: docs/workflows/07_exploratory_debug.md
• BLOCKED 状態: .claude/rules/working-context.md §BLOCKED 状態