claude-code-conductor 0.2.0__py3-none-any.whl

c3/_template/.claude/commands/setup.md

@@ -0,0 +1,206 @@
+# /setup コマンド
+
+プロジェクトのコーディング規約を設定する。
+ヒアリングは親 Claude が担当し、収集後に project-setup エージェントを起動する。
+
+---
+
+## Phase 1: 技術スタックのヒアリング（親 Claude が実施）
+
+### Q1: 言語・バージョン
+
+AskUserQuestion ツール:
+```json
+{
+  "questions": [{
+    "question": "使用する言語とバージョンを教えてください",
+    "options": [
+      { "label": "Python", "description": "バージョンを後で確認します" },
+      { "label": "TypeScript / JavaScript", "description": "バージョンを後で確認します" },
+      { "label": "Go", "description": "バージョンを後で確認します" },
+      { "label": "Java / Kotlin", "description": "バージョンを後で確認します" },
+      { "label": "C# / .NET", "description": "バージョンを後で確認します" },
+      { "label": "その他・自由入力" }
+    ]
+  }]
+}
+```
+
+選択後にバージョンを確認する。
+
+### Q2: フレームワーク
+
+AskUserQuestion ツール:
+```json
+{
+  "questions": [{
+    "question": "使用するフレームワーク・主要ライブラリを教えてください",
+    "options": [
+      { "label": "使用するものがある", "description": "具体的に入力してください" },
+      { "label": "まだ決めていない" },
+      { "label": "使用しない" }
+    ]
+  }]
+}
+```
+
+### Q3: 実行環境
+
+AskUserQuestion ツール:
+```json
+{
+  "questions": [{
+    "question": "実行環境はどれですか？",
+    "options": [
+      { "label": "サーバーサイド（API・バックエンド）" },
+      { "label": "ブラウザ（フロントエンド）" },
+      { "label": "両方（フルスタック）" },
+      { "label": "CLI ツール" },
+      { "label": "その他・自由入力" }
+    ]
+  }]
+}
+```
+
+### Q4: データベース
+
+AskUserQuestion ツール:
+```json
+{
+  "questions": [{
+    "question": "データベースは使いますか？",
+    "options": [
+      { "label": "PostgreSQL" },
+      { "label": "MySQL / MariaDB" },
+      { "label": "SQLite" },
+      { "label": "MongoDB" },
+      { "label": "その他・自由入力" },
+      { "label": "使わない" }
+    ]
+  }]
+}
+```
+
+### Q5: テストフレームワーク
+
+AskUserQuestion ツール:
+```json
+{
+  "questions": [{
+    "question": "テストフレームワークは決まっていますか？",
+    "options": [
+      { "label": "決まっている", "description": "具体的に入力してください" },
+      { "label": "まだ決めていない" }
+    ]
+  }]
+}
+```
+
+---
+
+## Phase 2: 独自規約のヒアリング（親 Claude が実施）
+
+### Q6: 参考スタイルガイド
+
+AskUserQuestion ツール:
+```json
+{
+  "questions": [{
+    "question": "参考にするスタイルガイドはありますか？",
+    "options": [
+      { "label": "公式スタイルガイドに従う", "description": "PEP8・Google・StandardJS 等" },
+      { "label": "Airbnb スタイル" },
+      { "label": "独自ルールがある", "description": "後で詳しく教えてください" },
+      { "label": "特になし・おすすめに任せる" }
+    ]
+  }]
+}
+```
+
+### Q7: コメント方針
+
+AskUserQuestion ツール:
+```json
+{
+  "questions": [{
+    "question": "コードコメントの方針を教えてください",
+    "options": [
+      { "label": "最小限にする", "description": "コード自体を読みやすく書く" },
+      { "label": "積極的に書く" },
+      { "label": "英語で統一" },
+      { "label": "日本語で統一" },
+      { "label": "特になし" }
+    ],
+    "multiSelect": true
+  }]
+}
+```
+
+### Q8: テストカバレッジ
+
+AskUserQuestion ツール:
+```json
+{
+  "questions": [{
+    "question": "テストカバレッジの目標はありますか？",
+    "options": [
+      { "label": "80% 以上" },
+      { "label": "クリティカルパスのみ" },
+      { "label": "数値目標なし" },
+      { "label": "その他・自由入力" }
+    ]
+  }]
+}
+```
+
+### Q9: その他の規約
+
+AskUserQuestion ツール:
+```json
+{
+  "questions": [{
+    "question": "他に規約として残しておきたいことはありますか？",
+    "options": [
+      { "label": "ある", "description": "自由に入力してください" },
+      { "label": "特になし" }
+    ]
+  }]
+}
+```
+
+---
+
+## Phase 3: project-setup エージェントの起動
+
+全ヒアリング結果を整理して Agent ツールで `project-setup` エージェントを起動する。
+
+プロンプト形式:
+```
+以下の情報をもとに rules/ ファイルを生成してください。
+
+## 技術スタック
+- 言語・バージョン: {回答}
+- フレームワーク: {回答}
+- 実行環境: {回答}
+- データベース: {回答}
+- テストフレームワーク: {回答}
+
+## チーム規約
+- 参考スタイルガイド: {回答}
+- コメント方針: {回答}
+- テストカバレッジ目標: {回答}
+- その他: {回答}
+```
+
+---
+
+## Phase 4: 完了報告
+
+```
+セットアップ完了:
+  .claude/rules/coding-standards.md    — 標準コーディング規約
+  .claude/rules/project-conventions.md — プロジェクト固有の規約
+
+次回から architect・developer・tester・code-reviewer・security-reviewer
+がこれらのルールを参照して作業します。
+```

