@ronkovic/aad 0.3.9 → 0.5.0

package/templates/CLAUDE.md

@@ -0,0 +1,122 @@
+# 🤖 Orchestrator System Definition
+
+あなたは、`.aad/docs/` を「唯一の真実(SSOT)」として管理し、階層的なブランチ戦略でPRを作成する自律型Orchestratorです。
+
+## 📂 Capability Mapping
+- **Workflow**: `.claude/skills/aad-pipeline/SKILL.md` (master-pipeline)
+- **Spec Decomposer**: `.claude/agents/aad-spec-decomposer.md` (大規模要件分割)
+- **Splitter**: `.claude/agents/aad-splitter.md` (要件解析・タスク分割)
+- **Tester**: `.claude/agents/aad-tester.md` (Go/Playwright 高度TDD実行)
+- **Implementer**: `.claude/agents/aad-implementer.md` (実装・リファクタ)
+- **Reviewer**: `.claude/agents/aad-reviewer.md` (コード品質・セキュリティレビュー)
+- **Documentor**: `.claude/agents/aad-documentor.md` (ドキュメント生成・更新)
+- **Parallel Coordinator**: `.claude/agents/aad-parallel-coordinator.md` (並列実行調整)
+- **GitHub Manager**: `.claude/agents/aad-github-manager.md` (ブランチ・Worktree・PR管理)
+
+## 📂 Branching Strategy
+1. **Feature Parent Branch**: 要件ごとに `main` から作成(例: `feature/yyyy-mm-dd-title`)。
+2. **Task Branches**: 各タスクはこの「親ブランチ」から派生し、**親ブランチに向けて**PRを作成する。
+
+## 📏 Core Rules
+- **TDD First**: 実装前に必ず失敗するテスト(Red)を書く。Goは「テーブル駆動テスト」を基本とする。
+- **Isolation**: 全ての作業は `../worktrees/wt-[task-id]` 内で行う。
+- **Documentation**: 思考過程とテスト結果を `./.aad/docs/` に逐次記録する。
+
+## 🔒 CRITICAL: ファイル所有権の確認
+
+**編集前に必ず確認**: どのファイルが何の責任範囲かを確認する。
+
+責任不明な場合は `/verify-ownership <file>` を実行。
+
+## 🎯 CRITICAL: 優先順位
+
+**機能的な正しさを最優先**。修飾的な問題は後回し。
+
+詳細: `.claude/rules/aad-priorities.md` を参照
+
+### HIGH (即座に対応)
+- テスト失敗、コンパイルエラー、ランタイムエラー
+
+### LOW (後で対応)
+- 全角/半角の統一、コメント体裁、空白調整
+
+## ✅ CRITICAL: タスク完了の徹底
+
+セッション終了前に必ず:
+1. 未コミットの変更をコミット
+2. 失敗したテストを記録
+3. Worktreeをクリーンアップ
+
+## 🛠️ スキル
+
+- `/verify-ownership <file>` - 編集前のファイル責任確認
+- `/implement-plan <run_id>` - 計画に基づいた実装
+
+## 💾 Agent Memory
+
+AADシステムは**Agent Memory**を活用し、エージェントが過去の知見を蓄積・活用します。
+
+### メモリスコープ
+
+- **`memory: project`**: プロジェクト全体で共有される知見（コーディング規約、アーキテクチャ決定、テストパターン等）
+  - Implementer, Reviewer, Tester, GitHub Manager, Documentorが使用
+- **`memory: user`**: ユーザー間で共有される知見（一般的なベストプラクティス）
+  - Splitter, Spec Decomposerが使用
+- **`memory: none`**: メモリを使用しない（単発タスク向け）
+
+### メモリ同期
+
+タスク完了後、worktree内の`MEMORY.md`がプロジェクトテンプレート（`.aad/templates/.claude/agent-memory/`）に自動同期されます。次回実行時、エージェントは過去の知見を参照できます。
+
+- **有効化**: `AAD_MEMORY_SYNC_ENABLED=1`（デフォルト有効）
+- **上限**: 各MEMORY.mdは200行まで（Claude Codeの自動挿入制限）
+
+## 🤝 Agent Teams
+
+AADシステムは**Agent Teams**を活用し、1つのフェーズ内で複数のClaude CLIインスタンスを並列実行します。
+
+### チーム構成
+
+- **Splitterフェーズ**: 3並列分析（デフォルト有効）
+  - `codebase-analyzer`: ディレクトリ構造、既存コード、技術スタック分析
+  - `requirement-analyzer`: 要件パース、ユーザーストーリー抽出、受入基準特定
+  - `dependency-mapper`: モジュール間依存、並列化ポテンシャル分析
+- **Reviewフェーズ**: 3並列レビュー（デフォルト無効）
+  - `quality-reviewer`: コード品質、可読性、保守性
+  - `security-reviewer`: セキュリティ脆弱性、権限チェック
+  - `performance-reviewer`: パフォーマンス、リソース効率
+
+### 重要な制約
+
+AADはtmuxを独自管理するため、`teammateMode: "in-process"`固定です。`"tmux"`モードは使用できません。
+
+- **設定**: `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`（settings.jsonのenvで設定）
+- **Splitter**: `AAD_USE_TEAMS_FOR_SPLITTER=1`（デフォルト有効）
+- **Review**: `AAD_USE_TEAMS_FOR_REVIEW=0`（デフォルト無効）
+
+## ⚙️ 環境変数一覧
+
+`.aad/config.sh`で以下の環境変数を設定できます:
+
+| 変数 | デフォルト | 説明 |
+|---|---|---|
+| `AAD_NUM_WORKERS` | `2` | 並列ワーカー数 |
+| `AAD_MAX_WORKERS` | `8` | 最大ワーカー数上限 |
+| `AAD_USE_TEAMS_FOR_SPLITTER` | `1` | Splitterフェーズのチーム有効 |
+| `AAD_USE_TEAMS_FOR_REVIEW` | `0` | Reviewフェーズのチーム有効 |
+| `AAD_MEMORY_SYNC_ENABLED` | `1` | Agent Memory同期有効 |
+| `AAD_ADAPTIVE_EFFORT` | `0` | タスク複雑度ベースeffort調整 |
+| `AAD_MODEL` | *(空=CLIデフォルト)* | 全フェーズ共通モデル |
+| `AAD_MODEL_SPLITTER` | *(空=AAD_MODEL)* | Splitterモデル |
+| `AAD_MODEL_TESTER` | *(空=AAD_MODEL)* | Testerモデル |
+| `AAD_MODEL_IMPLEMENTER` | *(空=AAD_MODEL)* | Implementerモデル |
+| `AAD_MODEL_REVIEWER` | *(空=AAD_MODEL)* | Reviewerモデル |
+| `AAD_MODEL_MERGE` | `haiku` | Merge resolverモデル |
+| `AAD_MODEL_BRANCH_NAME` | `haiku` | ブランチ名生成モデル |
+| `CLAUDE_TIMEOUT` | `1200` | Claude CLI呼び出しタイムアウト（秒） |
+| `TEST_TIMEOUT` | `600` | テスト実行タイムアウト（秒） |
+| `AAD_STALE_TASK_TIMEOUT` | `5400` | スタレタスクタイムアウト（秒） |
+| `MAX_PHASE_RETRIES` | `2` | フェーズ毎最大リトライ回数 |
+| `DEBUG` | `0` | デバッグログ有効 |
+
+利用可能なモデル名: `sonnet`, `opus`, `haiku`, `claude-sonnet-4-5-20250929`, `claude-opus-4-6`, `claude-haiku-4-5-20251001`

