claude-code-conductor 2.30.0__tar.gz → 2.31.1__tar.gz

{claude_code_conductor-2.30.0 → claude_code_conductor-2.31.1}/.claude/skills/dev-workflow/SKILL.md

@@ -19,60 +19,19 @@ user-invocable: false
 今日のセッションファイルに以下を追記する（未登録の場合のみ）:
 - `- [ ] ヒアリング` / `- [ ] 設計` / `- [ ] 計画`
 
-### A-1: 背景・きっかけ
+### A-1〜A-3: 動的ヒアリング（ルーブリック型）
 
-AskUserQuestion ツール:
-```json
-{
-  "questions": [{
-    "question": "背景・きっかけを教えてください（なぜ今これが必要ですか？）",
-    "options": [
-      { "label": "ユーザーからの要望", "description": "具体的な声があった" },
-      { "label": "ビジネス上の要件", "description": "事業的な理由がある" },
-      { "label": "技術的な負債解消", "description": "将来のために今直したい" },
-      { "label": "パフォーマンス問題", "description": "遅い・重いを解決したい" }
-    ]
-  }]
-}
-```
-
-### A-2: 制約・前提条件
-
-AskUserQuestion ツール:
-```json
-{
-  "questions": [{
-    "question": "制約や前提条件はありますか？（複数選択可）",
-    "options": [
-      { "label": "納期がある", "description": "期日を後で教えてください" },
-      { "label": "既存APIを壊せない", "description": "後方互換性が必要" },
-      { "label": "特定の技術スタックに限定", "description": "使える技術が決まっている" },
-      { "label": "特になし" }
-    ],
-    "multiSelect": true
-  }]
-}
-```
+**最初に必ず** `.claude/skills/dev-workflow/references/interview-rubric.md` を Read する（記憶・推測で進めない）。
+その指針に従い、床 5 観点（①背景・目的 ②スコープ境界 ③制約・前提 ④非機能要件 ⑤成功条件）を
+**動的にヒアリング**する。要点:
 
-制約を選んだ場合は補足情報（納期の日付など）を追加で確認する。
+- 質問文・選択肢はタスク固有に**その場で生成**する（固定テンプレの 4 択を使わない）。`Other`（自由記述）は常設。
+- 会話コンテキストと既存 `requirements-report` で**判明済みの観点は再質問しない**。
+- 1 回の `AskUserQuestion` = 1 問（CLAUDE.md「質問は 1 回に 1 つ」）。深掘りは設計を左右する不明点のみ 1 問。
+- **停止条件**: 床 5 観点が十分 / 質問総数 **上限 6 問** 到達 / ユーザーが「もう十分」。床充足なら即停止する。
+- requirements-report 生成前に **self-check**: 5 観点に確定内容があるか点検し、空欄は推測で埋めず「未確定事項」として明示する。
 
-### A-3: 非機能要件
-
-AskUserQuestion ツール:
-```json
-{
-  "questions": [{
-    "question": "特に重視したい品質特性はありますか？",
-    "options": [
-      { "label": "セキュリティ", "description": "認証・認可・データ保護を重視" },
-      { "label": "パフォーマンス", "description": "速度・スループットを重視" },
-      { "label": "保守性", "description": "読みやすさ・変更しやすさを重視" },
-      { "label": "特になし・バランスよく" }
-    ],
-    "multiSelect": true
-  }]
-}
-```
+詳細手順・予測可能性の担保根拠は `references/interview-rubric.md` を参照。
 
 ### A-4: requirements-report の生成と承認
 
@@ -111,25 +70,19 @@ AskUserQuestion ツール:
 今日のセッションファイルに以下を追記する（未登録の場合のみ）:
 - `- [ ] 設計` / `- [ ] 計画`
 
-### B-1: 技術スタックの確認
+### B-1〜B-2: 動的設計確認（ルーブリック型）
 