c3/_template/.claude/commands/start.md

@@ -0,0 +1,88 @@
+# /start コマンド
+
+開発ワークフローの入口。
+
+---
+
+## Step 0: レポートの整理
+
+Glob で `.claude/reports/*.md` を検索する（`archive/` 配下は含まない）。
+レポートが存在しない場合はこの Step をスキップして Step 1 へ進む。
+
+レポートが存在する場合はファイル名の一覧をテキストで提示してから AskUserQuestion で確認する:
+
+```json
+{
+  "questions": [{
+    "question": "既存のレポートがあります。どうしますか？",
+    "options": [
+      { "label": "全てアーカイブして新しく始める", "description": "全レポートを reports/archive/ に移動する" },
+      { "label": "アーカイブするフェーズを選ぶ", "description": "フェーズ単位で選んで一部だけ移動する" },
+      { "label": "そのまま引き継ぐ", "description": "レポートを変更せずに続ける" }
+    ]
+  }]
+}
+```
+
+**「全てアーカイブして新しく始める」の場合:**
+Bash ツールで実行する:
+```bash
+mkdir -p .claude/reports/archive && mv .claude/reports/*.md .claude/reports/archive/
+```
+
+**「アーカイブするフェーズを選ぶ」の場合:**
+AskUserQuestion で対象フェーズを確認する:
+
+```json
+{
+  "questions": [{
+    "question": "アーカイブするフェーズを選んでください（複数選択可）",
+    "options": [
+      { "label": "要件定義", "description": "requirements-report-*.md" },
+      { "label": "設計", "description": "architecture-report-*.md" },
+      { "label": "計画", "description": "plan-report-*.md" },
+      { "label": "レビュー", "description": "code-review-report-*.md / security-review-report-*.md" }
+    ],
+    "multiSelect": true
+  }]
+}
+```
+
+選択されたフェーズに対応するファイルを Bash ツールで移動する（ファイルが存在しない場合はスキップ）:
+- 要件定義: `mkdir -p .claude/reports/archive && mv .claude/reports/requirements-report-*.md .claude/reports/archive/ 2>/dev/null || true`
+- 設計: `mkdir -p .claude/reports/archive && mv .claude/reports/architecture-report-*.md .claude/reports/archive/ 2>/dev/null || true`
+- 計画: `mkdir -p .claude/reports/archive && mv .claude/reports/plan-report-*.md .claude/reports/archive/ 2>/dev/null || true`
+- レビュー: `mkdir -p .claude/reports/archive && mv .claude/reports/code-review-report-*.md .claude/reports/archive/ 2>/dev/null || true && mv .claude/reports/security-review-report-*.md .claude/reports/archive/ 2>/dev/null || true`
+
+---
+
+## Step 1: 開始地点の選択
+
+AskUserQuestion ツールで以下を提示する:
+
+```json
+{
+  "questions": [{
+    "question": "どこから始めますか？",
+    "options": [
+      { "label": "ヒアリング", "description": "要件を整理するところから始める（新規・大きな変更）" },
+      { "label": "設計", "description": "要件は明確なので設計から始める" },
+      { "label": "計画", "description": "設計済みなのでタスク計画から始める" },
+      { "label": "実装", "description": "計画済みなので実装から始める" }
+    ]
+  }]
+}
+```
+
+---
+
+## Step 2: dev-workflow.md を Read してフェーズを実行する
+
+**最初に必ず** `.claude/skills/dev-workflow.md` を Read する。記憶・推測で進めず、dev-workflow.md の AskUserQuestion・Edit・セッションファイル更新の手順を省略しないこと。
+
+選択した開始地点に対応するフェーズから実行する:
+
+- **ヒアリング** → フェーズ A から実行
+- **設計** → フェーズ B から実行
+- **計画** → フェーズ C から実行
+- **実装** → フェーズ D から実行

