@takuma-hirai/hirai-method 0.1.0

package/.claude/commands/gan-build.md

@@ -0,0 +1,91 @@
+---
+description: GAN harness Generator/Evaluator loop — iterate implementation against live-app eval until score ≥7.0 or 15 iterations.
+---
+
+# /gan-build
+
+GAN-Style Harness の **Generator/Evaluator ループ** フェーズ。実装 → live app デプロイ → Playwright で評価 → feedback → 次反復、を閾値到達まで繰り返す。
+
+## 使い方
+
+```
+/gan-build <spec-file>                    # 既定: max 15 iter, threshold 7.0
+/gan-build <spec-file> --max-iter 10      # 反復上限
+/gan-build <spec-file> --threshold 7.5    # 合格スコア
+/gan-build <spec-file> --max-cost 200     # USD 制限
+```
+
+## 動作
+
+### Initialization
+
+1. `<spec-file>` を読み込み
+2. セッション dir 作成: `.gan-sessions/<timestamp>/`
+3. live-app workspace 作成
+
+### Main Loop
+
+```
+for i in 1..max_iter:
+  # Generator
+  spec + (if i>1) feedback-{i-1}.md を context に
+  Generator(Opus) が実装 + git commit
+  live-app を port 3000 で起動
+
+  # Evaluator
+  Evaluator(Opus + Playwright MCP) が実機テスト
+  4基準（design/originality/craft/functionality）でスコア
+  feedback-{i}.md を保存
+
+  # Convergence check
+  if weighted_score >= threshold:
+    break "PASS"
+  if i >= 3 and no improvement:
+    break "PLATEAU - 人間レビュー要求"
+  if cost > max_cost:
+    break "BUDGET EXCEEDED"
+```
+
+### Sprint Contract
+
+各反復前に Generator と Evaluator が実装範囲を交渉:
+
+```markdown
+# Sprint Contract: <feature>
+- 実装範囲: <list>
+- 完了条件: <eval が PASS と判定する観測可能な振る舞い>
+- 非ゴール: <list>
+- 推定時間: <hour>
+```
+
+## Convergence
+
+- 合格閾値: **7.0 / 10**（重み付き合計）
+- 上限: **15 反復**（典型は 5-15 で十分）
+- Plateau: **3 反復連続でスコア改善なし** → 人間レビュー
+
+## 出力
+
+```
+.gan-sessions/<timestamp>/
+├── spec.md                  # /gan-design の出力
+├── feedback-001.md          # iter 1 のスコア + 指摘
+├── feedback-002.md          # iter 2
+├── ...
+├── feedback-NNN.md
+├── live-app/                # 最終成果物
+└── playwright-runs/         # スクリーンショット履歴
+```
+
+## コスト感
+
+| パターン | 時間 | コスト | 品質 |
+|---|---:|---:|---|
+| 単一エージェント | 20分 | $9 | barely functional |
+| GAN harness | 4-6h | $125-200 | production-ready |
+
+## 関連
+
+- skill: `.claude/skills/gan-style-harness/SKILL.md`
+- `/gan-design`
+- L4 instinct 化: Evaluator の指摘パターンを `/learn` 経由で instinct DB へ

package/.claude/commands/gan-design.md