package/templates/settings.json

@@ -0,0 +1,117 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(go test *)",
+      "Bash(go build *)",
+      "Bash(go mod *)",
+      "Bash(npm run *)",
+      "Bash(npm test)",
+      "Bash(npx playwright *)",
+      "Bash(git status)",
+      "Bash(git diff *)",
+      "Bash(git log *)",
+      "Bash(git branch *)",
+      "Bash(git checkout -b *)",
+      "Bash(git add *)",
+      "Bash(git commit *)",
+      "Bash(git worktree *)",
+      "Bash(gh pr *)",
+      "Bash(gh issue *)",
+      "Read",
+      "Grep",
+      "Glob",
+      "Write",
+      "Edit"
+    ],
+    "deny": [
+      "Bash(git push origin main)",
+      "Bash(git push origin master)",
+      "Bash(git push -f *)",
+      "Bash(git push --force *)",
+      "Bash(git reset --hard *)",
+      "Bash(rm -rf /)",
+      "Bash(rm -rf ~)",
+      "Bash(rm -rf /*)",
+      "Write(**/secrets/**)",
+      "Edit(**/secrets/**)",
+      "Bash(curl * | sh)",
+      "Bash(curl * | bash)",
+      "Bash(wget * | sh)",
+      "Read(.env)",
+      "Read(.env.*)",
+      "Read(~/.ssh/*)",
+      "Read(~/.aws/*)",
+      "Write(.env)",
+      "Write(.env.*)",
+      "Write(~/.ssh/*)",
+      "Write(~/.aws/*)",
+      "Write(.claude/settings.json)",
+      "Edit(.env)",
+      "Edit(.env.*)",
+      "Edit(~/.ssh/*)",
+      "Edit(~/.aws/*)",
+      "Edit(.claude/settings.json)"
+    ]
+  },
+  "sandbox": {
+    "enabled": true,
+    "autoAllowBashIfSandboxed": true,
+    "network": {
+      "allowedDomains": ["github.com", "api.github.com", "npmjs.org", "proxy.golang.org"]
+    }
+  },
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": ".claude/hooks/aad-validate-command.sh",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": ".claude/hooks/aad-post-edit-verify.sh",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "TeammateIdle": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": ".claude/hooks/aad-teammate-idle.sh",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "TaskCompleted": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": ".claude/hooks/aad-task-completed.sh",
+            "timeout": 10
+          }
+        ]
+      }
+    ]
+  },
+  "env": {
+    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1",
+    "AAD_USE_TEAMS_FOR_SPLITTER": "1"
+  }
+}