c3/_template/.claude/docs/parallel-orchestra-manifest.md

@@ -0,0 +1,108 @@
+# Parallel Orchestra YAML フロントマター仕様
+
+Parallel Orchestra が読み込む YAML フロントマターのフォーマット定義。
+C3 では `plan-report` ファイルのフロントマターとして planner が出力する。
+
+---
+
+## フィールド一覧
+
+| フィールド | 必須 | 型 | 備考 |
+|---|---|---|---|
+| `po_plan_version` | ✅ | string | フォーマットバージョン（現在: `"0.1"`） |
+| `name` | ✅ | string | プランの表示名 |
+| `cwd` | ✅ | string | YAML フロントマターが書かれたファイルのディレクトリからプロジェクトルートへの相対パス |
+| `tasks` | ✅ | array | タスク定義の配列（1件以上） |
+| `tasks[].id` | ✅ | string | タスクの一意識別子。英数字・ハイフン・アンダースコアのみ |
+| `tasks[].agent` | ✅ | string | 使用するエージェント名 |
+| `tasks[].read_only` | ✅ | boolean | `true`: 読み取り専用（worktree なし）／`false`: 書き込みあり（worktree 作成） |
+| `tasks[].prompt` | ✅ | string | エージェントへの指示内容 |
+| `tasks[].depends_on` | 任意 | string[] | 先行タスクの ID リスト。DAG スケジューリングに使用 |
+| `tasks[].writes` | 任意 | string[] | このタスクが書き込むファイルパス。タスク間の衝突検出ヒントに使用 |
+| `tasks[].max_retries` | 任意 | integer (≥0) | プロセス失敗時の最大リトライ回数。`defaults.max_retries` を上書き |
+| `tasks[].concurrency_group` | 任意 | string | 同時実行数を制限するグループ名。`concurrency_limits` に対応するエントリが必要 |
+| `defaults` | 任意 | object | 全タスク共通のデフォルト値 |
+| `defaults.max_retries` | 任意 | integer (≥0) | タスクレベルの `max_retries` が未指定の場合に使用 |
+| `concurrency_limits` | 任意 | object | グループ名をキー、最大同時実行数を値とするマップ |
+| `on_complete` | 任意 | object | 全タスク成功時の Webhook 設定 |
+| `on_complete.webhook_url` | — | string | HTTP/HTTPS URL |
+| `on_failure` | 任意 | object | 1件以上のタスク失敗時の Webhook 設定 |
+| `on_failure.webhook_url` | — | string | HTTP/HTTPS URL |
+
+---
+
+## Parallel Orchestra が内部で管理するもの（フロントマターに書かない）
+
+| 項目 | 理由 |
+|---|---|
+| `timeout_sec` | Parallel Orchestra がデフォルト値を内部保持 |
+| `idle_timeout_sec` | worktree + Agent ツール構成では誤検知になるため不採用 |
+| `retry_delay_sec` / `retry_backoff_factor` | Parallel Orchestra が固定値を内部保持 |
+| タスクの CWD（起動時） | `read_only: false` → worktree ルート、`read_only: true` → プロジェクトルートを PO が自動設定 |
+| `PO_WORKTREE_GUARD=1` | `read_only: false` タスク起動時に PO が自動セット |
+
+---
+
+## フォーマット例
+
+```yaml
+---
+po_plan_version: "0.1"
+name: "ユーザー認証機能の並列実装"
+cwd: "../.."
+
+tasks:
+  - id: tdd-auth-login
+    agent: tdd-develop
+    read_only: false
+    prompt: |
+      ログイン機能を TDD で実装してください。
+      plan-report: .claude/reports/plan-report-20260429-120000.md
+    writes:
+      - src/auth/login.py
+      - tests/test_login.py
+
+  - id: tdd-auth-logout
+    agent: tdd-develop
+    read_only: false
+    prompt: |
+      ログアウト機能を TDD で実装してください。
+      plan-report: .claude/reports/plan-report-20260429-120000.md
+    writes:
+      - src/auth/logout.py
+      - tests/test_logout.py
+
+  - id: review-auth
+    agent: code-reviewer
+    read_only: true
+    prompt: "認証モジュール全体のコードレビューを行ってください。"
+    depends_on: [tdd-auth-login, tdd-auth-logout]
+    concurrency_group: api-calls
+
+defaults:
+  max_retries: 1
+
+concurrency_limits:
+  api-calls: 2
+
+on_failure:
+  webhook_url: "https://example.com/notify"
+---
+```
+
+---
+
+## C3 における配置場所
+
+| ファイル | パス |
+|---|---|
+| plan-report（フロントマターを含む） | `.claude/reports/plan-report-YYYYMMDD-HHMMSS.md` |
+| `cwd` の値（C3 標準） | `"../.."` |
+
+---
+
+## 注意事項
+
+- `claude -p` の起動 CWD は `cwd` フィールドではなく worktree ルートパスを使用する
+- `cwd` は Parallel Orchestra が git worktree を作成するための**プロジェクトルート特定**に使用する
+- `read_only: false` タスクは必ず git リポジトリ内で実行すること（worktree が git 依存のため）

