claude-code-conductor 2.37.0__tar.gz → 2.38.0__tar.gz

{claude_code_conductor-2.37.0 → claude_code_conductor-2.38.0}/.claude/skills/init-session/SKILL.md

@@ -13,6 +13,49 @@ description: セッション開始時に前回の作業状態・残タスク・
 
 ---
 
+## 最優先: 初回セットアップガードと実行マーカー（Step 1 より前に必ず実行）
+
+### G-1: init-session 実行マーカーを書く（ループガード）
+
+`/start` からの再帰呼び出しを防ぐため、**最初に**現在のセッション ID を実行マーカーへ記録する:
+
+```bash
+mkdir -p .claude/state
+printf '%s' "$CLAUDE_CODE_SESSION_ID" > .claude/state/init_session.flag
+```
+
+### G-2: setup 未実行なら /setup を自動実行
+
+プロジェクトのコーディング規約が未設定なら、`/setup` を先に実行する。Bash で判定:
+
+```bash
+if [ -f .claude/rules/coding-standards.md ] || [ -f .claude/state/setup_done.flag ]; then
+  echo "SETUP_DONE"
+else
+  echo "SETUP_NEEDED"
+fi
+```
+
+> 順序について: setup ガード（G-2）は Step 1（前回セッション復元）より前に置く。`SETUP_NEEDED` となるのは規約未設定＝実質的に初回導入のケースであり、その場合 Step 1 で復元すべき前回セッションは通常存在しない（復元はほぼ no-op）ため、setup を先行させてもコンテキストへの実害はない。
+
+- **`SETUP_DONE`** → そのまま Step 1 へ進む。
+- **`SETUP_NEEDED`** → Skill ツールで `setup` を自動的に呼ぶ。ここでの「自動」は**ユーザーが `/setup` を打つ必要なく連鎖起動される**という意味で、`setup` 自体は言語・規約のヒアリング（AskUserQuestion 群）を行うため**ユーザー応答は必要**（規約設定をスキップ・無人実行する意味ではない）。`setup` 完了後（`coding-standards.md` と `setup_done.flag` が生成される）に Step 1 へ進む。
+  - ユーザーが `setup` のヒアリングを中断した場合、`coding-standards.md`・`setup_done.flag` のいずれも未生成なら次回の `/init-session`・`/start` で再度 `setup` が起動される（再試行可能）。
+
+### G-3: from-start 引数の扱い
+
+本スキルが **`from-start` 引数付き**で呼ばれた場合（`/start` のセッション初期化ガード経由）は、本ガード（G-1/G-2）と Step 1〜3（前回状態の復元・サマリ表示）まで実行したら、**以下の対話プロンプトを全てスキップ**して本スキルを終了する（Skill 実行が完了すれば呼び出し元の `/start` が Step 0 以降を続行する）:
+
+- Step 3 のサマリ提示後の「完了している可能性のあるタスク」確認 AskUserQuestion（Step 1.5 由来）
+- Step 4（作業の開始方法を選ぶ）
+- Step 5（選択に応じて分岐する）
+
+引数が無い通常起動では従来どおり上記を全て実行する。
+
+> from-start ではユーザーは既に `/start` を選んでおり、開始方法・陳腐化タスクの確認で二重に問われると煩雑なため、復元サマリの提示のみに留める（陳腐化タスクの `[x]` 化が必要なら次回の通常 `/init-session` 起動時に確認される）。
+
+---
+
 ## Step 1: 前回セッションを読み込む
 
 Glob で `.claude/memory/sessions/*.tmp` を検索し、ファイル名（YYYYMMDD）が最大のものを Read する。
