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

{claude_code_conductor-2.36.0 → claude_code_conductor-2.38.0}/.claude/hooks/recall_autorebuild.py

@@ -97,11 +97,14 @@ def find_repo_root() -> Path | None:
 
 
 def index_exists(repo_root: Path) -> bool:
-    """Return True if the recall HNSW index file exists.
+    """Return True if the recall index file (``recall.hnsw``) exists.
+
+    歴史的経緯でファイル名は ``.hnsw`` を維持しているが、中身は numpy ndarray
+    (``.npy`` ペイロード, shape (N, dim) float32) であり HNSW ではない。
 
     Only ``recall.hnsw`` is checked — not ``recall_meta.json`` — because
     this hook's purpose is to trigger a rebuild when the index is stale.
-    If the binary index is present (even without a metadata sidecar),
+    If the index file is present (even without a metadata sidecar),
     the stale check in ``index_is_stale_fast`` is meaningful and we should
     proceed.  ``recall_inject`` checks both files because it needs a valid
     meta to run a search; we do not run a search here.

{claude_code_conductor-2.36.0 → claude_code_conductor-2.38.0}/.claude/hooks/recall_inject.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
 """UserPromptSubmit hook: inject semantically-similar past context (α design).
 
-The hook runs ``c3 recall search`` against the local HNSW index and
+The hook runs ``c3 recall search`` against the recall index (numpy cosine search) and
 returns the top hits as ``additionalContext`` for the parent Claude to
 consider. The preface explicitly asks Claude to evaluate the relevance
 of each hit and ignore unrelated ones — i.e. *AI judges, hook does not

{claude_code_conductor-2.36.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.36.0 → claude_code_conductor-2.38.0}/.claude/skills/recall/SKILL.md

@@ -6,7 +6,7 @@ allowed-tools: Bash, Read
 
 # recall
 
-`c3 recall` の HNSW + 多言語 embedding（`sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2`）に基づき、
+`c3 recall` の numpy ベクトル検索 + 多言語 embedding（`sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2`）に基づき、
 `.claude/memory/sessions/`・`.claude/agent-memory/`・`.claude/reports/archive/`・
 `.claude/memory/patterns.json` から類似情報を意味検索する。
 

{claude_code_conductor-2.36.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.36.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.36.0 → claude_code_conductor-2.38.0}/ARCHITECTURE.md

@@ -38,7 +38,7 @@ C3 は性質の異なる **2 つの層** からなる。この区別が全体理
 | 言語 | Python | Markdown（+ hook は Python） |
 | 配布 | `pip install claude-code-conductor` | `c3 init` が層 A から展開 |
 | エントリ | `c3 = "c3.cli:main"`（pyproject.toml） | スラッシュコマンド・Agent ツール |
-| 依存 | PyYAML / duckdb / chroma-hnswlib / fastembed | Claude Code ランタイム |
+| 依存 | PyYAML / duckdb / numpy / fastembed | Claude Code ランタイム |
 
 **配布元リポジトリ内の物理対応**:
 
@@ -165,7 +165,7 @@ A ヒアリング → B 設計 → C 計画 → D 実装(TDD) → E レビュー
 
 ```
 recall_chunker.py  →  embedding.py            →  recall_index.py
-（sessions/reports/    （fastembed: paraphrase-     （HNSW: chroma-hnswlib・
+（sessions/reports/    （fastembed: paraphrase-     （numpy cosine ブルートフォース・
   patterns をチャンク化）  multilingual-MiniLM-L12-v2    .claude/state/ に保存）
                           384次元・約220MB・多言語）
 ```

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

@@ -1,5 +1,36 @@
 # 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
+
+### 変更
+
+- **recall の索引バックエンドを chroma-hnswlib（C++ 拡張）から numpy ブルートフォース cosine 検索へ置換**: C++ コンパイラ（Microsoft Visual C++ Build Tools）が無い環境で `pip install claude-code-conductor` が失敗する問題を解消。numpy は全環境に wheel が提供されておりコンパイル不要。recall のコーパスは 1 ユーザーの `.claude/` 規模（数千チャンク）で近似最近傍の高速化が不要なため、numpy の総当たり cosine 検索で十分。索引は次回 `c3 recall rebuild` 実行時に自動で numpy 形式へ再生成される。アップグレード直後・初回 rebuild 完了までの間は recall が一時的に結果を返さない（`c3 recall rebuild --force` で即時再生成可能）。`recall.hnsw` ファイル名は後方互換のため維持（中身が numpy ペイロードに変わる）。関連フック（`recall_inject.py` / `recall_autorebuild.py`）は無改修で動作する。`load()` は不正形状・旧 hnswlib バイナリ・破損ファイルを検出すると `False` を返して全再構築フォールバックに繋ぐ（`np.load(allow_pickle=False)` で pickle 経路は遮断）。
+
+### 依存
+
+- `chroma-hnswlib>=0.7.6` を削除し `numpy>=1.22` を追加。`LICENSES/chroma-hnswlib-*` を削除し `LICENSES/numpy-LICENSE`（BSD-3-Clause）を追加。
+
+### 後方互換
+
+- 公開 API・CLI・索引ファイル名（`recall.hnsw`）・meta スキーマに変更なし。索引は自動再生成のため migration 操作は不要。**破壊的変更なし**。
+
 ## [2.36.0] - 2026-06-14
 
 **セッションファイルに「現在地」フィールドを新設し、コンテキスト圧縮（コンパクト）後の肥大ループとワークフロー無視を同時に解消（hook・skill 手順の変更／破壊的変更なし）**: 200K コンテキスト運用で、セッション復元（コンパクト後・`/init-session`）の経路が「構造のない丸投げ」になっていたことが 2 つの症状を生んでいた。(1) **コンパクト肥大ループ**: `pre_compact.py` がコンパクト直前に状態を無上限追記させ、`restore_session.py` がコンパクト後に `## 残タスク` / `## うまくいったアプローチ` / `## 試みたが失敗したアプローチ` の 3 セクションを完了済み `- [x]` 行も含め丸ごと再注入し続けるため、コンテキスト使用率が上がり→さらにコンパクトが早まる正のフィードバックになっていた。(2) **ワークフロー無視**: 復元時にフェーズ状態が単なる ToDo として注入されるだけで「dev-workflow 進行中・skill 経由で再開せよ・Approval Flow を守れ」の指示が無く、`/init-session` の「続きから作業する」も「そのまま作業に入る」となっていたため、復元後に dev-workflow を飛ばして直接着手しがちだった。両症状の根は同じ「復元時に構造化された現在地が無い」ことであり、`現在地:` の 1 行フィールドを新設して構造化することで、再注入を小さく保ちつつワークフロー復帰を確実化する。

claude_code_conductor-2.38.0/LICENSES/numpy-LICENSE

@@ -0,0 +1,32 @@
+# Source: https://github.com/numpy/numpy/blob/main/LICENSE.txt
+
+Copyright (c) 2005-2024, NumPy Developers.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+    * Redistributions of source code must retain the above copyright
+       notice, this list of conditions and the following disclaimer.
+
+    * Redistributions in binary form must reproduce the above
+       copyright notice, this list of conditions and the following
+       disclaimer in the documentation and/or other materials provided
+       with the distribution.
+
+    * Neither the name of the NumPy Developers nor the names of any
+       contributors may be used to endorse or promote products derived
+       from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-code-conductor
-Version: 2.36.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
@@ -37,9 +37,9 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Software Development
 Requires-Python: >=3.10
-Requires-Dist: chroma-hnswlib>=0.7.6
 Requires-Dist: duckdb>=0.10
 Requires-Dist: fastembed>=0.8.0
+Requires-Dist: numpy>=1.22
 Requires-Dist: pyyaml>=6.0
 Provides-Extra: notify
 Requires-Dist: windows-toasts>=1.0; (sys_platform == 'win32') and extra == 'notify'
@@ -184,7 +184,7 @@ C3 のスラッシュコマンドはすべてスキル（`skills/{name}/SKILL.md
 | `/doc` | ドキュメントをヒアリングして生成（mermaid 図・README・API 仕様書など） |
 | `/mcp-config` | MCP サーバーの追加・一覧・削除（プロジェクトスコープ） |
 | `/extract-lib` | 複数プロジェクトのコードを横断解析し、共通処理をライブラリとして設計・生成 |
-| `/recall` | 過去のセッション・レポート・パターンから類似情報を意味検索（HNSW + 多言語 embedding） |
+| `/recall` | 過去のセッション・レポート・パターンから類似情報を意味検索（numpy ベクトル検索 + 多言語 embedding） |
 | `/brainstorm` | 仕事・設計の相談を、資料（PDF/画像）を読み込んだ上で気軽に発散・壁打ち。視点・選択肢・論点を増やす方向（grill＝詰めるとは逆）（v2.29.0〜） |
 
 ### ターミナルで使う `c3` CLI（PyPI インストール時）
@@ -200,7 +200,7 @@ C3 のスラッシュコマンドはすべてスキル（`skills/{name}/SKILL.md
 | `c3 plan validate <plan-report>` | plan-report の YAML フロントマターと agent 存在を検証 |
 | `c3 plan waves <plan-report>` | plan-report の wave 分解結果を JSON で出力 |
 | `c3 recall search "<query>"` または `c3 recall "<query>"` | `.claude/memory/sessions/` 等から類似チャンクを意味検索 |
-| `c3 recall rebuild [--force]` | HNSW インデックスを再構築（初回は fastembed が ~220MB のモデルを取得） |
+| `c3 recall rebuild [--force]` | numpy ベクトル検索インデックスを再構築（初回は fastembed が ~220MB のモデルを取得） |
 | `c3 recall stats` | チャンク数・モデル名・最終 rebuild 日時を表示 |
 | `c3 tier stats` | tier-routing（複雑度に応じた Tier 自動ルーティング）の学習データ・Tier 別コスト・現在の routing パラメータ（λ/ε/escalation・v2.27.0〜）を表形式で表示（`--json` で機械可読出力・`--recent N` で直近 outcome 件数指定）。ルーティング挙動は環境変数 `C3_TIER_COST_LAMBDA`（cost-weighted の重み・`0 ≤ λ ≤ 5`・v2.26.0〜、上限拡張 v2.27.0）/ `C3_TIER_EPSILON` / `C3_ESCALATION_THRESHOLD` で調整可（[CLI リファレンス](https://satoh-y-0323.github.io/claude-code-conductor/cli-reference/)参照） |
 
@@ -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` に変更しました）。
 
 ---
@@ -420,7 +424,7 @@ C3 はセッションをまたいで作業状態を記憶します。
 
 | 依存 | ライセンス | 用途 |
 |---|---|---|
-| [chroma-hnswlib](https://github.com/chroma-core/hnswlib) | Apache-2.0 | HNSW 近傍検索インデックス |
+| [numpy](https://github.com/numpy/numpy) | BSD-3-Clause | recall のベクトル類似度検索（cosine ブルートフォース） |
 | [fastembed](https://github.com/qdrant/fastembed) | Apache-2.0 | embedding 生成ランタイム（ONNX ベース） |
 | [onnxruntime](https://github.com/microsoft/onnxruntime) | MIT | fastembed の推論バックエンド |
 | [sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2](https://huggingface.co/sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2) | Apache-2.0 | 多言語 embedding モデル（384 次元・約 220MB・約 50 言語対応） |

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

@@ -137,7 +137,7 @@ C3 のスラッシュコマンドはすべてスキル（`skills/{name}/SKILL.md
 | `/doc` | ドキュメントをヒアリングして生成（mermaid 図・README・API 仕様書など） |
 | `/mcp-config` | MCP サーバーの追加・一覧・削除（プロジェクトスコープ） |
 | `/extract-lib` | 複数プロジェクトのコードを横断解析し、共通処理をライブラリとして設計・生成 |
-| `/recall` | 過去のセッション・レポート・パターンから類似情報を意味検索（HNSW + 多言語 embedding） |
+| `/recall` | 過去のセッション・レポート・パターンから類似情報を意味検索（numpy ベクトル検索 + 多言語 embedding） |
 | `/brainstorm` | 仕事・設計の相談を、資料（PDF/画像）を読み込んだ上で気軽に発散・壁打ち。視点・選択肢・論点を増やす方向（grill＝詰めるとは逆）（v2.29.0〜） |
 
 ### ターミナルで使う `c3` CLI（PyPI インストール時）
@@ -153,7 +153,7 @@ C3 のスラッシュコマンドはすべてスキル（`skills/{name}/SKILL.md
 | `c3 plan validate <plan-report>` | plan-report の YAML フロントマターと agent 存在を検証 |
 | `c3 plan waves <plan-report>` | plan-report の wave 分解結果を JSON で出力 |
 | `c3 recall search "<query>"` または `c3 recall "<query>"` | `.claude/memory/sessions/` 等から類似チャンクを意味検索 |
-| `c3 recall rebuild [--force]` | HNSW インデックスを再構築（初回は fastembed が ~220MB のモデルを取得） |
+| `c3 recall rebuild [--force]` | numpy ベクトル検索インデックスを再構築（初回は fastembed が ~220MB のモデルを取得） |
 | `c3 recall stats` | チャンク数・モデル名・最終 rebuild 日時を表示 |
 | `c3 tier stats` | tier-routing（複雑度に応じた Tier 自動ルーティング）の学習データ・Tier 別コスト・現在の routing パラメータ（λ/ε/escalation・v2.27.0〜）を表形式で表示（`--json` で機械可読出力・`--recent N` で直近 outcome 件数指定）。ルーティング挙動は環境変数 `C3_TIER_COST_LAMBDA`（cost-weighted の重み・`0 ≤ λ ≤ 5`・v2.26.0〜、上限拡張 v2.27.0）/ `C3_TIER_EPSILON` / `C3_ESCALATION_THRESHOLD` で調整可（[CLI リファレンス](https://satoh-y-0323.github.io/claude-code-conductor/cli-reference/)参照） |
 
@@ -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` に変更しました）。
 
 ---
@@ -373,7 +377,7 @@ C3 はセッションをまたいで作業状態を記憶します。
 
 | 依存 | ライセンス | 用途 |
 |---|---|---|
-| [chroma-hnswlib](https://github.com/chroma-core/hnswlib) | Apache-2.0 | HNSW 近傍検索インデックス |
+| [numpy](https://github.com/numpy/numpy) | BSD-3-Clause | recall のベクトル類似度検索（cosine ブルートフォース） |
 | [fastembed](https://github.com/qdrant/fastembed) | Apache-2.0 | embedding 生成ランタイム（ONNX ベース） |
 | [onnxruntime](https://github.com/microsoft/onnxruntime) | MIT | fastembed の推論バックエンド |
 | [sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2](https://huggingface.co/sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2) | Apache-2.0 | 多言語 embedding モデル（384 次元・約 220MB・約 50 言語対応） |

{claude_code_conductor-2.36.0 → claude_code_conductor-2.38.0}/pyproject.toml

@@ -26,7 +26,7 @@ classifiers = [
 dependencies = [
     "PyYAML>=6.0",
     "duckdb>=0.10",
-    "chroma-hnswlib>=0.7.6",
+    "numpy>=1.22",
     "fastembed>=0.8.0",
 ]
 

{claude_code_conductor-2.36.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.36.0"
+__version__ = "2.38.0"

{claude_code_conductor-2.36.0 → claude_code_conductor-2.38.0}/src/c3/cli_recall.py

@@ -2,13 +2,15 @@
 
 Subcommands:
 
-* ``c3 recall search <query>`` — query the HNSW index for relevant chunks.
+* ``c3 recall search <query>`` — query the numpy cosine index for relevant chunks.
 * ``c3 recall rebuild`` — re-embed every source file and rewrite the index.
 * ``c3 recall stats`` — report what's in the index.
 
-The heavy dependencies (``fastembed``, ``hnswlib``) are imported lazily
-inside the handlers so that ``c3 --help`` and unrelated subcommands stay
-fast even when the embedding model has not yet been downloaded.
+The heavy dependency (``fastembed``) is imported lazily inside the handlers
+so that ``c3 --help`` and unrelated subcommands stay fast even when the
+embedding model has not yet been downloaded. ``numpy`` is imported eagerly
+at module level (``import numpy as np`` in ``recall_index.py``) and is
+always available when this module is loaded.
 """
 
 from __future__ import annotations
@@ -296,13 +298,22 @@ def _handle_rebuild(args: argparse.Namespace) -> int:
             dim=embedder.dim,
         )
         try:
-            candidate.load()
-            old_index = candidate
+            # [M-01] load() の戻り値を確認し、False なら増分不可として全再構築する。
+            loaded = candidate.load()
+            if loaded:
+                old_index = candidate
+            else:
+                print(
+                    "[recall] 既存 index を読めず増分不可・全再構築にフォールバック:"
+                    " load() returned False",
+                    file=sys.stderr,
+                )
+                old_index = None
         except Exception as exc:
             # CR-E-002/SR-R-004: log the failure reason so operators can diagnose
             # corrupt or mismatched index files. Exception message is intentionally
             # omitted (type name only) to avoid leaking internal state — consistent
-            # with the SR-R-001 policy used in _hnsw_save/_hnsw_load.
+            # with the SR-R-001 policy used in RecallIndex.load().
             print(
                 f"[recall] 既存 index を読めず増分不可・全再構築にフォールバック: {type(exc).__name__}",
                 file=sys.stderr,