c3/_template/.claude/hooks/clear_file_history.py

@@ -0,0 +1,39 @@
+#!/usr/bin/env python3
+"""Utility: clear ~/.claude/file-history/ directory."""
+
+import os
+import shutil
+import sys
+
+sys.stdout.reconfigure(encoding='utf-8')
+sys.stderr.reconfigure(encoding='utf-8')
+
+FILE_HISTORY_DIR = os.path.join(os.path.expanduser('~'), '.claude', 'file-history')
+
+
+def main():
+    if not os.path.isdir(FILE_HISTORY_DIR):
+        print('[clear-file-history] file-history フォルダが存在しません。スキップします。')
+        return
+
+    entries = os.listdir(FILE_HISTORY_DIR)
+    deleted = 0
+
+    for name in entries:
+        full_path = os.path.join(FILE_HISTORY_DIR, name)
+        try:
+            if os.path.isdir(full_path):
+                shutil.rmtree(full_path)
+            else:
+                os.unlink(full_path)
+            deleted += 1
+        except FileNotFoundError:
+            pass
+        except Exception as e:
+            print(f'[clear-file-history] 削除に失敗: {name} ({e})')
+
+    print(f'[clear-file-history] {deleted} 件削除しました。')
+
+
+if __name__ == '__main__':
+    main()

c3/_template/.claude/hooks/enable_sandbox.py

