claude-flow 3.7.0-alpha.11 → 3.7.0-alpha.13

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 (430) hide show
  1. package/.claude/agents/MIGRATION_SUMMARY.md +221 -221
  2. package/.claude/agents/analysis/analyze-code-quality.md +57 -57
  3. package/.claude/agents/analysis/code-analyzer.md +188 -188
  4. package/.claude/agents/analysis/code-review/analyze-code-quality.md +57 -57
  5. package/.claude/agents/architecture/system-design/arch-system-design.md +35 -35
  6. package/.claude/agents/base-template-generator.md +41 -41
  7. package/.claude/agents/consensus/byzantine-coordinator.md +42 -42
  8. package/.claude/agents/consensus/crdt-synchronizer.md +976 -976
  9. package/.claude/agents/consensus/gossip-coordinator.md +42 -42
  10. package/.claude/agents/consensus/performance-benchmarker.md +830 -830
  11. package/.claude/agents/consensus/quorum-manager.md +802 -802
  12. package/.claude/agents/consensus/raft-manager.md +42 -42
  13. package/.claude/agents/consensus/security-manager.md +601 -601
  14. package/.claude/agents/core/coder.md +254 -254
  15. package/.claude/agents/core/planner.md +151 -151
  16. package/.claude/agents/core/researcher.md +173 -173
  17. package/.claude/agents/core/reviewer.md +308 -308
  18. package/.claude/agents/core/tester.md +299 -299
  19. package/.claude/agents/custom/test-long-runner.md +43 -43
  20. package/.claude/agents/data/ml/data-ml-model.md +75 -75
  21. package/.claude/agents/database-specialist.md +9 -9
  22. package/.claude/agents/development/backend/dev-backend-api.md +28 -28
  23. package/.claude/agents/development/dev-backend-api.md +177 -177
  24. package/.claude/agents/devops/ci-cd/ops-cicd-github.md +51 -51
  25. package/.claude/agents/documentation/api-docs/docs-api-openapi.md +62 -62
  26. package/.claude/agents/dual-mode/codex-coordinator.md +201 -201
  27. package/.claude/agents/dual-mode/codex-worker.md +183 -183
  28. package/.claude/agents/dual-mode/dual-orchestrator.md +253 -253
  29. package/.claude/agents/flow-nexus/app-store.md +87 -87
  30. package/.claude/agents/flow-nexus/authentication.md +68 -68
  31. package/.claude/agents/flow-nexus/challenges.md +80 -80
  32. package/.claude/agents/flow-nexus/neural-network.md +87 -87
  33. package/.claude/agents/flow-nexus/payments.md +82 -82
  34. package/.claude/agents/flow-nexus/sandbox.md +75 -75
  35. package/.claude/agents/flow-nexus/swarm.md +75 -75
  36. package/.claude/agents/flow-nexus/user-tools.md +95 -95
  37. package/.claude/agents/flow-nexus/workflow.md +83 -83
  38. package/.claude/agents/github/code-review-swarm.md +520 -520
  39. package/.claude/agents/github/github-modes.md +153 -153
  40. package/.claude/agents/github/issue-tracker.md +298 -298
  41. package/.claude/agents/github/multi-repo-swarm.md +524 -524
  42. package/.claude/agents/github/pr-manager.md +162 -162
  43. package/.claude/agents/github/project-board-sync.md +477 -477
  44. package/.claude/agents/github/release-manager.md +335 -335
  45. package/.claude/agents/github/release-swarm.md +550 -550
  46. package/.claude/agents/github/repo-architect.md +364 -364
  47. package/.claude/agents/github/swarm-issue.md +547 -547
  48. package/.claude/agents/github/swarm-pr.md +398 -398
  49. package/.claude/agents/github/sync-coordinator.md +422 -422
  50. package/.claude/agents/github/workflow-automation.md +604 -604
  51. package/.claude/agents/goal/agent.md +816 -816
  52. package/.claude/agents/goal/code-goal-planner.md +444 -444
  53. package/.claude/agents/goal/goal-planner.md +167 -167
  54. package/.claude/agents/hive-mind/collective-intelligence-coordinator.md +128 -128
  55. package/.claude/agents/hive-mind/queen-coordinator.md +201 -201
  56. package/.claude/agents/hive-mind/scout-explorer.md +240 -240
  57. package/.claude/agents/hive-mind/swarm-memory-manager.md +191 -191
  58. package/.claude/agents/hive-mind/worker-specialist.md +215 -215
  59. package/.claude/agents/neural/safla-neural.md +73 -73
  60. package/.claude/agents/optimization/benchmark-suite.md +662 -662
  61. package/.claude/agents/optimization/load-balancer.md +428 -428
  62. package/.claude/agents/optimization/performance-monitor.md +669 -669
  63. package/.claude/agents/optimization/resource-allocator.md +671 -671
  64. package/.claude/agents/optimization/topology-optimizer.md +805 -805
  65. package/.claude/agents/payments/agentic-payments.md +126 -126
  66. package/.claude/agents/project-coordinator.md +8 -8
  67. package/.claude/agents/python-specialist.md +9 -9
  68. package/.claude/agents/reasoning/agent.md +816 -816
  69. package/.claude/agents/reasoning/goal-planner.md +72 -72
  70. package/.claude/agents/security-auditor.md +9 -9
  71. package/.claude/agents/sona/sona-learning-optimizer.md +65 -65
  72. package/.claude/agents/sparc/architecture.md +452 -452
  73. package/.claude/agents/sparc/pseudocode.md +298 -298
  74. package/.claude/agents/sparc/refinement.md +503 -503
  75. package/.claude/agents/sparc/specification.md +257 -257
  76. package/.claude/agents/specialized/mobile/spec-mobile-react-native.md +87 -87
  77. package/.claude/agents/sublinear/consensus-coordinator.md +337 -337
  78. package/.claude/agents/sublinear/matrix-optimizer.md +184 -184
  79. package/.claude/agents/sublinear/pagerank-analyzer.md +298 -298
  80. package/.claude/agents/sublinear/performance-optimizer.md +367 -367
  81. package/.claude/agents/sublinear/trading-predictor.md +245 -245
  82. package/.claude/agents/swarm/adaptive-coordinator.md +363 -363
  83. package/.claude/agents/swarm/hierarchical-coordinator.md +299 -299
  84. package/.claude/agents/swarm/mesh-coordinator.md +362 -362
  85. package/.claude/agents/templates/automation-smart-agent.md +184 -184
  86. package/.claude/agents/templates/coordinator-swarm-init.md +82 -82
  87. package/.claude/agents/templates/github-pr-manager.md +154 -154
  88. package/.claude/agents/templates/implementer-sparc-coder.md +242 -242
  89. package/.claude/agents/templates/memory-coordinator.md +162 -162
  90. package/.claude/agents/templates/migration-plan.md +723 -723
  91. package/.claude/agents/templates/orchestrator-task.md +119 -119
  92. package/.claude/agents/templates/performance-analyzer.md +178 -178
  93. package/.claude/agents/templates/sparc-coordinator.md +162 -162
  94. package/.claude/agents/testing/production-validator.md +372 -372
  95. package/.claude/agents/testing/tdd-london-swarm.md +221 -221
  96. package/.claude/agents/testing/unit/tdd-london-swarm.md +221 -221
  97. package/.claude/agents/testing/validation/production-validator.md +372 -372
  98. package/.claude/agents/typescript-specialist.md +9 -9
  99. package/.claude/agents/v3/database-specialist.md +9 -9
  100. package/.claude/agents/v3/project-coordinator.md +8 -8
  101. package/.claude/agents/v3/python-specialist.md +9 -9
  102. package/.claude/agents/v3/test-architect.md +9 -9
  103. package/.claude/agents/v3/typescript-specialist.md +9 -9
  104. package/.claude/agents/v3/v3-integration-architect.md +311 -311
  105. package/.claude/agents/v3/v3-memory-specialist.md +280 -280
  106. package/.claude/agents/v3/v3-performance-engineer.md +362 -362
  107. package/.claude/agents/v3/v3-queen-coordinator.md +62 -62
  108. package/.claude/agents/v3/v3-security-architect.md +139 -139
  109. package/.claude/checkpoints/1767754460.json +8 -8
  110. package/.claude/commands/agents/README.md +10 -10
  111. package/.claude/commands/agents/agent-capabilities.md +21 -21
  112. package/.claude/commands/agents/agent-coordination.md +28 -28
  113. package/.claude/commands/agents/agent-spawning.md +28 -28
  114. package/.claude/commands/agents/agent-types.md +26 -26
  115. package/.claude/commands/analysis/COMMAND_COMPLIANCE_REPORT.md +53 -53
  116. package/.claude/commands/analysis/README.md +9 -9
  117. package/.claude/commands/analysis/bottleneck-detect.md +162 -162
  118. package/.claude/commands/analysis/performance-bottlenecks.md +58 -58
  119. package/.claude/commands/analysis/performance-report.md +25 -25
  120. package/.claude/commands/analysis/token-efficiency.md +44 -44
  121. package/.claude/commands/analysis/token-usage.md +25 -25
  122. package/.claude/commands/automation/README.md +9 -9
  123. package/.claude/commands/automation/auto-agent.md +122 -122
  124. package/.claude/commands/automation/self-healing.md +105 -105
  125. package/.claude/commands/automation/session-memory.md +89 -89
  126. package/.claude/commands/automation/smart-agents.md +72 -72
  127. package/.claude/commands/automation/smart-spawn.md +25 -25
  128. package/.claude/commands/automation/workflow-select.md +25 -25
  129. package/.claude/commands/claude-flow-help.md +103 -103
  130. package/.claude/commands/claude-flow-memory.md +107 -107
  131. package/.claude/commands/claude-flow-swarm.md +205 -205
  132. package/.claude/commands/coordination/README.md +9 -9
  133. package/.claude/commands/coordination/agent-spawn.md +25 -25
  134. package/.claude/commands/coordination/init.md +44 -44
  135. package/.claude/commands/coordination/orchestrate.md +43 -43
  136. package/.claude/commands/coordination/spawn.md +45 -45
  137. package/.claude/commands/coordination/swarm-init.md +85 -85
  138. package/.claude/commands/coordination/task-orchestrate.md +25 -25
  139. package/.claude/commands/flow-nexus/app-store.md +123 -123
  140. package/.claude/commands/flow-nexus/challenges.md +119 -119
  141. package/.claude/commands/flow-nexus/login-registration.md +64 -64
  142. package/.claude/commands/flow-nexus/neural-network.md +133 -133
  143. package/.claude/commands/flow-nexus/payments.md +115 -115
  144. package/.claude/commands/flow-nexus/sandbox.md +82 -82
  145. package/.claude/commands/flow-nexus/swarm.md +86 -86
  146. package/.claude/commands/flow-nexus/user-tools.md +151 -151
  147. package/.claude/commands/flow-nexus/workflow.md +114 -114
  148. package/.claude/commands/github/README.md +11 -11
  149. package/.claude/commands/github/code-review-swarm.md +513 -513
  150. package/.claude/commands/github/code-review.md +25 -25
  151. package/.claude/commands/github/github-modes.md +146 -146
  152. package/.claude/commands/github/github-swarm.md +121 -121
  153. package/.claude/commands/github/issue-tracker.md +291 -291
  154. package/.claude/commands/github/issue-triage.md +25 -25
  155. package/.claude/commands/github/multi-repo-swarm.md +518 -518
  156. package/.claude/commands/github/pr-enhance.md +26 -26
  157. package/.claude/commands/github/pr-manager.md +169 -169
  158. package/.claude/commands/github/project-board-sync.md +470 -470
  159. package/.claude/commands/github/release-manager.md +337 -337
  160. package/.claude/commands/github/release-swarm.md +543 -543
  161. package/.claude/commands/github/repo-analyze.md +25 -25
  162. package/.claude/commands/github/repo-architect.md +366 -366
  163. package/.claude/commands/github/swarm-issue.md +481 -481
  164. package/.claude/commands/github/swarm-pr.md +284 -284
  165. package/.claude/commands/github/sync-coordinator.md +300 -300
  166. package/.claude/commands/github/workflow-automation.md +441 -441
  167. package/.claude/commands/hive-mind/README.md +17 -17
  168. package/.claude/commands/hive-mind/hive-mind-consensus.md +8 -8
  169. package/.claude/commands/hive-mind/hive-mind-init.md +18 -18
  170. package/.claude/commands/hive-mind/hive-mind-memory.md +8 -8
  171. package/.claude/commands/hive-mind/hive-mind-metrics.md +8 -8
  172. package/.claude/commands/hive-mind/hive-mind-resume.md +8 -8
  173. package/.claude/commands/hive-mind/hive-mind-sessions.md +8 -8
  174. package/.claude/commands/hive-mind/hive-mind-spawn.md +21 -21
  175. package/.claude/commands/hive-mind/hive-mind-status.md +8 -8
  176. package/.claude/commands/hive-mind/hive-mind-stop.md +8 -8
  177. package/.claude/commands/hive-mind/hive-mind-wizard.md +8 -8
  178. package/.claude/commands/hive-mind/hive-mind.md +27 -27
  179. package/.claude/commands/hooks/README.md +11 -11
  180. package/.claude/commands/hooks/overview.md +57 -57
  181. package/.claude/commands/hooks/post-edit.md +117 -117
  182. package/.claude/commands/hooks/post-task.md +112 -112
  183. package/.claude/commands/hooks/pre-edit.md +113 -113
  184. package/.claude/commands/hooks/pre-task.md +111 -111
  185. package/.claude/commands/hooks/session-end.md +118 -118
  186. package/.claude/commands/hooks/setup.md +102 -102
  187. package/.claude/commands/memory/README.md +9 -9
  188. package/.claude/commands/memory/memory-persist.md +25 -25
  189. package/.claude/commands/memory/memory-search.md +25 -25
  190. package/.claude/commands/memory/memory-usage.md +25 -25
  191. package/.claude/commands/memory/neural.md +47 -47
  192. package/.claude/commands/monitoring/README.md +9 -9
  193. package/.claude/commands/monitoring/agent-metrics.md +25 -25
  194. package/.claude/commands/monitoring/agents.md +44 -44
  195. package/.claude/commands/monitoring/real-time-view.md +25 -25
  196. package/.claude/commands/monitoring/status.md +46 -46
  197. package/.claude/commands/monitoring/swarm-monitor.md +25 -25
  198. package/.claude/commands/optimization/README.md +9 -9
  199. package/.claude/commands/optimization/auto-topology.md +61 -61
  200. package/.claude/commands/optimization/cache-manage.md +25 -25
  201. package/.claude/commands/optimization/parallel-execute.md +25 -25
  202. package/.claude/commands/optimization/parallel-execution.md +49 -49
  203. package/.claude/commands/optimization/topology-optimize.md +25 -25
  204. package/.claude/commands/pair/README.md +260 -260
  205. package/.claude/commands/pair/commands.md +545 -545
  206. package/.claude/commands/pair/config.md +509 -509
  207. package/.claude/commands/pair/examples.md +511 -511
  208. package/.claude/commands/pair/modes.md +347 -347
  209. package/.claude/commands/pair/session.md +406 -406
  210. package/.claude/commands/pair/start.md +208 -208
  211. package/.claude/commands/sparc/analyzer.md +51 -51
  212. package/.claude/commands/sparc/architect.md +53 -53
  213. package/.claude/commands/sparc/ask.md +97 -97
  214. package/.claude/commands/sparc/batch-executor.md +54 -54
  215. package/.claude/commands/sparc/code.md +89 -89
  216. package/.claude/commands/sparc/coder.md +54 -54
  217. package/.claude/commands/sparc/debug.md +83 -83
  218. package/.claude/commands/sparc/debugger.md +54 -54
  219. package/.claude/commands/sparc/designer.md +53 -53
  220. package/.claude/commands/sparc/devops.md +109 -109
  221. package/.claude/commands/sparc/docs-writer.md +80 -80
  222. package/.claude/commands/sparc/documenter.md +54 -54
  223. package/.claude/commands/sparc/innovator.md +54 -54
  224. package/.claude/commands/sparc/integration.md +83 -83
  225. package/.claude/commands/sparc/mcp.md +117 -117
  226. package/.claude/commands/sparc/memory-manager.md +54 -54
  227. package/.claude/commands/sparc/optimizer.md +54 -54
  228. package/.claude/commands/sparc/orchestrator.md +131 -131
  229. package/.claude/commands/sparc/post-deployment-monitoring-mode.md +83 -83
  230. package/.claude/commands/sparc/refinement-optimization-mode.md +83 -83
  231. package/.claude/commands/sparc/researcher.md +54 -54
  232. package/.claude/commands/sparc/reviewer.md +54 -54
  233. package/.claude/commands/sparc/security-review.md +80 -80
  234. package/.claude/commands/sparc/sparc-modes.md +174 -174
  235. package/.claude/commands/sparc/sparc.md +111 -111
  236. package/.claude/commands/sparc/spec-pseudocode.md +80 -80
  237. package/.claude/commands/sparc/supabase-admin.md +348 -348
  238. package/.claude/commands/sparc/swarm-coordinator.md +54 -54
  239. package/.claude/commands/sparc/tdd.md +54 -54
  240. package/.claude/commands/sparc/tester.md +54 -54
  241. package/.claude/commands/sparc/tutorial.md +79 -79
  242. package/.claude/commands/sparc/workflow-manager.md +54 -54
  243. package/.claude/commands/sparc.md +166 -166
  244. package/.claude/commands/stream-chain/pipeline.md +120 -120
  245. package/.claude/commands/stream-chain/run.md +69 -69
  246. package/.claude/commands/swarm/README.md +15 -15
  247. package/.claude/commands/swarm/analysis.md +95 -95
  248. package/.claude/commands/swarm/development.md +96 -96
  249. package/.claude/commands/swarm/examples.md +168 -168
  250. package/.claude/commands/swarm/maintenance.md +102 -102
  251. package/.claude/commands/swarm/optimization.md +117 -117
  252. package/.claude/commands/swarm/research.md +136 -136
  253. package/.claude/commands/swarm/swarm-analysis.md +8 -8
  254. package/.claude/commands/swarm/swarm-background.md +8 -8
  255. package/.claude/commands/swarm/swarm-init.md +19 -19
  256. package/.claude/commands/swarm/swarm-modes.md +8 -8
  257. package/.claude/commands/swarm/swarm-monitor.md +8 -8
  258. package/.claude/commands/swarm/swarm-spawn.md +19 -19
  259. package/.claude/commands/swarm/swarm-status.md +8 -8
  260. package/.claude/commands/swarm/swarm-strategies.md +8 -8
  261. package/.claude/commands/swarm/swarm.md +27 -27
  262. package/.claude/commands/swarm/testing.md +131 -131
  263. package/.claude/commands/training/README.md +9 -9
  264. package/.claude/commands/training/model-update.md +25 -25
  265. package/.claude/commands/training/neural-patterns.md +73 -73
  266. package/.claude/commands/training/neural-train.md +25 -25
  267. package/.claude/commands/training/pattern-learn.md +25 -25
  268. package/.claude/commands/training/specialization.md +62 -62
  269. package/.claude/commands/truth/start.md +142 -142
  270. package/.claude/commands/verify/check.md +49 -49
  271. package/.claude/commands/verify/start.md +127 -127
  272. package/.claude/commands/workflows/README.md +9 -9
  273. package/.claude/commands/workflows/development.md +77 -77
  274. package/.claude/commands/workflows/research.md +62 -62
  275. package/.claude/commands/workflows/workflow-create.md +25 -25
  276. package/.claude/commands/workflows/workflow-execute.md +25 -25
  277. package/.claude/commands/workflows/workflow-export.md +25 -25
  278. package/.claude/config/v3-dependency-optimization.json +265 -265
  279. package/.claude/config/v3-performance-targets.json +250 -250
  280. package/.claude/helpers/README.md +96 -96
  281. package/.claude/helpers/adr-compliance.sh +186 -186
  282. package/.claude/helpers/aggressive-microcompact.mjs +36 -36
  283. package/.claude/helpers/auto-commit.sh +178 -178
  284. package/.claude/helpers/auto-memory-hook.mjs +564 -564
  285. package/.claude/helpers/checkpoint-manager.sh +251 -251
  286. package/.claude/helpers/context-persistence-hook.mjs +1979 -1979
  287. package/.claude/helpers/daemon-manager.sh +252 -252
  288. package/.claude/helpers/ddd-tracker.sh +144 -144
  289. package/.claude/helpers/github-safe.js +106 -106
  290. package/.claude/helpers/github-setup.sh +28 -28
  291. package/.claude/helpers/guidance-hook.sh +13 -13
  292. package/.claude/helpers/guidance-hooks.sh +102 -102
  293. package/.claude/helpers/health-monitor.sh +108 -108
  294. package/.claude/helpers/hook-handler.cjs +263 -263
  295. package/.claude/helpers/intelligence.cjs +230 -230
  296. package/.claude/helpers/learning-hooks.sh +329 -329
  297. package/.claude/helpers/learning-optimizer.sh +127 -127
  298. package/.claude/helpers/learning-service.mjs +1144 -1144
  299. package/.claude/helpers/memory.cjs +84 -84
  300. package/.claude/helpers/metrics-db.mjs +488 -488
  301. package/.claude/helpers/patch-aggressive-prune.mjs +184 -184
  302. package/.claude/helpers/pattern-consolidator.sh +86 -86
  303. package/.claude/helpers/perf-worker.sh +160 -160
  304. package/.claude/helpers/quick-start.sh +19 -19
  305. package/.claude/helpers/router.cjs +62 -62
  306. package/.claude/helpers/security-scanner.sh +127 -127
  307. package/.claude/helpers/session.cjs +125 -125
  308. package/.claude/helpers/setup-mcp.sh +18 -18
  309. package/.claude/helpers/standard-checkpoint-hooks.sh +189 -189
  310. package/.claude/helpers/statusline.cjs +819 -819
  311. package/.claude/helpers/swarm-comms.sh +353 -353
  312. package/.claude/helpers/swarm-hooks.sh +761 -761
  313. package/.claude/helpers/swarm-monitor.sh +210 -210
  314. package/.claude/helpers/sync-v3-metrics.sh +245 -245
  315. package/.claude/helpers/update-v3-progress.sh +165 -165
  316. package/.claude/helpers/v3-quick-status.sh +57 -57
  317. package/.claude/helpers/v3.sh +110 -110
  318. package/.claude/helpers/validate-v3-config.sh +215 -215
  319. package/.claude/helpers/worker-manager.sh +170 -170
  320. package/.claude/mcp.json +12 -12
  321. package/.claude/scheduled_tasks.lock +1 -1
  322. package/.claude/settings.json +285 -283
  323. package/.claude/settings.json.bak +526 -526
  324. package/.claude/settings.local.json +1 -0
  325. package/.claude/skills/agentdb-advanced/SKILL.md +550 -550
  326. package/.claude/skills/agentdb-learning/SKILL.md +545 -545
  327. package/.claude/skills/agentdb-memory-patterns/SKILL.md +339 -339
  328. package/.claude/skills/agentdb-optimization/SKILL.md +509 -509
  329. package/.claude/skills/agentdb-vector-search/SKILL.md +339 -339
  330. package/.claude/skills/agentic-jujutsu/SKILL.md +645 -645
  331. package/.claude/skills/browser/SKILL.md +204 -0
  332. package/.claude/skills/dual-mode/README.md +71 -71
  333. package/.claude/skills/dual-mode/dual-collect.md +103 -103
  334. package/.claude/skills/dual-mode/dual-coordinate.md +85 -85
  335. package/.claude/skills/dual-mode/dual-spawn.md +81 -81
  336. package/.claude/skills/flow-nexus-neural/SKILL.md +727 -727
  337. package/.claude/skills/flow-nexus-platform/SKILL.md +1154 -1154
  338. package/.claude/skills/flow-nexus-swarm/SKILL.md +604 -604
  339. package/.claude/skills/github-code-review/SKILL.md +1125 -1125
  340. package/.claude/skills/github-multi-repo/SKILL.md +862 -862
  341. package/.claude/skills/github-project-management/SKILL.md +1263 -1263
  342. package/.claude/skills/github-release-management/SKILL.md +1064 -1064
  343. package/.claude/skills/github-workflow-automation/SKILL.md +1047 -1047
  344. package/.claude/skills/hive-mind-advanced/SKILL.md +709 -709
  345. package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
  346. package/.claude/skills/pair-programming/SKILL.md +1202 -1202
  347. package/.claude/skills/performance-analysis/SKILL.md +560 -560
  348. package/.claude/skills/reasoningbank-agentdb/SKILL.md +446 -446
  349. package/.claude/skills/reasoningbank-intelligence/SKILL.md +201 -201
  350. package/.claude/skills/skill-builder/SKILL.md +910 -910
  351. package/.claude/skills/sparc-methodology/SKILL.md +1106 -1106
  352. package/.claude/skills/stream-chain/SKILL.md +560 -560
  353. package/.claude/skills/swarm-advanced/SKILL.md +970 -970
  354. package/.claude/skills/swarm-orchestration/SKILL.md +179 -179
  355. package/.claude/skills/v3-cli-modernization/SKILL.md +871 -871
  356. package/.claude/skills/v3-core-implementation/SKILL.md +796 -796
  357. package/.claude/skills/v3-ddd-architecture/SKILL.md +441 -441
  358. package/.claude/skills/v3-integration-deep/SKILL.md +240 -240
  359. package/.claude/skills/v3-mcp-optimization/SKILL.md +776 -776
  360. package/.claude/skills/v3-memory-unification/SKILL.md +173 -173
  361. package/.claude/skills/v3-performance-optimization/SKILL.md +389 -389
  362. package/.claude/skills/v3-security-overhaul/SKILL.md +81 -81
  363. package/.claude/skills/v3-swarm-coordination/SKILL.md +339 -339
  364. package/.claude/skills/verification-quality/SKILL.md +647 -647
  365. package/.claude/skills/worker-benchmarks/SKILL.md +129 -129
  366. package/.claude/skills/worker-integration/SKILL.md +147 -147
  367. package/.claude/statusline-command.sh +176 -176
  368. package/.claude/statusline.mjs +109 -109
  369. package/.claude/statusline.sh +431 -431
  370. package/.claude-plugin/README.md +720 -720
  371. package/.claude-plugin/docs/INSTALLATION.md +261 -261
  372. package/.claude-plugin/docs/PLUGIN_SUMMARY.md +361 -361
  373. package/.claude-plugin/docs/QUICKSTART.md +361 -361
  374. package/.claude-plugin/docs/STRUCTURE.md +128 -128
  375. package/.claude-plugin/hooks/hooks.json +74 -74
  376. package/.claude-plugin/marketplace.json +170 -170
  377. package/.claude-plugin/plugin.json +71 -71
  378. package/.claude-plugin/scripts/install.sh +234 -234
  379. package/.claude-plugin/scripts/uninstall.sh +36 -36
  380. package/.claude-plugin/scripts/verify.sh +108 -108
  381. package/LICENSE +21 -21
  382. package/README.md +393 -393
  383. package/bin/cli.js +11 -11
  384. package/bin/npx-repair.js +7 -7
  385. package/bin/npx-safe-launch.js +9 -9
  386. package/package.json +1 -1
  387. package/v3/@claude-flow/cli/README.md +393 -393
  388. package/v3/@claude-flow/cli/bin/cli.js +220 -220
  389. package/v3/@claude-flow/cli/bin/mcp-server.js +224 -224
  390. package/v3/@claude-flow/cli/bin/preinstall.cjs +2 -2
  391. package/v3/@claude-flow/cli/dist/src/commands/completions.js +409 -409
  392. package/v3/@claude-flow/cli/dist/src/commands/doctor.js +57 -17
  393. package/v3/@claude-flow/cli/dist/src/commands/embeddings.js +26 -26
  394. package/v3/@claude-flow/cli/dist/src/commands/hive-mind.js +97 -97
  395. package/v3/@claude-flow/cli/dist/src/commands/hooks.js +9 -9
  396. package/v3/@claude-flow/cli/dist/src/commands/memory.js +22 -3
  397. package/v3/@claude-flow/cli/dist/src/commands/ruvector/backup.js +23 -23
  398. package/v3/@claude-flow/cli/dist/src/commands/ruvector/benchmark.js +31 -31
  399. package/v3/@claude-flow/cli/dist/src/commands/ruvector/import.js +14 -14
  400. package/v3/@claude-flow/cli/dist/src/commands/ruvector/init.js +115 -115
  401. package/v3/@claude-flow/cli/dist/src/commands/ruvector/migrate.js +99 -99
  402. package/v3/@claude-flow/cli/dist/src/commands/ruvector/optimize.js +51 -51
  403. package/v3/@claude-flow/cli/dist/src/commands/ruvector/setup.js +624 -624
  404. package/v3/@claude-flow/cli/dist/src/commands/ruvector/status.js +38 -38
  405. package/v3/@claude-flow/cli/dist/src/config-adapter.js +1 -1
  406. package/v3/@claude-flow/cli/dist/src/index.js +14 -12
  407. package/v3/@claude-flow/cli/dist/src/init/claudemd-generator.js +226 -226
  408. package/v3/@claude-flow/cli/dist/src/init/executor.js +490 -456
  409. package/v3/@claude-flow/cli/dist/src/init/helpers-generator.js +645 -645
  410. package/v3/@claude-flow/cli/dist/src/init/mcp-generator.js +4 -4
  411. package/v3/@claude-flow/cli/dist/src/init/statusline-generator.js +858 -858
  412. package/v3/@claude-flow/cli/dist/src/mcp-tools/hooks-tools.js +44 -5
  413. package/v3/@claude-flow/cli/dist/src/mcp-tools/memory-tools.js +71 -46
  414. package/v3/@claude-flow/cli/dist/src/mcp-tools/system-tools.js +36 -11
  415. package/v3/@claude-flow/cli/dist/src/memory/memory-bridge.js +84 -84
  416. package/v3/@claude-flow/cli/dist/src/memory/memory-initializer.js +360 -360
  417. package/v3/@claude-flow/cli/dist/src/memory/rabitq-index.js +5 -5
  418. package/v3/@claude-flow/cli/dist/src/memory/sona-optimizer.js +0 -1
  419. package/v3/@claude-flow/cli/dist/src/runtime/headless.js +28 -28
  420. package/v3/@claude-flow/cli/dist/src/services/headless-worker-executor.js +84 -84
  421. package/v3/@claude-flow/cli/dist/src/services/worker-daemon.d.ts +25 -2
  422. package/v3/@claude-flow/cli/dist/src/services/worker-daemon.js +186 -10
  423. package/v3/@claude-flow/cli/dist/src/transfer/deploy-seraphine.js +23 -23
  424. package/v3/@claude-flow/cli/package.json +3 -2
  425. package/v3/@claude-flow/guidance/README.md +1195 -1195
  426. package/v3/@claude-flow/guidance/dist/analyzer.js +9 -0
  427. package/v3/@claude-flow/guidance/package.json +198 -198
  428. package/v3/@claude-flow/shared/README.md +323 -323
  429. package/v3/@claude-flow/shared/package.json +43 -43
  430. package/v3/README.md +493 -493
