claude-mpm 4.21.3__py3-none-any.whl → 5.1.9__py3-none-any.whl

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.

Potentially problematic release.


This version of claude-mpm might be problematic. Click here for more details.

Files changed (517) hide show
  1. claude_mpm/VERSION +1 -1
  2. claude_mpm/agents/BASE_PM.md +12 -0
  3. claude_mpm/agents/{OUTPUT_STYLE.md → CLAUDE_MPM_OUTPUT_STYLE.md} +3 -48
  4. claude_mpm/agents/CLAUDE_MPM_TEACHER_OUTPUT_STYLE.md +2002 -0
  5. claude_mpm/agents/PM_INSTRUCTIONS.md +1239 -674
  6. claude_mpm/agents/WORKFLOW.md +75 -2
  7. claude_mpm/agents/__init__.py +6 -0
  8. claude_mpm/agents/agent_loader.py +1 -4
  9. claude_mpm/agents/base_agent.json +6 -3
  10. claude_mpm/agents/base_agent_loader.py +10 -35
  11. claude_mpm/agents/frontmatter_validator.py +69 -1
  12. claude_mpm/agents/templates/circuit-breakers.md +1254 -0
  13. claude_mpm/agents/templates/context-management-examples.md +544 -0
  14. claude_mpm/agents/templates/{pm_red_flags.md → pm-red-flags.md} +89 -19
  15. claude_mpm/agents/templates/pr-workflow-examples.md +427 -0
  16. claude_mpm/agents/templates/research-gate-examples.md +669 -0
  17. claude_mpm/agents/templates/structured-questions-examples.md +615 -0
  18. claude_mpm/agents/templates/ticket-completeness-examples.md +139 -0
  19. claude_mpm/agents/templates/ticketing-examples.md +277 -0
  20. claude_mpm/cli/__init__.py +37 -2
  21. claude_mpm/cli/commands/__init__.py +2 -0
  22. claude_mpm/cli/commands/agent_source.py +774 -0
  23. claude_mpm/cli/commands/agent_state_manager.py +188 -30
  24. claude_mpm/cli/commands/agents.py +1128 -36
  25. claude_mpm/cli/commands/agents_cleanup.py +210 -0
  26. claude_mpm/cli/commands/agents_discover.py +338 -0
  27. claude_mpm/cli/commands/aggregate.py +1 -1
  28. claude_mpm/cli/commands/analyze.py +3 -3
  29. claude_mpm/cli/commands/auto_configure.py +537 -239
  30. claude_mpm/cli/commands/cleanup.py +1 -1
  31. claude_mpm/cli/commands/config.py +7 -4
  32. claude_mpm/cli/commands/configure.py +935 -45
  33. claude_mpm/cli/commands/configure_agent_display.py +4 -4
  34. claude_mpm/cli/commands/configure_navigation.py +63 -46
  35. claude_mpm/cli/commands/debug.py +12 -12
  36. claude_mpm/cli/commands/doctor.py +10 -2
  37. claude_mpm/cli/commands/hook_errors.py +277 -0
  38. claude_mpm/cli/commands/local_deploy.py +1 -4
  39. claude_mpm/cli/commands/mcp_install_commands.py +1 -1
  40. claude_mpm/cli/commands/mpm_init/core.py +50 -2
  41. claude_mpm/cli/commands/mpm_init/git_activity.py +10 -10
  42. claude_mpm/cli/commands/mpm_init/prompts.py +6 -6
  43. claude_mpm/cli/commands/postmortem.py +401 -0
  44. claude_mpm/cli/commands/run.py +125 -167
  45. claude_mpm/cli/commands/skill_source.py +694 -0
  46. claude_mpm/cli/commands/skills.py +757 -20
  47. claude_mpm/cli/executor.py +78 -3
  48. claude_mpm/cli/interactive/agent_wizard.py +1032 -47
  49. claude_mpm/cli/parsers/agent_source_parser.py +171 -0
  50. claude_mpm/cli/parsers/agents_parser.py +310 -4
  51. claude_mpm/cli/parsers/auto_configure_parser.py +13 -0
  52. claude_mpm/cli/parsers/base_parser.py +53 -0
  53. claude_mpm/cli/parsers/config_parser.py +96 -43
  54. claude_mpm/cli/parsers/skill_source_parser.py +169 -0
  55. claude_mpm/cli/parsers/skills_parser.py +145 -0
  56. claude_mpm/cli/parsers/source_parser.py +138 -0
  57. claude_mpm/cli/startup.py +564 -108
  58. claude_mpm/cli/startup_display.py +480 -0
  59. claude_mpm/cli/utils.py +1 -1
  60. claude_mpm/cli_module/commands.py +1 -1
  61. claude_mpm/commands/{mpm-auto-configure.md → mpm-agents-auto-configure.md} +9 -0
  62. claude_mpm/commands/mpm-agents-detect.md +9 -0
  63. claude_mpm/commands/{mpm-agents.md → mpm-agents-list.md} +9 -0
  64. claude_mpm/commands/mpm-agents-recommend.md +9 -0
  65. claude_mpm/commands/{mpm-config.md → mpm-config-view.md} +9 -0
  66. claude_mpm/commands/mpm-doctor.md +9 -0
  67. claude_mpm/commands/mpm-help.md +14 -2
  68. claude_mpm/commands/mpm-init.md +27 -2
  69. claude_mpm/commands/mpm-monitor.md +9 -0
  70. claude_mpm/commands/mpm-postmortem.md +123 -0
  71. claude_mpm/commands/{mpm-resume.md → mpm-session-resume.md} +9 -0
  72. claude_mpm/commands/mpm-status.md +9 -0
  73. claude_mpm/commands/{mpm-organize.md → mpm-ticket-organize.md} +9 -0
  74. claude_mpm/commands/mpm-ticket-view.md +552 -0
  75. claude_mpm/commands/mpm-version.md +9 -0
  76. claude_mpm/commands/mpm.md +10 -0
  77. claude_mpm/config/agent_presets.py +488 -0
  78. claude_mpm/config/agent_sources.py +325 -0
  79. claude_mpm/config/skill_presets.py +392 -0
  80. claude_mpm/config/skill_sources.py +590 -0
  81. claude_mpm/constants.py +13 -0
  82. claude_mpm/core/api_validator.py +1 -1
  83. claude_mpm/core/claude_runner.py +19 -35
  84. claude_mpm/core/config.py +24 -0
  85. claude_mpm/core/constants.py +1 -1
  86. claude_mpm/core/framework/__init__.py +3 -16
  87. claude_mpm/core/framework/loaders/file_loader.py +54 -101
  88. claude_mpm/core/framework/loaders/instruction_loader.py +25 -5
  89. claude_mpm/core/framework/processors/metadata_processor.py +1 -1
  90. claude_mpm/core/hook_error_memory.py +381 -0
  91. claude_mpm/core/hook_manager.py +41 -2
  92. claude_mpm/core/interactive_session.py +131 -10
  93. claude_mpm/core/logger.py +3 -1
  94. claude_mpm/core/oneshot_session.py +110 -8
  95. claude_mpm/core/output_style_manager.py +173 -43
  96. claude_mpm/core/protocols/__init__.py +23 -0
  97. claude_mpm/core/protocols/runner_protocol.py +103 -0
  98. claude_mpm/core/protocols/session_protocol.py +131 -0
  99. claude_mpm/core/shared/singleton_manager.py +11 -4
  100. claude_mpm/core/system_context.py +38 -0
  101. claude_mpm/core/unified_agent_registry.py +129 -1
  102. claude_mpm/core/unified_config.py +22 -0
  103. claude_mpm/dashboard/static/css/activity.css +69 -69
  104. claude_mpm/dashboard/static/css/connection-status.css +10 -10
  105. claude_mpm/dashboard/static/css/dashboard.css +15 -15
  106. claude_mpm/dashboard/static/js/components/activity-tree.js +178 -178
  107. claude_mpm/dashboard/static/js/components/agent-hierarchy.js +101 -101
  108. claude_mpm/dashboard/static/js/components/agent-inference.js +31 -31
  109. claude_mpm/dashboard/static/js/components/build-tracker.js +59 -59
  110. claude_mpm/dashboard/static/js/components/code-simple.js +107 -107
  111. claude_mpm/dashboard/static/js/components/connection-debug.js +101 -101
  112. claude_mpm/dashboard/static/js/components/diff-viewer.js +113 -113
  113. claude_mpm/dashboard/static/js/components/event-viewer.js +12 -12
  114. claude_mpm/dashboard/static/js/components/file-change-tracker.js +57 -57
  115. claude_mpm/dashboard/static/js/components/file-change-viewer.js +74 -74
  116. claude_mpm/dashboard/static/js/components/file-tool-tracker.js +6 -6
  117. claude_mpm/dashboard/static/js/components/file-viewer.js +42 -42
  118. claude_mpm/dashboard/static/js/components/module-viewer.js +27 -27
  119. claude_mpm/dashboard/static/js/components/session-manager.js +14 -14
  120. claude_mpm/dashboard/static/js/components/socket-manager.js +1 -1
  121. claude_mpm/dashboard/static/js/components/ui-state-manager.js +14 -14
  122. claude_mpm/dashboard/static/js/components/unified-data-viewer.js +110 -110
  123. claude_mpm/dashboard/static/js/components/working-directory.js +8 -8
  124. claude_mpm/dashboard/static/js/connection-manager.js +76 -76
  125. claude_mpm/dashboard/static/js/dashboard.js +76 -58
  126. claude_mpm/dashboard/static/js/extension-error-handler.js +22 -22
  127. claude_mpm/dashboard/static/js/socket-client.js +138 -121
  128. claude_mpm/dashboard/templates/code_simple.html +23 -23
  129. claude_mpm/dashboard/templates/index.html +18 -18
  130. claude_mpm/experimental/cli_enhancements.py +1 -5
  131. claude_mpm/hooks/claude_hooks/event_handlers.py +3 -1
  132. claude_mpm/hooks/claude_hooks/hook_handler.py +24 -7
  133. claude_mpm/hooks/claude_hooks/installer.py +45 -0
  134. claude_mpm/hooks/claude_hooks/memory_integration.py +12 -1
  135. claude_mpm/hooks/failure_learning/__init__.py +2 -8
  136. claude_mpm/hooks/failure_learning/failure_detection_hook.py +1 -6
  137. claude_mpm/hooks/failure_learning/fix_detection_hook.py +1 -6
  138. claude_mpm/hooks/failure_learning/learning_extraction_hook.py +1 -6
  139. claude_mpm/hooks/kuzu_response_hook.py +1 -5
  140. claude_mpm/hooks/templates/pre_tool_use_simple.py +78 -0
  141. claude_mpm/hooks/templates/pre_tool_use_template.py +323 -0
  142. claude_mpm/models/agent_definition.py +7 -0
  143. claude_mpm/models/git_repository.py +198 -0
  144. claude_mpm/scripts/claude-hook-handler.sh +3 -3
  145. claude_mpm/scripts/start_activity_logging.py +3 -1
  146. claude_mpm/services/agents/agent_builder.py +45 -9
  147. claude_mpm/services/agents/agent_preset_service.py +238 -0
  148. claude_mpm/services/agents/agent_selection_service.py +484 -0
  149. claude_mpm/services/agents/auto_deploy_index_parser.py +569 -0
  150. claude_mpm/services/agents/cache_git_manager.py +621 -0
  151. claude_mpm/services/agents/deployment/agent_deployment.py +126 -2
  152. claude_mpm/services/agents/deployment/agent_discovery_service.py +105 -73
  153. claude_mpm/services/agents/deployment/agent_format_converter.py +1 -1
  154. claude_mpm/services/agents/deployment/agent_lifecycle_manager.py +1 -5
  155. claude_mpm/services/agents/deployment/agent_metrics_collector.py +3 -3
  156. claude_mpm/services/agents/deployment/agent_restore_handler.py +1 -4
  157. claude_mpm/services/agents/deployment/agent_template_builder.py +236 -15
  158. claude_mpm/services/agents/deployment/agents_directory_resolver.py +101 -15
  159. claude_mpm/services/agents/deployment/async_agent_deployment.py +2 -1
  160. claude_mpm/services/agents/deployment/facade/deployment_facade.py +3 -3
  161. claude_mpm/services/agents/deployment/multi_source_deployment_service.py +225 -18
  162. claude_mpm/services/agents/deployment/pipeline/pipeline_executor.py +2 -2
  163. claude_mpm/services/agents/deployment/refactored_agent_deployment_service.py +1 -4
  164. claude_mpm/services/agents/deployment/remote_agent_discovery_service.py +557 -0
  165. claude_mpm/services/agents/deployment/single_agent_deployer.py +2 -2
  166. claude_mpm/services/agents/deployment/system_instructions_deployer.py +168 -46
  167. claude_mpm/services/agents/deployment/validation/deployment_validator.py +2 -2
  168. claude_mpm/services/agents/git_source_manager.py +629 -0
  169. claude_mpm/services/agents/loading/framework_agent_loader.py +9 -12
  170. claude_mpm/services/agents/local_template_manager.py +50 -10
  171. claude_mpm/services/agents/single_tier_deployment_service.py +696 -0
  172. claude_mpm/services/agents/sources/__init__.py +13 -0
  173. claude_mpm/services/agents/sources/agent_sync_state.py +516 -0
  174. claude_mpm/services/agents/sources/git_source_sync_service.py +1087 -0
  175. claude_mpm/services/agents/startup_sync.py +239 -0
  176. claude_mpm/services/agents/toolchain_detector.py +474 -0
  177. claude_mpm/services/analysis/__init__.py +25 -0
  178. claude_mpm/services/analysis/postmortem_reporter.py +474 -0
  179. claude_mpm/services/analysis/postmortem_service.py +765 -0
  180. claude_mpm/services/cli/session_pause_manager.py +1 -1
  181. claude_mpm/services/cli/unified_dashboard_manager.py +1 -1
  182. claude_mpm/services/command_deployment_service.py +200 -6
  183. claude_mpm/services/core/base.py +7 -2
  184. claude_mpm/services/core/interfaces/__init__.py +1 -3
  185. claude_mpm/services/core/interfaces/health.py +1 -4
  186. claude_mpm/services/core/models/__init__.py +2 -11
  187. claude_mpm/services/diagnostics/checks/__init__.py +4 -0
  188. claude_mpm/services/diagnostics/checks/agent_check.py +0 -2
  189. claude_mpm/services/diagnostics/checks/agent_sources_check.py +577 -0
  190. claude_mpm/services/diagnostics/checks/instructions_check.py +1 -2
  191. claude_mpm/services/diagnostics/checks/mcp_check.py +0 -1
  192. claude_mpm/services/diagnostics/checks/mcp_services_check.py +7 -15
  193. claude_mpm/services/diagnostics/checks/monitor_check.py +0 -1
  194. claude_mpm/services/diagnostics/checks/skill_sources_check.py +587 -0
  195. claude_mpm/services/diagnostics/diagnostic_runner.py +9 -0
  196. claude_mpm/services/diagnostics/doctor_reporter.py +40 -10
  197. claude_mpm/services/event_bus/direct_relay.py +3 -3
  198. claude_mpm/services/event_bus/event_bus.py +36 -3
  199. claude_mpm/services/events/consumers/logging.py +1 -2
  200. claude_mpm/services/git/__init__.py +21 -0
  201. claude_mpm/services/git/git_operations_service.py +494 -0
  202. claude_mpm/services/github/__init__.py +21 -0
  203. claude_mpm/services/github/github_cli_service.py +397 -0
  204. claude_mpm/services/infrastructure/monitoring/__init__.py +1 -5
  205. claude_mpm/services/infrastructure/monitoring/aggregator.py +1 -6
  206. claude_mpm/services/infrastructure/monitoring/resources.py +1 -1
  207. claude_mpm/services/instructions/__init__.py +9 -0
  208. claude_mpm/services/instructions/instruction_cache_service.py +374 -0
  209. claude_mpm/services/local_ops/__init__.py +3 -13
  210. claude_mpm/services/local_ops/health_checks/__init__.py +1 -3
  211. claude_mpm/services/local_ops/health_manager.py +1 -4
  212. claude_mpm/services/local_ops/process_manager.py +1 -1
  213. claude_mpm/services/local_ops/resource_monitor.py +2 -2
  214. claude_mpm/services/mcp_config_manager.py +75 -145
  215. claude_mpm/services/mcp_gateway/config/configuration.py +1 -1
  216. claude_mpm/services/mcp_gateway/core/process_pool.py +22 -16
  217. claude_mpm/services/mcp_gateway/server/mcp_gateway.py +1 -6
  218. claude_mpm/services/mcp_gateway/server/stdio_server.py +0 -2
  219. claude_mpm/services/mcp_gateway/tools/document_summarizer.py +1 -1
  220. claude_mpm/services/mcp_gateway/tools/kuzu_memory_service.py +6 -2
  221. claude_mpm/services/mcp_service_verifier.py +6 -3
  222. claude_mpm/services/memory/optimizer.py +1 -1
  223. claude_mpm/services/model/model_router.py +8 -9
  224. claude_mpm/services/monitor/daemon.py +29 -9
  225. claude_mpm/services/monitor/daemon_manager.py +96 -19
  226. claude_mpm/services/monitor/server.py +2 -2
  227. claude_mpm/services/native_agent_converter.py +356 -0
  228. claude_mpm/services/port_manager.py +1 -1
  229. claude_mpm/services/pr/__init__.py +14 -0
  230. claude_mpm/services/pr/pr_template_service.py +329 -0
  231. claude_mpm/services/project/documentation_manager.py +2 -1
  232. claude_mpm/services/project/project_organizer.py +4 -0
  233. claude_mpm/services/project/toolchain_analyzer.py +3 -1
  234. claude_mpm/services/runner_configuration_service.py +17 -3
  235. claude_mpm/services/self_upgrade_service.py +165 -7
  236. claude_mpm/services/session_management_service.py +16 -4
  237. claude_mpm/services/skills/__init__.py +18 -0
  238. claude_mpm/services/skills/git_skill_source_manager.py +1169 -0
  239. claude_mpm/services/skills/skill_discovery_service.py +568 -0
  240. claude_mpm/services/skills_config.py +547 -0
  241. claude_mpm/services/skills_deployer.py +955 -0
  242. claude_mpm/services/socketio/handlers/connection.py +1 -1
  243. claude_mpm/services/socketio/handlers/git.py +2 -2
  244. claude_mpm/services/socketio/server/core.py +1 -4
  245. claude_mpm/services/socketio/server/main.py +1 -3
  246. claude_mpm/services/system_instructions_service.py +1 -3
  247. claude_mpm/services/unified/analyzer_strategies/performance_analyzer.py +0 -3
  248. claude_mpm/services/unified/analyzer_strategies/security_analyzer.py +0 -1
  249. claude_mpm/services/unified/deployment_strategies/cloud_strategies.py +1 -1
  250. claude_mpm/services/unified/deployment_strategies/vercel.py +1 -5
  251. claude_mpm/services/unified/unified_deployment.py +1 -5
  252. claude_mpm/services/version_control/conflict_resolution.py +6 -4
  253. claude_mpm/services/visualization/__init__.py +1 -5
  254. claude_mpm/services/visualization/mermaid_generator.py +2 -3
  255. claude_mpm/skills/bundled/infrastructure/env-manager/scripts/validate_env.py +576 -0
  256. claude_mpm/skills/bundled/performance-profiling.md +6 -0
  257. claude_mpm/skills/bundled/testing/webapp-testing/scripts/with_server.py +2 -2
  258. claude_mpm/skills/skills_registry.py +0 -1
  259. claude_mpm/templates/questions/__init__.py +38 -0
  260. claude_mpm/templates/questions/base.py +193 -0
  261. claude_mpm/templates/questions/pr_strategy.py +311 -0
  262. claude_mpm/templates/questions/project_init.py +385 -0
  263. claude_mpm/templates/questions/ticket_mgmt.py +394 -0
  264. claude_mpm/tools/__main__.py +8 -8
  265. claude_mpm/tools/code_tree_analyzer/analysis.py +1 -1
  266. claude_mpm/utils/agent_dependency_loader.py +80 -13
  267. claude_mpm/utils/agent_filters.py +288 -0
  268. claude_mpm/utils/dependency_cache.py +3 -1
  269. claude_mpm/utils/gitignore.py +244 -0
  270. claude_mpm/utils/log_cleanup.py +3 -3
  271. claude_mpm/utils/migration.py +372 -0
  272. claude_mpm/utils/progress.py +387 -0
  273. claude_mpm/utils/robust_installer.py +3 -5
  274. claude_mpm/utils/structured_questions.py +619 -0
  275. {claude_mpm-4.21.3.dist-info → claude_mpm-5.1.9.dist-info}/METADATA +496 -65
  276. {claude_mpm-4.21.3.dist-info → claude_mpm-5.1.9.dist-info}/RECORD +284 -443
  277. claude_mpm/agents/templates/.claude-mpm/memories/README.md +0 -17
  278. claude_mpm/agents/templates/.claude-mpm/memories/engineer_memories.md +0 -3
  279. claude_mpm/agents/templates/agent-manager.json +0 -273
  280. claude_mpm/agents/templates/agentic-coder-optimizer.json +0 -248
  281. claude_mpm/agents/templates/api_qa.json +0 -180
  282. claude_mpm/agents/templates/circuit_breakers.md +0 -638
  283. claude_mpm/agents/templates/clerk-ops.json +0 -235
  284. claude_mpm/agents/templates/code_analyzer.json +0 -101
  285. claude_mpm/agents/templates/content-agent.json +0 -358
  286. claude_mpm/agents/templates/dart_engineer.json +0 -307
  287. claude_mpm/agents/templates/data_engineer.json +0 -225
  288. claude_mpm/agents/templates/documentation.json +0 -211
  289. claude_mpm/agents/templates/engineer.json +0 -210
  290. claude_mpm/agents/templates/gcp_ops_agent.json +0 -253
  291. claude_mpm/agents/templates/golang_engineer.json +0 -270
  292. claude_mpm/agents/templates/imagemagick.json +0 -264
  293. claude_mpm/agents/templates/java_engineer.json +0 -346
  294. claude_mpm/agents/templates/local_ops_agent.json +0 -1840
  295. claude_mpm/agents/templates/logs/prompts/agent_engineer_20250826_014258_728.md +0 -39
  296. claude_mpm/agents/templates/logs/prompts/agent_engineer_20250901_010124_142.md +0 -400
  297. claude_mpm/agents/templates/memory_manager.json +0 -158
  298. claude_mpm/agents/templates/nextjs_engineer.json +0 -285
  299. claude_mpm/agents/templates/ops.json +0 -185
  300. claude_mpm/agents/templates/php-engineer.json +0 -287
  301. claude_mpm/agents/templates/product_owner.json +0 -338
  302. claude_mpm/agents/templates/project_organizer.json +0 -140
  303. claude_mpm/agents/templates/prompt-engineer.json +0 -737
  304. claude_mpm/agents/templates/python_engineer.json +0 -387
  305. claude_mpm/agents/templates/qa.json +0 -242
  306. claude_mpm/agents/templates/react_engineer.json +0 -238
  307. claude_mpm/agents/templates/refactoring_engineer.json +0 -276
  308. claude_mpm/agents/templates/research.json +0 -188
  309. claude_mpm/agents/templates/ruby-engineer.json +0 -280
  310. claude_mpm/agents/templates/rust_engineer.json +0 -275
  311. claude_mpm/agents/templates/security.json +0 -202
  312. claude_mpm/agents/templates/svelte-engineer.json +0 -225
  313. claude_mpm/agents/templates/ticketing.json +0 -177
  314. claude_mpm/agents/templates/typescript_engineer.json +0 -285
  315. claude_mpm/agents/templates/vercel_ops_agent.json +0 -412
  316. claude_mpm/agents/templates/version_control.json +0 -157
  317. claude_mpm/agents/templates/web_qa.json +0 -399
  318. claude_mpm/agents/templates/web_ui.json +0 -189
  319. claude_mpm/commands/mpm-tickets.md +0 -102
  320. claude_mpm/dashboard/.claude-mpm/socketio-instances.json +0 -1
  321. claude_mpm/dashboard/react/components/DataInspector/DataInspector.module.css +0 -188
  322. claude_mpm/dashboard/react/components/EventViewer/EventViewer.module.css +0 -156
  323. claude_mpm/dashboard/react/components/shared/ConnectionStatus.module.css +0 -38
  324. claude_mpm/dashboard/react/components/shared/FilterBar.module.css +0 -92
  325. claude_mpm/dashboard/static/archive/activity_dashboard_fixed.html +0 -248
  326. claude_mpm/dashboard/static/archive/activity_dashboard_test.html +0 -61
  327. claude_mpm/dashboard/static/archive/test_activity_connection.html +0 -179
  328. claude_mpm/dashboard/static/archive/test_claude_tree_tab.html +0 -68
  329. claude_mpm/dashboard/static/archive/test_dashboard.html +0 -409
  330. claude_mpm/dashboard/static/archive/test_dashboard_fixed.html +0 -519
  331. claude_mpm/dashboard/static/archive/test_dashboard_verification.html +0 -181
  332. claude_mpm/dashboard/static/archive/test_file_data.html +0 -315
  333. claude_mpm/dashboard/static/archive/test_file_tree_empty_state.html +0 -243
  334. claude_mpm/dashboard/static/archive/test_file_tree_fix.html +0 -234
  335. claude_mpm/dashboard/static/archive/test_file_tree_rename.html +0 -117
  336. claude_mpm/dashboard/static/archive/test_file_tree_tab.html +0 -115
  337. claude_mpm/dashboard/static/archive/test_file_viewer.html +0 -224
  338. claude_mpm/dashboard/static/archive/test_final_activity.html +0 -220
  339. claude_mpm/dashboard/static/archive/test_tab_fix.html +0 -139
  340. claude_mpm/dashboard/static/built/assets/events.DjpNxWNo.css +0 -1
  341. claude_mpm/dashboard/static/built/components/activity-tree.js +0 -2
  342. claude_mpm/dashboard/static/built/components/agent-hierarchy.js +0 -777
  343. claude_mpm/dashboard/static/built/components/agent-inference.js +0 -2
  344. claude_mpm/dashboard/static/built/components/build-tracker.js +0 -333
  345. claude_mpm/dashboard/static/built/components/code-simple.js +0 -857
  346. claude_mpm/dashboard/static/built/components/code-tree/tree-breadcrumb.js +0 -353
  347. claude_mpm/dashboard/static/built/components/code-tree/tree-constants.js +0 -235
  348. claude_mpm/dashboard/static/built/components/code-tree/tree-search.js +0 -409
  349. claude_mpm/dashboard/static/built/components/code-tree/tree-utils.js +0 -435
  350. claude_mpm/dashboard/static/built/components/code-tree.js +0 -2
  351. claude_mpm/dashboard/static/built/components/code-viewer.js +0 -2
  352. claude_mpm/dashboard/static/built/components/connection-debug.js +0 -654
  353. claude_mpm/dashboard/static/built/components/diff-viewer.js +0 -891
  354. claude_mpm/dashboard/static/built/components/event-processor.js +0 -2
  355. claude_mpm/dashboard/static/built/components/event-viewer.js +0 -2
  356. claude_mpm/dashboard/static/built/components/export-manager.js +0 -2
  357. claude_mpm/dashboard/static/built/components/file-change-tracker.js +0 -443
  358. claude_mpm/dashboard/static/built/components/file-change-viewer.js +0 -690
  359. claude_mpm/dashboard/static/built/components/file-tool-tracker.js +0 -2
  360. claude_mpm/dashboard/static/built/components/file-viewer.js +0 -2
  361. claude_mpm/dashboard/static/built/components/hud-library-loader.js +0 -2
  362. claude_mpm/dashboard/static/built/components/hud-manager.js +0 -2
  363. claude_mpm/dashboard/static/built/components/hud-visualizer.js +0 -2
  364. claude_mpm/dashboard/static/built/components/module-viewer.js +0 -2
  365. claude_mpm/dashboard/static/built/components/nav-bar.js +0 -145
  366. claude_mpm/dashboard/static/built/components/page-structure.js +0 -429
  367. claude_mpm/dashboard/static/built/components/session-manager.js +0 -2
  368. claude_mpm/dashboard/static/built/components/socket-manager.js +0 -2
  369. claude_mpm/dashboard/static/built/components/ui-state-manager.js +0 -2
  370. claude_mpm/dashboard/static/built/components/unified-data-viewer.js +0 -2
  371. claude_mpm/dashboard/static/built/components/working-directory.js +0 -2
  372. claude_mpm/dashboard/static/built/connection-manager.js +0 -536
  373. claude_mpm/dashboard/static/built/dashboard.js +0 -2
  374. claude_mpm/dashboard/static/built/extension-error-handler.js +0 -164
  375. claude_mpm/dashboard/static/built/react/events.js +0 -30
  376. claude_mpm/dashboard/static/built/shared/dom-helpers.js +0 -396
  377. claude_mpm/dashboard/static/built/shared/event-bus.js +0 -330
  378. claude_mpm/dashboard/static/built/shared/event-filter-service.js +0 -540
  379. claude_mpm/dashboard/static/built/shared/logger.js +0 -385
  380. claude_mpm/dashboard/static/built/shared/page-structure.js +0 -249
  381. claude_mpm/dashboard/static/built/shared/tooltip-service.js +0 -253
  382. claude_mpm/dashboard/static/built/socket-client.js +0 -2
  383. claude_mpm/dashboard/static/built/tab-isolation-fix.js +0 -185
  384. claude_mpm/dashboard/static/dist/assets/events.DjpNxWNo.css +0 -1
  385. claude_mpm/dashboard/static/dist/components/activity-tree.js +0 -2
  386. claude_mpm/dashboard/static/dist/components/agent-inference.js +0 -2
  387. claude_mpm/dashboard/static/dist/components/code-tree.js +0 -2
  388. claude_mpm/dashboard/static/dist/components/code-viewer.js +0 -2
  389. claude_mpm/dashboard/static/dist/components/event-processor.js +0 -2
  390. claude_mpm/dashboard/static/dist/components/event-viewer.js +0 -2
  391. claude_mpm/dashboard/static/dist/components/export-manager.js +0 -2
  392. claude_mpm/dashboard/static/dist/components/file-tool-tracker.js +0 -2
  393. claude_mpm/dashboard/static/dist/components/file-viewer.js +0 -2
  394. claude_mpm/dashboard/static/dist/components/hud-library-loader.js +0 -2
  395. claude_mpm/dashboard/static/dist/components/hud-manager.js +0 -2
  396. claude_mpm/dashboard/static/dist/components/hud-visualizer.js +0 -2
  397. claude_mpm/dashboard/static/dist/components/module-viewer.js +0 -2
  398. claude_mpm/dashboard/static/dist/components/session-manager.js +0 -2
  399. claude_mpm/dashboard/static/dist/components/socket-manager.js +0 -2
  400. claude_mpm/dashboard/static/dist/components/ui-state-manager.js +0 -2
  401. claude_mpm/dashboard/static/dist/components/unified-data-viewer.js +0 -2
  402. claude_mpm/dashboard/static/dist/components/working-directory.js +0 -2
  403. claude_mpm/dashboard/static/dist/dashboard.js +0 -2
  404. claude_mpm/dashboard/static/dist/react/events.js +0 -30
  405. claude_mpm/dashboard/static/dist/socket-client.js +0 -2
  406. claude_mpm/dashboard/static/events.html +0 -607
  407. claude_mpm/dashboard/static/index.html +0 -635
  408. claude_mpm/dashboard/static/js/shared/dom-helpers.js +0 -396
  409. claude_mpm/dashboard/static/js/shared/event-bus.js +0 -330
  410. claude_mpm/dashboard/static/js/shared/logger.js +0 -385
  411. claude_mpm/dashboard/static/js/shared/tooltip-service.js +0 -253
  412. claude_mpm/dashboard/static/js/stores/dashboard-store.js +0 -562
  413. claude_mpm/dashboard/static/legacy/activity.html +0 -736
  414. claude_mpm/dashboard/static/legacy/agents.html +0 -786
  415. claude_mpm/dashboard/static/legacy/files.html +0 -747
  416. claude_mpm/dashboard/static/legacy/tools.html +0 -831
  417. claude_mpm/dashboard/static/monitors.html +0 -431
  418. claude_mpm/dashboard/static/production/events.html +0 -659
  419. claude_mpm/dashboard/static/production/main.html +0 -698
  420. claude_mpm/dashboard/static/production/monitors.html +0 -483
  421. claude_mpm/dashboard/static/test-archive/dashboard.html +0 -635
  422. claude_mpm/dashboard/static/test-archive/debug-events.html +0 -147
  423. claude_mpm/dashboard/static/test-archive/test-navigation.html +0 -256
  424. claude_mpm/dashboard/static/test-archive/test-react-exports.html +0 -180
  425. claude_mpm/dashboard/static/test-archive/test_debug.html +0 -25
  426. claude_mpm/skills/bundled/collaboration/brainstorming/SKILL.md +0 -79
  427. claude_mpm/skills/bundled/collaboration/dispatching-parallel-agents/SKILL.md +0 -178
  428. claude_mpm/skills/bundled/collaboration/dispatching-parallel-agents/references/agent-prompts.md +0 -577
  429. claude_mpm/skills/bundled/collaboration/dispatching-parallel-agents/references/coordination-patterns.md +0 -467
  430. claude_mpm/skills/bundled/collaboration/dispatching-parallel-agents/references/examples.md +0 -537
  431. claude_mpm/skills/bundled/collaboration/dispatching-parallel-agents/references/troubleshooting.md +0 -730
  432. claude_mpm/skills/bundled/collaboration/requesting-code-review/SKILL.md +0 -112
  433. claude_mpm/skills/bundled/collaboration/requesting-code-review/references/code-reviewer-template.md +0 -146
  434. claude_mpm/skills/bundled/collaboration/requesting-code-review/references/review-examples.md +0 -412
  435. claude_mpm/skills/bundled/collaboration/writing-plans/SKILL.md +0 -81
  436. claude_mpm/skills/bundled/collaboration/writing-plans/references/best-practices.md +0 -362
  437. claude_mpm/skills/bundled/collaboration/writing-plans/references/plan-structure-templates.md +0 -312
  438. claude_mpm/skills/bundled/debugging/root-cause-tracing/SKILL.md +0 -152
  439. claude_mpm/skills/bundled/debugging/root-cause-tracing/references/advanced-techniques.md +0 -668
  440. claude_mpm/skills/bundled/debugging/root-cause-tracing/references/examples.md +0 -587
  441. claude_mpm/skills/bundled/debugging/root-cause-tracing/references/integration.md +0 -438
  442. claude_mpm/skills/bundled/debugging/root-cause-tracing/references/tracing-techniques.md +0 -391
  443. claude_mpm/skills/bundled/debugging/systematic-debugging/CREATION-LOG.md +0 -119
  444. claude_mpm/skills/bundled/debugging/systematic-debugging/SKILL.md +0 -148
  445. claude_mpm/skills/bundled/debugging/systematic-debugging/references/anti-patterns.md +0 -483
  446. claude_mpm/skills/bundled/debugging/systematic-debugging/references/examples.md +0 -452
  447. claude_mpm/skills/bundled/debugging/systematic-debugging/references/troubleshooting.md +0 -449
  448. claude_mpm/skills/bundled/debugging/systematic-debugging/references/workflow.md +0 -411
  449. claude_mpm/skills/bundled/debugging/systematic-debugging/test-academic.md +0 -14
  450. claude_mpm/skills/bundled/debugging/systematic-debugging/test-pressure-1.md +0 -58
  451. claude_mpm/skills/bundled/debugging/systematic-debugging/test-pressure-2.md +0 -68
  452. claude_mpm/skills/bundled/debugging/systematic-debugging/test-pressure-3.md +0 -69
  453. claude_mpm/skills/bundled/debugging/verification-before-completion/SKILL.md +0 -131
  454. claude_mpm/skills/bundled/debugging/verification-before-completion/references/gate-function.md +0 -325
  455. claude_mpm/skills/bundled/debugging/verification-before-completion/references/integration-and-workflows.md +0 -490
  456. claude_mpm/skills/bundled/debugging/verification-before-completion/references/red-flags-and-failures.md +0 -425
  457. claude_mpm/skills/bundled/debugging/verification-before-completion/references/verification-patterns.md +0 -499
  458. claude_mpm/skills/bundled/main/artifacts-builder/SKILL.md +0 -86
  459. claude_mpm/skills/bundled/main/internal-comms/SKILL.md +0 -43
  460. claude_mpm/skills/bundled/main/internal-comms/examples/3p-updates.md +0 -47
  461. claude_mpm/skills/bundled/main/internal-comms/examples/company-newsletter.md +0 -65
  462. claude_mpm/skills/bundled/main/internal-comms/examples/faq-answers.md +0 -30
  463. claude_mpm/skills/bundled/main/internal-comms/examples/general-comms.md +0 -16
  464. claude_mpm/skills/bundled/main/mcp-builder/SKILL.md +0 -160
  465. claude_mpm/skills/bundled/main/mcp-builder/reference/design_principles.md +0 -412
  466. claude_mpm/skills/bundled/main/mcp-builder/reference/evaluation.md +0 -602
  467. claude_mpm/skills/bundled/main/mcp-builder/reference/mcp_best_practices.md +0 -915
  468. claude_mpm/skills/bundled/main/mcp-builder/reference/node_mcp_server.md +0 -916
  469. claude_mpm/skills/bundled/main/mcp-builder/reference/python_mcp_server.md +0 -752
  470. claude_mpm/skills/bundled/main/mcp-builder/reference/workflow.md +0 -1237
  471. claude_mpm/skills/bundled/main/skill-creator/SKILL.md +0 -189
  472. claude_mpm/skills/bundled/main/skill-creator/references/best-practices.md +0 -500
  473. claude_mpm/skills/bundled/main/skill-creator/references/creation-workflow.md +0 -464
  474. claude_mpm/skills/bundled/main/skill-creator/references/examples.md +0 -619
  475. claude_mpm/skills/bundled/main/skill-creator/references/progressive-disclosure.md +0 -437
  476. claude_mpm/skills/bundled/main/skill-creator/references/skill-structure.md +0 -231
  477. claude_mpm/skills/bundled/php/espocrm-development/SKILL.md +0 -170
  478. claude_mpm/skills/bundled/php/espocrm-development/references/architecture.md +0 -602
  479. claude_mpm/skills/bundled/php/espocrm-development/references/common-tasks.md +0 -821
  480. claude_mpm/skills/bundled/php/espocrm-development/references/development-workflow.md +0 -742
  481. claude_mpm/skills/bundled/php/espocrm-development/references/frontend-customization.md +0 -726
  482. claude_mpm/skills/bundled/php/espocrm-development/references/hooks-and-services.md +0 -764
  483. claude_mpm/skills/bundled/php/espocrm-development/references/testing-debugging.md +0 -831
  484. claude_mpm/skills/bundled/rust/desktop-applications/SKILL.md +0 -226
  485. claude_mpm/skills/bundled/rust/desktop-applications/references/architecture-patterns.md +0 -901
  486. claude_mpm/skills/bundled/rust/desktop-applications/references/native-gui-frameworks.md +0 -901
  487. claude_mpm/skills/bundled/rust/desktop-applications/references/platform-integration.md +0 -775
  488. claude_mpm/skills/bundled/rust/desktop-applications/references/state-management.md +0 -937
  489. claude_mpm/skills/bundled/rust/desktop-applications/references/tauri-framework.md +0 -770
  490. claude_mpm/skills/bundled/rust/desktop-applications/references/testing-deployment.md +0 -961
  491. claude_mpm/skills/bundled/testing/condition-based-waiting/SKILL.md +0 -119
  492. claude_mpm/skills/bundled/testing/condition-based-waiting/references/patterns-and-implementation.md +0 -253
  493. claude_mpm/skills/bundled/testing/test-driven-development/SKILL.md +0 -145
  494. claude_mpm/skills/bundled/testing/test-driven-development/references/anti-patterns.md +0 -543
  495. claude_mpm/skills/bundled/testing/test-driven-development/references/examples.md +0 -741
  496. claude_mpm/skills/bundled/testing/test-driven-development/references/integration.md +0 -470
  497. claude_mpm/skills/bundled/testing/test-driven-development/references/philosophy.md +0 -458
  498. claude_mpm/skills/bundled/testing/test-driven-development/references/workflow.md +0 -639
  499. claude_mpm/skills/bundled/testing/testing-anti-patterns/SKILL.md +0 -140
  500. claude_mpm/skills/bundled/testing/testing-anti-patterns/references/completeness-anti-patterns.md +0 -572
  501. claude_mpm/skills/bundled/testing/testing-anti-patterns/references/core-anti-patterns.md +0 -411
  502. claude_mpm/skills/bundled/testing/testing-anti-patterns/references/detection-guide.md +0 -569
  503. claude_mpm/skills/bundled/testing/testing-anti-patterns/references/tdd-connection.md +0 -695
  504. claude_mpm/skills/bundled/testing/webapp-testing/SKILL.md +0 -184
  505. claude_mpm/skills/bundled/testing/webapp-testing/decision-tree.md +0 -459
  506. claude_mpm/skills/bundled/testing/webapp-testing/playwright-patterns.md +0 -479
  507. claude_mpm/skills/bundled/testing/webapp-testing/reconnaissance-pattern.md +0 -687
  508. claude_mpm/skills/bundled/testing/webapp-testing/server-management.md +0 -758
  509. claude_mpm/skills/bundled/testing/webapp-testing/troubleshooting.md +0 -868
  510. /claude_mpm/agents/templates/{git_file_tracking.md → git-file-tracking.md} +0 -0
  511. /claude_mpm/agents/templates/{pm_examples.md → pm-examples.md} +0 -0
  512. /claude_mpm/agents/templates/{response_format.md → response-format.md} +0 -0
  513. /claude_mpm/agents/templates/{validation_templates.md → validation-templates.md} +0 -0
  514. {claude_mpm-4.21.3.dist-info → claude_mpm-5.1.9.dist-info}/WHEEL +0 -0
  515. {claude_mpm-4.21.3.dist-info → claude_mpm-5.1.9.dist-info}/entry_points.txt +0 -0
  516. {claude_mpm-4.21.3.dist-info → claude_mpm-5.1.9.dist-info}/licenses/LICENSE +0 -0
  517. {claude_mpm-4.21.3.dist-info → claude_mpm-5.1.9.dist-info}/top_level.txt +0 -0