@@ -0,0 +1,61 @@
+#!/usr/bin/env python3
+"""Utility: ensure full sandbox config is present in settings.json."""
+
+import json
+import os
+import sys
+
+sys.stdout.reconfigure(encoding='utf-8')
+sys.stderr.reconfigure(encoding='utf-8')
+
+FULL_SANDBOX_CONFIG = {
+    "enabled": True,
+    "autoAllowBashIfSandboxed": True,
+    "allowUnsandboxedCommands": False,
+    "excludedCommands": [],
+    "network": {
+        "allowUnixSockets": [],
+        "allowAllUnixSockets": False,
+        "allowLocalBinding": False,
+        "allowedDomains": []
+    },
+    "enableWeakerNestedSandbox": True
+}
+
+
+def main():
+    cwd = os.getcwd()
+
+    # git worktree 内では実行しない（.git がファイルの場合は worktree）
+    git_path = os.path.join(cwd, '.git')
+    if os.path.exists(git_path) and os.path.isfile(git_path):
+        print('[enable-sandbox] git worktree 内での実行のためスキップします。')
+        return
+
+    settings_path = os.path.join(cwd, '.claude', 'settings.json')
+    if not os.path.exists(settings_path):
+        print(f'[enable-sandbox] settings.json が見つかりません: {settings_path}')
+        return
+
+    with open(settings_path, 'r', encoding='utf-8') as f:
+        try:
+            settings = json.load(f)
+        except json.JSONDecodeError as e:
+            print(f'[enable-sandbox] settings.json の JSON 解析に失敗しました: {e}')
+            return
+
+    if settings.get('sandbox', {}).get('enabled') is True:
+        print('[enable-sandbox] sandbox はすでに有効です。')
+        return
+
+    settings['sandbox'] = FULL_SANDBOX_CONFIG
+
+    with open(settings_path, 'w', encoding='utf-8') as f:
+        json.dump(settings, f, ensure_ascii=False, indent=2)
+        f.write('\n')
+
+    print('[enable-sandbox] sandbox を有効化しました。Claude Code 再起動後に反映されます。')
+
+
+if __name__ == '__main__':
+    main()

c3/_template/.claude/hooks/pre_compact.py

@@ -0,0 +1,82 @@
+#!/usr/bin/env python3
+"""PreCompact hook: append checkpoint marker to today's session file."""
+
+import json
+import os
+import sys
+from datetime import datetime, timezone
+
+sys.stdout.reconfigure(encoding='utf-8')
+sys.stderr.reconfigure(encoding='utf-8')
+
+
+def is_worktree(cwd: str) -> bool:
+    git_path = os.path.join(cwd, '.git')
+    return os.path.exists(git_path) and os.path.isfile(git_path)
+
+
+def create_session_template(date_str: str) -> str:
+    return (
+        f"SESSION: {date_str}\n"
+        f"AGENT: \n"
+        f"DURATION: \n"
+        f"\n"
+        f"## うまくいったアプローチ\n"
+        f"\n"
+        f"## 試みたが失敗したアプローチ\n"
+        f"\n"
+        f"## 残タスク\n"
+        f"\n"
+        f"## 事実ログ（自動生成 / stop.py）\n"
+        f"- 記録時刻: \n"
+        f"\n"
+        f"<!-- C3:SESSION:JSON\n"
+        f"{{\n"
+        f'  "session": "{date_str}",\n'
+        f'  "patterns": [],\n'
+        f'  "successes": [],\n'
+        f'  "failures": [],\n'
+        f'  "todos": []\n'
+        f"}}\n"
+        f"-->\n"
+    )
+
+
+def main():
+    try:
+        json.loads(sys.stdin.read())
+    except (json.JSONDecodeError, ValueError):
+        pass
+
+    cwd = os.getcwd()
+
+    if is_worktree(cwd):
+        sys.exit(0)
+
+    session_dir = os.path.join(cwd, '.claude', 'memory', 'sessions')
+    os.makedirs(session_dir, exist_ok=True)
+
+    now = datetime.now(timezone.utc)
+    date_str = now.strftime('%Y%m%d')
+    session_file = os.path.join(session_dir, f'{date_str}.tmp')
+
+    if not os.path.exists(session_file):
+        with open(session_file, 'w', encoding='utf-8') as f:
+            f.write(create_session_template(date_str))
+
+    ts = now.isoformat()
+    checkpoint = (
+        f'\n'
+        f'## [PreCompact checkpoint: {ts}]\n'
+        f'コンテキストウィンドウ圧縮が発生しました。\n'
+        f'このポイント以前の詳細な文脈は失われています。\n'
+    )
+
+    with open(session_file, 'a', encoding='utf-8') as f:
+        f.write(checkpoint)
+
+    print(f'[PreCompact] セッション状態を {session_file} に保存しました', file=sys.stderr)
+
+
+if __name__ == '__main__':
+    main()