-AskUserQuestion ツール:
-```json
-{
-  "questions": [{
-    "question": "技術スタックについて制約はありますか？",
-    "options": [
-      { "label": "既存スタックに合わせる", "description": "使用中の言語・FWに統一する" },
-      { "label": "最適なものを選んでほしい", "description": "推薦に任せる" },
-      { "label": "指定がある", "description": "使う技術を具体的に伝えます" }
-    ]
-  }]
-}
-```
+**最初に必ず** `.claude/skills/dev-workflow/references/design-rubric.md` を Read する（記憶・推測で進めない）。
+その指針に従い、床 4 観点（①技術スタック制約 ②要件から導く設計判断ポイント ③非機能の実現方針 ④トレードオフ分岐）を
+**動的に確認**する。要点:
 
-### B-2: 設計と不明点の確認
+- 技術スタック制約を起点に、要件から設計判断ポイントを**その場で列挙**して確認する（固定テンプレの 3 択を使わない）。
+- 要件から自明に決まる設計判断（非機能の実現方針が要件から定まる場合を含む）は再質問しない。複数案があるものは比較の軸も併せて提示する。
+- 1 回の `AskUserQuestion` = 1 問。設計を左右する不明点のみ深掘り（控えめ）。
+- **停止条件**: 床 4 観点が十分 / 質問総数 **上限 4 問** 到達 / ユーザーが「もう十分」。床充足なら即停止する。
+- architecture-report 生成前に **self-check**: 4 観点に確定内容があるか点検し、空欄は推測で埋めず「未確定事項」として明示する。
 
-要件をもとに設計案を作成する。不明点があれば AskUserQuestion ツールで確認する。
+詳細手順は `references/design-rubric.md` を参照。
 
 ### B-3: architecture-report の生成と承認
 

claude_code_conductor-2.31.1/.claude/skills/dev-workflow/references/design-rubric.md

@@ -0,0 +1,63 @@
+# Design Rubric（設計・ルーブリック）
+
+`dev-workflow` フェーズ B（設計）で architect ペルソナが参照する**動的設計確認の指針**。
+`/start` で親 Claude が `.claude/agents/architect.md` のペルソナを採用した後、本ファイルを Read して
+**床観点をルーブリックに従って動的に確認する**。フェーズ B（旧 B-1 + B-2 を統合）専用。
+
+設計思想（ハイブリッド）: **確認する観点カテゴリ＝固定**（予測可能）／
+**質問文・選択肢・深掘り＝動的**（要件から導いてその場で生成する）。
+
+---
+
+## 床観点（必ず押さえる 4 観点）
+
+| # | 観点 | 確認したいこと |
+|---|---|---|
+| 1 | 技術スタック制約 | 既存スタックに合わせる / 最適なものを選ぶ / 指定がある |
+| 2 | 主要な設計判断ポイント | 要件から導く分岐（データ保存方式・連携方式・状態管理・モジュール境界 等） |
+| 3 | 非機能の実現方針 | requirements-report の非機能要件を設計でどう満たすか |
+| 4 | トレードオフ分岐 | 複数案があり採用判断が要る箇所（採用理由を記録する） |
+
+architect は interviewer と異なり**構造化（選択肢付き）**で確認する。
+設計判断は選択肢を明示した方がユーザーが選びやすく、トレードオフも提示しやすい。
+
+---
+
+## 動的確認のフロー
+
+### Step 1: 既知情報の取り込み
+
+`requirements-report`（コンテキスト内になければ Glob で最新を Read）と既存コード（Glob / Grep）を読み、
+床 4 観点を「判明 / 未判明」でマークする。要件から自明に決まる設計判断は再質問しない。
+ユーザーが設計関連の資料（PDF / 画像 / 既存ドキュメント等）を提示している場合は Read で読み込み、観点の判明マークに反映する（ユーザーに事前執筆は求めない）。
+
+### Step 2: 技術スタック制約を起点に動的確認
+
+1. まず観点 1（技術スタック制約）を確認する。
+2. 続いて、要件から**主要な設計判断ポイント（観点 2）を動的に列挙**し、判断が要るものを確認する。
+   - 質問文・選択肢は要件に即してその場で生成する（固定テンプレを使わない）。
+   - 複数案があるものは比較の軸（観点 4 のトレードオフ）も併せて提示する。
+3. 非機能の実現方針（観点 3）に未確定があれば確認する。
+
+- **1 回の `AskUserQuestion` = 1 問**（CLAUDE.md「質問は 1 回に 1 つ」）。
+- 設計を左右する不明点のみ、**1 観点につき 1 問まで**深掘りする（控えめ）。
+
+### Step 3: 停止条件（ガードレール）
+
+以下のいずれかで確認を終了し、B-3（architecture-report 生成）へ進む。
+
+- **床 4 観点すべてが設計判断に十分**になった（→ 床充足で即停止。残り質問枠があっても追加しない）。
+- 質問総数が **上限 4 問** に達した（残る未確定は report に「未確定事項」として明記）。
+- ユーザーが「もう十分」と表明した。
+
+### Step 4: self-check（architecture-report 生成前）
+
+report を Write する直前に、床 4 観点それぞれに確定内容があるか点検する。
+空欄は推測で埋めず、report に「**未確定事項**」として明示する（後段の planner が把握できる形で残す）。
+
+---
+
+## 予測可能性の担保
+
+**確認する観点カテゴリは固定**・**質問文と選択肢だけ動的**。
+ユーザーは設計フェーズでおおよそ何を問われるか予測しつつ、タスク固有の設計判断に踏み込める。