@@ -1,446 +1,446 @@
1
- ---
2
- name: "ReasoningBank with AgentDB"
3
- description: "Implement ReasoningBank adaptive learning with AgentDB's 150x faster vector database. Includes trajectory tracking, verdict judgment, memory distillation, and pattern recognition. Use when building self-learning agents, optimizing decision-making, or implementing experience replay systems."
4
- ---
5
-
6
- # ReasoningBank with AgentDB
7
-
8
- ## What This Skill Does
9
-
10
- Provides ReasoningBank adaptive learning patterns using AgentDB's high-performance backend (150x-12,500x faster). Enables agents to learn from experiences, judge outcomes, distill memories, and improve decision-making over time with 100% backward compatibility.
11
-
12
- **Performance**: 150x faster pattern retrieval, 500x faster batch operations, <1ms memory access.
13
-
14
- ## Prerequisites
15
-
16
- - Node.js 18+
17
- - AgentDB v1.0.7+ (via agentic-flow)
18
- - Understanding of reinforcement learning concepts (optional)
19
-
20
- ---
21
-
22
- ## Quick Start with CLI
23
-
24
- ### Initialize ReasoningBank Database
25
-
26
- ```bash
27
- # Initialize AgentDB for ReasoningBank
28
- npx agentdb@latest init ./.agentdb/reasoningbank.db --dimension 1536
29
-
30
- # Start MCP server for Claude Code integration
31
- npx agentdb@latest mcp
32
- claude mcp add agentdb npx agentdb@latest mcp
33
- ```
34
-
35
- ### Migrate from Legacy ReasoningBank
36
-
37
- ```bash
38
- # Automatic migration with validation
39
- npx agentdb@latest migrate --source .swarm/memory.db
40
-
41
- # Verify migration
42
- npx agentdb@latest stats ./.agentdb/reasoningbank.db
43
- ```
44
-
45
- ---
46
-
47
- ## Quick Start with API
48
-
49
- ```typescript
50
- import { createAgentDBAdapter, computeEmbedding } from 'agentic-flow/reasoningbank';
51
-
52
- // Initialize ReasoningBank with AgentDB
53
- const rb = await createAgentDBAdapter({
54
- dbPath: '.agentdb/reasoningbank.db',
55
- enableLearning: true, // Enable learning plugins
56
- enableReasoning: true, // Enable reasoning agents
57
- cacheSize: 1000, // 1000 pattern cache
58
- });
59
-
60
- // Store successful experience
61
- const query = "How to optimize database queries?";
62
- const embedding = await computeEmbedding(query);
63
-
64
- await rb.insertPattern({
65
- id: '',
66
- type: 'experience',
67
- domain: 'database-optimization',
68
- pattern_data: JSON.stringify({
69
- embedding,
70
- pattern: {
71
- query,
72
- approach: 'indexing + query optimization',
73
- outcome: 'success',
74
- metrics: { latency_reduction: 0.85 }
75
- }
76
- }),
77
- confidence: 0.95,
78
- usage_count: 1,
79
- success_count: 1,
80
- created_at: Date.now(),
81
- last_used: Date.now(),
82
- });
83
-
84
- // Retrieve similar experiences with reasoning
85
- const result = await rb.retrieveWithReasoning(embedding, {
86
- domain: 'database-optimization',
87
- k: 5,
88
- useMMR: true, // Diverse results
89
- synthesizeContext: true, // Rich context synthesis
90
- });
91
-
92
- console.log('Memories:', result.memories);
93
- console.log('Context:', result.context);
94
- console.log('Patterns:', result.patterns);
95
- ```
96
-
97
- ---
98
-
99
- ## Core ReasoningBank Concepts
100
-
101
- ### 1. Trajectory Tracking
102
-
103
- Track agent execution paths and outcomes:
104
-
105
- ```typescript
106
- // Record trajectory (sequence of actions)
107
- const trajectory = {
108
- task: 'optimize-api-endpoint',
109
- steps: [
110
- { action: 'analyze-bottleneck', result: 'found N+1 query' },
111
- { action: 'add-eager-loading', result: 'reduced queries' },
112
- { action: 'add-caching', result: 'improved latency' }
113
- ],
114
- outcome: 'success',
115
- metrics: { latency_before: 2500, latency_after: 150 }
116
- };
117
-
118
- const embedding = await computeEmbedding(JSON.stringify(trajectory));
119
-
120
- await rb.insertPattern({
121
- id: '',
122
- type: 'trajectory',
123
- domain: 'api-optimization',
124
- pattern_data: JSON.stringify({ embedding, pattern: trajectory }),
125
- confidence: 0.9,
126
- usage_count: 1,
127
- success_count: 1,
128
- created_at: Date.now(),
129
- last_used: Date.now(),
130
- });
131
- ```
132
-
133
- ### 2. Verdict Judgment
134
-
135
- Judge whether a trajectory was successful:
136
-
137
- ```typescript
138
- // Retrieve similar past trajectories
139
- const similar = await rb.retrieveWithReasoning(queryEmbedding, {
140
- domain: 'api-optimization',
141
- k: 10,
142
- });
143
-
144
- // Judge based on similarity to successful patterns
145
- const verdict = similar.memories.filter(m =>
146
- m.pattern.outcome === 'success' &&
147
- m.similarity > 0.8
148
- ).length > 5 ? 'likely_success' : 'needs_review';
149
-
150
- console.log('Verdict:', verdict);
151
- console.log('Confidence:', similar.memories[0]?.similarity || 0);
152
- ```
153
-
154
- ### 3. Memory Distillation
155
-
156
- Consolidate similar experiences into patterns:
157
-
158
- ```typescript
159
- // Get all experiences in domain
160
- const experiences = await rb.retrieveWithReasoning(embedding, {
161
- domain: 'api-optimization',
162
- k: 100,
163
- optimizeMemory: true, // Automatic consolidation
164
- });
165
-
166
- // Distill into high-level pattern
167
- const distilledPattern = {
168
- domain: 'api-optimization',
169
- pattern: 'For N+1 queries: add eager loading, then cache',
170
- success_rate: 0.92,
171
- sample_size: experiences.memories.length,
172
- confidence: 0.95
173
- };
174
-
175
- await rb.insertPattern({
176
- id: '',
177
- type: 'distilled-pattern',
178
- domain: 'api-optimization',
179
- pattern_data: JSON.stringify({
180
- embedding: await computeEmbedding(JSON.stringify(distilledPattern)),
181
- pattern: distilledPattern
182
- }),
183
- confidence: 0.95,
184
- usage_count: 0,
185
- success_count: 0,
186
- created_at: Date.now(),
187
- last_used: Date.now(),
188
- });
189
- ```
190
-
191
- ---
192
-
193
- ## Integration with Reasoning Agents
194
-
195
- AgentDB provides 4 reasoning modules that enhance ReasoningBank:
196
-
197
- ### 1. PatternMatcher
198
-
199
- Find similar successful patterns:
200
-
201
- ```typescript
202
- const result = await rb.retrieveWithReasoning(queryEmbedding, {
203
- domain: 'problem-solving',
204
- k: 10,
205
- useMMR: true, // Maximal Marginal Relevance for diversity
206
- });
207
-
208
- // PatternMatcher returns diverse, relevant memories
209
- result.memories.forEach(mem => {
210
- console.log(`Pattern: ${mem.pattern.approach}`);
211
- console.log(`Similarity: ${mem.similarity}`);
212
- console.log(`Success Rate: ${mem.success_count / mem.usage_count}`);
213
- });
214
- ```
215
-
216
- ### 2. ContextSynthesizer
217
-
218
- Generate rich context from multiple memories:
219
-
220
- ```typescript
221
- const result = await rb.retrieveWithReasoning(queryEmbedding, {
222
- domain: 'code-optimization',
223
- synthesizeContext: true, // Enable context synthesis
224
- k: 5,
225
- });
226
-
227
- // ContextSynthesizer creates coherent narrative
228
- console.log('Synthesized Context:', result.context);
229
- // "Based on 5 similar optimizations, the most effective approach
230
- // involves profiling, identifying bottlenecks, and applying targeted
231
- // improvements. Success rate: 87%"
232
- ```
233
-
234
- ### 3. MemoryOptimizer
235
-
236
- Automatically consolidate and prune:
237
-
238
- ```typescript
239
- const result = await rb.retrieveWithReasoning(queryEmbedding, {
240
- domain: 'testing',
241
- optimizeMemory: true, // Enable automatic optimization
242
- });
243
-
244
- // MemoryOptimizer consolidates similar patterns and prunes low-quality
245
- console.log('Optimizations:', result.optimizations);
246
- // { consolidated: 15, pruned: 3, improved_quality: 0.12 }
247
- ```
248
-
249
- ### 4. ExperienceCurator
250
-
251
- Filter by quality and relevance:
252
-
253
- ```typescript
254
- const result = await rb.retrieveWithReasoning(queryEmbedding, {
255
- domain: 'debugging',
256
- k: 20,
257
- minConfidence: 0.8, // Only high-confidence experiences
258
- });
259
-
260
- // ExperienceCurator returns only quality experiences
261
- result.memories.forEach(mem => {
262
- console.log(`Confidence: ${mem.confidence}`);
263
- console.log(`Success Rate: ${mem.success_count / mem.usage_count}`);
264
- });
265
- ```
266
-
267
- ---
268
-
269
- ## Legacy API Compatibility
270
-
271
- AgentDB maintains 100% backward compatibility with legacy ReasoningBank:
272
-
273
- ```typescript
274
- import {
275
- retrieveMemories,
276
- judgeTrajectory,
277
- distillMemories
278
- } from 'agentic-flow/reasoningbank';
279
-
280
- // Legacy API works unchanged (uses AgentDB backend automatically)
281
- const memories = await retrieveMemories(query, {
282
- domain: 'code-generation',
283
- agent: 'coder'
284
- });
285
-
286
- const verdict = await judgeTrajectory(trajectory, query);
287
-
288
- const newMemories = await distillMemories(
289
- trajectory,
290
- verdict,
291
- query,
292
- { domain: 'code-generation' }
293
- );
294
- ```
295
-
296
- ---
297
-
298
- ## Performance Characteristics
299
-
300
- - **Pattern Search**: 150x faster (100µs vs 15ms)
301
- - **Memory Retrieval**: <1ms (with cache)
302
- - **Batch Insert**: 500x faster (2ms vs 1s for 100 patterns)
303
- - **Trajectory Judgment**: <5ms (including retrieval + analysis)
304
- - **Memory Distillation**: <50ms (consolidate 100 patterns)
305
-
306
- ---
307
-
308
- ## Advanced Patterns
309
-
310
- ### Hierarchical Memory
311
-
312
- Organize memories by abstraction level:
313
-
314
- ```typescript
315
- // Low-level: Specific implementation
316
- await rb.insertPattern({
317
- type: 'concrete',
318
- domain: 'debugging/null-pointer',
319
- pattern_data: JSON.stringify({
320
- embedding,
321
- pattern: { bug: 'NPE in UserService.getUser()', fix: 'Add null check' }
322
- }),
323
- confidence: 0.9,
324
- // ...
325
- });
326
-
327
- // Mid-level: Pattern across similar cases
328
- await rb.insertPattern({
329
- type: 'pattern',
330
- domain: 'debugging',
331
- pattern_data: JSON.stringify({
332
- embedding,
333
- pattern: { category: 'null-pointer', approach: 'defensive-checks' }
334
- }),
335
- confidence: 0.85,
336
- // ...
337
- });
338
-
339
- // High-level: General principle
340
- await rb.insertPattern({
341
- type: 'principle',
342
- domain: 'software-engineering',
343
- pattern_data: JSON.stringify({
344
- embedding,
345
- pattern: { principle: 'fail-fast with clear errors' }
346
- }),
347
- confidence: 0.95,
348
- // ...
349
- });
350
- ```
351
-
352
- ### Multi-Domain Learning
353
-
354
- Transfer learning across domains:
355
-
356
- ```typescript
357
- // Learn from backend optimization
358
- const backendExperience = await rb.retrieveWithReasoning(embedding, {
359
- domain: 'backend-optimization',
360
- k: 10,
361
- });
362
-
363
- // Apply to frontend optimization
364
- const transferredKnowledge = backendExperience.memories.map(mem => ({
365
- ...mem,
366
- domain: 'frontend-optimization',
367
- adapted: true,
368
- }));
369
- ```
370
-
371
- ---
372
-
373
- ## CLI Operations
374
-
375
- ### Database Management
376
-
377
- ```bash
378
- # Export trajectories and patterns
379
- npx agentdb@latest export ./.agentdb/reasoningbank.db ./backup.json
380
-
381
- # Import experiences
382
- npx agentdb@latest import ./experiences.json
383
-
384
- # Get statistics
385
- npx agentdb@latest stats ./.agentdb/reasoningbank.db
386
- # Shows: total patterns, domains, confidence distribution
387
- ```
388
-
389
- ### Migration
390
-
391
- ```bash
392
- # Migrate from legacy ReasoningBank
393
- npx agentdb@latest migrate --source .swarm/memory.db --target .agentdb/reasoningbank.db
394
-
395
- # Validate migration
396
- npx agentdb@latest stats .agentdb/reasoningbank.db
397
- ```
398
-
399
- ---
400
-
401
- ## Troubleshooting
402
-
403
- ### Issue: Migration fails
404
- ```bash
405
- # Check source database exists
406
- ls -la .swarm/memory.db
407
-
408
- # Run with verbose logging
409
- DEBUG=agentdb:* npx agentdb@latest migrate --source .swarm/memory.db
410
- ```
411
-
412
- ### Issue: Low confidence scores
413
- ```typescript
414
- // Enable context synthesis for better quality
415
- const result = await rb.retrieveWithReasoning(embedding, {
416
- synthesizeContext: true,
417
- useMMR: true,
418
- k: 10,
419
- });
420
- ```
421
-
422
- ### Issue: Memory growing too large
423
- ```typescript
424
- // Enable automatic optimization
425
- const result = await rb.retrieveWithReasoning(embedding, {
426
- optimizeMemory: true, // Consolidates similar patterns
427
- });
428
-
429
- // Or manually optimize
430
- await rb.optimize();
431
- ```
432
-
433
- ---
434
-
435
- ## Learn More
436
-
437
- - **AgentDB Integration**: node_modules/agentic-flow/docs/AGENTDB_INTEGRATION.md
438
- - **GitHub**: https://github.com/ruvnet/agentic-flow/tree/main/packages/agentdb
439
- - **MCP Integration**: `npx agentdb@latest mcp`
440
- - **Website**: https://agentdb.ruv.io
441
-
442
- ---
443
-
444
- **Category**: Machine Learning / Reinforcement Learning
445
- **Difficulty**: Intermediate
446
- **Estimated Time**: 20-30 minutes
1
+ ---
2
+ name: "ReasoningBank with AgentDB"
3
+ description: "Implement ReasoningBank adaptive learning with AgentDB's 150x faster vector database. Includes trajectory tracking, verdict judgment, memory distillation, and pattern recognition. Use when building self-learning agents, optimizing decision-making, or implementing experience replay systems."
4
+ ---
5
+
6
+ # ReasoningBank with AgentDB
7
+
8
+ ## What This Skill Does
9
+
10
+ Provides ReasoningBank adaptive learning patterns using AgentDB's high-performance backend (150x-12,500x faster). Enables agents to learn from experiences, judge outcomes, distill memories, and improve decision-making over time with 100% backward compatibility.
11
+
12
+ **Performance**: 150x faster pattern retrieval, 500x faster batch operations, <1ms memory access.
13
+
14
+ ## Prerequisites
15
+
16
+ - Node.js 18+
17
+ - AgentDB v1.0.7+ (via agentic-flow)
18
+ - Understanding of reinforcement learning concepts (optional)
19
+
20
+ ---
21
+
22
+ ## Quick Start with CLI
23
+
24
+ ### Initialize ReasoningBank Database
25
+
26
+ ```bash
27
+ # Initialize AgentDB for ReasoningBank
28
+ npx agentdb@latest init ./.agentdb/reasoningbank.db --dimension 1536
29
+
30
+ # Start MCP server for Claude Code integration
31
+ npx agentdb@latest mcp
32
+ claude mcp add agentdb npx agentdb@latest mcp
33
+ ```
34
+
35
+ ### Migrate from Legacy ReasoningBank
36
+
37
+ ```bash
38
+ # Automatic migration with validation
39
+ npx agentdb@latest migrate --source .swarm/memory.db
40
+
41
+ # Verify migration
42
+ npx agentdb@latest stats ./.agentdb/reasoningbank.db
43
+ ```
44
+
45
+ ---
46
+
47
+ ## Quick Start with API
48
+
49
+ ```typescript
50
+ import { createAgentDBAdapter, computeEmbedding } from 'agentic-flow/reasoningbank';
51
+
52
+ // Initialize ReasoningBank with AgentDB
53
+ const rb = await createAgentDBAdapter({
54
+ dbPath: '.agentdb/reasoningbank.db',
55
+ enableLearning: true, // Enable learning plugins
56
+ enableReasoning: true, // Enable reasoning agents
57
+ cacheSize: 1000, // 1000 pattern cache
58
+ });
59
+
60
+ // Store successful experience
61
+ const query = "How to optimize database queries?";
62
+ const embedding = await computeEmbedding(query);
63
+
64
+ await rb.insertPattern({
65
+ id: '',
66
+ type: 'experience',
67
+ domain: 'database-optimization',
68
+ pattern_data: JSON.stringify({
69
+ embedding,
70
+ pattern: {
71
+ query,
72
+ approach: 'indexing + query optimization',
73
+ outcome: 'success',
74
+ metrics: { latency_reduction: 0.85 }
75
+ }
76
+ }),
77
+ confidence: 0.95,
78
+ usage_count: 1,
79
+ success_count: 1,
80
+ created_at: Date.now(),
81
+ last_used: Date.now(),
82
+ });
83
+
84
+ // Retrieve similar experiences with reasoning
85
+ const result = await rb.retrieveWithReasoning(embedding, {
86
+ domain: 'database-optimization',
87
+ k: 5,
88
+ useMMR: true, // Diverse results
89
+ synthesizeContext: true, // Rich context synthesis
90
+ });
91
+
92
+ console.log('Memories:', result.memories);
93
+ console.log('Context:', result.context);
94
+ console.log('Patterns:', result.patterns);
95
+ ```
96
+
97
+ ---
98
+
99
+ ## Core ReasoningBank Concepts
100
+
101
+ ### 1. Trajectory Tracking
102
+
103
+ Track agent execution paths and outcomes:
104
+
105
+ ```typescript
106
+ // Record trajectory (sequence of actions)
107
+ const trajectory = {
108
+ task: 'optimize-api-endpoint',
109
+ steps: [
110
+ { action: 'analyze-bottleneck', result: 'found N+1 query' },
111
+ { action: 'add-eager-loading', result: 'reduced queries' },
112
+ { action: 'add-caching', result: 'improved latency' }
113
+ ],
114
+ outcome: 'success',
115
+ metrics: { latency_before: 2500, latency_after: 150 }
116
+ };
117
+
118
+ const embedding = await computeEmbedding(JSON.stringify(trajectory));
119
+
120
+ await rb.insertPattern({
121
+ id: '',
122
+ type: 'trajectory',
123
+ domain: 'api-optimization',
124
+ pattern_data: JSON.stringify({ embedding, pattern: trajectory }),
125
+ confidence: 0.9,
126
+ usage_count: 1,
127
+ success_count: 1,
128
+ created_at: Date.now(),
129
+ last_used: Date.now(),
130
+ });
131
+ ```
132
+
133
+ ### 2. Verdict Judgment
134
+
135
+ Judge whether a trajectory was successful:
136
+
137
+ ```typescript
138
+ // Retrieve similar past trajectories
139
+ const similar = await rb.retrieveWithReasoning(queryEmbedding, {
140
+ domain: 'api-optimization',
141
+ k: 10,
142
+ });
143
+
144
+ // Judge based on similarity to successful patterns
145
+ const verdict = similar.memories.filter(m =>
146
+ m.pattern.outcome === 'success' &&
147
+ m.similarity > 0.8
148
+ ).length > 5 ? 'likely_success' : 'needs_review';
149
+
150
+ console.log('Verdict:', verdict);
151
+ console.log('Confidence:', similar.memories[0]?.similarity || 0);
152
+ ```
153
+
154
+ ### 3. Memory Distillation
155
+
156
+ Consolidate similar experiences into patterns:
157
+
158
+ ```typescript
159
+ // Get all experiences in domain
160
+ const experiences = await rb.retrieveWithReasoning(embedding, {
161
+ domain: 'api-optimization',
162
+ k: 100,
163
+ optimizeMemory: true, // Automatic consolidation
164
+ });
165
+
166
+ // Distill into high-level pattern
167
+ const distilledPattern = {
168
+ domain: 'api-optimization',
169
+ pattern: 'For N+1 queries: add eager loading, then cache',
170
+ success_rate: 0.92,
171
+ sample_size: experiences.memories.length,
172
+ confidence: 0.95
173
+ };
174
+
175
+ await rb.insertPattern({
176
+ id: '',
177
+ type: 'distilled-pattern',
178
+ domain: 'api-optimization',
179
+ pattern_data: JSON.stringify({
180
+ embedding: await computeEmbedding(JSON.stringify(distilledPattern)),
181
+ pattern: distilledPattern
182
+ }),
183
+ confidence: 0.95,
184
+ usage_count: 0,
185
+ success_count: 0,
186
+ created_at: Date.now(),
187
+ last_used: Date.now(),
188
+ });
189
+ ```
190
+
191
+ ---
192
+
193
+ ## Integration with Reasoning Agents
194
+
195
+ AgentDB provides 4 reasoning modules that enhance ReasoningBank:
196
+
197
+ ### 1. PatternMatcher
198
+
199
+ Find similar successful patterns:
200
+
201
+ ```typescript
202
+ const result = await rb.retrieveWithReasoning(queryEmbedding, {
203
+ domain: 'problem-solving',
204
+ k: 10,
205
+ useMMR: true, // Maximal Marginal Relevance for diversity
206
+ });
207
+
208
+ // PatternMatcher returns diverse, relevant memories
209
+ result.memories.forEach(mem => {
210
+ console.log(`Pattern: ${mem.pattern.approach}`);
211
+ console.log(`Similarity: ${mem.similarity}`);
212
+ console.log(`Success Rate: ${mem.success_count / mem.usage_count}`);
213
+ });
214
+ ```
215
+
216
+ ### 2. ContextSynthesizer
217
+
218
+ Generate rich context from multiple memories:
219
+
220
+ ```typescript
221
+ const result = await rb.retrieveWithReasoning(queryEmbedding, {
222
+ domain: 'code-optimization',
223
+ synthesizeContext: true, // Enable context synthesis
224
+ k: 5,
225
+ });
226
+
227
+ // ContextSynthesizer creates coherent narrative
228
+ console.log('Synthesized Context:', result.context);
229
+ // "Based on 5 similar optimizations, the most effective approach
230
+ // involves profiling, identifying bottlenecks, and applying targeted
231
+ // improvements. Success rate: 87%"
232
+ ```
233
+
234
+ ### 3. MemoryOptimizer
235
+
236
+ Automatically consolidate and prune:
237
+
238
+ ```typescript
239
+ const result = await rb.retrieveWithReasoning(queryEmbedding, {
240
+ domain: 'testing',
241
+ optimizeMemory: true, // Enable automatic optimization
242
+ });
243
+
244
+ // MemoryOptimizer consolidates similar patterns and prunes low-quality
245
+ console.log('Optimizations:', result.optimizations);
246
+ // { consolidated: 15, pruned: 3, improved_quality: 0.12 }
247
+ ```
248
+
249
+ ### 4. ExperienceCurator
250
+
251
+ Filter by quality and relevance:
252
+
253
+ ```typescript
254
+ const result = await rb.retrieveWithReasoning(queryEmbedding, {
255
+ domain: 'debugging',
256
+ k: 20,
257
+ minConfidence: 0.8, // Only high-confidence experiences
258
+ });
259
+
260
+ // ExperienceCurator returns only quality experiences
261
+ result.memories.forEach(mem => {
262
+ console.log(`Confidence: ${mem.confidence}`);
263
+ console.log(`Success Rate: ${mem.success_count / mem.usage_count}`);
264
+ });
265
+ ```
266
+
267
+ ---
268
+
269
+ ## Legacy API Compatibility
270
+
271
+ AgentDB maintains 100% backward compatibility with legacy ReasoningBank:
272
+
273
+ ```typescript
274
+ import {
275
+ retrieveMemories,
276
+ judgeTrajectory,
277
+ distillMemories
278
+ } from 'agentic-flow/reasoningbank';
279
+
280
+ // Legacy API works unchanged (uses AgentDB backend automatically)
281
+ const memories = await retrieveMemories(query, {
282
+ domain: 'code-generation',
283
+ agent: 'coder'
284
+ });
285
+
286
+ const verdict = await judgeTrajectory(trajectory, query);
287
+
288
+ const newMemories = await distillMemories(
289
+ trajectory,
290
+ verdict,
291
+ query,
292
+ { domain: 'code-generation' }
293
+ );
294
+ ```
295
+
296
+ ---
297
+
298
+ ## Performance Characteristics
299
+
300
+ - **Pattern Search**: 150x faster (100µs vs 15ms)
301
+ - **Memory Retrieval**: <1ms (with cache)
302
+ - **Batch Insert**: 500x faster (2ms vs 1s for 100 patterns)
303
+ - **Trajectory Judgment**: <5ms (including retrieval + analysis)
304
+ - **Memory Distillation**: <50ms (consolidate 100 patterns)
305
+
306
+ ---
307
+
308
+ ## Advanced Patterns
309
+
310
+ ### Hierarchical Memory
311
+
312
+ Organize memories by abstraction level:
313
+
314
+ ```typescript
315
+ // Low-level: Specific implementation
316
+ await rb.insertPattern({
317
+ type: 'concrete',
318
+ domain: 'debugging/null-pointer',
319
+ pattern_data: JSON.stringify({
320
+ embedding,
321
+ pattern: { bug: 'NPE in UserService.getUser()', fix: 'Add null check' }
322
+ }),
323
+ confidence: 0.9,
324
+ // ...
325
+ });
326
+
327
+ // Mid-level: Pattern across similar cases
328
+ await rb.insertPattern({
329
+ type: 'pattern',
330
+ domain: 'debugging',
331
+ pattern_data: JSON.stringify({
332
+ embedding,
333
+ pattern: { category: 'null-pointer', approach: 'defensive-checks' }
334
+ }),
335
+ confidence: 0.85,
336
+ // ...
337
+ });
338
+
339
+ // High-level: General principle
340
+ await rb.insertPattern({
341
+ type: 'principle',
342
+ domain: 'software-engineering',
343
+ pattern_data: JSON.stringify({
344
+ embedding,
345
+ pattern: { principle: 'fail-fast with clear errors' }
346
+ }),
347
+ confidence: 0.95,
348
+ // ...
349
+ });
350
+ ```
351
+
352
+ ### Multi-Domain Learning
353
+
354
+ Transfer learning across domains:
355
+
356
+ ```typescript
357
+ // Learn from backend optimization
358
+ const backendExperience = await rb.retrieveWithReasoning(embedding, {
359
+ domain: 'backend-optimization',
360
+ k: 10,
361
+ });
362
+
363
+ // Apply to frontend optimization
364
+ const transferredKnowledge = backendExperience.memories.map(mem => ({
365
+ ...mem,
366
+ domain: 'frontend-optimization',
367
+ adapted: true,
368
+ }));
369
+ ```
370
+
371
+ ---
372
+
373
+ ## CLI Operations
374
+
375
+ ### Database Management
376
+
377
+ ```bash
378
+ # Export trajectories and patterns
379
+ npx agentdb@latest export ./.agentdb/reasoningbank.db ./backup.json
380
+
381
+ # Import experiences
382
+ npx agentdb@latest import ./experiences.json
383
+
384
+ # Get statistics
385
+ npx agentdb@latest stats ./.agentdb/reasoningbank.db
386
+ # Shows: total patterns, domains, confidence distribution
387
+ ```
388
+
389
+ ### Migration
390
+
391
+ ```bash
392
+ # Migrate from legacy ReasoningBank
393
+ npx agentdb@latest migrate --source .swarm/memory.db --target .agentdb/reasoningbank.db
394
+
395
+ # Validate migration
396
+ npx agentdb@latest stats .agentdb/reasoningbank.db
397
+ ```
398
+
399
+ ---
400
+
401
+ ## Troubleshooting
402
+
403
+ ### Issue: Migration fails
404
+ ```bash
405
+ # Check source database exists
406
+ ls -la .swarm/memory.db
407
+
408
+ # Run with verbose logging
409
+ DEBUG=agentdb:* npx agentdb@latest migrate --source .swarm/memory.db
410
+ ```
411
+
412
+ ### Issue: Low confidence scores
413
+ ```typescript
414
+ // Enable context synthesis for better quality
415
+ const result = await rb.retrieveWithReasoning(embedding, {
416
+ synthesizeContext: true,
417
+ useMMR: true,
418
+ k: 10,
419
+ });
420
+ ```
421
+
422
+ ### Issue: Memory growing too large
423
+ ```typescript
424
+ // Enable automatic optimization
425
+ const result = await rb.retrieveWithReasoning(embedding, {
426
+ optimizeMemory: true, // Consolidates similar patterns
427
+ });
428
+
429
+ // Or manually optimize
430
+ await rb.optimize();
431
+ ```
432
+
433
+ ---
434
+
435
+ ## Learn More
436
+
437
+ - **AgentDB Integration**: node_modules/agentic-flow/docs/AGENTDB_INTEGRATION.md
438
+ - **GitHub**: https://github.com/ruvnet/agentic-flow/tree/main/packages/agentdb
439
+ - **MCP Integration**: `npx agentdb@latest mcp`
440
+ - **Website**: https://agentdb.ruv.io
441
+
442
+ ---
443
+
444
+ **Category**: Machine Learning / Reinforcement Learning
445
+ **Difficulty**: Intermediate
446
+ **Estimated Time**: 20-30 minutes