@@ -36,7 +79,7 @@ Glob で `.claude/memory/sessions/*.tmp` を検索し、ファイル名（YYYYMM
    ```
 3. 各 `- [ ]` 行に含まれる識別キーワード（機能名 / `Phase X` / 「Zenn」「リリース」などの名詞）が、いずれかのコミットメッセージに含まれているかをキーワード照合する
 4. 該当があれば「**完了している可能性のあるタスク**」として Step 3 のサマリに加える（コミットハッシュも併記する）
-5. **自動で `[x]` 化はしない**。Step 4 のあとで AskUserQuestion を提示し、ユーザー承認した項目のみ Edit で `[x]` 化する
+5. **自動で `[x]` 化はしない**。Step 3 のサマリ提示後（Step 4 の前）に AskUserQuestion を提示し、ユーザー承認した項目のみ Edit で `[x]` 化する（**`from-start` 起動時はこの確認もスキップする**。G-3 参照）
 6. 該当なし、または前回セッションが当日の場合はこの Step をスキップする
 
 > 目的: 「memory-consolidation Phase 2 → v1.3.0 完了」のように、リリースで完了したのに `[ ]` のまま残った引き継ぎタスクを次セッション開始時に検出する。
@@ -77,7 +120,7 @@ Glob で `.claude/memory/sessions/*.tmp` を検索し、ファイル名（YYYYMM
 {promotion_candidate: true のパターン一覧。なければ「なし」}
 ```
 
-Step 1.5 で「完了している可能性のあるタスク」が検出された場合は、Step 4 の前に以下の AskUserQuestion を提示する:
+Step 1.5 で「完了している可能性のあるタスク」が検出された場合は、Step 4 の前に以下の AskUserQuestion を提示する（**`from-start` 起動時はスキップ**・G-3 参照）:
 
 ```json
 {
@@ -98,6 +141,8 @@ Step 1.5 で「完了している可能性のあるタスク」が検出され
 
 ## Step 4: 作業の開始方法を選ぶ
 
+> **`from-start` 引数付きで呼ばれた場合はこの Step 4 と Step 5 をスキップし、復元サマリを出したら `/start` に制御を返す**（最優先ガード G-3 参照）。以下は通常起動（引数なし）のみ実行する。
+
 AskUserQuestion ツールで以下を提示する:
 
 ```json

{claude_code_conductor-2.37.0 → claude_code_conductor-2.38.0}/.claude/skills/setup/SKILL.md

@@ -211,6 +211,16 @@ agent は本 skill 配下の `templates/` と `reference.md` を Read して、`
 
 ## Phase 4: 完了報告
 
+project-setup エージェントが 2 ファイルを生成したら、Bash で setup 実行済みマーカーを記録する
+（`/init-session` の setup ガードが再発火しないようにするため。`state/*` は gitignore＋配布除外済み）。
+このフラグは**存在自体がマーカー**であり中身は不要（空ファイルで可）:
+
+```bash
+mkdir -p .claude/state && : > .claude/state/setup_done.flag
+```
+
+その後、以下を報告する:
+
 ```
 セットアップ完了:
   .claude/rules/coding-standards.md    — 標準コーディング規約

{claude_code_conductor-2.37.0 → claude_code_conductor-2.38.0}/.claude/skills/start/SKILL.md

@@ -4,7 +4,7 @@ description: 開発ワークフローの入口。開始地点（標準ワーク
 
 # start
 
-開発ワークフローの入口。フロー順序: **Step 0（レポート整理）→ Step 1（開始地点選択）→ Step 2（フェーズ遷移）**。
+開発ワークフローの入口。フロー順序: **セッション初期化ガード（最優先）→ Step 0（レポート整理）→ Step 1（開始地点選択）→ Step 2（フェーズ遷移）**。
 
 ワークフローは 2 つだけ:
 
@@ -15,6 +15,30 @@ description: 開発ワークフローの入口。開始地点（標準ワーク
 
 ---
 
+## 最優先: セッション初期化ガード（Step 0 より前に必ず実行）
+
+本体（Step 0 以降）に入る前に、**当該セッションで `/init-session` が実行済みかを判定し、未実行なら自動実行する**。
+Bash で判定する:
+
+```bash
+flag=".claude/state/init_session.flag"
+saved="$(tr -d '\r\n' < "$flag" 2>/dev/null)"
+if [ -n "$CLAUDE_CODE_SESSION_ID" ] && [ "$saved" = "$CLAUDE_CODE_SESSION_ID" ]; then
+  echo "INIT_DONE"
+else
+  echo "INIT_NEEDED"
+fi
+```
+
+- **`INIT_DONE`**（フラグの中身が現在の `CLAUDE_CODE_SESSION_ID` と一致）→ 既に初期化済み。そのまま Step 0 へ進む。
+- **`INIT_NEEDED`**（不一致 / フラグ不在 / `CLAUDE_CODE_SESSION_ID` が空）→ Skill ツールで `init-session` を **`from-start` 引数付き**で呼ぶ。
+  - `init-session` が（必要なら `/setup` を連鎖実行し）前回状態を復元し、`init_session.flag` を書く。`from-start` 付きのため `init-session` 側は開始方法の選択（Step 4）や陳腐化タスク確認などの対話プロンプトをスキップして復元サマリのみ提示する。
+  - `init-session` の Skill 実行が完了したら本スキルに戻り、続けて Step 0（レポート整理）以降を実行する。
+
+> **ループ回避**: `init-session` は本体開始直後に `init_session.flag` を現セッション ID で書く。そのため `init-session`（Step 5「ワークフローで始める」）が `/start` を呼び戻しても、本ガードは `INIT_DONE` と判定し再帰呼び出ししない。
+
+---
+
 ## Step 0: レポートの整理
 
 Glob で `.claude/reports/*.md` を検索する（`archive/` 配下は含まない）。

{claude_code_conductor-2.37.0 → claude_code_conductor-2.38.0}/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## [2.38.0] - 2026-06-16
+
+### 追加
+
+- **オンボーディング動線の自走化（`/start` → `/init-session` → `/setup` の自動チェーン）**: C3 初導入プロジェクトで「最初に `/start` を打ち、規約未設定（`/setup` 未実行）のまま開発が始まる」事故を防ぐ。`/start` 実行時に当該セッションで `/init-session` が未実行なら自動で先行実行し、`/init-session` 実行時にプロジェクト規約が未設定なら `/setup` を自動で連鎖実行する。最初に打つコマンドが `/start` でも `/init-session` でも正しい順序に揃う。「自動」はコマンドを覚えていなくても連鎖起動される意味で、`/setup` 自体のヒアリング応答は引き続き必要（規約設定を無人スキップするわけではない）。
+
+### 仕組み
+
+- **setup 実行済み判定** = `.claude/rules/coding-standards.md` の存在（setup の生成物・利用先で git 追跡され永続）**または** `.claude/state/setup_done.flag` の存在。`/setup` は Phase 4 でこのフラグを書く。
+- **init-session 実行済み判定（セッション単位）** = `.claude/state/init_session.flag` の中身が現在の `CLAUDE_CODE_SESSION_ID` と一致するか。`/init-session` は本体開始直後にこのフラグを書く。
+- **ループ回避**: `/init-session`（Step 5「ワークフローで始める」）が `/start` を呼び戻しても、`/start` のガードは init_session.flag の一致を見て `/init-session` を再実行しない。`/start` から呼ばれた `/init-session` は `from-start` 引数で Step 4（開始方法選択）・Step 5・Step 1.5 由来の陳腐化タスク確認プロンプトをスキップし、復元サマリのみ提示して `/start` に戻る。
+- マーカーは `.claude/state/`（gitignore＋配布除外済み）に置くため 3 ファイル同期は不要。配布元リポジトリには誤発火防止用の `setup_done.flag` を 1 つ配置（コミット・配布されない）。
+
+### 後方互換
+
+- 既存の手動順序（`/init-session` → `/setup` → `/start`）は引き続き有効。公開 API・CLI・DB スキーマに変更なし。**破壊的変更なし**。
+
 ## [2.37.0] - 2026-06-16
 
 ### 変更

{claude_code_conductor-2.37.0 → claude_code_conductor-2.38.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-code-conductor
-Version: 2.37.0
+Version: 2.38.0
 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
@@ -214,6 +214,10 @@ C3 のスラッシュコマンドはすべてスキル（`skills/{name}/SKILL.md
 
 `/start` 実行後は、各フェーズの承認を進めるだけで最後まで自動的に流れます。
 
+> **動線は C3 が自動で補完します（v2.38.0〜）:** 上の 3 段階の順序を覚えていなくても構いません。`/start` を実行すれば、当該セッションで `/init-session` が未実行なら自動的に先行実行し、さらにプロジェクト規約が未設定（初回）なら `/setup` を自動的に連鎖実行してから開発に入ります。`/init-session` 単体実行でも、規約未設定なら `/setup` を自動実行します。初回導入でも継続作業でも、最初に打つコマンドが `/start` でも `/init-session` でも正しい順序に揃います。
+>
+> なお「自動」はコマンドを覚えていなくても**連鎖起動される**という意味で、`/setup` 自体は使用言語・規約のヒアリング（数問）を行うため、初回はそれに回答する必要があります（規約設定を無人でスキップするわけではありません）。
+
 > **公式コマンドとの名前衝突について:** C3 のスキル名は Claude Code 公式コマンドと重複しないよう設計しています。`/review-phase`（≠ 公式 `/code-review` / `/review`）、`/mcp-config`（≠ 公式 `/mcp`）はこの方針に基づく命名です。公式コマンドが追加された場合は衝突回避のために本フレームワークの skill 名を変更することがあります（v2.15.1 で `/code-review` → `/review-phase` に変更しました）。
 
 ---

{claude_code_conductor-2.37.0 → claude_code_conductor-2.38.0}/README.md

@@ -167,6 +167,10 @@ C3 のスラッシュコマンドはすべてスキル（`skills/{name}/SKILL.md
 
 `/start` 実行後は、各フェーズの承認を進めるだけで最後まで自動的に流れます。
 
+> **動線は C3 が自動で補完します（v2.38.0〜）:** 上の 3 段階の順序を覚えていなくても構いません。`/start` を実行すれば、当該セッションで `/init-session` が未実行なら自動的に先行実行し、さらにプロジェクト規約が未設定（初回）なら `/setup` を自動的に連鎖実行してから開発に入ります。`/init-session` 単体実行でも、規約未設定なら `/setup` を自動実行します。初回導入でも継続作業でも、最初に打つコマンドが `/start` でも `/init-session` でも正しい順序に揃います。
+>
+> なお「自動」はコマンドを覚えていなくても**連鎖起動される**という意味で、`/setup` 自体は使用言語・規約のヒアリング（数問）を行うため、初回はそれに回答する必要があります（規約設定を無人でスキップするわけではありません）。
+
 > **公式コマンドとの名前衝突について:** C3 のスキル名は Claude Code 公式コマンドと重複しないよう設計しています。`/review-phase`（≠ 公式 `/code-review` / `/review`）、`/mcp-config`（≠ 公式 `/mcp`）はこの方針に基づく命名です。公式コマンドが追加された場合は衝突回避のために本フレームワークの skill 名を変更することがあります（v2.15.1 で `/code-review` → `/review-phase` に変更しました）。
 
 ---

{claude_code_conductor-2.37.0 → claude_code_conductor-2.38.0}/src/c3/__init__.py

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