package/src/modules/persistence/__tests__/.tmp-stores-test-81991/progress.json

@@ -1,10 +0,0 @@
-{
-  "runId": "run-latest",
-  "parentBranch": "main",
-  "totalTasks": 8,
-  "pending": 0,
-  "running": 0,
-  "completed": 8,
-  "failed": 0,
-  "startTime": "2024-01-03T10:00:00Z"
-}

package/src/modules/persistence/__tests__/.tmp-stores-test-81991/queue/completed/task-getall-2.json

@@ -1,10 +0,0 @@
-{
-  "taskId": "task-getall-2",
-  "title": "Task 2",
-  "description": "Task 2",
-  "filesToModify": [],
-  "dependsOn": [],
-  "priority": 2,
-  "status": "completed",
-  "retryCount": 0
-}

package/src/modules/persistence/__tests__/.tmp-stores-test-81991/queue/pending/task-1.json

@@ -1,13 +0,0 @@
-{
-  "taskId": "task-1",
-  "title": "FS Test Task",
-  "description": "A filesystem test task",
-  "filesToModify": [
-    "file1.ts",
-    "file2.ts"
-  ],
-  "dependsOn": [],
-  "priority": 1,
-  "status": "pending",
-  "retryCount": 0
-}

package/src/modules/persistence/__tests__/.tmp-stores-test-81991/queue/pending/task-getall-1.json

@@ -1,10 +0,0 @@
-{
-  "taskId": "task-getall-1",
-  "title": "Task 1",
-  "description": "Task 1",
-  "filesToModify": [],
-  "dependsOn": [],
-  "priority": 1,
-  "status": "pending",
-  "retryCount": 0
-}

package/src/modules/persistence/__tests__/.tmp-stores-test-81991/queue/pending/task-status-change.json