@@ -0,0 +1,82 @@
+---
+description: GAN harness Planner phase — turn a one-line prompt into a full product specification with features, sprints, and evaluation criteria.
+---
+
+# /gan-design
+
+GAN-Style Harness の **Planner** フェーズ。1 行プロンプトを 16 機能・複数 Sprint 構成の本格仕様書に展開する。
+
+## 使い方
+
+```
+/gan-design <one-line prompt>
+```
+
+例:
+```
+/gan-design 「契約進捗を Slack で確認できる社内 Bot」
+```
+
+## 動作
+
+1. プロンプトを Opus に投げる（Planner agent）
+2. 以下の構造で `.gan-sessions/<timestamp>/spec.md` を生成:
+
+```markdown
+# Product Spec: <name>
+
+## Vision
+<1段落>
+
+## Target Users / Personas
+<list>
+
+## Features (16+)
+### Feature 1: <name>
+- User Story: As a ___, I want ___ so that ___
+- Acceptance Criteria:
+  - [ ] ...
+
+### Feature 2: ...
+
+## Sprints
+### Sprint 1: Foundation
+Features: 1, 2, 3
+Goal: ...
+
+### Sprint 2: Core Flow
+...
+
+## Evaluation Criteria
+### Design Quality (weight 0.30)
+- ...
+### Originality (weight 0.20)
+- ...
+### Craft (weight 0.30)
+- ...
+### Functionality (weight 0.20)
+- ...
+
+## Non-Goals
+<list>
+
+## Tech Stack Constraints
+<list>
+```
+
+3. 生成された spec.md をユーザーに提示・レビュー依頼
+
+## 次のステップ
+
+ユーザーが spec を承認したら:
+
+```
+/gan-build .gan-sessions/<timestamp>/spec.md
+```
+
+で Generator/Evaluator ループを開始。
+
+## 関連
+
+- skill: `.claude/skills/gan-style-harness/SKILL.md`
+- `/gan-build`

package/.claude/commands/gate-bypass.md

@@ -0,0 +1,77 @@
+---
+description: Pre-clear GateGuard for a specific file, or pre-pass the next Confidence Gate (F3) check.
+---
+
+# /gate-bypass
+
+GateGuard 系を **事前 clear** する汎用コマンド。
+
+| 形式 | 用途 |
+|---|---|
+| `/gate-bypass <file>` | F1 GateGuard: 指定ファイルの Edit/Write 両方を pre-clear |
+| `/gate-bypass --edit <file>` | F1 GateGuard: Edit のみ |
+| `/gate-bypass --write <file>` | F1 GateGuard: Write のみ |
+| `/gate-bypass confidence <reason>` | F3 Confidence Gate: 次回 1 回 PASS（reason は bypass.log に記録） |
+
+## F1 GateGuard bypass
+
+すでに事実調査が済んでいる（サブエージェントの報告から得た等）ケースで、無駄なゲート発火を防ぐ。
+
+### 動作
+
+1. file path を SHA-256 12文字 hash 化
+2. `.claude/.gateguard-state/edit-<hash>.cleared` と `write-<hash>.cleared` を `touch`
+3. 次回の Edit/Write は通過
+
+### 例
+
+```bash
+# サブエージェントから「auth.ts は影響範囲調査済み（importers 12 ファイル、API 不変）」と報告を受けた
+/gate-bypass src/lib/auth.ts
+# → cleared: edit-a1b2c3d4e5f6.cleared
+# → cleared: write-a1b2c3d4e5f6.cleared
+```
+
+## F3 Confidence Gate bypass
+
+サブエージェントの完了サマリから confidence が抽出できなかった / 閾値未満だが、メイン側で
+別ルートの確証がある場合に使う **1 回限り** の通過 marker。
+
+### 動作
+
+1. `.claude/.confidence-gate-state/bypass.cleared` を作成（reason を本文に記入）
+2. **次回 1 回** だけ confidence-gate.sh が PASS を返す
+3. その際 `bypass.log` に `<ISO 時刻>\tbypassed: <reason>` を 1 行追記
+4. marker は自動削除（**re-armed** — 2 回目以降は通常判定）
+
+### 実体（cli から手動実行する場合）
+
+```bash
+mkdir -p .claude/.confidence-gate-state
+printf '%s' "user 確認済み: docs only 修正" > .claude/.confidence-gate-state/bypass.cleared
+```
+
+### 例
+
+```bash
+/gate-bypass confidence "user 確認済み: docs only 修正で confidence 計測対象外"
+# → .claude/.confidence-gate-state/bypass.cleared 作成
+# → 次回 SubagentStop で 1 回 PASS し、bypass.log に記録
+```
+
+bypass の理由は `/harness-audit` で集計されるため、後から監査可能。
+
+## 注意
+
+- **honor system**: 事実調査を実際にせずに bypass するとゲートの意義を失う
+- bypass の根拠は CLAUDE.md / docs/tasks/ の該当エントリに記録するのが望ましい
+- F1: セキュリティ機微ファイルや migration には使わない
+- F3: 連続 bypass は `/harness-audit` で可視化される（隠せない）
+
+## 関連
+
+- `/gate-status` — 何が cleared か確認
+- `/gate-clear` — F1 取り消し
+- `/harness-audit` — F3 bypass 集計（bypass.log 行数 + 直近 5 件 reason）
+- skill: `.claude/skills/gateguard/SKILL.md`
+- docs: [`docs/CONFIDENCE-GATE.md`](../../docs/CONFIDENCE-GATE.md)

