claude-flow 3.32.9 → 3.32.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (451) hide show
  1. package/.claude/.proven-config-version +1 -0
  2. package/.claude/agents/MIGRATION_SUMMARY.md +221 -221
  3. package/.claude/agents/analysis/analyze-code-quality.md +57 -57
  4. package/.claude/agents/analysis/code-analyzer.md +188 -188
  5. package/.claude/agents/analysis/code-review/analyze-code-quality.md +57 -57
  6. package/.claude/agents/architecture/system-design/arch-system-design.md +35 -35
  7. package/.claude/agents/base-template-generator.md +41 -41
  8. package/.claude/agents/consensus/byzantine-coordinator.md +42 -42
  9. package/.claude/agents/consensus/crdt-synchronizer.md +976 -976
  10. package/.claude/agents/consensus/gossip-coordinator.md +42 -42
  11. package/.claude/agents/consensus/performance-benchmarker.md +830 -830
  12. package/.claude/agents/consensus/quorum-manager.md +802 -802
  13. package/.claude/agents/consensus/raft-manager.md +42 -42
  14. package/.claude/agents/consensus/security-manager.md +601 -601
  15. package/.claude/agents/core/coder.md +254 -254
  16. package/.claude/agents/core/planner.md +151 -151
  17. package/.claude/agents/core/researcher.md +173 -173
  18. package/.claude/agents/core/reviewer.md +308 -308
  19. package/.claude/agents/core/tester.md +299 -299
  20. package/.claude/agents/custom/test-long-runner.md +43 -43
  21. package/.claude/agents/data/ml/data-ml-model.md +75 -75
  22. package/.claude/agents/database-specialist.md +9 -9
  23. package/.claude/agents/development/backend/dev-backend-api.md +28 -28
  24. package/.claude/agents/development/dev-backend-api.md +177 -177
  25. package/.claude/agents/devops/ci-cd/ops-cicd-github.md +51 -51
  26. package/.claude/agents/documentation/api-docs/docs-api-openapi.md +62 -62
  27. package/.claude/agents/dual-mode/codex-coordinator.md +206 -206
  28. package/.claude/agents/dual-mode/codex-worker.md +190 -190
  29. package/.claude/agents/dual-mode/dual-orchestrator.md +253 -253
  30. package/.claude/agents/flow-nexus/app-store.md +87 -87
  31. package/.claude/agents/flow-nexus/authentication.md +68 -68
  32. package/.claude/agents/flow-nexus/challenges.md +80 -80
  33. package/.claude/agents/flow-nexus/neural-network.md +87 -87
  34. package/.claude/agents/flow-nexus/payments.md +82 -82
  35. package/.claude/agents/flow-nexus/sandbox.md +75 -75
  36. package/.claude/agents/flow-nexus/swarm.md +75 -75
  37. package/.claude/agents/flow-nexus/user-tools.md +95 -95
  38. package/.claude/agents/flow-nexus/workflow.md +83 -83
  39. package/.claude/agents/github/code-review-swarm.md +520 -520
  40. package/.claude/agents/github/github-modes.md +153 -153
  41. package/.claude/agents/github/issue-tracker.md +298 -298
  42. package/.claude/agents/github/multi-repo-swarm.md +524 -524
  43. package/.claude/agents/github/pr-manager.md +162 -162
  44. package/.claude/agents/github/project-board-sync.md +477 -477
  45. package/.claude/agents/github/release-manager.md +337 -337
  46. package/.claude/agents/github/release-swarm.md +550 -550
  47. package/.claude/agents/github/repo-architect.md +364 -364
  48. package/.claude/agents/github/swarm-issue.md +550 -550
  49. package/.claude/agents/github/swarm-pr.md +401 -401
  50. package/.claude/agents/github/sync-coordinator.md +424 -424
  51. package/.claude/agents/github/workflow-automation.md +604 -604
  52. package/.claude/agents/goal/agent.md +816 -816
  53. package/.claude/agents/goal/code-goal-planner.md +444 -444
  54. package/.claude/agents/goal/goal-planner.md +167 -167
  55. package/.claude/agents/hive-mind/collective-intelligence-coordinator.md +128 -128
  56. package/.claude/agents/hive-mind/queen-coordinator.md +201 -201
  57. package/.claude/agents/hive-mind/scout-explorer.md +240 -240
  58. package/.claude/agents/hive-mind/swarm-memory-manager.md +191 -191
  59. package/.claude/agents/hive-mind/worker-specialist.md +215 -215
  60. package/.claude/agents/neural/safla-neural.md +73 -73
  61. package/.claude/agents/optimization/benchmark-suite.md +662 -662
  62. package/.claude/agents/optimization/load-balancer.md +428 -428
  63. package/.claude/agents/optimization/performance-monitor.md +669 -669
  64. package/.claude/agents/optimization/resource-allocator.md +671 -671
  65. package/.claude/agents/optimization/topology-optimizer.md +805 -805
  66. package/.claude/agents/payments/agentic-payments.md +126 -126
  67. package/.claude/agents/project-coordinator.md +8 -8
  68. package/.claude/agents/python-specialist.md +9 -9
  69. package/.claude/agents/reasoning/agent.md +816 -816
  70. package/.claude/agents/reasoning/goal-planner.md +72 -72
  71. package/.claude/agents/security-auditor.md +9 -9
  72. package/.claude/agents/sona/sona-learning-optimizer.md +65 -65
  73. package/.claude/agents/sparc/architecture.md +452 -452
  74. package/.claude/agents/sparc/pseudocode.md +298 -298
  75. package/.claude/agents/sparc/refinement.md +503 -503
  76. package/.claude/agents/sparc/specification.md +257 -257
  77. package/.claude/agents/specialized/mobile/spec-mobile-react-native.md +87 -87
  78. package/.claude/agents/sublinear/consensus-coordinator.md +337 -337
  79. package/.claude/agents/sublinear/matrix-optimizer.md +184 -184
  80. package/.claude/agents/sublinear/pagerank-analyzer.md +298 -298
  81. package/.claude/agents/sublinear/performance-optimizer.md +367 -367
  82. package/.claude/agents/sublinear/trading-predictor.md +245 -245
  83. package/.claude/agents/swarm/adaptive-coordinator.md +363 -363
  84. package/.claude/agents/swarm/hierarchical-coordinator.md +299 -299
  85. package/.claude/agents/swarm/mesh-coordinator.md +362 -362
  86. package/.claude/agents/templates/automation-smart-agent.md +184 -184
  87. package/.claude/agents/templates/coordinator-swarm-init.md +82 -82
  88. package/.claude/agents/templates/github-pr-manager.md +154 -154
  89. package/.claude/agents/templates/implementer-sparc-coder.md +242 -242
  90. package/.claude/agents/templates/memory-coordinator.md +162 -162
  91. package/.claude/agents/templates/migration-plan.md +723 -723
  92. package/.claude/agents/templates/orchestrator-task.md +119 -119
  93. package/.claude/agents/templates/performance-analyzer.md +178 -178
  94. package/.claude/agents/templates/sparc-coordinator.md +162 -162
  95. package/.claude/agents/testing/production-validator.md +372 -372
  96. package/.claude/agents/testing/tdd-london-swarm.md +221 -221
  97. package/.claude/agents/testing/unit/tdd-london-swarm.md +221 -221
  98. package/.claude/agents/testing/validation/production-validator.md +372 -372
  99. package/.claude/agents/typescript-specialist.md +9 -9
  100. package/.claude/agents/v3/database-specialist.md +9 -9
  101. package/.claude/agents/v3/project-coordinator.md +8 -8
  102. package/.claude/agents/v3/python-specialist.md +9 -9
  103. package/.claude/agents/v3/test-architect.md +9 -9
  104. package/.claude/agents/v3/typescript-specialist.md +9 -9
  105. package/.claude/agents/v3/v3-integration-architect.md +311 -311
  106. package/.claude/agents/v3/v3-memory-specialist.md +280 -280
  107. package/.claude/agents/v3/v3-performance-engineer.md +362 -362
  108. package/.claude/agents/v3/v3-queen-coordinator.md +62 -62
  109. package/.claude/agents/v3/v3-security-architect.md +139 -139
  110. package/.claude/checkpoints/1767754460.json +8 -8
  111. package/.claude/commands/agents/README.md +10 -10
  112. package/.claude/commands/agents/agent-capabilities.md +21 -21
  113. package/.claude/commands/agents/agent-coordination.md +28 -28
  114. package/.claude/commands/agents/agent-spawning.md +28 -28
  115. package/.claude/commands/agents/agent-types.md +26 -26
  116. package/.claude/commands/analysis/COMMAND_COMPLIANCE_REPORT.md +53 -53
  117. package/.claude/commands/analysis/README.md +9 -9
  118. package/.claude/commands/analysis/bottleneck-detect.md +162 -162
  119. package/.claude/commands/analysis/performance-bottlenecks.md +58 -58
  120. package/.claude/commands/analysis/performance-report.md +25 -25
  121. package/.claude/commands/analysis/token-efficiency.md +44 -44
  122. package/.claude/commands/analysis/token-usage.md +25 -25
  123. package/.claude/commands/automation/README.md +9 -9
  124. package/.claude/commands/automation/auto-agent.md +122 -122
  125. package/.claude/commands/automation/self-healing.md +105 -105
  126. package/.claude/commands/automation/session-memory.md +89 -89
  127. package/.claude/commands/automation/smart-agents.md +72 -72
  128. package/.claude/commands/automation/smart-spawn.md +25 -25
  129. package/.claude/commands/automation/workflow-select.md +25 -25
  130. package/.claude/commands/claude-flow-help.md +103 -103
  131. package/.claude/commands/claude-flow-memory.md +107 -107
  132. package/.claude/commands/claude-flow-swarm.md +205 -205
  133. package/.claude/commands/coordination/README.md +9 -9
  134. package/.claude/commands/coordination/agent-spawn.md +25 -25
  135. package/.claude/commands/coordination/init.md +44 -44
  136. package/.claude/commands/coordination/orchestrate.md +43 -43
  137. package/.claude/commands/coordination/spawn.md +45 -45
  138. package/.claude/commands/coordination/swarm-init.md +85 -85
  139. package/.claude/commands/coordination/task-orchestrate.md +25 -25
  140. package/.claude/commands/flow-nexus/app-store.md +123 -123
  141. package/.claude/commands/flow-nexus/challenges.md +119 -119
  142. package/.claude/commands/flow-nexus/login-registration.md +64 -64
  143. package/.claude/commands/flow-nexus/neural-network.md +133 -133
  144. package/.claude/commands/flow-nexus/payments.md +115 -115
  145. package/.claude/commands/flow-nexus/sandbox.md +82 -82
  146. package/.claude/commands/flow-nexus/swarm.md +86 -86
  147. package/.claude/commands/flow-nexus/user-tools.md +151 -151
  148. package/.claude/commands/flow-nexus/workflow.md +114 -114
  149. package/.claude/commands/github/README.md +11 -11
  150. package/.claude/commands/github/code-review-swarm.md +513 -513
  151. package/.claude/commands/github/code-review.md +25 -25
  152. package/.claude/commands/github/github-modes.md +146 -146
  153. package/.claude/commands/github/github-swarm.md +121 -121
  154. package/.claude/commands/github/issue-tracker.md +291 -291
  155. package/.claude/commands/github/issue-triage.md +25 -25
  156. package/.claude/commands/github/multi-repo-swarm.md +518 -518
  157. package/.claude/commands/github/pr-enhance.md +26 -26
  158. package/.claude/commands/github/pr-manager.md +169 -169
  159. package/.claude/commands/github/project-board-sync.md +470 -470
  160. package/.claude/commands/github/release-manager.md +337 -337
  161. package/.claude/commands/github/release-swarm.md +543 -543
  162. package/.claude/commands/github/repo-analyze.md +25 -25
  163. package/.claude/commands/github/repo-architect.md +366 -366
  164. package/.claude/commands/github/swarm-issue.md +481 -481
  165. package/.claude/commands/github/swarm-pr.md +284 -284
  166. package/.claude/commands/github/sync-coordinator.md +300 -300
  167. package/.claude/commands/github/workflow-automation.md +441 -441
  168. package/.claude/commands/hive-mind/README.md +17 -17
  169. package/.claude/commands/hive-mind/hive-mind-consensus.md +8 -8
  170. package/.claude/commands/hive-mind/hive-mind-init.md +18 -18
  171. package/.claude/commands/hive-mind/hive-mind-memory.md +8 -8
  172. package/.claude/commands/hive-mind/hive-mind-metrics.md +8 -8
  173. package/.claude/commands/hive-mind/hive-mind-resume.md +8 -8
  174. package/.claude/commands/hive-mind/hive-mind-sessions.md +8 -8
  175. package/.claude/commands/hive-mind/hive-mind-spawn.md +21 -21
  176. package/.claude/commands/hive-mind/hive-mind-status.md +8 -8
  177. package/.claude/commands/hive-mind/hive-mind-stop.md +8 -8
  178. package/.claude/commands/hive-mind/hive-mind-wizard.md +8 -8
  179. package/.claude/commands/hive-mind/hive-mind.md +27 -27
  180. package/.claude/commands/hooks/README.md +11 -11
  181. package/.claude/commands/hooks/overview.md +57 -57
  182. package/.claude/commands/hooks/post-edit.md +117 -117
  183. package/.claude/commands/hooks/post-task.md +112 -112
  184. package/.claude/commands/hooks/pre-edit.md +113 -113
  185. package/.claude/commands/hooks/pre-task.md +111 -111
  186. package/.claude/commands/hooks/session-end.md +118 -118
  187. package/.claude/commands/hooks/setup.md +102 -102
  188. package/.claude/commands/memory/README.md +9 -9
  189. package/.claude/commands/memory/memory-persist.md +25 -25
  190. package/.claude/commands/memory/memory-search.md +25 -25
  191. package/.claude/commands/memory/memory-usage.md +25 -25
  192. package/.claude/commands/memory/neural.md +47 -47
  193. package/.claude/commands/monitoring/README.md +9 -9
  194. package/.claude/commands/monitoring/agent-metrics.md +25 -25
  195. package/.claude/commands/monitoring/agents.md +44 -44
  196. package/.claude/commands/monitoring/real-time-view.md +25 -25
  197. package/.claude/commands/monitoring/status.md +46 -46
  198. package/.claude/commands/monitoring/swarm-monitor.md +25 -25
  199. package/.claude/commands/optimization/README.md +9 -9
  200. package/.claude/commands/optimization/auto-topology.md +61 -61
  201. package/.claude/commands/optimization/cache-manage.md +25 -25
  202. package/.claude/commands/optimization/parallel-execute.md +25 -25
  203. package/.claude/commands/optimization/parallel-execution.md +49 -49
  204. package/.claude/commands/optimization/topology-optimize.md +25 -25
  205. package/.claude/commands/pair/README.md +260 -260
  206. package/.claude/commands/pair/commands.md +545 -545
  207. package/.claude/commands/pair/config.md +509 -509
  208. package/.claude/commands/pair/examples.md +511 -511
  209. package/.claude/commands/pair/modes.md +347 -347
  210. package/.claude/commands/pair/session.md +406 -406
  211. package/.claude/commands/pair/start.md +208 -208
  212. package/.claude/commands/sparc/analyzer.md +51 -51
  213. package/.claude/commands/sparc/architect.md +53 -53
  214. package/.claude/commands/sparc/ask.md +97 -97
  215. package/.claude/commands/sparc/batch-executor.md +54 -54
  216. package/.claude/commands/sparc/code.md +89 -89
  217. package/.claude/commands/sparc/coder.md +54 -54
  218. package/.claude/commands/sparc/debug.md +83 -83
  219. package/.claude/commands/sparc/debugger.md +54 -54
  220. package/.claude/commands/sparc/designer.md +53 -53
  221. package/.claude/commands/sparc/devops.md +109 -109
  222. package/.claude/commands/sparc/docs-writer.md +80 -80
  223. package/.claude/commands/sparc/documenter.md +54 -54
  224. package/.claude/commands/sparc/innovator.md +54 -54
  225. package/.claude/commands/sparc/integration.md +83 -83
  226. package/.claude/commands/sparc/mcp.md +117 -117
  227. package/.claude/commands/sparc/memory-manager.md +54 -54
  228. package/.claude/commands/sparc/optimizer.md +54 -54
  229. package/.claude/commands/sparc/orchestrator.md +131 -131
  230. package/.claude/commands/sparc/post-deployment-monitoring-mode.md +83 -83
  231. package/.claude/commands/sparc/refinement-optimization-mode.md +83 -83
  232. package/.claude/commands/sparc/researcher.md +54 -54
  233. package/.claude/commands/sparc/reviewer.md +54 -54
  234. package/.claude/commands/sparc/security-review.md +80 -80
  235. package/.claude/commands/sparc/sparc-modes.md +174 -174
  236. package/.claude/commands/sparc/sparc.md +111 -111
  237. package/.claude/commands/sparc/spec-pseudocode.md +80 -80
  238. package/.claude/commands/sparc/supabase-admin.md +348 -348
  239. package/.claude/commands/sparc/swarm-coordinator.md +54 -54
  240. package/.claude/commands/sparc/tdd.md +54 -54
  241. package/.claude/commands/sparc/tester.md +54 -54
  242. package/.claude/commands/sparc/tutorial.md +79 -79
  243. package/.claude/commands/sparc/workflow-manager.md +54 -54
  244. package/.claude/commands/sparc.md +166 -166
  245. package/.claude/commands/stream-chain/pipeline.md +120 -120
  246. package/.claude/commands/stream-chain/run.md +69 -69
  247. package/.claude/commands/swarm/README.md +15 -15
  248. package/.claude/commands/swarm/analysis.md +95 -95
  249. package/.claude/commands/swarm/development.md +96 -96
  250. package/.claude/commands/swarm/examples.md +168 -168
  251. package/.claude/commands/swarm/maintenance.md +102 -102
  252. package/.claude/commands/swarm/optimization.md +117 -117
  253. package/.claude/commands/swarm/research.md +136 -136
  254. package/.claude/commands/swarm/swarm-analysis.md +8 -8
  255. package/.claude/commands/swarm/swarm-background.md +8 -8
  256. package/.claude/commands/swarm/swarm-init.md +19 -19
  257. package/.claude/commands/swarm/swarm-modes.md +8 -8
  258. package/.claude/commands/swarm/swarm-monitor.md +8 -8
  259. package/.claude/commands/swarm/swarm-spawn.md +19 -19
  260. package/.claude/commands/swarm/swarm-status.md +8 -8
  261. package/.claude/commands/swarm/swarm-strategies.md +8 -8
  262. package/.claude/commands/swarm/swarm.md +27 -27
  263. package/.claude/commands/swarm/testing.md +131 -131
  264. package/.claude/commands/training/README.md +9 -9
  265. package/.claude/commands/training/model-update.md +25 -25
  266. package/.claude/commands/training/neural-patterns.md +73 -73
  267. package/.claude/commands/training/neural-train.md +25 -25
  268. package/.claude/commands/training/pattern-learn.md +25 -25
  269. package/.claude/commands/training/specialization.md +62 -62
  270. package/.claude/commands/truth/start.md +142 -142
  271. package/.claude/commands/verify/check.md +49 -49
  272. package/.claude/commands/verify/start.md +127 -127
  273. package/.claude/commands/workflows/README.md +9 -9
  274. package/.claude/commands/workflows/development.md +77 -77
  275. package/.claude/commands/workflows/research.md +62 -62
  276. package/.claude/commands/workflows/workflow-create.md +25 -25
  277. package/.claude/commands/workflows/workflow-execute.md +25 -25
  278. package/.claude/commands/workflows/workflow-export.md +25 -25
  279. package/.claude/config/v3-dependency-optimization.json +265 -265
  280. package/.claude/config/v3-performance-targets.json +250 -250
  281. package/.claude/helpers/.LOCKED +2 -2
  282. package/.claude/helpers/.helpers-version +1 -0
  283. package/.claude/helpers/README.md +96 -96
  284. package/.claude/helpers/adr-compliance.sh +186 -186
  285. package/.claude/helpers/aggressive-microcompact.mjs +36 -36
  286. package/.claude/helpers/auto-commit.sh +178 -178
  287. package/.claude/helpers/auto-memory-hook.mjs +430 -430
  288. package/.claude/helpers/checkpoint-manager.sh +251 -251
  289. package/.claude/helpers/context-persistence-hook.mjs +2001 -2001
  290. package/.claude/helpers/daemon-manager.sh +252 -252
  291. package/.claude/helpers/ddd-tracker.sh +144 -144
  292. package/.claude/helpers/github-safe.js +156 -156
  293. package/.claude/helpers/github-setup.sh +45 -45
  294. package/.claude/helpers/guidance-hook.sh +13 -13
  295. package/.claude/helpers/guidance-hooks.sh +102 -102
  296. package/.claude/helpers/health-monitor.sh +108 -108
  297. package/.claude/helpers/helpers.manifest.json +13 -0
  298. package/.claude/helpers/hook-handler.cjs +464 -464
  299. package/.claude/helpers/intelligence.cjs +1058 -1058
  300. package/.claude/helpers/learning-hooks.sh +329 -329
  301. package/.claude/helpers/learning-optimizer.sh +127 -127
  302. package/.claude/helpers/learning-service.mjs +1144 -1144
  303. package/.claude/helpers/memory.cjs +84 -84
  304. package/.claude/helpers/metrics-db.mjs +503 -503
  305. package/.claude/helpers/patch-aggressive-prune.mjs +184 -184
  306. package/.claude/helpers/pattern-consolidator.sh +86 -86
  307. package/.claude/helpers/perf-worker.sh +160 -160
  308. package/.claude/helpers/quick-start.sh +19 -19
  309. package/.claude/helpers/router.cjs +62 -62
  310. package/.claude/helpers/security-scanner.sh +127 -127
  311. package/.claude/helpers/session.cjs +125 -125
  312. package/.claude/helpers/setup-mcp.sh +18 -18
  313. package/.claude/helpers/standard-checkpoint-hooks.sh +189 -189
  314. package/.claude/helpers/statusline.cjs +156 -1
  315. package/.claude/helpers/swarm-comms.sh +353 -353
  316. package/.claude/helpers/swarm-hooks.sh +761 -761
  317. package/.claude/helpers/swarm-monitor.sh +210 -210
  318. package/.claude/helpers/sync-v3-metrics.sh +245 -245
  319. package/.claude/helpers/update-v3-progress.sh +165 -165
  320. package/.claude/helpers/v3-quick-status.sh +57 -57
  321. package/.claude/helpers/v3.sh +110 -110
  322. package/.claude/helpers/validate-v3-config.sh +215 -215
  323. package/.claude/helpers/worker-manager.sh +170 -170
  324. package/.claude/mcp.json +12 -12
  325. package/.claude/proven-config.json +42 -0
  326. package/.claude/settings.json +284 -284
  327. package/.claude/settings.json.bak +526 -526
  328. package/.claude/skills/agentdb-advanced/SKILL.md +550 -550
  329. package/.claude/skills/agentdb-learning/SKILL.md +545 -545
  330. package/.claude/skills/agentdb-memory-patterns/SKILL.md +339 -339
  331. package/.claude/skills/agentdb-optimization/SKILL.md +509 -509
  332. package/.claude/skills/agentdb-vector-search/SKILL.md +339 -339
  333. package/.claude/skills/agentic-jujutsu/SKILL.md +645 -645
  334. package/.claude/skills/browser/SKILL.md +204 -204
  335. package/.claude/skills/dual-mode/README.md +71 -71
  336. package/.claude/skills/dual-mode/dual-collect.md +103 -103
  337. package/.claude/skills/dual-mode/dual-coordinate.md +85 -85
  338. package/.claude/skills/dual-mode/dual-spawn.md +81 -81
  339. package/.claude/skills/flow-nexus-neural/SKILL.md +727 -727
  340. package/.claude/skills/flow-nexus-platform/SKILL.md +1154 -1154
  341. package/.claude/skills/flow-nexus-swarm/SKILL.md +604 -604
  342. package/.claude/skills/github-code-review/SKILL.md +1125 -1125
  343. package/.claude/skills/github-multi-repo/SKILL.md +862 -862
  344. package/.claude/skills/github-project-management/SKILL.md +1262 -1262
  345. package/.claude/skills/github-release-management/SKILL.md +1064 -1064
  346. package/.claude/skills/github-workflow-automation/SKILL.md +1047 -1047
  347. package/.claude/skills/hive-mind-advanced/SKILL.md +709 -709
  348. package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
  349. package/.claude/skills/pair-programming/SKILL.md +1202 -1202
  350. package/.claude/skills/performance-analysis/SKILL.md +560 -560
  351. package/.claude/skills/reasoningbank-agentdb/SKILL.md +446 -446
  352. package/.claude/skills/reasoningbank-intelligence/SKILL.md +201 -201
  353. package/.claude/skills/skill-builder/SKILL.md +910 -910
  354. package/.claude/skills/sparc-methodology/SKILL.md +1106 -1106
  355. package/.claude/skills/stream-chain/SKILL.md +560 -560
  356. package/.claude/skills/swarm-advanced/SKILL.md +970 -970
  357. package/.claude/skills/swarm-orchestration/SKILL.md +179 -179
  358. package/.claude/skills/v3-cli-modernization/SKILL.md +871 -871
  359. package/.claude/skills/v3-core-implementation/SKILL.md +796 -796
  360. package/.claude/skills/v3-ddd-architecture/SKILL.md +441 -441
  361. package/.claude/skills/v3-integration-deep/SKILL.md +240 -240
  362. package/.claude/skills/v3-mcp-optimization/SKILL.md +776 -776
  363. package/.claude/skills/v3-memory-unification/SKILL.md +173 -173
  364. package/.claude/skills/v3-performance-optimization/SKILL.md +389 -389
  365. package/.claude/skills/v3-security-overhaul/SKILL.md +81 -81
  366. package/.claude/skills/v3-swarm-coordination/SKILL.md +339 -339
  367. package/.claude/skills/verification-quality/SKILL.md +691 -691
  368. package/.claude/skills/worker-benchmarks/SKILL.md +129 -129
  369. package/.claude/skills/worker-integration/SKILL.md +147 -147
  370. package/.claude/statusline-command.sh +176 -176
  371. package/.claude/statusline.mjs +109 -109
  372. package/.claude/statusline.sh +431 -431
  373. package/.claude/workflows/full-system-test.js +65 -65
  374. package/.claude/workflows/intelligence-system-hardening.js +120 -120
  375. package/.claude/workflows/plugin-contract-audit.js +91 -91
  376. package/.claude-plugin/README.md +720 -720
  377. package/.claude-plugin/docs/INSTALLATION.md +261 -261
  378. package/.claude-plugin/docs/PLUGIN_SUMMARY.md +361 -361
  379. package/.claude-plugin/docs/QUICKSTART.md +361 -361
  380. package/.claude-plugin/docs/STRUCTURE.md +128 -128
  381. package/.claude-plugin/hooks/hooks.json +79 -79
  382. package/.claude-plugin/marketplace.json +185 -185
  383. package/.claude-plugin/plugin.json +71 -71
  384. package/.claude-plugin/scripts/install.sh +234 -234
  385. package/.claude-plugin/scripts/ruflo-hook.cjs +166 -166
  386. package/.claude-plugin/scripts/ruflo-hook.sh +52 -52
  387. package/.claude-plugin/scripts/uninstall.sh +36 -36
  388. package/.claude-plugin/scripts/verify.sh +108 -108
  389. package/LICENSE +21 -21
  390. package/README.md +419 -419
  391. package/bin/cli.js +11 -11
  392. package/bin/npx-repair.js +7 -7
  393. package/bin/npx-safe-launch.js +9 -9
  394. package/package.json +192 -192
  395. package/v3/@claude-flow/cli/README.md +419 -419
  396. package/v3/@claude-flow/cli/bin/cli.js +314 -314
  397. package/v3/@claude-flow/cli/bin/mcp-server.js +224 -224
  398. package/v3/@claude-flow/cli/bin/preinstall.cjs +2 -2
  399. package/v3/@claude-flow/cli/catalog-manifest.json +2 -2
  400. package/v3/@claude-flow/cli/dist/src/autopilot-state.js +24 -7
  401. package/v3/@claude-flow/cli/dist/src/benchmarks/gaia-critic.js +24 -24
  402. package/v3/@claude-flow/cli/dist/src/business-pods/bbs-budget-tracker.js +53 -53
  403. package/v3/@claude-flow/cli/dist/src/commands/completions.js +409 -409
  404. package/v3/@claude-flow/cli/dist/src/commands/daemon.js +44 -44
  405. package/v3/@claude-flow/cli/dist/src/commands/embeddings.js +26 -26
  406. package/v3/@claude-flow/cli/dist/src/commands/hive-mind.js +97 -97
  407. package/v3/@claude-flow/cli/dist/src/commands/hooks.js +31 -10
  408. package/v3/@claude-flow/cli/dist/src/commands/init.js +202 -34
  409. package/v3/@claude-flow/cli/dist/src/commands/memory.js +12 -1
  410. package/v3/@claude-flow/cli/dist/src/commands/ruvector/backup.js +23 -23
  411. package/v3/@claude-flow/cli/dist/src/commands/ruvector/benchmark.js +31 -31
  412. package/v3/@claude-flow/cli/dist/src/commands/ruvector/import.js +14 -14
  413. package/v3/@claude-flow/cli/dist/src/commands/ruvector/init.js +115 -115
  414. package/v3/@claude-flow/cli/dist/src/commands/ruvector/migrate.js +99 -99
  415. package/v3/@claude-flow/cli/dist/src/commands/ruvector/optimize.js +51 -51
  416. package/v3/@claude-flow/cli/dist/src/commands/ruvector/setup.js +624 -624
  417. package/v3/@claude-flow/cli/dist/src/commands/ruvector/status.js +38 -38
  418. package/v3/@claude-flow/cli/dist/src/config/proven-config.js +2 -2
  419. package/v3/@claude-flow/cli/dist/src/funnel/disclosure.js +13 -2
  420. package/v3/@claude-flow/cli/dist/src/funnel/messages.d.ts +12 -10
  421. package/v3/@claude-flow/cli/dist/src/funnel/messages.js +83 -11
  422. package/v3/@claude-flow/cli/dist/src/init/claudemd-generator.js +231 -231
  423. package/v3/@claude-flow/cli/dist/src/init/executor.js +453 -453
  424. package/v3/@claude-flow/cli/dist/src/init/helper-signing.js +2 -2
  425. package/v3/@claude-flow/cli/dist/src/init/helpers-generator.js +751 -751
  426. package/v3/@claude-flow/cli/dist/src/init/statusline-generator.js +24 -24
  427. package/v3/@claude-flow/cli/dist/src/mcp-tools/agentdb-tools.js +15 -15
  428. package/v3/@claude-flow/cli/dist/src/mcp-tools/browser-intent-tools.js +19 -19
  429. package/v3/@claude-flow/cli/dist/src/mcp-tools/browser-tools.js +8 -0
  430. package/v3/@claude-flow/cli/dist/src/mcp-tools/hooks-tools.js +21 -0
  431. package/v3/@claude-flow/cli/dist/src/mcp-tools/memory-tools.js +4 -3
  432. package/v3/@claude-flow/cli/dist/src/memory/graph-edge-writer.js +22 -22
  433. package/v3/@claude-flow/cli/dist/src/memory/memory-bridge.js +248 -158
  434. package/v3/@claude-flow/cli/dist/src/memory/memory-initializer.js +407 -407
  435. package/v3/@claude-flow/cli/dist/src/memory/rabitq-index.js +5 -5
  436. package/v3/@claude-flow/cli/dist/src/parser.js +25 -9
  437. package/v3/@claude-flow/cli/dist/src/proxy/verify.js +2 -2
  438. package/v3/@claude-flow/cli/dist/src/runtime/headless.js +28 -28
  439. package/v3/@claude-flow/cli/dist/src/services/distill-tuning.js +7 -7
  440. package/v3/@claude-flow/cli/dist/src/services/headless-worker-executor.js +84 -84
  441. package/v3/@claude-flow/cli/dist/src/services/memory-distillation.js +4 -4
  442. package/v3/@claude-flow/cli/dist/src/services/worker-daemon.js +7 -4
  443. package/v3/@claude-flow/cli/dist/src/transfer/deploy-seraphine.js +23 -23
  444. package/v3/@claude-flow/cli/package.json +137 -137
  445. package/v3/@claude-flow/guidance/README.md +1195 -1195
  446. package/v3/@claude-flow/guidance/package.json +198 -198
  447. package/v3/@claude-flow/shared/README.md +323 -323
  448. package/v3/@claude-flow/shared/dist/events/event-store.js +31 -31
  449. package/v3/@claude-flow/shared/dist/hooks/safety/git-commit.js +3 -3
  450. package/v3/@claude-flow/shared/package.json +43 -43
  451. package/v3/README.md +493 -493