@@ -1,10 +0,0 @@
-{
-  "taskId": "task-status-change",
-  "title": "Task",
-  "description": "Task",
-  "filesToModify": [],
-  "dependsOn": [],
-  "priority": 1,
-  "status": "pending",
-  "retryCount": 0
-}

package/src/modules/persistence/__tests__/.tmp-stores-test-81991/workers/worker-1.json

@@ -1,5 +0,0 @@
-{
-  "workerId": "worker-1",
-  "status": "idle",
-  "currentTask": null
-}

package/src/modules/persistence/__tests__/.tmp-stores-test-81991/workers/worker-2.json

@@ -1,5 +0,0 @@
-{
-  "workerId": "worker-2",
-  "status": "busy",
-  "currentTask": "task-1"
-}

package/src/modules/persistence/__tests__/.tmp-stores-test-82469/progress.json

@@ -1,10 +0,0 @@
-{
-  "runId": "run-latest",
-  "parentBranch": "main",
-  "totalTasks": 8,
-  "pending": 0,
-  "running": 0,
-  "completed": 8,
-  "failed": 0,
-  "startTime": "2024-01-03T10:00:00Z"
-}

package/src/modules/persistence/__tests__/.tmp-stores-test-82469/queue/completed/task-getall-2.json

@@ -1,10 +0,0 @@
-{
-  "taskId": "task-getall-2",
-  "title": "Task 2",
-  "description": "Task 2",
-  "filesToModify": [],
-  "dependsOn": [],
-  "priority": 2,
-  "status": "completed",
-  "retryCount": 0
-}

package/src/modules/persistence/__tests__/.tmp-stores-test-82469/queue/pending/task-1.json

@@ -1,13 +0,0 @@
-{
-  "taskId": "task-1",
-  "title": "FS Test Task",
-  "description": "A filesystem test task",
-  "filesToModify": [
-    "file1.ts",
-    "file2.ts"
-  ],
-  "dependsOn": [],
-  "priority": 1,
-  "status": "pending",
-  "retryCount": 0
-}

package/src/modules/persistence/__tests__/.tmp-stores-test-82469/queue/pending/task-getall-1.json

@@ -1,10 +0,0 @@
-{
-  "taskId": "task-getall-1",
-  "title": "Task 1",
-  "description": "Task 1",
-  "filesToModify": [],
-  "dependsOn": [],
-  "priority": 1,
-  "status": "pending",
-  "retryCount": 0
-}

package/src/modules/persistence/__tests__/.tmp-stores-test-82469/queue/pending/task-status-change.json

@@ -1,10 +0,0 @@
-{
-  "taskId": "task-status-change",
-  "title": "Task",
-  "description": "Task",
-  "filesToModify": [],
-  "dependsOn": [],
-  "priority": 1,
-  "status": "pending",
-  "retryCount": 0
-}

package/src/modules/persistence/__tests__/.tmp-stores-test-82469/workers/worker-1.json

@@ -1,5 +0,0 @@
-{
-  "workerId": "worker-1",
-  "status": "idle",
-  "currentTask": null
-}

package/src/modules/persistence/__tests__/.tmp-stores-test-82469/workers/worker-2.json

@@ -1,5 +0,0 @@
-{
-  "workerId": "worker-2",
-  "status": "busy",
-  "currentTask": "task-1"
-}

package/src/modules/persistence/__tests__/.tmp-stores-test-85301/progress.json

@@ -1,10 +0,0 @@
-{
-  "runId": "run-latest",
-  "parentBranch": "main",
-  "totalTasks": 8,
-  "pending": 0,
-  "running": 0,
-  "completed": 8,
-  "failed": 0,
-  "startTime": "2024-01-03T10:00:00Z"
-}

package/src/modules/persistence/__tests__/.tmp-stores-test-85301/queue/completed/task-getall-2.json

@@ -1,10 +0,0 @@
-{
-  "taskId": "task-getall-2",
-  "title": "Task 2",
-  "description": "Task 2",
-  "filesToModify": [],
-  "dependsOn": [],
-  "priority": 2,
-  "status": "completed",
-  "retryCount": 0
-}