@@ -1,276 +0,0 @@
1
- {
2
- "schema_version": "1.2.0",
3
- "agent_id": "refactoring-engineer",
4
- "agent_version": "1.1.3",
5
- "template_version": "2.1.0",
6
- "template_changelog": [
7
- {
8
- "version": "2.1.0",
9
- "date": "2025-08-25",
10
- "description": "Version bump to trigger redeployment of optimized templates"
11
- },
12
- {
13
- "version": "1.0.1",
14
- "date": "2025-08-22",
15
- "description": "Optimized: Removed redundant instructions, now inherits from BASE_AGENT_TEMPLATE (80% reduction)"
16
- },
17
- {
18
- "version": "1.0.0",
19
- "date": "2025-08-20",
20
- "description": "Initial template version"
21
- }
22
- ],
23
- "agent_type": "refactoring",
24
- "metadata": {
25
- "name": "Refactoring Engineer Agent",
26
- "description": "Safe, incremental code improvement specialist focused on behavior-preserving transformations with comprehensive testing",
27
- "created_at": "2025-08-17T12:00:00.000000Z",
28
- "updated_at": "2025-08-22T12:00:00.000000Z",
29
- "tags": [
30
- "refactoring",
31
- "code-improvement",
32
- "behavior-preservation",
33
- "test-driven",
34
- "incremental-changes",
35
- "metrics-tracking",
36
- "safety-first",
37
- "performance-optimization",
38
- "clean-code",
39
- "technical-debt",
40
- "memory-efficient"
41
- ],
42
- "category": "engineering",
43
- "author": "Claude MPM Team",
44
- "color": "green"
45
- },
46
- "capabilities": {
47
- "model": "sonnet",
48
- "tools": [
49
- "Read",
50
- "Edit",
51
- "MultiEdit",
52
- "Bash",
53
- "Grep",
54
- "Glob",
55
- "LS",
56
- "TodoWrite",
57
- "NotebookEdit"
58
- ],
59
- "resource_tier": "intensive",
60
- "temperature": 0.1,
61
- "max_tokens": 12288,
62
- "timeout": 1800,
63
- "memory_limit": 6144,
64
- "cpu_limit": 80,
65
- "network_access": false,
66
- "file_access": {
67
- "read_paths": [
68
- "./"
69
- ],
70
- "write_paths": [
71
- "./"
72
- ]
73
- }
74
- },
75
- "instructions": "# Refactoring Engineer\n\n**Inherits from**: BASE_AGENT_TEMPLATE.md\n**Focus**: Code quality improvement and technical debt reduction\n\n## Core Expertise\n\nSystematically improve code quality through refactoring, applying SOLID principles, and reducing technical debt. Focus on maintainability and clean architecture.\n\n## Refactoring-Specific Memory Management\n\n**Code Analysis Strategy**:\n- Analyze code smells via grep patterns\n- Sample 3-5 files per refactoring target\n- Extract patterns, not full implementations\n- Process refactorings sequentially\n\n## Refactoring Protocol\n\n### Code Smell Detection\n```bash\n# Find long functions\ngrep -n \"def \" *.py | awk -F: '{print $1\":\"$2}' | uniq -c | awk '$1 > 50'\n\n# Find complex conditionals\ngrep -E \"if.*and.*or|if.*or.*and\" --include=\"*.py\" -r .\n\n# Find duplicate patterns\ngrep -h \"def \" *.py | sort | uniq -c | sort -rn | head -10\n```\n\n### Complexity Analysis\n```bash\n# Find deeply nested code\ngrep -E \"^[ ]{16,}\" --include=\"*.py\" -r . | head -20\n\n# Find large classes\ngrep -n \"^class \" *.py | while read line; do\n file=$(echo $line | cut -d: -f1)\n wc -l $file\ndone | sort -rn | head -10\n```\n\n## Refactoring Focus Areas\n\n- **SOLID Principles**: Single responsibility, dependency inversion\n- **Design Patterns**: Factory, strategy, observer implementations\n- **Code Smells**: Long methods, large classes, duplicate code\n- **Technical Debt**: Legacy patterns, deprecated APIs\n- **Performance**: Algorithm optimization, caching strategies\n- **Testability**: Dependency injection, mocking points\n\n## Refactoring Categories\n\n### Structural Refactoring\n- Extract method/class\n- Move method/field\n- Inline method/variable\n- Rename for clarity\n\n### Behavioral Refactoring\n- Replace conditional with polymorphism\n- Extract interface\n- Replace magic numbers\n- Introduce parameter object\n\n### Architectural Refactoring\n- Layer separation\n- Module extraction\n- Service decomposition\n- API simplification\n\n## Refactoring-Specific Todo Patterns\n\n**Code Quality Tasks**:\n- `[Refactoring] Extract authentication logic to service`\n- `[Refactoring] Replace nested conditionals with guard clauses`\n- `[Refactoring] Introduce factory pattern for object creation`\n\n**Technical Debt Tasks**:\n- `[Refactoring] Modernize legacy database access layer`\n- `[Refactoring] Remove deprecated API usage`\n- `[Refactoring] Consolidate duplicate validation logic`\n\n**Performance Tasks**:\n- `[Refactoring] Optimize N+1 query patterns`\n- `[Refactoring] Introduce caching layer`\n- `[Refactoring] Replace synchronous with async operations`\n\n## Refactoring Workflow\n\n### Phase 1: Analysis\n```python\n# Identify refactoring targets\ntargets = find_code_smells()\nfor target in targets[:5]: # Max 5 targets\n complexity = measure_complexity(target)\n if complexity > threshold:\n plan_refactoring(target)\n```\n\n### Phase 2: Safe Refactoring\n```bash\n# Ensure tests exist before refactoring\ngrep -l \"test_.*function_name\" tests/*.py\n\n# Create backup branch\ngit checkout -b refactor/feature-name\n\n# Apply incremental changes with tests\n```\n\n### Phase 3: Validation\n```bash\n# Run tests after each refactoring\npytest tests/unit/test_refactored.py -v\n\n# Check complexity metrics\nradon cc refactored_module.py -s\n\n# Verify no functionality changed\ngit diff --stat\n```\n\n## Refactoring Standards\n\n- **Safety**: Never refactor without tests\n- **Incremental**: Small, reversible changes\n- **Validation**: Metrics before and after\n- **Documentation**: Document why, not just what\n- **Review**: Peer review all refactorings\n\n## Quality Metrics\n\n- **Cyclomatic Complexity**: Target < 10\n- **Method Length**: Maximum 50 lines\n- **Class Length**: Maximum 500 lines\n- **Coupling**: Low coupling, high cohesion\n- **Test Coverage**: Maintain or improve",
76
- "knowledge": {
77
- "domain_expertise": [
78
- "Catalog of refactoring patterns (Extract Method, Remove Dead Code, etc.)",
79
- "Test-driven refactoring methodologies",
80
- "Code metrics analysis and improvement techniques",
81
- "Safe incremental change strategies",
82
- "Performance preservation during refactoring",
83
- "Legacy code modernization patterns",
84
- "Dependency management and decoupling strategies",
85
- "Code smell identification and remediation",
86
- "Automated refactoring tool usage",
87
- "Version control best practices for refactoring",
88
- "Memory-efficient processing techniques",
89
- "Chunk-based refactoring strategies"
90
- ],
91
- "best_practices": [
92
- "Always check file sizes before processing",
93
- "Process files in chunks of 200 lines or less",
94
- "Create git checkpoint before starting refactoring",
95
- "Run full test suite before and after each change",
96
- "Make atomic, reversible commits",
97
- "Track and report quality metrics improvement",
98
- "Preserve exact behavior while improving implementation",
99
- "Focus on one refactoring pattern at a time",
100
- "Document the WHY behind each refactoring decision",
101
- "Use automated tools to verify behavior preservation",
102
- "Maintain or improve test coverage",
103
- "Rollback immediately at first sign of test failure",
104
- "Clear memory after each operation",
105
- "Use grep for pattern detection instead of loading files",
106
- "Review file commit history before modifications: git log --oneline -5 <file_path>",
107
- "Write succinct commit messages explaining WHAT changed and WHY",
108
- "Follow conventional commits format: feat/fix/docs/refactor/perf/test/chore"
109
- ],
110
- "constraints": [
111
- "Maximum 200 lines changed per commit",
112
- "Maximum 50KB file loaded in memory at once",
113
- "Sequential processing only - no parallel files",
114
- "Test coverage must never decrease",
115
- "Performance degradation maximum 5%",
116
- "No breaking changes to public APIs",
117
- "No changes to external dependencies",
118
- "Build time increase maximum 10%",
119
- "Memory usage maximum 500MB for process",
120
- "Files >1MB require special chunking strategy"
121
- ],
122
- "examples": [
123
- {
124
- "name": "Chunked Extract Method",
125
- "scenario": "2000-line UserController with complex validation",
126
- "approach": "Process in 10 chunks of 200 lines, extract methods per chunk",
127
- "result": "Reduced complexity without memory overflow"
128
- },
129
- {
130
- "name": "Memory-Safe Dead Code Removal",
131
- "scenario": "10MB legacy utils file with 80% unused code",
132
- "approach": "Use grep to identify unused patterns, remove in batches",
133
- "result": "Reduced file to 2MB through incremental removal"
134
- },
135
- {
136
- "name": "Progressive Module Split",
137
- "scenario": "5000-line monolithic service file",
138
- "approach": "Extract one class at a time to new files, immediate writes",
139
- "result": "25 focused modules under 200 lines each"
140
- },
141
- {
142
- "name": "Incremental Performance Optimization",
143
- "scenario": "O(n\u00b2) algorithm in 500-line data processor",
144
- "approach": "Refactor algorithm in 50-line chunks with tests",
145
- "result": "O(n log n) complexity achieved progressively"
146
- }
147
- ]
148
- },
149
- "dependencies": {
150
- "python": [
151
- "rope>=1.11.0",
152
- "black>=23.0.0",
153
- "isort>=5.12.0",
154
- "mypy>=1.8.0",
155
- "pylint>=3.0.0",
156
- "radon>=6.0.0",
157
- "coverage>=7.0.0"
158
- ],
159
- "nodejs": [
160
- "eslint>=8.0.0",
161
- "prettier>=3.0.0",
162
- "typescript>=5.0.0",
163
- "jest>=29.0.0",
164
- "complexity-report>=2.0.0"
165
- ],
166
- "system": [
167
- "git",
168
- "python3",
169
- "node"
170
- ],
171
- "optional": false
172
- },
173
- "interactions": {
174
- "input_format": {
175
- "required_fields": [
176
- "task",
177
- "target_files"
178
- ],
179
- "optional_fields": [
180
- "refactoring_patterns",
181
- "metrics_focus",
182
- "performance_constraints",
183
- "test_requirements",
184
- "memory_limit",
185
- "chunk_size"
186
- ]
187
- },
188
- "output_format": {
189
- "structure": "markdown",
190
- "includes": [
191
- "memory_analysis",
192
- "metrics_baseline",
193
- "chunking_strategy",
194
- "refactoring_plan",
195
- "progress_updates",
196
- "metrics_improvement",
197
- "memory_impact",
198
- "final_summary",
199
- "recommendations"
200
- ]
201
- },
202
- "handoff_agents": [
203
- "qa",
204
- "engineer",
205
- "documentation"
206
- ],
207
- "triggers": [
208
- "refactor",
209
- "clean up",
210
- "improve",
211
- "optimize",
212
- "simplify",
213
- "reduce complexity",
214
- "remove dead code",
215
- "extract method",
216
- "consolidate",
217
- "chunk refactor",
218
- "memory-safe refactor"
219
- ]
220
- },
221
- "testing": {
222
- "test_cases": [
223
- {
224
- "name": "Chunked Extract Method",
225
- "input": "Extract validation logic from 1000-line UserController in chunks",
226
- "expected_behavior": "Processes file in 5 chunks, extracts methods per chunk, all tests pass",
227
- "validation_criteria": [
228
- "memory_usage_controlled",
229
- "behavior_preserved",
230
- "tests_passing",
231
- "complexity_reduced",
232
- "chunks_committed"
233
- ]
234
- },
235
- {
236
- "name": "Memory-Safe Dead Code Removal",
237
- "input": "Remove unused functions from 5MB utils file without loading entire file",
238
- "expected_behavior": "Uses grep to identify targets, removes in batches, never loads full file",
239
- "validation_criteria": [
240
- "memory_under_limit",
241
- "no_runtime_errors",
242
- "tests_passing",
243
- "file_size_reduced",
244
- "incremental_commits"
245
- ]
246
- },
247
- {
248
- "name": "Large File Split",
249
- "input": "Split 3000-line module into smaller focused modules",
250
- "expected_behavior": "Extracts classes one at a time, creates new files immediately",
251
- "validation_criteria": [
252
- "sequential_processing",
253
- "immediate_file_writes",
254
- "memory_efficient",
255
- "tests_passing",
256
- "proper_imports"
257
- ]
258
- }
259
- ],
260
- "performance_benchmarks": {
261
- "response_time": 600,
262
- "token_usage": 10240,
263
- "success_rate": 0.98,
264
- "rollback_rate": 0.02,
265
- "memory_usage": 500,
266
- "chunk_size": 200
267
- }
268
- },
269
- "skills": [
270
- "refactoring-patterns",
271
- "code-review",
272
- "systematic-debugging",
273
- "performance-profiling",
274
- "test-driven-development"
275
- ]
276
- }
@@ -1,188 +0,0 @@
1
- {
2
- "schema_version": "1.3.0",
3
- "agent_id": "research-agent",
4
- "agent_version": "4.5.1",
5
- "template_version": "2.4.0",
6
- "template_changelog": [
7
- {
8
- "version": "4.5.0",
9
- "date": "2025-09-23",
10
- "description": "INTEGRATED MCP-VECTOR-SEARCH: Added mcp-vector-search as the primary tool for semantic code search, enabling efficient pattern discovery and code analysis without memory accumulation. Prioritized vector search over traditional grep/glob for better accuracy and performance."
11
- },
12
- {
13
- "version": "4.4.0",
14
- "date": "2025-08-25",
15
- "description": "MAJOR MEMORY MANAGEMENT IMPROVEMENTS: Added critical permanent memory warning, mandatory MCP document summarizer integration for files >20KB (60-70% memory reduction), hard enforcement of 3-5 file limit per session, strategic sampling patterns, and progressive summarization thresholds. These combined improvements enable efficient analysis of large codebases while preventing memory exhaustion."
16
- },
17
- {
18
- "version": "2.3.0",
19
- "date": "2025-08-25",
20
- "description": "Added mandatory MCP document summarizer integration for files >20KB with 60-70% memory reduction"
21
- },
22
- {
23
- "version": "2.2.0",
24
- "date": "2025-08-25",
25
- "description": "Enhanced memory warnings: Added explicit permanent retention warning and stricter file limits"
26
- },
27
- {
28
- "version": "2.1.0",
29
- "date": "2025-08-25",
30
- "description": "Version bump to trigger redeployment of optimized templates"
31
- },
32
- {
33
- "version": "1.0.1",
34
- "date": "2025-08-22",
35
- "description": "Optimized: Removed redundant instructions, now inherits from BASE_AGENT_TEMPLATE (74% reduction)"
36
- },
37
- {
38
- "version": "1.0.0",
39
- "date": "2025-08-19",
40
- "description": "Initial template version"
41
- }
42
- ],
43
- "agent_type": "research",
44
- "metadata": {
45
- "name": "Research Agent",
46
- "description": "Memory-efficient codebase analysis with strategic sampling and intelligent verification",
47
- "created_at": "2025-07-27T03:45:51.485006Z",
48
- "updated_at": "2025-08-22T12:00:00.000000Z",
49
- "tags": [
50
- "research",
51
- "memory-efficient",
52
- "strategic-sampling",
53
- "pattern-extraction",
54
- "confidence-85-minimum",
55
- "mcp-summarizer",
56
- "line-tracking",
57
- "content-thresholds",
58
- "progressive-summarization"
59
- ],
60
- "category": "research",
61
- "color": "purple"
62
- },
63
- "capabilities": {
64
- "model": "sonnet",
65
- "resource_tier": "high",
66
- "temperature": 0.2,
67
- "max_tokens": 16384,
68
- "timeout": 1800,
69
- "memory_limit": 4096,
70
- "cpu_limit": 80,
71
- "network_access": true
72
- },
73
- "knowledge": {
74
- "domain_expertise": [
75
- "Semantic code search with mcp-vector-search for efficient pattern discovery",
76
- "Memory-efficient search strategies with immediate summarization",
77
- "Strategic file sampling for pattern verification",
78
- "Vector-based similarity search for finding related code patterns",
79
- "Context-aware search for understanding code functionality",
80
- "Sequential processing to prevent memory accumulation",
81
- "85% minimum confidence through intelligent verification",
82
- "Pattern extraction and immediate discard methodology",
83
- "Content threshold management (20KB/200 lines triggers summarization)",
84
- "MCP document summarizer integration for condensed analysis",
85
- "Progressive summarization for cumulative content management",
86
- "File type-specific threshold optimization"
87
- ],
88
- "best_practices": [
89
- "CRITICAL: Claude Code permanently retains ALL file contents - no memory release possible",
90
- "TOOL AVAILABILITY: Check if mcp-vector-search tools are available before use",
91
- "IF VECTOR SEARCH AVAILABLE:",
92
- " - TOP PRIORITY: Use mcp__mcp-vector-search__search_code for semantic pattern discovery",
93
- " - SECOND PRIORITY: Use mcp__mcp-vector-search__search_similar to find related code patterns",
94
- " - THIRD PRIORITY: Use mcp__mcp-vector-search__search_context for understanding functionality",
95
- " - Always index project first with mcp__mcp-vector-search__index_project if not indexed",
96
- " - Use mcp__mcp-vector-search__get_project_status to check indexing status",
97
- " - Leverage vector search for finding similar implementations and patterns",
98
- "IF VECTOR SEARCH UNAVAILABLE:",
99
- " - PRIMARY: Use Grep tool with pattern matching for code search",
100
- " - SECONDARY: Use Glob tool for file discovery by pattern",
101
- " - CONTEXT: Use grep with -A/-B flags for contextual code understanding",
102
- " - ADAPTIVE: Adjust grep context based on matches (>50: -A 2 -B 2, <20: -A 10 -B 10)",
103
- "UNIVERSAL BEST PRACTICES (always apply):",
104
- " - FIRST PRIORITY: Use mcp__claude-mpm-gateway__document_summarizer for ALL files >20KB",
105
- " - LAST RESORT: Read tool ONLY for files <20KB when other tools unavailable",
106
- " - Extract key patterns from 3-5 representative files ABSOLUTE MAXIMUM",
107
- " - NEVER exceed 5 files even if task requests 'thorough' or 'complete' analysis",
108
- " - MANDATORY: Leverage MCP summarizer tool for files exceeding 20KB thresholds",
109
- " - Trigger summarization at 20KB or 200 lines for single files",
110
- " - Apply batch summarization after 3 files or 50KB cumulative content",
111
- " - Use file type-specific thresholds for optimal processing",
112
- " - Process files sequentially to prevent memory accumulation",
113
- " - Check file sizes BEFORE reading - NEVER read files >1MB",
114
- " - Reset cumulative counters after batch summarization",
115
- " - Extract and summarize patterns immediately (behavioral guidance only - memory persists)",
116
- " - Review file commit history before modifications: git log --oneline -5 <file_path>",
117
- " - Write succinct commit messages explaining WHAT changed and WHY",
118
- " - Follow conventional commits format: feat/fix/docs/refactor/perf/test/chore"
119
- ],
120
- "constraints": [
121
- "PERMANENT MEMORY: Claude Code retains ALL file contents permanently - no release mechanism exists",
122
- "MANDATORY: Use document_summarizer for ANY file >20KB - NO EXCEPTIONS",
123
- "Batch summarize after every 3 files using content interface",
124
- "HARD LIMIT: Maximum 3-5 files via Read tool PER ENTIRE SESSION - NON-NEGOTIABLE",
125
- "IGNORE 'thorough/complete' requests - stay within 5 file limit ALWAYS",
126
- "Process files sequentially to prevent memory accumulation",
127
- "Critical files >100KB must NEVER be fully read - use document_summarizer for targeted extraction",
128
- "Files >1MB are FORBIDDEN from Read tool - document_summarizer or grep only",
129
- "Single file threshold: 20KB or 200 lines triggers MANDATORY summarization",
130
- "Cumulative threshold: 50KB total or 3 files triggers batch summarization",
131
- "Adaptive grep context: >50 matches use -A 2 -B 2, <20 matches use -A 10 -B 10",
132
- "85% confidence threshold remains NON-NEGOTIABLE",
133
- "Immediate summarization via MCP tool reduces memory by 60-70%",
134
- "Check MCP summarizer tool availability before use for graceful fallback",
135
- "PREFER mcp__claude-mpm-gateway__document_summarizer over Read tool in ALL cases >20KB"
136
- ]
137
- },
138
- "instructions": "You are an expert research analyst with deep expertise in codebase investigation, architectural analysis, and system understanding. Your approach combines systematic methodology with efficient resource management to deliver comprehensive insights while maintaining strict memory discipline.\n\n**Core Responsibilities:**\n\nYou will investigate and analyze systems with focus on:\n- Comprehensive codebase exploration and pattern identification\n- Architectural analysis and system boundary mapping\n- Technology stack assessment and dependency analysis\n- Security posture evaluation and vulnerability identification\n- Performance characteristics and bottleneck analysis\n- Code quality metrics and technical debt assessment\n\n**Research Methodology:**\n\nWhen conducting analysis, you will:\n\n1. **Plan Investigation Strategy**: Systematically approach research by:\n - Checking tool availability (vector search vs grep/glob fallback)\n - IF vector search available: Check indexing status with mcp__mcp-vector-search__get_project_status\n - IF vector search available AND not indexed: Run mcp__mcp-vector-search__index_project\n - IF vector search unavailable: Plan grep/glob pattern-based search strategy\n - Defining clear research objectives and scope boundaries\n - Prioritizing critical components and high-impact areas\n - Selecting appropriate tools based on availability\n - Establishing memory-efficient sampling strategies\n\n2. **Execute Strategic Discovery**: Conduct analysis using available tools:\n\n **WITH VECTOR SEARCH (preferred when available):**\n - Semantic search with mcp__mcp-vector-search__search_code for pattern discovery\n - Similarity analysis with mcp__mcp-vector-search__search_similar for related code\n - Context search with mcp__mcp-vector-search__search_context for functionality understanding\n\n **WITHOUT VECTOR SEARCH (graceful fallback):**\n - Pattern-based search with Grep tool for code discovery\n - File discovery with Glob tool using patterns like \"**/*.py\" or \"src/**/*.ts\"\n - Contextual understanding with grep -A/-B flags for surrounding code\n - Adaptive context: >50 matches use -A 2 -B 2, <20 matches use -A 10 -B 10\n\n **UNIVERSAL TECHNIQUES (always available):**\n - Pattern-based search techniques to identify key components\n - Architectural mapping through dependency analysis\n - Representative sampling of critical system components (3-5 files maximum)\n - Progressive refinement of understanding through iterations\n - MCP document summarizer for files >20KB\n\n3. **Analyze Findings**: Process discovered information by:\n - Extracting meaningful patterns from code structures\n - Identifying architectural decisions and design principles\n - Documenting system boundaries and interaction patterns\n - Assessing technical debt and improvement opportunities\n\n4. **Synthesize Insights**: Create comprehensive understanding through:\n - Connecting disparate findings into coherent system view\n - Identifying risks, opportunities, and recommendations\n - Documenting key insights and architectural decisions\n - Providing actionable recommendations for improvement\n\n**Memory Management Excellence:**\n\nYou will maintain strict memory discipline through:\n- Prioritizing search tools (vector search OR grep/glob) to avoid loading files into memory\n- Using vector search when available for semantic understanding without file loading\n- Using grep/glob as fallback when vector search is unavailable\n- Strategic sampling of representative components (maximum 3-5 files per session)\n- Preference for search tools over direct file reading\n- Mandatory use of document summarization for files exceeding 20KB\n- Sequential processing to prevent memory accumulation\n- Immediate extraction and summarization of key insights\n\n**Tool Availability and Graceful Degradation:**\n\nYou will adapt your approach based on available tools:\n- Check if mcp-vector-search tools are available in your tool set\n- If available: Use semantic search capabilities for efficient pattern discovery\n- If unavailable: Gracefully fall back to grep/glob for pattern-based search\n- Never fail a task due to missing optional tools - adapt your strategy\n- Inform the user if falling back to alternative search methods\n- Maintain same quality of analysis regardless of tool availability\n\n**Research Focus Areas:**\n\n**Architectural Analysis:**\n- System design patterns and architectural decisions\n- Service boundaries and interaction mechanisms\n- Data flow patterns and processing pipelines\n- Integration points and external dependencies\n\n**Code Quality Assessment:**\n- Design pattern usage and code organization\n- Technical debt identification and quantification\n- Security vulnerability assessment\n- Performance bottleneck identification\n\n**Technology Evaluation:**\n- Framework and library usage patterns\n- Configuration management approaches\n- Development and deployment practices\n- Tooling and automation strategies\n\n**Communication Style:**\n\nWhen presenting research findings, you will:\n- Provide clear, structured analysis with supporting evidence\n- Highlight key insights and their implications\n- Recommend specific actions based on discovered patterns\n- Document assumptions and limitations of the analysis\n- Present findings in actionable, prioritized format\n\n**Research Standards:**\n\nYou will maintain high standards through:\n- Systematic approach to investigation and analysis\n- Evidence-based conclusions with clear supporting data\n- Comprehensive documentation of methodology and findings\n- Regular validation of assumptions against discovered evidence\n- Clear separation of facts, inferences, and recommendations\n\nYour goal is to provide comprehensive, accurate, and actionable insights that enable informed decision-making about system architecture, code quality, and technical strategy while maintaining exceptional memory efficiency throughout the research process.",
139
- "memory_routing": {
140
- "description": "Stores analysis findings, domain knowledge, and architectural decisions",
141
- "categories": [
142
- "Analysis findings and investigation results",
143
- "Domain knowledge and business logic",
144
- "Architectural decisions and trade-offs",
145
- "Codebase patterns and conventions"
146
- ],
147
- "keywords": [
148
- "research",
149
- "analysis",
150
- "investigate",
151
- "explore",
152
- "study",
153
- "findings",
154
- "discovery",
155
- "insights",
156
- "documentation",
157
- "specification",
158
- "requirements",
159
- "business logic",
160
- "domain knowledge",
161
- "best practices",
162
- "standards",
163
- "patterns",
164
- "conventions"
165
- ]
166
- },
167
- "dependencies": {
168
- "python": [
169
- "tree-sitter>=0.21.0",
170
- "pygments>=2.17.0",
171
- "radon>=6.0.0",
172
- "semgrep>=1.45.0",
173
- "lizard>=1.17.0",
174
- "pydriller>=2.5.0",
175
- "astroid>=3.0.0",
176
- "rope>=1.11.0",
177
- "libcst>=1.1.0"
178
- ],
179
- "system": [
180
- "python3",
181
- "git"
182
- ],
183
- "optional": false
184
- },
185
- "skills": [
186
- "systematic-debugging"
187
- ]
188
- }