@@ -1,478 +1,478 @@
1
- ---
2
- name: project-board-sync
3
- description: |
4
- Synchronize AI swarms with GitHub Projects for visual task management, progress tracking, and team coordination
5
- tools: Bash, Read, Write, Edit, Glob, Grep, LS, TodoWrite, mcp__claude-flow__swarm_init, mcp__claude-flow__agent_spawn, mcp__claude-flow__task_orchestrate, mcp__claude-flow__swarm_status, mcp__claude-flow__memory_usage, mcp__claude-flow__github_repo_analyze, mcp__claude-flow__github_pr_manage, mcp__claude-flow__github_issue_track, mcp__claude-flow__github_metrics, mcp__claude-flow__workflow_create, mcp__claude-flow__workflow_execute
6
- ---
7
-
8
- # Project Board Sync - GitHub Projects Integration
9
-
10
- ## Overview
11
- Synchronize AI swarms with GitHub Projects for visual task management, progress tracking, and team coordination.
12
-
13
- ## Core Features
14
-
15
- ### 1. Board Initialization
16
- ```bash
17
- # Connect swarm to GitHub Project using gh CLI
18
- # Get project details
19
- PROJECT_ID=$(gh project list --owner @me --format json | \
20
- jq -r '.projects[] | select(.title == "Development Board") | .id')
21
-
22
- # Initialize swarm with project
23
- npx ruv-swarm github board-init \
24
- --project-id "$PROJECT_ID" \
25
- --sync-mode "bidirectional" \
26
- --create-views "swarm-status,agent-workload,priority"
27
-
28
- # Create project fields for swarm tracking
29
- gh project field-create $PROJECT_ID --owner @me \
30
- --name "Swarm Status" \
31
- --data-type "SINGLE_SELECT" \
32
- --single-select-options "pending,in_progress,completed"
33
- ```
34
-
35
- ### 2. Task Synchronization
36
- ```bash
37
- # Sync swarm tasks with project cards
38
- npx ruv-swarm github board-sync \
39
- --map-status '{
40
- "todo": "To Do",
41
- "in_progress": "In Progress",
42
- "review": "Review",
43
- "done": "Done"
44
- }' \
45
- --auto-move-cards \
46
- --update-metadata
47
- ```
48
-
49
- ### 3. Real-time Updates
50
- ```bash
51
- # Enable real-time board updates
52
- npx ruv-swarm github board-realtime \
53
- --webhook-endpoint "https://api.example.com/github-sync" \
54
- --update-frequency "immediate" \
55
- --batch-updates false
56
- ```
57
-
58
- ## Configuration
59
-
60
- ### Board Mapping Configuration
61
- ```yaml
62
- # .github/board-sync.yml
63
- version: 1
64
- project:
65
- name: "AI Development Board"
66
- number: 1
67
-
68
- mapping:
69
- # Map swarm task status to board columns
70
- status:
71
- pending: "Backlog"
72
- assigned: "Ready"
73
- in_progress: "In Progress"
74
- review: "Review"
75
- completed: "Done"
76
- blocked: "Blocked"
77
-
78
- # Map agent types to labels
79
- agents:
80
- coder: "🔧 Development"
81
- tester: "🧪 Testing"
82
- analyst: "📊 Analysis"
83
- designer: "🎨 Design"
84
- architect: "🏗️ Architecture"
85
-
86
- # Map priority to project fields
87
- priority:
88
- critical: "🔴 Critical"
89
- high: "🟡 High"
90
- medium: "🟢 Medium"
91
- low: "⚪ Low"
92
-
93
- # Custom fields
94
- fields:
95
- - name: "Agent Count"
96
- type: number
97
- source: task.agents.length
98
- - name: "Complexity"
99
- type: select
100
- source: task.complexity
101
- - name: "ETA"
102
- type: date
103
- source: task.estimatedCompletion
104
- ```
105
-
106
- ### View Configuration
107
- ```javascript
108
- // Custom board views
109
- {
110
- "views": [
111
- {
112
- "name": "Swarm Overview",
113
- "type": "board",
114
- "groupBy": "status",
115
- "filters": ["is:open"],
116
- "sort": "priority:desc"
117
- },
118
- {
119
- "name": "Agent Workload",
120
- "type": "table",
121
- "groupBy": "assignedAgent",
122
- "columns": ["title", "status", "priority", "eta"],
123
- "sort": "eta:asc"
124
- },
125
- {
126
- "name": "Sprint Progress",
127
- "type": "roadmap",
128
- "dateField": "eta",
129
- "groupBy": "milestone"
130
- }
131
- ]
132
- }
133
- ```
134
-
135
- ## Automation Features
136
-
137
- ### 1. Auto-Assignment
138
- ```bash
139
- # Automatically assign cards to agents
140
- npx ruv-swarm github board-auto-assign \
141
- --strategy "load-balanced" \
142
- --consider "expertise,workload,availability" \
143
- --update-cards
144
- ```
145
-
146
- ### 2. Progress Tracking
147
- ```bash
148
- # Track and visualize progress
149
- npx ruv-swarm github board-progress \
150
- --show "burndown,velocity,cycle-time" \
151
- --time-period "sprint" \
152
- --export-metrics
153
- ```
154
-
155
- ### 3. Smart Card Movement
156
- ```bash
157
- # Intelligent card state transitions
158
- npx ruv-swarm github board-smart-move \
159
- --rules '{
160
- "auto-progress": "when:all-subtasks-done",
161
- "auto-review": "when:tests-pass",
162
- "auto-done": "when:pr-merged"
163
- }'
164
- ```
165
-
166
- ## Board Commands
167
-
168
- ### Create Cards from Issues
169
- ```bash
170
- # Convert issues to project cards using gh CLI
171
- # List issues with label
172
- ISSUES=$(gh issue list --label "enhancement" --json number,title,body)
173
-
174
- # Add issues to project
175
- echo "$ISSUES" | jq -r '.[].number' | while read -r issue; do
176
- gh project item-add $PROJECT_ID --owner @me --url "https://github.com/$GITHUB_REPOSITORY/issues/$issue"
177
- done
178
-
179
- # Process with swarm
180
- npx ruv-swarm github board-import-issues \
181
- --issues "$ISSUES" \
182
- --add-to-column "Backlog" \
183
- --parse-checklist \
184
- --assign-agents
185
- ```
186
-
187
- ### Bulk Operations
188
- ```bash
189
- # Bulk card operations
190
- npx ruv-swarm github board-bulk \
191
- --filter "status:blocked" \
192
- --action "add-label:needs-attention" \
193
- --notify-assignees
194
- ```
195
-
196
- ### Card Templates
197
- ```bash
198
- # Create cards from templates
199
- npx ruv-swarm github board-template \
200
- --template "feature-development" \
201
- --variables '{
202
- "feature": "User Authentication",
203
- "priority": "high",
204
- "agents": ["architect", "coder", "tester"]
205
- }' \
206
- --create-subtasks
207
- ```
208
-
209
- ## Advanced Synchronization
210
-
211
- ### 1. Multi-Board Sync
212
- ```bash
213
- # Sync across multiple boards
214
- npx ruv-swarm github multi-board-sync \
215
- --boards "Development,QA,Release" \
216
- --sync-rules '{
217
- "Development->QA": "when:ready-for-test",
218
- "QA->Release": "when:tests-pass"
219
- }'
220
- ```
221
-
222
- ### 2. Cross-Organization Sync
223
- ```bash
224
- # Sync boards across organizations
225
- npx ruv-swarm github cross-org-sync \
226
- --source "org1/Project-A" \
227
- --target "org2/Project-B" \
228
- --field-mapping "custom" \
229
- --conflict-resolution "source-wins"
230
- ```
231
-
232
- ### 3. External Tool Integration
233
- ```bash
234
- # Sync with external tools
235
- npx ruv-swarm github board-integrate \
236
- --tool "jira" \
237
- --mapping "bidirectional" \
238
- --sync-frequency "5m" \
239
- --transform-rules "custom"
240
- ```
241
-
242
- ## Visualization & Reporting
243
-
244
- ### Board Analytics
245
- ```bash
246
- # Generate board analytics using gh CLI data
247
- # Fetch project data
248
- PROJECT_DATA=$(gh project item-list $PROJECT_ID --owner @me --format json)
249
-
250
- # Get issue metrics
251
- ISSUE_METRICS=$(echo "$PROJECT_DATA" | jq -r '.items[] | select(.content.type == "Issue")' | \
252
- while read -r item; do
253
- ISSUE_NUM=$(echo "$item" | jq -r '.content.number')
254
- gh issue view $ISSUE_NUM --json createdAt,closedAt,labels,assignees
255
- done)
256
-
257
- # Generate analytics with swarm
258
- npx ruv-swarm github board-analytics \
259
- --project-data "$PROJECT_DATA" \
260
- --issue-metrics "$ISSUE_METRICS" \
261
- --metrics "throughput,cycle-time,wip" \
262
- --group-by "agent,priority,type" \
263
- --time-range "30d" \
264
- --export "dashboard"
265
- ```
266
-
267
- ### Custom Dashboards
268
- ```javascript
269
- // Dashboard configuration
270
- {
271
- "dashboard": {
272
- "widgets": [
273
- {
274
- "type": "chart",
275
- "title": "Task Completion Rate",
276
- "data": "completed-per-day",
277
- "visualization": "line"
278
- },
279
- {
280
- "type": "gauge",
281
- "title": "Sprint Progress",
282
- "data": "sprint-completion",
283
- "target": 100
284
- },
285
- {
286
- "type": "heatmap",
287
- "title": "Agent Activity",
288
- "data": "agent-tasks-per-day"
289
- }
290
- ]
291
- }
292
- }
293
- ```
294
-
295
- ### Reports
296
- ```bash
297
- # Generate reports
298
- npx ruv-swarm github board-report \
299
- --type "sprint-summary" \
300
- --format "markdown" \
301
- --include "velocity,burndown,blockers" \
302
- --distribute "slack,email"
303
- ```
304
-
305
- ## Workflow Integration
306
-
307
- ### Sprint Management
308
- ```bash
309
- # Manage sprints with swarms
310
- npx ruv-swarm github sprint-manage \
311
- --sprint "Sprint 23" \
312
- --auto-populate \
313
- --capacity-planning \
314
- --track-velocity
315
- ```
316
-
317
- ### Milestone Tracking
318
- ```bash
319
- # Track milestone progress
320
- npx ruv-swarm github milestone-track \
321
- --milestone "v2.0 Release" \
322
- --update-board \
323
- --show-dependencies \
324
- --predict-completion
325
- ```
326
-
327
- ### Release Planning
328
- ```bash
329
- # Plan releases using board data
330
- npx ruv-swarm github release-plan-board \
331
- --analyze-velocity \
332
- --estimate-completion \
333
- --identify-risks \
334
- --optimize-scope
335
- ```
336
-
337
- ## Team Collaboration
338
-
339
- ### Work Distribution
340
- ```bash
341
- # Distribute work among team
342
- npx ruv-swarm github board-distribute \
343
- --strategy "skills-based" \
344
- --balance-workload \
345
- --respect-preferences \
346
- --notify-assignments
347
- ```
348
-
349
- ### Standup Automation
350
- ```bash
351
- # Generate standup reports
352
- npx ruv-swarm github standup-report \
353
- --team "frontend" \
354
- --include "yesterday,today,blockers" \
355
- --format "slack" \
356
- --schedule "daily-9am"
357
- ```
358
-
359
- ### Review Coordination
360
- ```bash
361
- # Coordinate reviews via board
362
- npx ruv-swarm github review-coordinate \
363
- --board "Code Review" \
364
- --assign-reviewers \
365
- --track-feedback \
366
- --ensure-coverage
367
- ```
368
-
369
- ## Best Practices
370
-
371
- ### 1. Board Organization
372
- - Clear column definitions
373
- - Consistent labeling system
374
- - Regular board grooming
375
- - Automation rules
376
-
377
- ### 2. Data Integrity
378
- - Bidirectional sync validation
379
- - Conflict resolution strategies
380
- - Audit trails
381
- - Regular backups
382
-
383
- ### 3. Team Adoption
384
- - Training materials
385
- - Clear workflows
386
- - Regular reviews
387
- - Feedback loops
388
-
389
- ## Troubleshooting
390
-
391
- ### Sync Issues
392
- ```bash
393
- # Diagnose sync problems
394
- npx ruv-swarm github board-diagnose \
395
- --check "permissions,webhooks,rate-limits" \
396
- --test-sync \
397
- --show-conflicts
398
- ```
399
-
400
- ### Performance
401
- ```bash
402
- # Optimize board performance
403
- npx ruv-swarm github board-optimize \
404
- --analyze-size \
405
- --archive-completed \
406
- --index-fields \
407
- --cache-views
408
- ```
409
-
410
- ### Data Recovery
411
- ```bash
412
- # Recover board data
413
- npx ruv-swarm github board-recover \
414
- --backup-id "2024-01-15" \
415
- --restore-cards \
416
- --preserve-current \
417
- --merge-conflicts
418
- ```
419
-
420
- ## Examples
421
-
422
- ### Agile Development Board
423
- ```bash
424
- # Setup agile board
425
- npx ruv-swarm github agile-board \
426
- --methodology "scrum" \
427
- --sprint-length "2w" \
428
- --ceremonies "planning,review,retro" \
429
- --metrics "velocity,burndown"
430
- ```
431
-
432
- ### Kanban Flow Board
433
- ```bash
434
- # Setup kanban board
435
- npx ruv-swarm github kanban-board \
436
- --wip-limits '{
437
- "In Progress": 5,
438
- "Review": 3
439
- }' \
440
- --cycle-time-tracking \
441
- --continuous-flow
442
- ```
443
-
444
- ### Research Project Board
445
- ```bash
446
- # Setup research board
447
- npx ruv-swarm github research-board \
448
- --phases "ideation,research,experiment,analysis,publish" \
449
- --track-citations \
450
- --collaborate-external
451
- ```
452
-
453
- ## Metrics & KPIs
454
-
455
- ### Performance Metrics
456
- ```bash
457
- # Track board performance
458
- npx ruv-swarm github board-kpis \
459
- --metrics '[
460
- "average-cycle-time",
461
- "throughput-per-sprint",
462
- "blocked-time-percentage",
463
- "first-time-pass-rate"
464
- ]' \
465
- --dashboard-url
466
- ```
467
-
468
- ### Team Metrics
469
- ```bash
470
- # Track team performance
471
- npx ruv-swarm github team-metrics \
472
- --board "Development" \
473
- --per-member \
474
- --include "velocity,quality,collaboration" \
475
- --anonymous-option
476
- ```
477
-
1
+ ---
2
+ name: project-board-sync
3
+ description: |
4
+ Synchronize AI swarms with GitHub Projects for visual task management, progress tracking, and team coordination
5
+ tools: Bash, Read, Write, Edit, Glob, Grep, LS, TodoWrite, mcp__claude-flow__swarm_init, mcp__claude-flow__agent_spawn, mcp__claude-flow__task_orchestrate, mcp__claude-flow__swarm_status, mcp__claude-flow__memory_usage, mcp__claude-flow__github_repo_analyze, mcp__claude-flow__github_pr_manage, mcp__claude-flow__github_issue_track, mcp__claude-flow__github_metrics, mcp__claude-flow__workflow_create, mcp__claude-flow__workflow_execute
6
+ ---
7
+
8
+ # Project Board Sync - GitHub Projects Integration
9
+
10
+ ## Overview
11
+ Synchronize AI swarms with GitHub Projects for visual task management, progress tracking, and team coordination.
12
+
13
+ ## Core Features
14
+
15
+ ### 1. Board Initialization
16
+ ```bash
17
+ # Connect swarm to GitHub Project using gh CLI
18
+ # Get project details
19
+ PROJECT_ID=$(gh project list --owner @me --format json | \
20
+ jq -r '.projects[] | select(.title == "Development Board") | .id')
21
+
22
+ # Initialize swarm with project
23
+ npx ruv-swarm github board-init \
24
+ --project-id "$PROJECT_ID" \
25
+ --sync-mode "bidirectional" \
26
+ --create-views "swarm-status,agent-workload,priority"
27
+
28
+ # Create project fields for swarm tracking
29
+ gh project field-create $PROJECT_ID --owner @me \
30
+ --name "Swarm Status" \
31
+ --data-type "SINGLE_SELECT" \
32
+ --single-select-options "pending,in_progress,completed"
33
+ ```
34
+
35
+ ### 2. Task Synchronization
36
+ ```bash
37
+ # Sync swarm tasks with project cards
38
+ npx ruv-swarm github board-sync \
39
+ --map-status '{
40
+ "todo": "To Do",
41
+ "in_progress": "In Progress",
42
+ "review": "Review",
43
+ "done": "Done"
44
+ }' \
45
+ --auto-move-cards \
46
+ --update-metadata
47
+ ```
48
+
49
+ ### 3. Real-time Updates
50
+ ```bash
51
+ # Enable real-time board updates
52
+ npx ruv-swarm github board-realtime \
53
+ --webhook-endpoint "https://api.example.com/github-sync" \
54
+ --update-frequency "immediate" \
55
+ --batch-updates false
56
+ ```
57
+
58
+ ## Configuration
59
+
60
+ ### Board Mapping Configuration
61
+ ```yaml
62
+ # .github/board-sync.yml
63
+ version: 1
64
+ project:
65
+ name: "AI Development Board"
66
+ number: 1
67
+
68
+ mapping:
69
+ # Map swarm task status to board columns
70
+ status:
71
+ pending: "Backlog"
72
+ assigned: "Ready"
73
+ in_progress: "In Progress"
74
+ review: "Review"
75
+ completed: "Done"
76
+ blocked: "Blocked"
77
+
78
+ # Map agent types to labels
79
+ agents:
80
+ coder: "🔧 Development"
81
+ tester: "🧪 Testing"
82
+ analyst: "📊 Analysis"
83
+ designer: "🎨 Design"
84
+ architect: "🏗️ Architecture"
85
+
86
+ # Map priority to project fields
87
+ priority:
88
+ critical: "🔴 Critical"
89
+ high: "🟡 High"
90
+ medium: "🟢 Medium"
91
+ low: "⚪ Low"
92
+
93
+ # Custom fields
94
+ fields:
95
+ - name: "Agent Count"
96
+ type: number
97
+ source: task.agents.length
98
+ - name: "Complexity"
99
+ type: select
100
+ source: task.complexity
101
+ - name: "ETA"
102
+ type: date
103
+ source: task.estimatedCompletion
104
+ ```
105
+
106
+ ### View Configuration
107
+ ```javascript
108
+ // Custom board views
109
+ {
110
+ "views": [
111
+ {
112
+ "name": "Swarm Overview",
113
+ "type": "board",
114
+ "groupBy": "status",
115
+ "filters": ["is:open"],
116
+ "sort": "priority:desc"
117
+ },
118
+ {
119
+ "name": "Agent Workload",
120
+ "type": "table",
121
+ "groupBy": "assignedAgent",
122
+ "columns": ["title", "status", "priority", "eta"],
123
+ "sort": "eta:asc"
124
+ },
125
+ {
126
+ "name": "Sprint Progress",
127
+ "type": "roadmap",
128
+ "dateField": "eta",
129
+ "groupBy": "milestone"
130
+ }
131
+ ]
132
+ }
133
+ ```
134
+
135
+ ## Automation Features
136
+
137
+ ### 1. Auto-Assignment
138
+ ```bash
139
+ # Automatically assign cards to agents
140
+ npx ruv-swarm github board-auto-assign \
141
+ --strategy "load-balanced" \
142
+ --consider "expertise,workload,availability" \
143
+ --update-cards
144
+ ```
145
+
146
+ ### 2. Progress Tracking
147
+ ```bash
148
+ # Track and visualize progress
149
+ npx ruv-swarm github board-progress \
150
+ --show "burndown,velocity,cycle-time" \
151
+ --time-period "sprint" \
152
+ --export-metrics
153
+ ```
154
+
155
+ ### 3. Smart Card Movement
156
+ ```bash
157
+ # Intelligent card state transitions
158
+ npx ruv-swarm github board-smart-move \
159
+ --rules '{
160
+ "auto-progress": "when:all-subtasks-done",
161
+ "auto-review": "when:tests-pass",
162
+ "auto-done": "when:pr-merged"
163
+ }'
164
+ ```
165
+
166
+ ## Board Commands
167
+
168
+ ### Create Cards from Issues
169
+ ```bash
170
+ # Convert issues to project cards using gh CLI
171
+ # List issues with label
172
+ ISSUES=$(gh issue list --label "enhancement" --json number,title,body)
173
+
174
+ # Add issues to project
175
+ echo "$ISSUES" | jq -r '.[].number' | while read -r issue; do
176
+ gh project item-add $PROJECT_ID --owner @me --url "https://github.com/$GITHUB_REPOSITORY/issues/$issue"
177
+ done
178
+
179
+ # Process with swarm
180
+ npx ruv-swarm github board-import-issues \
181
+ --issues "$ISSUES" \
182
+ --add-to-column "Backlog" \
183
+ --parse-checklist \
184
+ --assign-agents
185
+ ```
186
+
187
+ ### Bulk Operations
188
+ ```bash
189
+ # Bulk card operations
190
+ npx ruv-swarm github board-bulk \
191
+ --filter "status:blocked" \
192
+ --action "add-label:needs-attention" \
193
+ --notify-assignees
194
+ ```
195
+
196
+ ### Card Templates
197
+ ```bash
198
+ # Create cards from templates
199
+ npx ruv-swarm github board-template \
200
+ --template "feature-development" \
201
+ --variables '{
202
+ "feature": "User Authentication",
203
+ "priority": "high",
204
+ "agents": ["architect", "coder", "tester"]
205
+ }' \
206
+ --create-subtasks
207
+ ```
208
+
209
+ ## Advanced Synchronization
210
+
211
+ ### 1. Multi-Board Sync
212
+ ```bash
213
+ # Sync across multiple boards
214
+ npx ruv-swarm github multi-board-sync \
215
+ --boards "Development,QA,Release" \
216
+ --sync-rules '{
217
+ "Development->QA": "when:ready-for-test",
218
+ "QA->Release": "when:tests-pass"
219
+ }'
220
+ ```
221
+
222
+ ### 2. Cross-Organization Sync
223
+ ```bash
224
+ # Sync boards across organizations
225
+ npx ruv-swarm github cross-org-sync \
226
+ --source "org1/Project-A" \
227
+ --target "org2/Project-B" \
228
+ --field-mapping "custom" \
229
+ --conflict-resolution "source-wins"
230
+ ```
231
+
232
+ ### 3. External Tool Integration
233
+ ```bash
234
+ # Sync with external tools
235
+ npx ruv-swarm github board-integrate \
236
+ --tool "jira" \
237
+ --mapping "bidirectional" \
238
+ --sync-frequency "5m" \
239
+ --transform-rules "custom"
240
+ ```
241
+
242
+ ## Visualization & Reporting
243
+
244
+ ### Board Analytics
245
+ ```bash
246
+ # Generate board analytics using gh CLI data
247
+ # Fetch project data
248
+ PROJECT_DATA=$(gh project item-list $PROJECT_ID --owner @me --format json)
249
+
250
+ # Get issue metrics
251
+ ISSUE_METRICS=$(echo "$PROJECT_DATA" | jq -r '.items[] | select(.content.type == "Issue")' | \
252
+ while read -r item; do
253
+ ISSUE_NUM=$(echo "$item" | jq -r '.content.number')
254
+ gh issue view $ISSUE_NUM --json createdAt,closedAt,labels,assignees
255
+ done)
256
+
257
+ # Generate analytics with swarm
258
+ npx ruv-swarm github board-analytics \
259
+ --project-data "$PROJECT_DATA" \
260
+ --issue-metrics "$ISSUE_METRICS" \
261
+ --metrics "throughput,cycle-time,wip" \
262
+ --group-by "agent,priority,type" \
263
+ --time-range "30d" \
264
+ --export "dashboard"
265
+ ```
266
+
267
+ ### Custom Dashboards
268
+ ```javascript
269
+ // Dashboard configuration
270
+ {
271
+ "dashboard": {
272
+ "widgets": [
273
+ {
274
+ "type": "chart",
275
+ "title": "Task Completion Rate",
276
+ "data": "completed-per-day",
277
+ "visualization": "line"
278
+ },
279
+ {
280
+ "type": "gauge",
281
+ "title": "Sprint Progress",
282
+ "data": "sprint-completion",
283
+ "target": 100
284
+ },
285
+ {
286
+ "type": "heatmap",
287
+ "title": "Agent Activity",
288
+ "data": "agent-tasks-per-day"
289
+ }
290
+ ]
291
+ }
292
+ }
293
+ ```
294
+
295
+ ### Reports
296
+ ```bash
297
+ # Generate reports
298
+ npx ruv-swarm github board-report \
299
+ --type "sprint-summary" \
300
+ --format "markdown" \
301
+ --include "velocity,burndown,blockers" \
302
+ --distribute "slack,email"
303
+ ```
304
+
305
+ ## Workflow Integration
306
+
307
+ ### Sprint Management
308
+ ```bash
309
+ # Manage sprints with swarms
310
+ npx ruv-swarm github sprint-manage \
311
+ --sprint "Sprint 23" \
312
+ --auto-populate \
313
+ --capacity-planning \
314
+ --track-velocity
315
+ ```
316
+
317
+ ### Milestone Tracking
318
+ ```bash
319
+ # Track milestone progress
320
+ npx ruv-swarm github milestone-track \
321
+ --milestone "v2.0 Release" \
322
+ --update-board \
323
+ --show-dependencies \
324
+ --predict-completion
325
+ ```
326
+
327
+ ### Release Planning
328
+ ```bash
329
+ # Plan releases using board data
330
+ npx ruv-swarm github release-plan-board \
331
+ --analyze-velocity \
332
+ --estimate-completion \
333
+ --identify-risks \
334
+ --optimize-scope
335
+ ```
336
+
337
+ ## Team Collaboration
338
+
339
+ ### Work Distribution
340
+ ```bash
341
+ # Distribute work among team
342
+ npx ruv-swarm github board-distribute \
343
+ --strategy "skills-based" \
344
+ --balance-workload \
345
+ --respect-preferences \
346
+ --notify-assignments
347
+ ```
348
+
349
+ ### Standup Automation
350
+ ```bash
351
+ # Generate standup reports
352
+ npx ruv-swarm github standup-report \
353
+ --team "frontend" \
354
+ --include "yesterday,today,blockers" \
355
+ --format "slack" \
356
+ --schedule "daily-9am"
357
+ ```
358
+
359
+ ### Review Coordination
360
+ ```bash
361
+ # Coordinate reviews via board
362
+ npx ruv-swarm github review-coordinate \
363
+ --board "Code Review" \
364
+ --assign-reviewers \
365
+ --track-feedback \
366
+ --ensure-coverage
367
+ ```
368
+
369
+ ## Best Practices
370
+
371
+ ### 1. Board Organization
372
+ - Clear column definitions
373
+ - Consistent labeling system
374
+ - Regular board grooming
375
+ - Automation rules
376
+
377
+ ### 2. Data Integrity
378
+ - Bidirectional sync validation
379
+ - Conflict resolution strategies
380
+ - Audit trails
381
+ - Regular backups
382
+
383
+ ### 3. Team Adoption
384
+ - Training materials
385
+ - Clear workflows
386
+ - Regular reviews
387
+ - Feedback loops
388
+
389
+ ## Troubleshooting
390
+
391
+ ### Sync Issues
392
+ ```bash
393
+ # Diagnose sync problems
394
+ npx ruv-swarm github board-diagnose \
395
+ --check "permissions,webhooks,rate-limits" \
396
+ --test-sync \
397
+ --show-conflicts
398
+ ```
399
+
400
+ ### Performance
401
+ ```bash
402
+ # Optimize board performance
403
+ npx ruv-swarm github board-optimize \
404
+ --analyze-size \
405
+ --archive-completed \
406
+ --index-fields \
407
+ --cache-views
408
+ ```
409
+
410
+ ### Data Recovery
411
+ ```bash
412
+ # Recover board data
413
+ npx ruv-swarm github board-recover \
414
+ --backup-id "2024-01-15" \
415
+ --restore-cards \
416
+ --preserve-current \
417
+ --merge-conflicts
418
+ ```
419
+
420
+ ## Examples
421
+
422
+ ### Agile Development Board
423
+ ```bash
424
+ # Setup agile board
425
+ npx ruv-swarm github agile-board \
426
+ --methodology "scrum" \
427
+ --sprint-length "2w" \
428
+ --ceremonies "planning,review,retro" \
429
+ --metrics "velocity,burndown"
430
+ ```
431
+
432
+ ### Kanban Flow Board
433
+ ```bash
434
+ # Setup kanban board
435
+ npx ruv-swarm github kanban-board \
436
+ --wip-limits '{
437
+ "In Progress": 5,
438
+ "Review": 3
439
+ }' \
440
+ --cycle-time-tracking \
441
+ --continuous-flow
442
+ ```
443
+
444
+ ### Research Project Board
445
+ ```bash
446
+ # Setup research board
447
+ npx ruv-swarm github research-board \
448
+ --phases "ideation,research,experiment,analysis,publish" \
449
+ --track-citations \
450
+ --collaborate-external
451
+ ```
452
+
453
+ ## Metrics & KPIs
454
+
455
+ ### Performance Metrics
456
+ ```bash
457
+ # Track board performance
458
+ npx ruv-swarm github board-kpis \
459
+ --metrics '[
460
+ "average-cycle-time",
461
+ "throughput-per-sprint",
462
+ "blocked-time-percentage",
463
+ "first-time-pass-rate"
464
+ ]' \
465
+ --dashboard-url
466
+ ```
467
+
468
+ ### Team Metrics
469
+ ```bash
470
+ # Track team performance
471
+ npx ruv-swarm github team-metrics \
472
+ --board "Development" \
473
+ --per-member \
474
+ --include "velocity,quality,collaboration" \
475
+ --anonymous-option
476
+ ```
477
+
478
478
  See also: [swarm-issue.md](./swarm-issue.md), [multi-repo-swarm.md](./multi-repo-swarm.md)