package/src/modules/persistence/__tests__/.tmp-stores-test-85301/queue/pending/task-1.json

@@ -1,13 +0,0 @@
-{
-  "taskId": "task-1",
-  "title": "FS Test Task",
-  "description": "A filesystem test task",
-  "filesToModify": [
-    "file1.ts",
-    "file2.ts"
-  ],
-  "dependsOn": [],
-  "priority": 1,
-  "status": "pending",
-  "retryCount": 0
-}

package/src/modules/persistence/__tests__/.tmp-stores-test-85301/queue/pending/task-getall-1.json

@@ -1,10 +0,0 @@
-{
-  "taskId": "task-getall-1",
-  "title": "Task 1",
-  "description": "Task 1",
-  "filesToModify": [],
-  "dependsOn": [],
-  "priority": 1,
-  "status": "pending",
-  "retryCount": 0
-}

package/src/modules/persistence/__tests__/.tmp-stores-test-85301/queue/pending/task-status-change.json

@@ -1,10 +0,0 @@
-{
-  "taskId": "task-status-change",
-  "title": "Task",
-  "description": "Task",
-  "filesToModify": [],
-  "dependsOn": [],
-  "priority": 1,
-  "status": "pending",
-  "retryCount": 0
-}

package/src/modules/persistence/__tests__/.tmp-stores-test-85301/workers/worker-1.json

@@ -1,5 +0,0 @@
-{
-  "workerId": "worker-1",
-  "status": "idle",
-  "currentTask": null
-}

package/src/modules/persistence/__tests__/.tmp-stores-test-85301/workers/worker-2.json

@@ -1,5 +0,0 @@
-{
-  "workerId": "worker-2",
-  "status": "busy",
-  "currentTask": "task-1"
-}

package/src/modules/persistence/__tests__/.tmp-stores-test-85759/progress.json

@@ -1,10 +0,0 @@
-{
-  "runId": "run-latest",
-  "parentBranch": "main",
-  "totalTasks": 8,
-  "pending": 0,
-  "running": 0,
-  "completed": 8,
-  "failed": 0,
-  "startTime": "2024-01-03T10:00:00Z"
-}

package/src/modules/persistence/__tests__/.tmp-stores-test-85759/queue/completed/task-getall-2.json

@@ -1,10 +0,0 @@
-{
-  "taskId": "task-getall-2",
-  "title": "Task 2",
-  "description": "Task 2",
-  "filesToModify": [],
-  "dependsOn": [],
-  "priority": 2,
-  "status": "completed",
-  "retryCount": 0
-}

package/src/modules/persistence/__tests__/.tmp-stores-test-85759/queue/pending/task-1.json

@@ -1,13 +0,0 @@
-{
-  "taskId": "task-1",
-  "title": "FS Test Task",
-  "description": "A filesystem test task",
-  "filesToModify": [
-    "file1.ts",
-    "file2.ts"
-  ],
-  "dependsOn": [],
-  "priority": 1,
-  "status": "pending",
-  "retryCount": 0
-}

package/src/modules/persistence/__tests__/.tmp-stores-test-85759/queue/pending/task-getall-1.json

@@ -1,10 +0,0 @@
-{
-  "taskId": "task-getall-1",
-  "title": "Task 1",
-  "description": "Task 1",
-  "filesToModify": [],
-  "dependsOn": [],
-  "priority": 1,
-  "status": "pending",
-  "retryCount": 0
-}

package/src/modules/persistence/__tests__/.tmp-stores-test-85759/queue/pending/task-status-change.json

@@ -1,10 +0,0 @@
-{
-  "taskId": "task-status-change",
-  "title": "Task",
-  "description": "Task",
-  "filesToModify": [],
-  "dependsOn": [],
-  "priority": 1,
-  "status": "pending",
-  "retryCount": 0
-}

package/src/modules/persistence/__tests__/.tmp-stores-test-85759/workers/worker-1.json

@@ -1,5 +0,0 @@
-{
-  "workerId": "worker-1",
-  "status": "idle",
-  "currentTask": null
-}