claude_code_conductor-2.31.1/.claude/skills/dev-workflow/references/interview-rubric.md

@@ -0,0 +1,79 @@
+# Interview Rubric（ヒアリング・ルーブリック）
+
+`dev-workflow` フェーズ A（ヒアリング）で interviewer ペルソナが参照する**動的ヒアリング指針**。
+`/start` で親 Claude が `.claude/agents/interviewer.md` のペルソナを採用した後、本ファイルを Read して
+**床観点をルーブリックに従って動的にヒアリングする**。フェーズ A 専用。
+
+設計思想（ハイブリッド）: **聞く観点カテゴリ＝固定**（ユーザーは何を聞かれるか予測できる）／
+**質問文・選択肢・深掘り＝動的**（タスク固有にその場で生成し、毎回同じ固定テンプレに縛られない）。
+
+---
+
+## 床観点（必ず埋める 5 観点）
+
+ヒアリング終了時、以下 5 観点それぞれに「設計判断に足る確定内容」があることを目指す。
+これは**最低限のカバレッジ床**であり、各観点の質問文・選択肢はタスクに合わせて動的に作る。
+
+| # | 観点 | 確認したいこと |
+|---|---|---|
+| 1 | 背景・目的 | なぜ今これが必要か。解決したい課題・きっかけ |
+| 2 | スコープ境界 | やること / やらないこと の線引き。今回の範囲外 |
+| 3 | 制約・前提 | 納期・後方互換・技術スタック・運用環境などの制約 |
+| 4 | 非機能要件 | 重視する品質特性（セキュリティ / パフォーマンス / 保守性 等） |
+| 5 | 成功条件 | 何をもって完成とするか。受け入れ基準・完了の定義 |
+
+> 観点 5（成功条件）は固定テンプレ時代に欠けていた観点。設計の手戻りを減らすため必ず確認する。
+
+---
+
+## 動的ヒアリングのループ
+
+### Step 1: 既知情報の取り込み
+
+ヒアリングを始める前に、**会話コンテキスト**と**既存 `requirements-report`**（あれば Glob で最新を Read）を読み、
+床 5 観点それぞれを「判明 / 未判明」でマークする。
+
+- **ユーザーが資料（PDF / 画像 / 既存の要件定義書・ドキュメント等）を提示している場合は Read で読み込み**、その内容からも観点を判明マークする（資料ドリブンの壁打ち。ユーザーに指示書の事前執筆は求めず、既に持っている資料を土台に未知だけを動的に掘る）。
+- **判明済みの観点は再質問しない**（ユーザーが既に話した内容を聞き返さない）。
+- 判明が部分的なら「未判明（部分）」とし、不足部分だけを後続で確認する。
+
+### Step 2: 未判明観点を 1 問ずつ動的生成
+
+未判明の観点について、**タスク固有の質問文と選択肢をその場で生成**して `AskUserQuestion` で確認する。
+
+- CLAUDE.md「質問は 1 回に 1 つ」に従い、**1 回の `AskUserQuestion` = 1 問**（`multiSelect` 可）。
+- 選択肢はタスク文脈に即して動的に作る。固定テンプレの 4 択をそのまま使わない。
+- `Other`（自由記述）は常に残し、ユーザーが選択肢外を答えられる余白を確保する（対話余白型）。
+- スタイルは軽量・自由記述寄り。ユーザーが話しやすいよう、選択肢で誘導しすぎない。
+
+### Step 3: 深掘り判定（控えめ）
+
+回答を受けたら「この観点は**設計判断に十分な解像度**か」を自己評価する。
+
+- 不足していて、かつ**設計を左右する不明点**である場合に限り、追加で **1 問だけ**深掘りする。
+- 「念のため」「より詳しく」程度の理由では深掘りしない（コスト増・予測可能性低下を避ける）。
+
+### Step 4: 停止条件（ガードレール）
+
+以下のいずれかを満たしたらヒアリングを終了し、A-4（report 生成）へ進む。
+
+- **床 5 観点すべてが「設計判断に十分」**になった（→ 床充足で即停止。残り質問枠があっても追加しない）。
+- 質問総数が **上限 6 問** に達した（残る未判明観点は report に「未確定事項」として明記する）。
+- ユーザーが「もう十分」「これで進めて」と表明した（→ 即停止）。
+
+### Step 5: self-check（requirements-report 生成前）
+
+report を Write する直前に、床 5 観点それぞれに 1 行以上の確定内容があるか点検する。
+
+- 空欄の観点は**黙って推測で埋めない**。report に「**未確定事項**」セクションを設けて明示する。
+- 「未確定」と分かる形で残すことで、後段の architect / planner が補完すべき箇所を把握できる。
+
+---
+
+## 予測可能性の担保（この設計の肝）
+
+- **何を聞かれるか（観点カテゴリ）は固定** → ユーザーは毎回おおよそ同じ範囲を問われると予測できる。
+- **どう聞かれるか（質問文・選択肢・深掘り）だけが動的** → タスク固有の精度が上がる。
+
+この「カテゴリ固定 × 文面動的」が固定テンプレと完全自由の中間（ハイブリッド）であり、
+予測可能性を保ちながら観点漏れと画一的な質問の両方を避ける狙い。

