claude-flow 3.6.30 → 3.7.0-alpha.10

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 (453) 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 -809
  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 +283 -283
  323. package/.claude/settings.json.bak +526 -526
  324. package/.claude/skills/agentdb-advanced/SKILL.md +550 -550
  325. package/.claude/skills/agentdb-learning/SKILL.md +545 -545
  326. package/.claude/skills/agentdb-memory-patterns/SKILL.md +339 -339
  327. package/.claude/skills/agentdb-optimization/SKILL.md +509 -509
  328. package/.claude/skills/agentdb-vector-search/SKILL.md +339 -339
  329. package/.claude/skills/agentic-jujutsu/SKILL.md +645 -645
  330. package/.claude/skills/dual-mode/README.md +71 -71
  331. package/.claude/skills/dual-mode/dual-collect.md +103 -103
  332. package/.claude/skills/dual-mode/dual-coordinate.md +85 -85
  333. package/.claude/skills/dual-mode/dual-spawn.md +81 -81
  334. package/.claude/skills/flow-nexus-neural/SKILL.md +727 -727
  335. package/.claude/skills/flow-nexus-platform/SKILL.md +1154 -1154
  336. package/.claude/skills/flow-nexus-swarm/SKILL.md +604 -604
  337. package/.claude/skills/github-code-review/SKILL.md +1125 -1125
  338. package/.claude/skills/github-multi-repo/SKILL.md +862 -862
  339. package/.claude/skills/github-project-management/SKILL.md +1263 -1250
  340. package/.claude/skills/github-release-management/SKILL.md +1064 -1064
  341. package/.claude/skills/github-workflow-automation/SKILL.md +1047 -1047
  342. package/.claude/skills/hive-mind-advanced/SKILL.md +709 -709
  343. package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
  344. package/.claude/skills/pair-programming/SKILL.md +1202 -1202
  345. package/.claude/skills/performance-analysis/SKILL.md +560 -560
  346. package/.claude/skills/reasoningbank-agentdb/SKILL.md +446 -446
  347. package/.claude/skills/reasoningbank-intelligence/SKILL.md +201 -201
  348. package/.claude/skills/skill-builder/SKILL.md +910 -910
  349. package/.claude/skills/sparc-methodology/SKILL.md +1106 -1106
  350. package/.claude/skills/stream-chain/SKILL.md +560 -560
  351. package/.claude/skills/swarm-advanced/SKILL.md +970 -970
  352. package/.claude/skills/swarm-orchestration/SKILL.md +179 -179
  353. package/.claude/skills/v3-cli-modernization/SKILL.md +871 -871
  354. package/.claude/skills/v3-core-implementation/SKILL.md +796 -796
  355. package/.claude/skills/v3-ddd-architecture/SKILL.md +441 -441
  356. package/.claude/skills/v3-integration-deep/SKILL.md +240 -240
  357. package/.claude/skills/v3-mcp-optimization/SKILL.md +776 -776
  358. package/.claude/skills/v3-memory-unification/SKILL.md +173 -173
  359. package/.claude/skills/v3-performance-optimization/SKILL.md +389 -389
  360. package/.claude/skills/v3-security-overhaul/SKILL.md +81 -81
  361. package/.claude/skills/v3-swarm-coordination/SKILL.md +339 -339
  362. package/.claude/skills/verification-quality/SKILL.md +647 -647
  363. package/.claude/skills/worker-benchmarks/SKILL.md +129 -129
  364. package/.claude/skills/worker-integration/SKILL.md +147 -147
  365. package/.claude/statusline-command.sh +176 -176
  366. package/.claude/statusline.mjs +109 -109
  367. package/.claude/statusline.sh +431 -431
  368. package/.claude-plugin/README.md +720 -720
  369. package/.claude-plugin/docs/INSTALLATION.md +261 -261
  370. package/.claude-plugin/docs/PLUGIN_SUMMARY.md +361 -361
  371. package/.claude-plugin/docs/QUICKSTART.md +361 -361
  372. package/.claude-plugin/docs/STRUCTURE.md +128 -128
  373. package/.claude-plugin/hooks/hooks.json +74 -74
  374. package/.claude-plugin/marketplace.json +170 -170
  375. package/.claude-plugin/plugin.json +71 -71
  376. package/.claude-plugin/scripts/install.sh +234 -234
  377. package/.claude-plugin/scripts/uninstall.sh +36 -36
  378. package/.claude-plugin/scripts/verify.sh +108 -108
  379. package/LICENSE +21 -21
  380. package/README.md +393 -391
  381. package/bin/cli.js +11 -11
  382. package/bin/npx-repair.js +7 -7
  383. package/bin/npx-safe-launch.js +9 -9
  384. package/package.json +7 -1
  385. package/v3/@claude-flow/cli/README.md +393 -391
  386. package/v3/@claude-flow/cli/bin/cli.js +220 -220
  387. package/v3/@claude-flow/cli/bin/mcp-server.js +224 -224
  388. package/v3/@claude-flow/cli/bin/preinstall.cjs +2 -2
  389. package/v3/@claude-flow/cli/dist/src/commands/agent-wasm.js +2 -2
  390. package/v3/@claude-flow/cli/dist/src/commands/completions.js +409 -409
  391. package/v3/@claude-flow/cli/dist/src/commands/daemon.js +19 -3
  392. package/v3/@claude-flow/cli/dist/src/commands/doctor.js +105 -23
  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 +122 -104
  395. package/v3/@claude-flow/cli/dist/src/commands/hooks.js +34 -21
  396. package/v3/@claude-flow/cli/dist/src/commands/memory.js +68 -0
  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/index.d.ts +5 -1
  406. package/v3/@claude-flow/cli/dist/src/index.js +59 -18
  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 +511 -453
  409. package/v3/@claude-flow/cli/dist/src/init/helpers-generator.js +645 -645
  410. package/v3/@claude-flow/cli/dist/src/init/settings-generator.js +11 -5
  411. package/v3/@claude-flow/cli/dist/src/init/statusline-generator.js +858 -858
  412. package/v3/@claude-flow/cli/dist/src/init/types.d.ts +7 -0
  413. package/v3/@claude-flow/cli/dist/src/mcp-tools/agentdb-tools.d.ts +3 -0
  414. package/v3/@claude-flow/cli/dist/src/mcp-tools/agentdb-tools.js +108 -0
  415. package/v3/@claude-flow/cli/dist/src/mcp-tools/hooks-tools.js +4 -2
  416. package/v3/@claude-flow/cli/dist/src/mcp-tools/memory-tools.js +19 -0
  417. package/v3/@claude-flow/cli/dist/src/mcp-tools/neural-tools.js +14 -1
  418. package/v3/@claude-flow/cli/dist/src/mcp-tools/security-tools.js +28 -3
  419. package/v3/@claude-flow/cli/dist/src/mcp-tools/swarm-tools.js +72 -3
  420. package/v3/@claude-flow/cli/dist/src/mcp-tools/types.d.ts +4 -33
  421. package/v3/@claude-flow/cli/dist/src/mcp-tools/types.js +4 -14
  422. package/v3/@claude-flow/cli/dist/src/mcp-tools/validate-input.d.ts +5 -57
  423. package/v3/@claude-flow/cli/dist/src/mcp-tools/validate-input.js +5 -233
  424. package/v3/@claude-flow/cli/dist/src/mcp-tools/wasm-agent-tools.js +1 -1
  425. package/v3/@claude-flow/cli/dist/src/memory/intelligence.js +28 -3
  426. package/v3/@claude-flow/cli/dist/src/memory/memory-bridge.d.ts +69 -0
  427. package/v3/@claude-flow/cli/dist/src/memory/memory-bridge.js +319 -66
  428. package/v3/@claude-flow/cli/dist/src/memory/memory-initializer.d.ts +5 -0
  429. package/v3/@claude-flow/cli/dist/src/memory/memory-initializer.js +369 -363
  430. package/v3/@claude-flow/cli/dist/src/memory/neural-package-bridge.d.ts +48 -0
  431. package/v3/@claude-flow/cli/dist/src/memory/neural-package-bridge.js +87 -0
  432. package/v3/@claude-flow/cli/dist/src/memory/rabitq-index.js +5 -5
  433. package/v3/@claude-flow/cli/dist/src/memory/sona-optimizer.js +1 -0
  434. package/v3/@claude-flow/cli/dist/src/output.d.ts +6 -130
  435. package/v3/@claude-flow/cli/dist/src/output.js +6 -511
  436. package/v3/@claude-flow/cli/dist/src/parser.d.ts +9 -0
  437. package/v3/@claude-flow/cli/dist/src/parser.js +11 -0
  438. package/v3/@claude-flow/cli/dist/src/runtime/headless.js +28 -28
  439. package/v3/@claude-flow/cli/dist/src/ruvector/agent-wasm.js +4 -1
  440. package/v3/@claude-flow/cli/dist/src/ruvector/index.d.ts +0 -2
  441. package/v3/@claude-flow/cli/dist/src/ruvector/index.js +8 -2
  442. package/v3/@claude-flow/cli/dist/src/ruvector/model-router.d.ts +22 -1
  443. package/v3/@claude-flow/cli/dist/src/ruvector/model-router.js +125 -5
  444. package/v3/@claude-flow/cli/dist/src/services/headless-worker-executor.js +84 -84
  445. package/v3/@claude-flow/cli/dist/src/transfer/deploy-seraphine.js +23 -23
  446. package/v3/@claude-flow/cli/dist/src/types.d.ts +10 -195
  447. package/v3/@claude-flow/cli/dist/src/types.js +10 -35
  448. package/v3/@claude-flow/cli/package.json +6 -4
  449. package/v3/@claude-flow/guidance/README.md +1195 -1195
  450. package/v3/@claude-flow/guidance/package.json +198 -198
  451. package/v3/@claude-flow/shared/README.md +323 -323
  452. package/v3/@claude-flow/shared/package.json +43 -43
  453. package/v3/README.md +493 -493