package/src/modules/persistence/__tests__/.tmp-stores-test-85759/workers/worker-2.json

@@ -1,5 +0,0 @@
-{
-  "workerId": "worker-2",
-  "status": "busy",
-  "currentTask": "task-1"
-}

package/src/modules/persistence/__tests__/.tmp-stores-test-86184/progress.json

@@ -1,10 +0,0 @@
-{
-  "runId": "run-latest",
-  "parentBranch": "main",
-  "totalTasks": 8,
-  "pending": 0,
-  "running": 0,
-  "completed": 8,
-  "failed": 0,
-  "startTime": "2024-01-03T10:00:00Z"
-}

package/src/modules/persistence/__tests__/.tmp-stores-test-86184/queue/completed/task-getall-2.json

@@ -1,10 +0,0 @@
-{
-  "taskId": "task-getall-2",
-  "title": "Task 2",
-  "description": "Task 2",
-  "filesToModify": [],
-  "dependsOn": [],
-  "priority": 2,
-  "status": "completed",
-  "retryCount": 0
-}

package/src/modules/persistence/__tests__/.tmp-stores-test-86184/queue/pending/task-1.json

@@ -1,13 +0,0 @@
-{
-  "taskId": "task-1",
-  "title": "FS Test Task",
-  "description": "A filesystem test task",
-  "filesToModify": [
-    "file1.ts",
-    "file2.ts"
-  ],
-  "dependsOn": [],
-  "priority": 1,
-  "status": "pending",
-  "retryCount": 0
-}

package/src/modules/persistence/__tests__/.tmp-stores-test-86184/queue/pending/task-getall-1.json

@@ -1,10 +0,0 @@
-{
-  "taskId": "task-getall-1",
-  "title": "Task 1",
-  "description": "Task 1",
-  "filesToModify": [],
-  "dependsOn": [],
-  "priority": 1,
-  "status": "pending",
-  "retryCount": 0
-}

package/src/modules/persistence/__tests__/.tmp-stores-test-86184/queue/pending/task-status-change.json

@@ -1,10 +0,0 @@
-{
-  "taskId": "task-status-change",
-  "title": "Task",
-  "description": "Task",
-  "filesToModify": [],
-  "dependsOn": [],
-  "priority": 1,
-  "status": "pending",
-  "retryCount": 0
-}

package/src/modules/persistence/__tests__/.tmp-stores-test-86184/workers/worker-1.json

@@ -1,5 +0,0 @@
-{
-  "workerId": "worker-1",
-  "status": "idle",
-  "currentTask": null
-}

package/src/modules/persistence/__tests__/.tmp-stores-test-86184/workers/worker-2.json

@@ -1,5 +0,0 @@
-{
-  "workerId": "worker-2",
-  "status": "busy",
-  "currentTask": "task-1"
-}

package/src/modules/persistence/__tests__/.tmp-stores-test-88026/progress.json

@@ -1,10 +0,0 @@
-{
-  "runId": "run-latest",
-  "parentBranch": "main",
-  "totalTasks": 8,
-  "pending": 0,
-  "running": 0,
-  "completed": 8,
-  "failed": 0,
-  "startTime": "2024-01-03T10:00:00Z"
-}

package/src/modules/persistence/__tests__/.tmp-stores-test-88026/queue/completed/task-getall-2.json

@@ -1,10 +0,0 @@
-{
-  "taskId": "task-getall-2",
-  "title": "Task 2",
-  "description": "Task 2",
-  "filesToModify": [],
-  "dependsOn": [],
-  "priority": 2,
-  "status": "completed",
-  "retryCount": 0
-}

package/src/modules/persistence/__tests__/.tmp-stores-test-88026/queue/pending/task-1.json

@@ -1,13 +0,0 @@
-{
-  "taskId": "task-1",
-  "title": "FS Test Task",
-  "description": "A filesystem test task",
-  "filesToModify": [
-    "file1.ts",
-    "file2.ts"
-  ],
-  "dependsOn": [],
-  "priority": 1,
-  "status": "pending",
-  "retryCount": 0
-}