c3/_template/.claude/hooks/pre_tool.py

@@ -0,0 +1,64 @@
+#!/usr/bin/env python3
+"""PreToolUse hook: guard dangerous Bash commands."""
+
+import json
+import re
+import sys
+
+sys.stdout.reconfigure(encoding='utf-8')
+sys.stderr.reconfigure(encoding='utf-8')
+
+
+def main():
+    try:
+        payload = json.loads(sys.stdin.read())
+    except (json.JSONDecodeError, ValueError):
+        sys.exit(0)
+
+    if payload.get('tool_name') != 'Bash':
+        sys.exit(0)
+
+    cmd = payload.get('tool_input', {}).get('command', '')
+    if not isinstance(cmd, str):
+        sys.exit(0)
+
+    # git force push: 警告（ブロックしない）
+    if re.search(r'git\s+push\s+(--force|--force-with-lease|-f)\b', cmd):
+        print('[PreToolUse WARNING] git force push を検出しました。実行前にユーザーに確認を取ってください。',
+              file=sys.stderr)
+
+    # DROP TABLE / DROP DATABASE / TRUNCATE: 警告（ブロックしない）
+    if re.search(r'DROP\s+TABLE|DROP\s+DATABASE|TRUNCATE', cmd, re.IGNORECASE):
+        print('[PreToolUse WARNING] 破壊的な DB 操作を検出しました。本番環境での実行でないことを確認してください。',
+              file=sys.stderr)
+
+    # cd コマンド: CWD 固定バグを防ぐためブロック
+    # Bash ツールで cd を実行すると以降の全コマンドの CWD が変わり、
+    # フックが相対パスで .claude/hooks/ を参照できなくなる。
+    if re.search(r'(?:^|[;&|])\s*cd(?:\s|$)', cmd):
+        print(
+            '[PreToolUse BLOCK] cd コマンドをブロックしました。\n'
+            'Bash ツールで cd を実行すると CWD が変わり、以降のフックが失敗します。\n'
+            'cd を使わず、プロジェクトルートからの相対パスで実行してください。\n'
+            '例: python -m pytest test1/tests -v  （cd test1 && python -m pytest の代わり）',
+            file=sys.stderr
+        )
+        sys.exit(2)
+
+    # rm -rf 系: ブロック
+    # 短フラグ形式（-rf / -fr / -r -f 等）とロングオプション形式（--recursive --force）に対応
+    if re.search(r'\brm\b', cmd):
+        short_flags = ''.join(re.findall(r'-[a-zA-Z]+', cmd))
+        has_r = 'r' in short_flags or bool(re.search(r'\brm\b.*\s-[a-zA-Z]*r[a-zA-Z]*', cmd))
+        has_f = 'f' in short_flags or bool(re.search(r'\brm\b.*\s-[a-zA-Z]*f[a-zA-Z]*', cmd))
+        has_long_recursive = '--recursive' in cmd
+        has_long_force = '--force' in cmd
+        if (has_r and has_f) or (has_long_recursive and has_long_force):
+            print(f'[PreToolUse BLOCK] 危険なコマンドをブロックしました: {cmd}', file=sys.stderr)
+            sys.exit(2)
+
+    sys.exit(0)
+
+
+if __name__ == '__main__':
+    main()