package/.claude/commands/gate-clear.md

@@ -0,0 +1,45 @@
+---
+description: Reset GateGuard cleared state — for a specific file, or all entries.
+---
+
+# /gate-clear
+
+GateGuard の cleared state をリセットする。リセット後は次回 Edit/Write/Bash で再ゲート発火。
+
+## 使い方
+
+```
+/gate-clear              # 対話で対象選択
+/gate-clear all          # 全 state 消去
+/gate-clear <file>       # 特定ファイルの cleared を消去
+/gate-clear --bash <cmd> # 特定 bash コマンドの cleared を消去
+```
+
+## 動作
+
+1. `.claude/.gateguard-state/` の対象 marker を `rm`
+2. リセット件数を報告
+
+## 例
+
+```bash
+# 全リセット
+/gate-clear all
+# → Removed 6 cleared markers.
+
+# 特定ファイルだけ
+/gate-clear src/lib/auth.ts
+# → file hash a1b2c3d4e5f6
+# → Removed: edit-a1b2c3d4e5f6.cleared
+```
+
+## いつ使うか
+
+- 大規模リファクタの前に「全ファイル再ゲート」したい
+- セッションをまたいで前のセッションの state を引きずりたくない
+- gate を回避したつもりが実は古い state で通っていた、と気付いたとき
+
+## 関連
+
+- `/gate-status`
+- `/gate-bypass`

package/.claude/commands/gate-status.md

@@ -0,0 +1,46 @@
+---
+description: Show GateGuard cleared/pending state for the current session.
+---
+
+# /gate-status
+
+GateGuard が cleared した（事実調査済みとマークした）ファイル/コマンドを一覧表示する。
+
+## 使い方
+
+```
+/gate-status
+```
+
+## 動作
+
+1. `.claude/.gateguard-state/` を ls
+2. 各 cleared エントリを type（edit/write/bash）と hash で表示
+3. 必要なら hash → 元 path のリバース検索（recent observations から）
+
+## 出力例
+
+```
+=== GateGuard State ===
+state dir: .claude/.gateguard-state/
+
+Edit cleared (3):
+  edit-a1b2c3d4e5f6.cleared    src/lib/auth.ts
+  edit-1f2e3d4c5b6a.cleared    src/components/Hero.tsx
+  edit-fedcba987654.cleared    .claude/rules/self-improvement.md
+
+Write cleared (1):
+  write-aabbccddeeff.cleared   src/lib/new-helper.ts
+
+Bash cleared (2):
+  bash-112233445566.cleared    rm -rf node_modules
+  bash-778899aabbcc.cleared    git reset --hard origin/main
+
+Bypass: ECC_GATEGUARD = (unset → active)
+```
+
+## 関連
+
+- `/gate-clear [file|all]` — リセット
+- `/gate-bypass <file>` — pre-clear
+- skill: `.claude/skills/gateguard/SKILL.md`

package/.claude/commands/harness-audit.md