@@ -1,117 +1,117 @@
1
- # hook post-edit
2
-
3
- Execute post-edit processing including formatting, validation, and memory updates.
4
-
5
- ## Usage
6
-
7
- ```bash
8
- npx claude-flow hook post-edit [options]
9
- ```
10
-
11
- ## Options
12
-
13
- - `--file, -f <path>` - File path that was edited
14
- - `--auto-format` - Automatically format code (default: true)
15
- - `--memory-key, -m <key>` - Store edit context in memory
16
- - `--train-patterns` - Train neural patterns from edit
17
- - `--validate-output` - Validate edited file
18
-
19
- ## Examples
20
-
21
- ### Basic post-edit hook
22
-
23
- ```bash
24
- npx claude-flow hook post-edit --file "src/components/Button.jsx"
25
- ```
26
-
27
- ### With memory storage
28
-
29
- ```bash
30
- npx claude-flow hook post-edit -f "api/auth.js" --memory-key "auth/login-implementation"
31
- ```
32
-
33
- ### Format and validate
34
-
35
- ```bash
36
- npx claude-flow hook post-edit -f "config/webpack.js" --auto-format --validate-output
37
- ```
38
-
39
- ### Neural training
40
-
41
- ```bash
42
- npx claude-flow hook post-edit -f "utils/helpers.ts" --train-patterns --memory-key "utils/refactor"
43
- ```
44
-
45
- ## Features
46
-
47
- ### Auto Formatting
48
-
49
- - Language-specific formatters
50
- - Prettier for JS/TS/JSON
51
- - Black for Python
52
- - gofmt for Go
53
- - Maintains consistency
54
-
55
- ### Memory Storage
56
-
57
- - Saves edit context
58
- - Records decisions made
59
- - Tracks implementation details
60
- - Enables knowledge sharing
61
-
62
- ### Pattern Training
63
-
64
- - Learns from successful edits
65
- - Improves future suggestions
66
- - Adapts to coding style
67
- - Enhances coordination
68
-
69
- ### Output Validation
70
-
71
- - Checks syntax correctness
72
- - Runs linting rules
73
- - Validates formatting
74
- - Ensures quality
75
-
76
- ## Integration
77
-
78
- This hook is automatically called by Claude Code when:
79
-
80
- - After Edit tool completes
81
- - Following MultiEdit operations
82
- - During file saves
83
- - After code generation
84
-
85
- Manual usage in agents:
86
-
87
- ```bash
88
- # After editing files
89
- npx claude-flow hook post-edit --file "path/to/edited.js" --memory-key "feature/step1"
90
- ```
91
-
92
- ## Output
93
-
94
- Returns JSON with:
95
-
96
- ```json
97
- {
98
- "file": "src/components/Button.jsx",
99
- "formatted": true,
100
- "formatterUsed": "prettier",
101
- "lintPassed": true,
102
- "memorySaved": "component/button-refactor",
103
- "patternsTrained": 3,
104
- "warnings": [],
105
- "stats": {
106
- "linesChanged": 45,
107
- "charactersAdded": 234
108
- }
109
- }
110
- ```
111
-
112
- ## See Also
113
-
114
- - `hook pre-edit` - Pre-edit preparation
115
- - `Edit` - File editing tool
116
- - `memory usage` - Memory management
117
- - `neural train` - Pattern training
1
+ # hook post-edit
2
+
3
+ Execute post-edit processing including formatting, validation, and memory updates.
4
+
5
+ ## Usage
6
+
7
+ ```bash
8
+ npx claude-flow hook post-edit [options]
9
+ ```
10
+
11
+ ## Options
12
+
13
+ - `--file, -f <path>` - File path that was edited
14
+ - `--auto-format` - Automatically format code (default: true)
15
+ - `--memory-key, -m <key>` - Store edit context in memory
16
+ - `--train-patterns` - Train neural patterns from edit
17
+ - `--validate-output` - Validate edited file
18
+
19
+ ## Examples
20
+
21
+ ### Basic post-edit hook
22
+
23
+ ```bash
24
+ npx claude-flow hook post-edit --file "src/components/Button.jsx"
25
+ ```
26
+
27
+ ### With memory storage
28
+
29
+ ```bash
30
+ npx claude-flow hook post-edit -f "api/auth.js" --memory-key "auth/login-implementation"
31
+ ```
32
+
33
+ ### Format and validate
34
+
35
+ ```bash
36
+ npx claude-flow hook post-edit -f "config/webpack.js" --auto-format --validate-output
37
+ ```
38
+
39
+ ### Neural training
40
+
41
+ ```bash
42
+ npx claude-flow hook post-edit -f "utils/helpers.ts" --train-patterns --memory-key "utils/refactor"
43
+ ```
44
+
45
+ ## Features
46
+
47
+ ### Auto Formatting
48
+
49
+ - Language-specific formatters
50
+ - Prettier for JS/TS/JSON
51
+ - Black for Python
52
+ - gofmt for Go
53
+ - Maintains consistency
54
+
55
+ ### Memory Storage
56
+
57
+ - Saves edit context
58
+ - Records decisions made
59
+ - Tracks implementation details
60
+ - Enables knowledge sharing
61
+
62
+ ### Pattern Training
63
+
64
+ - Learns from successful edits
65
+ - Improves future suggestions
66
+ - Adapts to coding style
67
+ - Enhances coordination
68
+
69
+ ### Output Validation
70
+
71
+ - Checks syntax correctness
72
+ - Runs linting rules
73
+ - Validates formatting
74
+ - Ensures quality
75
+
76
+ ## Integration
77
+
78
+ This hook is automatically called by Claude Code when:
79
+
80
+ - After Edit tool completes
81
+ - Following MultiEdit operations
82
+ - During file saves
83
+ - After code generation
84
+
85
+ Manual usage in agents:
86
+
87
+ ```bash
88
+ # After editing files
89
+ npx claude-flow hook post-edit --file "path/to/edited.js" --memory-key "feature/step1"
90
+ ```
91
+
92
+ ## Output
93
+
94
+ Returns JSON with:
95
+
96
+ ```json
97
+ {
98
+ "file": "src/components/Button.jsx",
99
+ "formatted": true,
100
+ "formatterUsed": "prettier",
101
+ "lintPassed": true,
102
+ "memorySaved": "component/button-refactor",
103
+ "patternsTrained": 3,
104
+ "warnings": [],
105
+ "stats": {
106
+ "linesChanged": 45,
107
+ "charactersAdded": 234
108
+ }
109
+ }
110
+ ```
111
+
112
+ ## See Also
113
+
114
+ - `hook pre-edit` - Pre-edit preparation
115
+ - `Edit` - File editing tool
116
+ - `memory usage` - Memory management
117
+ - `neural train` - Pattern training
@@ -1,112 +1,112 @@
1
- # hook post-task
2
-
3
- Execute post-task cleanup, performance analysis, and memory storage.
4
-
5
- ## Usage
6
-
7
- ```bash
8
- npx claude-flow hook post-task [options]
9
- ```
10
-
11
- ## Options
12
-
13
- - `--task-id, -t <id>` - Task identifier for tracking
14
- - `--analyze-performance` - Generate performance metrics (default: true)
15
- - `--store-decisions` - Save task decisions to memory
16
- - `--export-learnings` - Export neural pattern learnings
17
- - `--generate-report` - Create task completion report
18
-
19
- ## Examples
20
-
21
- ### Basic post-task hook
22
-
23
- ```bash
24
- npx claude-flow hook post-task --task-id "auth-implementation"
25
- ```
26
-
27
- ### With full analysis
28
-
29
- ```bash
30
- npx claude-flow hook post-task -t "api-refactor" --analyze-performance --generate-report
31
- ```
32
-
33
- ### Memory storage
34
-
35
- ```bash
36
- npx claude-flow hook post-task -t "bug-fix-123" --store-decisions --export-learnings
37
- ```
38
-
39
- ### Quick cleanup
40
-
41
- ```bash
42
- npx claude-flow hook post-task -t "minor-update" --analyze-performance false
43
- ```
44
-
45
- ## Features
46
-
47
- ### Performance Analysis
48
-
49
- - Measures execution time
50
- - Tracks token usage
51
- - Identifies bottlenecks
52
- - Suggests optimizations
53
-
54
- ### Decision Storage
55
-
56
- - Saves key decisions made
57
- - Records implementation choices
58
- - Stores error resolutions
59
- - Maintains knowledge base
60
-
61
- ### Neural Learning
62
-
63
- - Exports successful patterns
64
- - Updates coordination models
65
- - Improves future performance
66
- - Trains on task outcomes
67
-
68
- ### Report Generation
69
-
70
- - Creates completion summary
71
- - Documents changes made
72
- - Lists files modified
73
- - Tracks metrics achieved
74
-
75
- ## Integration
76
-
77
- This hook is automatically called by Claude Code when:
78
-
79
- - Completing a task
80
- - Switching to a new task
81
- - Ending a work session
82
- - After major milestones
83
-
84
- Manual usage in agents:
85
-
86
- ```bash
87
- # In agent coordination
88
- npx claude-flow hook post-task --task-id "your-task-id" --analyze-performance true
89
- ```
90
-
91
- ## Output
92
-
93
- Returns JSON with:
94
-
95
- ```json
96
- {
97
- "taskId": "auth-implementation",
98
- "duration": 1800000,
99
- "tokensUsed": 45000,
100
- "filesModified": 12,
101
- "performanceScore": 0.92,
102
- "learningsExported": true,
103
- "reportPath": "/reports/task-auth-implementation.md"
104
- }
105
- ```
106
-
107
- ## See Also
108
-
109
- - `hook pre-task` - Pre-task setup
110
- - `performance report` - Detailed metrics
111
- - `memory usage` - Memory management
112
- - `neural patterns` - Pattern analysis
1
+ # hook post-task
2
+
3
+ Execute post-task cleanup, performance analysis, and memory storage.
4
+
5
+ ## Usage
6
+
7
+ ```bash
8
+ npx claude-flow hook post-task [options]
9
+ ```
10
+
11
+ ## Options
12
+
13
+ - `--task-id, -t <id>` - Task identifier for tracking
14
+ - `--analyze-performance` - Generate performance metrics (default: true)
15
+ - `--store-decisions` - Save task decisions to memory
16
+ - `--export-learnings` - Export neural pattern learnings
17
+ - `--generate-report` - Create task completion report
18
+
19
+ ## Examples
20
+
21
+ ### Basic post-task hook
22
+
23
+ ```bash
24
+ npx claude-flow hook post-task --task-id "auth-implementation"
25
+ ```
26
+
27
+ ### With full analysis
28
+
29
+ ```bash
30
+ npx claude-flow hook post-task -t "api-refactor" --analyze-performance --generate-report
31
+ ```
32
+
33
+ ### Memory storage
34
+
35
+ ```bash
36
+ npx claude-flow hook post-task -t "bug-fix-123" --store-decisions --export-learnings
37
+ ```
38
+
39
+ ### Quick cleanup
40
+
41
+ ```bash
42
+ npx claude-flow hook post-task -t "minor-update" --analyze-performance false
43
+ ```
44
+
45
+ ## Features
46
+
47
+ ### Performance Analysis
48
+
49
+ - Measures execution time
50
+ - Tracks token usage
51
+ - Identifies bottlenecks
52
+ - Suggests optimizations
53
+
54
+ ### Decision Storage
55
+
56
+ - Saves key decisions made
57
+ - Records implementation choices
58
+ - Stores error resolutions
59
+ - Maintains knowledge base
60
+
61
+ ### Neural Learning
62
+
63
+ - Exports successful patterns
64
+ - Updates coordination models
65
+ - Improves future performance
66
+ - Trains on task outcomes
67
+
68
+ ### Report Generation
69
+
70
+ - Creates completion summary
71
+ - Documents changes made
72
+ - Lists files modified
73
+ - Tracks metrics achieved
74
+
75
+ ## Integration
76
+
77
+ This hook is automatically called by Claude Code when:
78
+
79
+ - Completing a task
80
+ - Switching to a new task
81
+ - Ending a work session
82
+ - After major milestones
83
+
84
+ Manual usage in agents:
85
+
86
+ ```bash
87
+ # In agent coordination
88
+ npx claude-flow hook post-task --task-id "your-task-id" --analyze-performance true
89
+ ```
90
+
91
+ ## Output
92
+
93
+ Returns JSON with:
94
+
95
+ ```json
96
+ {
97
+ "taskId": "auth-implementation",
98
+ "duration": 1800000,
99
+ "tokensUsed": 45000,
100
+ "filesModified": 12,
101
+ "performanceScore": 0.92,
102
+ "learningsExported": true,
103
+ "reportPath": "/reports/task-auth-implementation.md"
104
+ }
105
+ ```
106
+
107
+ ## See Also
108
+
109
+ - `hook pre-task` - Pre-task setup
110
+ - `performance report` - Detailed metrics
111
+ - `memory usage` - Memory management
112
+ - `neural patterns` - Pattern analysis
@@ -1,113 +1,113 @@
1
- # hook pre-edit
2
-
3
- Execute pre-edit validations and agent assignment before file modifications.
4
-
5
- ## Usage
6
-
7
- ```bash
8
- npx claude-flow hook pre-edit [options]
9
- ```
10
-
11
- ## Options
12
-
13
- - `--file, -f <path>` - File path to be edited
14
- - `--auto-assign-agent` - Automatically assign best agent (default: true)
15
- - `--validate-syntax` - Pre-validate syntax before edit
16
- - `--check-conflicts` - Check for merge conflicts
17
- - `--backup-file` - Create backup before editing
18
-
19
- ## Examples
20
-
21
- ### Basic pre-edit hook
22
-
23
- ```bash
24
- npx claude-flow hook pre-edit --file "src/auth/login.js"
25
- ```
26
-
27
- ### With validation
28
-
29
- ```bash
30
- npx claude-flow hook pre-edit -f "config/database.js" --validate-syntax
31
- ```
32
-
33
- ### Manual agent assignment
34
-
35
- ```bash
36
- npx claude-flow hook pre-edit -f "api/users.ts" --auto-assign-agent false
37
- ```
38
-
39
- ### Safe editing with backup
40
-
41
- ```bash
42
- npx claude-flow hook pre-edit -f "production.env" --backup-file --check-conflicts
43
- ```
44
-
45
- ## Features
46
-
47
- ### Auto Agent Assignment
48
-
49
- - Analyzes file type and content
50
- - Assigns specialist agents
51
- - TypeScript → TypeScript expert
52
- - Database → Data specialist
53
- - Tests → QA engineer
54
-
55
- ### Syntax Validation
56
-
57
- - Pre-checks syntax validity
58
- - Identifies potential errors
59
- - Suggests corrections
60
- - Prevents broken code
61
-
62
- ### Conflict Detection
63
-
64
- - Checks for git conflicts
65
- - Identifies concurrent edits
66
- - Warns about stale files
67
- - Suggests merge strategies
68
-
69
- ### File Backup
70
-
71
- - Creates safety backups
72
- - Enables quick rollback
73
- - Tracks edit history
74
- - Preserves originals
75
-
76
- ## Integration
77
-
78
- This hook is automatically called by Claude Code when:
79
-
80
- - Using Edit or MultiEdit tools
81
- - Before file modifications
82
- - During refactoring operations
83
- - When updating critical files
84
-
85
- Manual usage in agents:
86
-
87
- ```bash
88
- # Before editing files
89
- npx claude-flow hook pre-edit --file "path/to/file.js" --validate-syntax
90
- ```
91
-
92
- ## Output
93
-
94
- Returns JSON with:
95
-
96
- ```json
97
- {
98
- "continue": true,
99
- "file": "src/auth/login.js",
100
- "assignedAgent": "auth-specialist",
101
- "syntaxValid": true,
102
- "conflicts": false,
103
- "backupPath": ".backups/login.js.bak",
104
- "warnings": []
105
- }
106
- ```
107
-
108
- ## See Also
109
-
110
- - `hook post-edit` - Post-edit processing
111
- - `Edit` - File editing tool
112
- - `MultiEdit` - Multiple edits tool
113
- - `agent spawn` - Manual agent creation
1
+ # hook pre-edit
2
+
3
+ Execute pre-edit validations and agent assignment before file modifications.
4
+
5
+ ## Usage
6
+
7
+ ```bash
8
+ npx claude-flow hook pre-edit [options]
9
+ ```
10
+
11
+ ## Options
12
+
13
+ - `--file, -f <path>` - File path to be edited
14
+ - `--auto-assign-agent` - Automatically assign best agent (default: true)
15
+ - `--validate-syntax` - Pre-validate syntax before edit
16
+ - `--check-conflicts` - Check for merge conflicts
17
+ - `--backup-file` - Create backup before editing
18
+
19
+ ## Examples
20
+
21
+ ### Basic pre-edit hook
22
+
23
+ ```bash
24
+ npx claude-flow hook pre-edit --file "src/auth/login.js"
25
+ ```
26
+
27
+ ### With validation
28
+
29
+ ```bash
30
+ npx claude-flow hook pre-edit -f "config/database.js" --validate-syntax
31
+ ```
32
+
33
+ ### Manual agent assignment
34
+
35
+ ```bash
36
+ npx claude-flow hook pre-edit -f "api/users.ts" --auto-assign-agent false
37
+ ```
38
+
39
+ ### Safe editing with backup
40
+
41
+ ```bash
42
+ npx claude-flow hook pre-edit -f "production.env" --backup-file --check-conflicts
43
+ ```
44
+
45
+ ## Features
46
+
47
+ ### Auto Agent Assignment
48
+
49
+ - Analyzes file type and content
50
+ - Assigns specialist agents
51
+ - TypeScript → TypeScript expert
52
+ - Database → Data specialist
53
+ - Tests → QA engineer
54
+
55
+ ### Syntax Validation
56
+
57
+ - Pre-checks syntax validity
58
+ - Identifies potential errors
59
+ - Suggests corrections
60
+ - Prevents broken code
61
+
62
+ ### Conflict Detection
63
+
64
+ - Checks for git conflicts
65
+ - Identifies concurrent edits
66
+ - Warns about stale files
67
+ - Suggests merge strategies
68
+
69
+ ### File Backup
70
+
71
+ - Creates safety backups
72
+ - Enables quick rollback
73
+ - Tracks edit history
74
+ - Preserves originals
75
+
76
+ ## Integration
77
+
78
+ This hook is automatically called by Claude Code when:
79
+
80
+ - Using Edit or MultiEdit tools
81
+ - Before file modifications
82
+ - During refactoring operations
83
+ - When updating critical files
84
+
85
+ Manual usage in agents:
86
+
87
+ ```bash
88
+ # Before editing files
89
+ npx claude-flow hook pre-edit --file "path/to/file.js" --validate-syntax
90
+ ```
91
+
92
+ ## Output
93
+
94
+ Returns JSON with:
95
+
96
+ ```json
97
+ {
98
+ "continue": true,
99
+ "file": "src/auth/login.js",
100
+ "assignedAgent": "auth-specialist",
101
+ "syntaxValid": true,
102
+ "conflicts": false,
103
+ "backupPath": ".backups/login.js.bak",
104
+ "warnings": []
105
+ }
106
+ ```
107
+
108
+ ## See Also
109
+
110
+ - `hook post-edit` - Post-edit processing
111
+ - `Edit` - File editing tool
112
+ - `MultiEdit` - Multiple edits tool
113
+ - `agent spawn` - Manual agent creation