{claude_code_conductor-2.30.0 → claude_code_conductor-2.31.1}/CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog
 
+## [2.31.1] - 2026-06-06
+
+**ドキュメント PATCH（コード変更・破壊的変更・migration なし）**: v2.31.0 で導入した動的ヒアリング/設計ルーブリックの Step 1（既知情報の取り込み）に、**資料ドリブンの壁打ち**を明文化した。ユーザーが提示した資料（PDF / 画像 / 既存の要件定義書・ドキュメント等）を Read で読み込み、床観点の判明マークに反映する。ユーザーに指示書の事前執筆を求めず、既に持っている資料を土台に未知だけを動的に掘る方針。
+
+### ドキュメント
+
+- `.claude/skills/dev-workflow/references/interview-rubric.md` / `design-rubric.md` の Step 1 に「ユーザー提示資料があれば Read で読み込み観点を判明マーク（事前執筆は求めない）」を 1 行ずつ追記。
+
+### 後方互換
+
+- reference ファイル本文への追記のみ。`SKILL.md`・公開 API・CLI・DB スキーマ・hook に変更なし。資料は元々会話コンテキストとして読めるため挙動の実体変化はなく、rubric の指示を明示化しただけ。**破壊的変更なし**・migration 不要。
+
+## [2.31.0] - 2026-06-06
+
+**標準ワークフローのヒアリング/設計フェーズを動的化（機能改善・破壊的変更なし）**: `dev-workflow` のフェーズ A（interviewer）と フェーズ B（architect）の固定 `AskUserQuestion` テンプレ（毎回同じ4択・3択）を、ルーブリック型ハイブリッドの動的生成に置き換えた。「聞く観点カテゴリ＝固定（予測可能）／質問文・選択肢・深掘り＝動的（タスク固有）」を両立させ、固定テンプレでは拾えなかった観点（特に成功条件／受け入れ基準）を掘れるようにする。
+
+### 追加
+
+- **`.claude/skills/dev-workflow/references/interview-rubric.md`（新規）**: フェーズ A の動的ヒアリング指針。床5観点（背景・目的／スコープ境界／制約・前提／非機能要件／成功条件）を固定の「カバレッジ床」として持ち、質問文・選択肢はタスク固有に動的生成する。会話・既存 requirements-report で判明済みの観点は再質問しない。ガードレール（上限6問・床充足で即停止・深掘りは設計を左右する不明点のみ1問）と report 生成前の self-check（空欄は推測で埋めず「未確定事項」として明示）を規定。対話余白型（自由記述寄り・`Other` 常設）。
+- **`.claude/skills/dev-workflow/references/design-rubric.md`（新規）**: フェーズ B の動的設計確認指針。床4観点（技術スタック制約／要件から導く設計判断ポイント／非機能の実現方針／トレードオフ分岐）。技術スタック制約を起点に設計判断ポイントを動的に列挙する構造化型。上限4問・床充足で即停止・self-check 付き。
+
+### 変更
+
+- **`dev-workflow/SKILL.md` フェーズ A**: 固定テンプレ A-1/A-2/A-3（背景・制約・非機能の3つの固定 `AskUserQuestion`）を `interview-rubric.md` 参照の動的ヒアリング手順に置換。
+- **`dev-workflow/SKILL.md` フェーズ B**: 固定3択の B-1（技術スタック確認）を `design-rubric.md` 参照の動的確認に置換し、既に動的だった B-2 と統合。
+- A-4 / B-3（requirements-report・architecture-report の生成と承認）、承認フロー、セッションファイルの `[x]` 化タイミング、知識蓄積セクションは**無改変**。
+
+### 後方互換
+
+- 変更は `.claude/skills/dev-workflow/` 配下（SKILL.md と新規 references 2件）のみ。公開 API・CLI・DB スキーマ・他フェーズ（C/D/E）・hook に変更なし。`AskUserQuestion` を使う対話フロー自体は維持され、利用者から見た承認フローは不変。**破壊的変更なし**・migration 不要。
+
 ## [2.30.0] - 2026-06-02
 
 **新プラットフォーム adapter（機能追加・破壊的変更なし）**: `c3 init --platform opencode` で [OpenCode](https://opencode.ai) 向けの adapter を生成できるようになった。`.claude/` を canonical source としたまま、`AGENTS.md`（C3 専用 managed block）と `.opencode/agents/c3-*.md` / `.opencode/agents/c3-skill-*.md` を派生生成する。外部コントリビューター（PR #3 / @ma2tak）の実装に、C3 側でテスト・ドキュメント整備を追加してリリースする。

{claude_code_conductor-2.30.0 → claude_code_conductor-2.31.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-code-conductor
-Version: 2.30.0
+Version: 2.31.1
 Summary: Multi-agent orchestration framework for Claude Code with Codex/Cursor adapters (C3)
 Project-URL: Homepage, https://github.com/satoh-y-0323/claude-code-conductor
 Project-URL: Repository, https://github.com/satoh-y-0323/claude-code-conductor

{claude_code_conductor-2.30.0 → claude_code_conductor-2.31.1}/src/c3/__init__.py

@@ -1,3 +1,3 @@
 """Claude Code Conductor (C3) - multi-agent orchestration framework for Claude Code."""
 
-__version__ = "2.30.0"
+__version__ = "2.31.1"