@@ -0,0 +1,151 @@
+---
+description: ハーネス自身の健全性を実測値で出力（observations / GateGuard / TaskGuard / failure-window から完成率・リトライ率・ブロック頻度・active loop を集計）
+---
+
+# /harness-audit
+
+`./claude-code-harness` の健全性レポートを実測値で出力する。「+2.25/10」のような外部引用値を**自リポ実測値**に置き換えるための入口。
+
+## 何を出すか
+
+- **観察ログ**（`~/.claude/homunculus/projects/<hash>/observations.jsonl`）から:
+  - 直近 N 件の tool 呼び出し総数 / エラー率 / timeout 検出
+  - tool 別 retry 率（top 10）
+- **GateGuard state**（`.claude/.gateguard-state/`）:
+  - cleared 件数を edit / write / bash に分類
+- **TaskGuard bypass**（`.claude/.taskguard-state/`）:
+  - slug 別 bypass 件数（記録漏れチェック）
+- **Failure-loop window**（`.claude/.failure-window/`）:
+  - session 別の連続失敗件数 / **active loop** 検出
+- **Health バッジ**: 🟢 / 🟡 / 🔴
+
+## 実行
+
+```bash
+python3 .claude/scripts/harness-audit.py
+```
+
+オプション:
+
+- `--json` — JSON 出力（CI / 後段処理向け）
+- `--window=N` — 観察ログの集計件数（default 100）
+- `--compare PATH` — 他リポの `.claude/` と structural diff を取る（task-25 B3、複数指定可）
+- `--compare-format {summary,detail,json}` — `--compare` の出力 format（default: `summary`）
+- `--compare-include {hooks,rules,skills,commands,templates,settings,all}` — 比較対象 category 絞り込み（default: `all`、複数指定可）
+- `--compare-source PATH` — `--compare` の source root（default: cwd）
+
+## クロスリポ drift 検出 (`--compare`, task-25 B3)
+
+複数リポ (hirai-method / recall_poc / classlab-weekly-news 等) で `.claude/` ハーネスが drift していないかを構造的に検出する。
+
+### 比較指標
+
+- **file presence diff**: 一方にあって他方にない file 一覧 (path 単位)
+- **content diff**: 両方にある file の sha256 hash 比較、不一致なら「drift あり」mark + size delta / mtime delta 付き
+- **clean**: 両方に存在 + hash 一致の file 一覧
+
+### 無視 path (runtime-only)
+
+`.claude/.workflow-state/<slug>.json` / `.claude/.gateguard-state/*.cleared` / `.claude/.taskguard-state/*` / `.claude/.failure-window/*` / `.claude/.confidence-gate-state/*` / `.claude/.session-help-shown` / `.claude/.compaction-state/` / `.claude/logs/` / `.DS_Store` は default で除外。ただし `SCHEMA.md` / `bypass.log.template` / `.gitignore` は track 対象として比較される。
+
+### 実行例
+
+```bash
+# 単一リポ比較
+python3 .claude/scripts/harness-audit.py --compare /Users/t.hirai/recall_poc
+
+# 複数リポを並列比較
+python3 .claude/scripts/harness-audit.py \
+    --compare /Users/t.hirai/recall_poc \
+    --compare /Users/t.hirai/classlab-weekly-news
+
+# 全 file path を列挙 (大規模 drift 用)
+python3 .claude/scripts/harness-audit.py --compare /path/to/other-repo --compare-format detail
+
+# hooks/rules のみ比較
+python3 .claude/scripts/harness-audit.py --compare /path/to/other-repo \
+    --compare-include hooks --compare-include rules
+
+# CI / 後段処理向け JSON
+python3 .claude/scripts/harness-audit.py --compare /path/to/other-repo --compare-format json
+```
+
+### 出力例 (summary mode)
+
+```
+[harness-audit --compare]
+Source: /Users/t.hirai/work/hirai-method/.claude (X files, Y KB)
+Target: /Users/t.hirai/recall_poc/.claude (Z files, W KB)
+Includes: all
+
+## Missing in target (source only): N files
+  - .claude/hooks/draft-flow-guard.sh
+  - .claude/evals/system-reminder-attention.md
+  ...
+
+## Missing in source (target only): M files
+  - .claude/<recall_poc specific>
+
+## Content drift (same path, different hash): K files
+  - .claude/rules/task-management.md (source: X B / target: Y B / size delta: +10B / mtime delta: 3d)
+  ...
+
+## Summary
+  - install.sh --update sync 推奨 file 数: N (missing in target が新規追加対象)
+  - 真の drift (両 repo で独立進化): K (要 manual review)
+  - clean: P files (両 repo identical)
+```
+
+### 終了コード
+
+- `0` — 比較成功 (drift 件数に関わらず)
+- `2` — `--compare` 引数 path 不在 / source `.claude/` 不在 / argparse error
+
+## メインエージェントの動作
+
+1. `python3 .claude/scripts/harness-audit.py` を実行（whitelist 許可済 prefix）
+2. 標準出力をそのままユーザーに返す
+3. **active failure loop** が検出された場合は、続けて `/agent-introspect` の起動を提案
+4. **TaskGuard bypass** が 0 でない場合は、bypass 根拠が `CLAUDE.md` / `docs/tasks/` に記録されているか確認するよう促す
+
+## 出力例
+
+```
+# Harness Audit Report
+_generated: 2026-05-04T16:30:00_
+
+## 観察ログ (observations.jsonl)
+- source: `~/.claude/homunculus/projects/abc123/observations.jsonl`
+- window: 直近 100 件
+- total events: 87
+- errors: 12（error rate 13.8%）
+- timeouts: 2
+
+### tool 別 (top 10)
+  - `Bash`: 42 calls / 5 errors (12%)
+  - `Edit`: 18 calls / 3 errors (17%)
+  - `Read`: 27 calls / 4 errors (15%)
+
+## GateGuard state (F1)
+- cleared: 7 files
+  - edit: 4 / write: 2 / bash: 1
+
+## TaskGuard bypass (タスク管理)
+- cleared: 0 files
+
+## Failure-loop window (W2.1)
+- active loops: 0
+
+## Health
+- 🟡 moderate error rate
+```
+
+## Bypass / 注意
+
+- 観察ログは `~/.claude/homunculus/projects/<hash>/` 配下。`git remote` 未設定の場合は global fallback を読む。
+- スクリプトは標準ライブラリのみ（外部依存なし）。
+- 集計は read-only。state を改変しない。
+- 実測値が「+2.25/10」より高いか低いかを記録するには、`--json` を `tee` して時系列保存することを推奨:
+  ```
+  python3 .claude/scripts/harness-audit.py --json > ~/.claude/audit-history/$(date +%Y-%m-%d).json
+  ```

package/.claude/commands/hearing.md

@@ -0,0 +1,138 @@
+---
+name: hearing
+description: "ヒアリングシート作成 - MTGメモ・議事録からhearing.mdを自動生成"
+category: workflow
+complexity: enhanced
+model: opus
+mcp-servers: [asana]
+---
+
+# /hearing - ヒアリングシート生成
+
+## 概要
+
+MTGのメモや議事録を元に、`/requirement` の入力素材となるヒアリングシート（hearing.md）を生成するコマンド。
+ヒアリング漏れがないかチェックリストに照らし合わせて確認し、不足項目を明示する。
+
+## 位置付け
+
+```
+/hearing（MTGメモ → hearing.md生成）
+    ↓
+/requirement（hearing.md → 正式な要件定義書生成）
+```
+
+## 使用方法
+
+```
+/hearing [AsanaタスクURL]
+```
+
+エンジニアがMTGメモ・議事録テキストを貼り付けて実行する。
+
+## 実行フロー
+
+### H-1: 入力受付
+
+1. AsanaタスクURLが指定された場合、タスク名を取得して出力フォルダ名に使用
+2. エンジニアにMTGメモ・議事録テキストの貼り付けを依頼
+
+### H-2: テンプレート照合・情報抽出
+
+MTGメモの内容を `.ai/templates/hearing.template.md` のチェックリストに照合し、以下を実行:
+
+1. MTGメモから各項目に該当する情報を抽出・整理
+2. **プロジェクト概要（5W2H）の抽出を最優先で実施**
+   - Why（目的 + なぜ実行者がやるか）、Goal（ゴールの状態）、When（期限）、What（準備物・成果物）、How many（数量・人数）は必須
+   - Where（場所）、Who（関係者）、Whom（対象者）、Which（優先順位）、How（やり方）は推奨項目として抽出
+3. **途中確認チェックポイントの設定**
+   - 確認者・確認方法を抽出
+   - 50%チェックポイント = 要件定義・設計レビュー完了後、構築フェーズの50%時点（固定定義）
+4. 抽出した情報をテンプレートの各セクションに配置
+5. **不足項目の検出**: テンプレートの項目でMTGメモに情報がない項目を特定
+
+### H-3: hearing.md 生成
+
+1. `doc_draft/requirement/[依頼名]/` フォルダを作成（既存の場合はそのまま使用）
+2. `hearing.md` を生成
+
+### H-4: 不足項目の提示・補足
+
+1. 不足している項目を一覧で提示
+2. エンジニアに追加情報の入力を促す
+3. 入力があれば hearing.md を更新
+4. エンジニアが「OK」と判断するまで繰り返す
+
+## 出力物
+
+```
+doc_draft/requirement/
+└── [依頼名]/
+    └── hearing.md
+```
+
+## ヒアリングチェックリスト
+
+hearing.md生成時に以下の項目が網羅されているかを確認する。
+不足項目は `<!-- ⚠️ 未確認 -->` コメントを付与してエンジニアに提示する。
+
+### 必須項目
+
+| カテゴリ         | 確認項目                                     | 必須度 |
+| ---------------- | -------------------------------------------- | ------ |
+| 5W2H - Why       | その業務の目的は何か                          | 必須   |
+| 5W2H - Why       | なぜ実行者がやるのか                          | 必須   |
+| 5W2H - Goal      | ゴールの状態は何か                            | 必須   |
+| 5W2H - When      | いつまでに                                    | 必須   |
+| 5W2H - What      | 準備物・成果物は何か                          | 必須   |
+| 5W2H - How many  | 数量・人数はいくつか                          | 必須   |
+| 5W2H - Where     | どこで行うか・必要なものはどこにあるか        | 推奨   |
+| 5W2H - Who       | 誰が関わるか（参加者・関係者）                | 推奨   |
+| 5W2H - Whom      | 誰に対して行うか                              | 推奨   |
+| 5W2H - Which     | どれから着手するか（優先順位）                | 推奨   |
+| 5W2H - How       | どのように行うか                              | 推奨   |
+| チェックポイント  | 50%確認者・確認方法                           | 必須   |
+| 課題・背景       | 今何が困っているか                            | 必須   |
+| 課題・背景       | 今はどう対処しているか                        | 必須   |
+| 課題・背景       | なぜ今やる必要があるか                        | 推奨   |
+| 業務要件         | 誰が使うか（利用部署）                        | 必須   |
+| 業務要件         | 何をしたいか（機能概要）                      | 必須   |
+| 業務要件         | いつ動くか（発火条件）                        | 必須   |
+| 業務要件         | 何のデータを使うか（インプット）               | 必須   |
+| 業務要件         | どう変わるべきか（アウトプット）               | 必須   |
+| 業務要件         | 条件分岐（ビジネスルール）                    | 推奨   |
+| 業務要件         | エラー時の期待動作                            | 推奨   |
+| 制約・条件       | 変えてはいけないもの                          | 推奨   |
+| 制約・条件       | リリース時の注意                              | 推奨   |
+| 運用             | 実際の操作フロー                              | 推奨   |
+
+### 不足項目の表示形式
+
+```markdown
+## ⚠️ 未確認項目
+
+以下の項目がMTGメモから確認できませんでした。追加情報があれば入力してください。
+
+| # | カテゴリ        | 項目                              | 必須度 |
+|---|----------------|-----------------------------------|--------|
+| 1 | 5W2H - What     | 準備物・成果物は何か               | 必須   |
+| 2 | 5W2H - How many | 数量・人数はいくつか               | 必須   |
+| 3 | チェックポイント | 50%確認者                         | 必須   |
+| 4 | 業務要件        | 条件分岐（ビジネスルール）          | 推奨   |
+```
+
+## /requirement との連携
+
+`/requirement` 実行時に `doc_draft/requirement/[依頼名]/hearing.md` が存在する場合:
+
+1. hearing.md を自動的に読み込む
+2. hearing.md の情報を正式な要件定義書の各セクションにマッピング
+3. Asana/Slack/GitHub MCPからの自動取得情報と統合
+4. 正式な `requirement.md` を生成
+
+## 注意事項
+
+- hearing.md はあくまで「素材」であり、正式なドキュメントではない
+- `/requirement` が hearing.md を整形・補完して正式な要件定義書にする
+- MTGメモが箇条書きや口語体でも問題ない（AIが整形する）
+- 不足項目は `/requirement` 実行時にも再度確認される