tapps-agents 3.6.0__py3-none-any.whl → 3.6.1__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.
Files changed (815) hide show
  1. tapps_agents/__init__.py +2 -2
  2. tapps_agents/agents/__init__.py +22 -22
  3. tapps_agents/agents/analyst/__init__.py +5 -5
  4. tapps_agents/agents/architect/__init__.py +5 -5
  5. tapps_agents/agents/architect/agent.py +1033 -1033
  6. tapps_agents/agents/architect/pattern_detector.py +75 -75
  7. tapps_agents/agents/cleanup/__init__.py +7 -7
  8. tapps_agents/agents/cleanup/agent.py +445 -445
  9. tapps_agents/agents/debugger/__init__.py +7 -7
  10. tapps_agents/agents/debugger/agent.py +310 -310
  11. tapps_agents/agents/debugger/error_analyzer.py +437 -437
  12. tapps_agents/agents/designer/__init__.py +5 -5
  13. tapps_agents/agents/designer/agent.py +786 -786
  14. tapps_agents/agents/designer/visual_designer.py +638 -638
  15. tapps_agents/agents/documenter/__init__.py +7 -7
  16. tapps_agents/agents/documenter/agent.py +531 -531
  17. tapps_agents/agents/documenter/doc_generator.py +472 -472
  18. tapps_agents/agents/documenter/doc_validator.py +393 -393
  19. tapps_agents/agents/documenter/framework_doc_updater.py +493 -493
  20. tapps_agents/agents/enhancer/__init__.py +7 -7
  21. tapps_agents/agents/evaluator/__init__.py +7 -7
  22. tapps_agents/agents/evaluator/agent.py +443 -443
  23. tapps_agents/agents/evaluator/priority_evaluator.py +641 -641
  24. tapps_agents/agents/evaluator/quality_analyzer.py +147 -147
  25. tapps_agents/agents/evaluator/report_generator.py +344 -344
  26. tapps_agents/agents/evaluator/usage_analyzer.py +192 -192
  27. tapps_agents/agents/evaluator/workflow_analyzer.py +189 -189
  28. tapps_agents/agents/implementer/__init__.py +7 -7
  29. tapps_agents/agents/implementer/agent.py +798 -798
  30. tapps_agents/agents/implementer/auto_fix.py +1119 -1119
  31. tapps_agents/agents/implementer/code_generator.py +73 -73
  32. tapps_agents/agents/improver/__init__.py +1 -1
  33. tapps_agents/agents/improver/agent.py +753 -753
  34. tapps_agents/agents/ops/__init__.py +1 -1
  35. tapps_agents/agents/ops/agent.py +619 -619
  36. tapps_agents/agents/ops/dependency_analyzer.py +600 -600
  37. tapps_agents/agents/orchestrator/__init__.py +5 -5
  38. tapps_agents/agents/orchestrator/agent.py +522 -522
  39. tapps_agents/agents/planner/__init__.py +7 -7
  40. tapps_agents/agents/planner/agent.py +1127 -1127
  41. tapps_agents/agents/reviewer/__init__.py +24 -24
  42. tapps_agents/agents/reviewer/agent.py +3513 -3513
  43. tapps_agents/agents/reviewer/aggregator.py +213 -213
  44. tapps_agents/agents/reviewer/batch_review.py +448 -448
  45. tapps_agents/agents/reviewer/cache.py +443 -443
  46. tapps_agents/agents/reviewer/context7_enhancer.py +630 -630
  47. tapps_agents/agents/reviewer/context_detector.py +203 -203
  48. tapps_agents/agents/reviewer/docker_compose_validator.py +158 -158
  49. tapps_agents/agents/reviewer/dockerfile_validator.py +176 -176
  50. tapps_agents/agents/reviewer/error_handling.py +126 -126
  51. tapps_agents/agents/reviewer/feedback_generator.py +490 -490
  52. tapps_agents/agents/reviewer/influxdb_validator.py +316 -316
  53. tapps_agents/agents/reviewer/issue_tracking.py +169 -169
  54. tapps_agents/agents/reviewer/library_detector.py +295 -295
  55. tapps_agents/agents/reviewer/library_patterns.py +268 -268
  56. tapps_agents/agents/reviewer/maintainability_scorer.py +593 -593
  57. tapps_agents/agents/reviewer/metric_strategies.py +276 -276
  58. tapps_agents/agents/reviewer/mqtt_validator.py +160 -160
  59. tapps_agents/agents/reviewer/output_enhancer.py +105 -105
  60. tapps_agents/agents/reviewer/pattern_detector.py +241 -241
  61. tapps_agents/agents/reviewer/performance_scorer.py +357 -357
  62. tapps_agents/agents/reviewer/phased_review.py +516 -516
  63. tapps_agents/agents/reviewer/progressive_review.py +435 -435
  64. tapps_agents/agents/reviewer/react_scorer.py +331 -331
  65. tapps_agents/agents/reviewer/score_constants.py +228 -228
  66. tapps_agents/agents/reviewer/score_validator.py +507 -507
  67. tapps_agents/agents/reviewer/scorer_registry.py +373 -373
  68. tapps_agents/agents/reviewer/service_discovery.py +534 -534
  69. tapps_agents/agents/reviewer/tools/parallel_executor.py +581 -581
  70. tapps_agents/agents/reviewer/tools/ruff_grouping.py +250 -250
  71. tapps_agents/agents/reviewer/tools/scoped_mypy.py +284 -284
  72. tapps_agents/agents/reviewer/typescript_scorer.py +1142 -1142
  73. tapps_agents/agents/reviewer/validation.py +208 -208
  74. tapps_agents/agents/reviewer/websocket_validator.py +132 -132
  75. tapps_agents/agents/tester/__init__.py +7 -7
  76. tapps_agents/agents/tester/accessibility_auditor.py +309 -309
  77. tapps_agents/agents/tester/agent.py +1080 -1080
  78. tapps_agents/agents/tester/batch_generator.py +54 -54
  79. tapps_agents/agents/tester/context_learner.py +51 -51
  80. tapps_agents/agents/tester/coverage_analyzer.py +386 -386
  81. tapps_agents/agents/tester/coverage_test_generator.py +290 -290
  82. tapps_agents/agents/tester/debug_enhancer.py +238 -238
  83. tapps_agents/agents/tester/device_emulator.py +241 -241
  84. tapps_agents/agents/tester/integration_generator.py +62 -62
  85. tapps_agents/agents/tester/network_recorder.py +300 -300
  86. tapps_agents/agents/tester/performance_monitor.py +320 -320
  87. tapps_agents/agents/tester/test_fixer.py +316 -316
  88. tapps_agents/agents/tester/test_generator.py +632 -632
  89. tapps_agents/agents/tester/trace_manager.py +234 -234
  90. tapps_agents/agents/tester/visual_regression.py +291 -291
  91. tapps_agents/analysis/pattern_detector.py +36 -36
  92. tapps_agents/beads/hydration.py +213 -213
  93. tapps_agents/beads/parse.py +32 -32
  94. tapps_agents/beads/specs.py +206 -206
  95. tapps_agents/cli/__init__.py +9 -9
  96. tapps_agents/cli/__main__.py +8 -8
  97. tapps_agents/cli/base.py +478 -478
  98. tapps_agents/cli/command_classifier.py +72 -72
  99. tapps_agents/cli/commands/__init__.py +2 -2
  100. tapps_agents/cli/commands/analyst.py +173 -173
  101. tapps_agents/cli/commands/architect.py +109 -109
  102. tapps_agents/cli/commands/cleanup_agent.py +92 -92
  103. tapps_agents/cli/commands/common.py +126 -126
  104. tapps_agents/cli/commands/debugger.py +90 -90
  105. tapps_agents/cli/commands/designer.py +112 -112
  106. tapps_agents/cli/commands/documenter.py +136 -136
  107. tapps_agents/cli/commands/enhancer.py +110 -110
  108. tapps_agents/cli/commands/evaluator.py +255 -255
  109. tapps_agents/cli/commands/implementer.py +301 -301
  110. tapps_agents/cli/commands/improver.py +91 -91
  111. tapps_agents/cli/commands/knowledge.py +111 -111
  112. tapps_agents/cli/commands/learning.py +172 -172
  113. tapps_agents/cli/commands/observability.py +283 -283
  114. tapps_agents/cli/commands/ops.py +135 -135
  115. tapps_agents/cli/commands/orchestrator.py +116 -116
  116. tapps_agents/cli/commands/planner.py +237 -237
  117. tapps_agents/cli/commands/reviewer.py +1872 -1872
  118. tapps_agents/cli/commands/status.py +285 -285
  119. tapps_agents/cli/commands/task.py +227 -227
  120. tapps_agents/cli/commands/tester.py +191 -191
  121. tapps_agents/cli/feedback.py +936 -936
  122. tapps_agents/cli/formatters.py +608 -608
  123. tapps_agents/cli/help/__init__.py +7 -7
  124. tapps_agents/cli/help/static_help.py +425 -425
  125. tapps_agents/cli/network_detection.py +110 -110
  126. tapps_agents/cli/output_compactor.py +274 -274
  127. tapps_agents/cli/parsers/__init__.py +2 -2
  128. tapps_agents/cli/parsers/analyst.py +186 -186
  129. tapps_agents/cli/parsers/architect.py +167 -167
  130. tapps_agents/cli/parsers/cleanup_agent.py +228 -228
  131. tapps_agents/cli/parsers/debugger.py +116 -116
  132. tapps_agents/cli/parsers/designer.py +182 -182
  133. tapps_agents/cli/parsers/documenter.py +134 -134
  134. tapps_agents/cli/parsers/enhancer.py +113 -113
  135. tapps_agents/cli/parsers/evaluator.py +213 -213
  136. tapps_agents/cli/parsers/implementer.py +168 -168
  137. tapps_agents/cli/parsers/improver.py +132 -132
  138. tapps_agents/cli/parsers/ops.py +159 -159
  139. tapps_agents/cli/parsers/orchestrator.py +98 -98
  140. tapps_agents/cli/parsers/planner.py +145 -145
  141. tapps_agents/cli/parsers/reviewer.py +462 -462
  142. tapps_agents/cli/parsers/tester.py +124 -124
  143. tapps_agents/cli/progress_heartbeat.py +254 -254
  144. tapps_agents/cli/streaming_progress.py +336 -336
  145. tapps_agents/cli/utils/__init__.py +6 -6
  146. tapps_agents/cli/utils/agent_lifecycle.py +48 -48
  147. tapps_agents/cli/utils/error_formatter.py +82 -82
  148. tapps_agents/cli/utils/error_recovery.py +188 -188
  149. tapps_agents/cli/utils/output_handler.py +59 -59
  150. tapps_agents/cli/utils/prompt_enhancer.py +319 -319
  151. tapps_agents/cli/validators/__init__.py +9 -9
  152. tapps_agents/cli/validators/command_validator.py +81 -81
  153. tapps_agents/context7/__init__.py +112 -112
  154. tapps_agents/context7/agent_integration.py +869 -869
  155. tapps_agents/context7/analytics.py +382 -382
  156. tapps_agents/context7/analytics_dashboard.py +299 -299
  157. tapps_agents/context7/async_cache.py +681 -681
  158. tapps_agents/context7/backup_client.py +958 -958
  159. tapps_agents/context7/cache_locking.py +194 -194
  160. tapps_agents/context7/cache_metadata.py +214 -214
  161. tapps_agents/context7/cache_prewarm.py +488 -488
  162. tapps_agents/context7/cache_structure.py +168 -168
  163. tapps_agents/context7/cache_warming.py +604 -604
  164. tapps_agents/context7/circuit_breaker.py +376 -376
  165. tapps_agents/context7/cleanup.py +461 -461
  166. tapps_agents/context7/commands.py +858 -858
  167. tapps_agents/context7/credential_validation.py +276 -276
  168. tapps_agents/context7/cross_reference_resolver.py +168 -168
  169. tapps_agents/context7/cross_references.py +424 -424
  170. tapps_agents/context7/doc_manager.py +225 -225
  171. tapps_agents/context7/fuzzy_matcher.py +369 -369
  172. tapps_agents/context7/kb_cache.py +404 -404
  173. tapps_agents/context7/language_detector.py +219 -219
  174. tapps_agents/context7/library_detector.py +725 -725
  175. tapps_agents/context7/lookup.py +738 -738
  176. tapps_agents/context7/metadata.py +258 -258
  177. tapps_agents/context7/refresh_queue.py +300 -300
  178. tapps_agents/context7/security.py +373 -373
  179. tapps_agents/context7/staleness_policies.py +278 -278
  180. tapps_agents/context7/tiles_integration.py +47 -47
  181. tapps_agents/continuous_bug_fix/__init__.py +20 -20
  182. tapps_agents/continuous_bug_fix/bug_finder.py +306 -306
  183. tapps_agents/continuous_bug_fix/bug_fix_coordinator.py +177 -177
  184. tapps_agents/continuous_bug_fix/commit_manager.py +178 -178
  185. tapps_agents/continuous_bug_fix/continuous_bug_fixer.py +322 -322
  186. tapps_agents/continuous_bug_fix/proactive_bug_finder.py +285 -285
  187. tapps_agents/core/__init__.py +298 -298
  188. tapps_agents/core/adaptive_cache_config.py +432 -432
  189. tapps_agents/core/agent_base.py +647 -647
  190. tapps_agents/core/agent_cache.py +466 -466
  191. tapps_agents/core/agent_learning.py +1865 -1865
  192. tapps_agents/core/analytics_dashboard.py +563 -563
  193. tapps_agents/core/analytics_enhancements.py +597 -597
  194. tapps_agents/core/anonymization.py +274 -274
  195. tapps_agents/core/ast_parser.py +228 -228
  196. tapps_agents/core/async_file_ops.py +402 -402
  197. tapps_agents/core/best_practice_consultant.py +299 -299
  198. tapps_agents/core/brownfield_analyzer.py +299 -299
  199. tapps_agents/core/brownfield_review.py +541 -541
  200. tapps_agents/core/browser_controller.py +513 -513
  201. tapps_agents/core/capability_registry.py +418 -418
  202. tapps_agents/core/change_impact_analyzer.py +190 -190
  203. tapps_agents/core/checkpoint_manager.py +377 -377
  204. tapps_agents/core/code_generator.py +329 -329
  205. tapps_agents/core/code_validator.py +276 -276
  206. tapps_agents/core/command_registry.py +327 -327
  207. tapps_agents/core/context_gathering/__init__.py +2 -2
  208. tapps_agents/core/context_gathering/repository_explorer.py +28 -28
  209. tapps_agents/core/context_intelligence/__init__.py +2 -2
  210. tapps_agents/core/context_intelligence/relevance_scorer.py +24 -24
  211. tapps_agents/core/context_intelligence/token_budget_manager.py +27 -27
  212. tapps_agents/core/context_manager.py +240 -240
  213. tapps_agents/core/cursor_feedback_monitor.py +146 -146
  214. tapps_agents/core/cursor_verification.py +290 -290
  215. tapps_agents/core/customization_loader.py +280 -280
  216. tapps_agents/core/customization_schema.py +260 -260
  217. tapps_agents/core/customization_template.py +238 -238
  218. tapps_agents/core/debug_logger.py +124 -124
  219. tapps_agents/core/design_validator.py +298 -298
  220. tapps_agents/core/diagram_generator.py +226 -226
  221. tapps_agents/core/docker_utils.py +232 -232
  222. tapps_agents/core/document_generator.py +617 -617
  223. tapps_agents/core/domain_detector.py +30 -30
  224. tapps_agents/core/error_envelope.py +454 -454
  225. tapps_agents/core/error_handler.py +270 -270
  226. tapps_agents/core/estimation_tracker.py +189 -189
  227. tapps_agents/core/eval_prompt_engine.py +116 -116
  228. tapps_agents/core/evaluation_base.py +119 -119
  229. tapps_agents/core/evaluation_models.py +320 -320
  230. tapps_agents/core/evaluation_orchestrator.py +225 -225
  231. tapps_agents/core/evaluators/__init__.py +7 -7
  232. tapps_agents/core/evaluators/architectural_evaluator.py +205 -205
  233. tapps_agents/core/evaluators/behavioral_evaluator.py +160 -160
  234. tapps_agents/core/evaluators/performance_profile_evaluator.py +160 -160
  235. tapps_agents/core/evaluators/security_posture_evaluator.py +148 -148
  236. tapps_agents/core/evaluators/spec_compliance_evaluator.py +181 -181
  237. tapps_agents/core/exceptions.py +107 -107
  238. tapps_agents/core/expert_config_generator.py +293 -293
  239. tapps_agents/core/export_schema.py +202 -202
  240. tapps_agents/core/external_feedback_models.py +102 -102
  241. tapps_agents/core/external_feedback_storage.py +213 -213
  242. tapps_agents/core/fallback_strategy.py +314 -314
  243. tapps_agents/core/feedback_analyzer.py +162 -162
  244. tapps_agents/core/feedback_collector.py +178 -178
  245. tapps_agents/core/git_operations.py +445 -445
  246. tapps_agents/core/hardware_profiler.py +151 -151
  247. tapps_agents/core/instructions.py +324 -324
  248. tapps_agents/core/io_guardrails.py +69 -69
  249. tapps_agents/core/issue_manifest.py +249 -249
  250. tapps_agents/core/issue_schema.py +139 -139
  251. tapps_agents/core/json_utils.py +128 -128
  252. tapps_agents/core/knowledge_graph.py +446 -446
  253. tapps_agents/core/language_detector.py +296 -296
  254. tapps_agents/core/learning_confidence.py +242 -242
  255. tapps_agents/core/learning_dashboard.py +246 -246
  256. tapps_agents/core/learning_decision.py +384 -384
  257. tapps_agents/core/learning_explainability.py +578 -578
  258. tapps_agents/core/learning_export.py +287 -287
  259. tapps_agents/core/learning_integration.py +228 -228
  260. tapps_agents/core/llm_behavior.py +232 -232
  261. tapps_agents/core/long_duration_support.py +786 -786
  262. tapps_agents/core/mcp_setup.py +106 -106
  263. tapps_agents/core/memory_integration.py +396 -396
  264. tapps_agents/core/meta_learning.py +666 -666
  265. tapps_agents/core/module_path_sanitizer.py +199 -199
  266. tapps_agents/core/multi_agent_orchestrator.py +382 -382
  267. tapps_agents/core/network_errors.py +125 -125
  268. tapps_agents/core/nfr_validator.py +336 -336
  269. tapps_agents/core/offline_mode.py +158 -158
  270. tapps_agents/core/output_contracts.py +300 -300
  271. tapps_agents/core/output_formatter.py +300 -300
  272. tapps_agents/core/path_normalizer.py +174 -174
  273. tapps_agents/core/path_validator.py +322 -322
  274. tapps_agents/core/pattern_library.py +250 -250
  275. tapps_agents/core/performance_benchmark.py +301 -301
  276. tapps_agents/core/performance_monitor.py +184 -184
  277. tapps_agents/core/playwright_mcp_controller.py +771 -771
  278. tapps_agents/core/policy_loader.py +135 -135
  279. tapps_agents/core/progress.py +166 -166
  280. tapps_agents/core/project_profile.py +354 -354
  281. tapps_agents/core/project_type_detector.py +454 -454
  282. tapps_agents/core/prompt_base.py +223 -223
  283. tapps_agents/core/prompt_learning/__init__.py +2 -2
  284. tapps_agents/core/prompt_learning/learning_loop.py +24 -24
  285. tapps_agents/core/prompt_learning/project_prompt_store.py +25 -25
  286. tapps_agents/core/prompt_learning/skills_prompt_analyzer.py +35 -35
  287. tapps_agents/core/prompt_optimization/__init__.py +6 -6
  288. tapps_agents/core/prompt_optimization/ab_tester.py +114 -114
  289. tapps_agents/core/prompt_optimization/correlation_analyzer.py +160 -160
  290. tapps_agents/core/prompt_optimization/progressive_refiner.py +129 -129
  291. tapps_agents/core/prompt_optimization/prompt_library.py +37 -37
  292. tapps_agents/core/requirements_evaluator.py +431 -431
  293. tapps_agents/core/resource_aware_executor.py +449 -449
  294. tapps_agents/core/resource_monitor.py +343 -343
  295. tapps_agents/core/resume_handler.py +298 -298
  296. tapps_agents/core/retry_handler.py +197 -197
  297. tapps_agents/core/review_checklists.py +479 -479
  298. tapps_agents/core/role_loader.py +201 -201
  299. tapps_agents/core/role_template_loader.py +201 -201
  300. tapps_agents/core/runtime_mode.py +60 -60
  301. tapps_agents/core/security_scanner.py +342 -342
  302. tapps_agents/core/skill_agent_registry.py +194 -194
  303. tapps_agents/core/skill_integration.py +208 -208
  304. tapps_agents/core/skill_loader.py +492 -492
  305. tapps_agents/core/skill_template.py +341 -341
  306. tapps_agents/core/skill_validator.py +478 -478
  307. tapps_agents/core/stack_analyzer.py +35 -35
  308. tapps_agents/core/startup.py +174 -174
  309. tapps_agents/core/storage_manager.py +397 -397
  310. tapps_agents/core/storage_models.py +166 -166
  311. tapps_agents/core/story_evaluator.py +410 -410
  312. tapps_agents/core/subprocess_utils.py +170 -170
  313. tapps_agents/core/task_duration.py +296 -296
  314. tapps_agents/core/task_memory.py +582 -582
  315. tapps_agents/core/task_state.py +226 -226
  316. tapps_agents/core/tech_stack_priorities.py +208 -208
  317. tapps_agents/core/temp_directory.py +194 -194
  318. tapps_agents/core/template_merger.py +600 -600
  319. tapps_agents/core/template_selector.py +280 -280
  320. tapps_agents/core/test_generator.py +286 -286
  321. tapps_agents/core/tiered_context.py +253 -253
  322. tapps_agents/core/token_monitor.py +345 -345
  323. tapps_agents/core/traceability.py +254 -254
  324. tapps_agents/core/trajectory_tracker.py +50 -50
  325. tapps_agents/core/unicode_safe.py +143 -143
  326. tapps_agents/core/unified_cache_config.py +170 -170
  327. tapps_agents/core/unified_state.py +324 -324
  328. tapps_agents/core/validate_cursor_setup.py +237 -237
  329. tapps_agents/core/validation_registry.py +136 -136
  330. tapps_agents/core/validators/__init__.py +4 -4
  331. tapps_agents/core/validators/python_validator.py +87 -87
  332. tapps_agents/core/verification_agent.py +90 -90
  333. tapps_agents/core/visual_feedback.py +644 -644
  334. tapps_agents/core/workflow_validator.py +197 -197
  335. tapps_agents/core/worktree.py +367 -367
  336. tapps_agents/docker/__init__.py +10 -10
  337. tapps_agents/docker/analyzer.py +186 -186
  338. tapps_agents/docker/debugger.py +229 -229
  339. tapps_agents/docker/error_patterns.py +216 -216
  340. tapps_agents/epic/__init__.py +22 -22
  341. tapps_agents/epic/beads_sync.py +115 -115
  342. tapps_agents/epic/markdown_sync.py +105 -105
  343. tapps_agents/epic/models.py +96 -96
  344. tapps_agents/experts/__init__.py +163 -163
  345. tapps_agents/experts/agent_integration.py +243 -243
  346. tapps_agents/experts/auto_generator.py +331 -331
  347. tapps_agents/experts/base_expert.py +536 -536
  348. tapps_agents/experts/builtin_registry.py +261 -261
  349. tapps_agents/experts/business_metrics.py +565 -565
  350. tapps_agents/experts/cache.py +266 -266
  351. tapps_agents/experts/confidence_breakdown.py +306 -306
  352. tapps_agents/experts/confidence_calculator.py +336 -336
  353. tapps_agents/experts/confidence_metrics.py +236 -236
  354. tapps_agents/experts/domain_config.py +311 -311
  355. tapps_agents/experts/domain_detector.py +550 -550
  356. tapps_agents/experts/domain_utils.py +84 -84
  357. tapps_agents/experts/expert_config.py +113 -113
  358. tapps_agents/experts/expert_engine.py +465 -465
  359. tapps_agents/experts/expert_registry.py +744 -744
  360. tapps_agents/experts/expert_synthesizer.py +70 -70
  361. tapps_agents/experts/governance.py +197 -197
  362. tapps_agents/experts/history_logger.py +312 -312
  363. tapps_agents/experts/knowledge/README.md +180 -180
  364. tapps_agents/experts/knowledge/accessibility/accessible-forms.md +331 -331
  365. tapps_agents/experts/knowledge/accessibility/aria-patterns.md +344 -344
  366. tapps_agents/experts/knowledge/accessibility/color-contrast.md +285 -285
  367. tapps_agents/experts/knowledge/accessibility/keyboard-navigation.md +332 -332
  368. tapps_agents/experts/knowledge/accessibility/screen-readers.md +282 -282
  369. tapps_agents/experts/knowledge/accessibility/semantic-html.md +355 -355
  370. tapps_agents/experts/knowledge/accessibility/testing-accessibility.md +369 -369
  371. tapps_agents/experts/knowledge/accessibility/wcag-2.1.md +296 -296
  372. tapps_agents/experts/knowledge/accessibility/wcag-2.2.md +211 -211
  373. tapps_agents/experts/knowledge/agent-learning/best-practices.md +715 -715
  374. tapps_agents/experts/knowledge/agent-learning/pattern-extraction.md +282 -282
  375. tapps_agents/experts/knowledge/agent-learning/prompt-optimization.md +320 -320
  376. tapps_agents/experts/knowledge/ai-frameworks/model-optimization.md +90 -90
  377. tapps_agents/experts/knowledge/ai-frameworks/openvino-patterns.md +260 -260
  378. tapps_agents/experts/knowledge/api-design-integration/api-gateway-patterns.md +309 -309
  379. tapps_agents/experts/knowledge/api-design-integration/api-security-patterns.md +521 -521
  380. tapps_agents/experts/knowledge/api-design-integration/api-versioning.md +421 -421
  381. tapps_agents/experts/knowledge/api-design-integration/async-protocol-patterns.md +61 -61
  382. tapps_agents/experts/knowledge/api-design-integration/contract-testing.md +221 -221
  383. tapps_agents/experts/knowledge/api-design-integration/external-api-integration.md +489 -489
  384. tapps_agents/experts/knowledge/api-design-integration/fastapi-patterns.md +360 -360
  385. tapps_agents/experts/knowledge/api-design-integration/fastapi-testing.md +262 -262
  386. tapps_agents/experts/knowledge/api-design-integration/graphql-patterns.md +582 -582
  387. tapps_agents/experts/knowledge/api-design-integration/grpc-best-practices.md +499 -499
  388. tapps_agents/experts/knowledge/api-design-integration/mqtt-patterns.md +455 -455
  389. tapps_agents/experts/knowledge/api-design-integration/rate-limiting.md +507 -507
  390. tapps_agents/experts/knowledge/api-design-integration/restful-api-design.md +618 -618
  391. tapps_agents/experts/knowledge/api-design-integration/websocket-patterns.md +480 -480
  392. tapps_agents/experts/knowledge/cloud-infrastructure/cloud-native-patterns.md +175 -175
  393. tapps_agents/experts/knowledge/cloud-infrastructure/container-health-checks.md +261 -261
  394. tapps_agents/experts/knowledge/cloud-infrastructure/containerization.md +222 -222
  395. tapps_agents/experts/knowledge/cloud-infrastructure/cost-optimization.md +122 -122
  396. tapps_agents/experts/knowledge/cloud-infrastructure/disaster-recovery.md +153 -153
  397. tapps_agents/experts/knowledge/cloud-infrastructure/dockerfile-patterns.md +285 -285
  398. tapps_agents/experts/knowledge/cloud-infrastructure/infrastructure-as-code.md +187 -187
  399. tapps_agents/experts/knowledge/cloud-infrastructure/kubernetes-patterns.md +253 -253
  400. tapps_agents/experts/knowledge/cloud-infrastructure/multi-cloud-strategies.md +155 -155
  401. tapps_agents/experts/knowledge/cloud-infrastructure/serverless-architecture.md +200 -200
  402. tapps_agents/experts/knowledge/code-quality-analysis/README.md +16 -16
  403. tapps_agents/experts/knowledge/code-quality-analysis/code-metrics.md +137 -137
  404. tapps_agents/experts/knowledge/code-quality-analysis/complexity-analysis.md +181 -181
  405. tapps_agents/experts/knowledge/code-quality-analysis/technical-debt-patterns.md +191 -191
  406. tapps_agents/experts/knowledge/data-privacy-compliance/anonymization.md +313 -313
  407. tapps_agents/experts/knowledge/data-privacy-compliance/ccpa.md +255 -255
  408. tapps_agents/experts/knowledge/data-privacy-compliance/consent-management.md +282 -282
  409. tapps_agents/experts/knowledge/data-privacy-compliance/data-minimization.md +275 -275
  410. tapps_agents/experts/knowledge/data-privacy-compliance/data-retention.md +297 -297
  411. tapps_agents/experts/knowledge/data-privacy-compliance/data-subject-rights.md +383 -383
  412. tapps_agents/experts/knowledge/data-privacy-compliance/encryption-privacy.md +285 -285
  413. tapps_agents/experts/knowledge/data-privacy-compliance/gdpr.md +344 -344
  414. tapps_agents/experts/knowledge/data-privacy-compliance/hipaa.md +385 -385
  415. tapps_agents/experts/knowledge/data-privacy-compliance/privacy-by-design.md +280 -280
  416. tapps_agents/experts/knowledge/database-data-management/acid-vs-cap.md +164 -164
  417. tapps_agents/experts/knowledge/database-data-management/backup-and-recovery.md +182 -182
  418. tapps_agents/experts/knowledge/database-data-management/data-modeling.md +172 -172
  419. tapps_agents/experts/knowledge/database-data-management/database-design.md +187 -187
  420. tapps_agents/experts/knowledge/database-data-management/flux-query-optimization.md +342 -342
  421. tapps_agents/experts/knowledge/database-data-management/influxdb-connection-patterns.md +432 -432
  422. tapps_agents/experts/knowledge/database-data-management/influxdb-patterns.md +442 -442
  423. tapps_agents/experts/knowledge/database-data-management/migration-strategies.md +216 -216
  424. tapps_agents/experts/knowledge/database-data-management/nosql-patterns.md +259 -259
  425. tapps_agents/experts/knowledge/database-data-management/scalability-patterns.md +184 -184
  426. tapps_agents/experts/knowledge/database-data-management/sql-optimization.md +175 -175
  427. tapps_agents/experts/knowledge/database-data-management/time-series-modeling.md +444 -444
  428. tapps_agents/experts/knowledge/development-workflow/README.md +16 -16
  429. tapps_agents/experts/knowledge/development-workflow/automation-best-practices.md +216 -216
  430. tapps_agents/experts/knowledge/development-workflow/build-strategies.md +198 -198
  431. tapps_agents/experts/knowledge/development-workflow/deployment-patterns.md +205 -205
  432. tapps_agents/experts/knowledge/development-workflow/git-workflows.md +205 -205
  433. tapps_agents/experts/knowledge/documentation-knowledge-management/README.md +16 -16
  434. tapps_agents/experts/knowledge/documentation-knowledge-management/api-documentation-patterns.md +231 -231
  435. tapps_agents/experts/knowledge/documentation-knowledge-management/documentation-standards.md +191 -191
  436. tapps_agents/experts/knowledge/documentation-knowledge-management/knowledge-management.md +171 -171
  437. tapps_agents/experts/knowledge/documentation-knowledge-management/technical-writing-guide.md +192 -192
  438. tapps_agents/experts/knowledge/observability-monitoring/alerting-patterns.md +461 -461
  439. tapps_agents/experts/knowledge/observability-monitoring/apm-tools.md +459 -459
  440. tapps_agents/experts/knowledge/observability-monitoring/distributed-tracing.md +367 -367
  441. tapps_agents/experts/knowledge/observability-monitoring/logging-strategies.md +478 -478
  442. tapps_agents/experts/knowledge/observability-monitoring/metrics-and-monitoring.md +510 -510
  443. tapps_agents/experts/knowledge/observability-monitoring/observability-best-practices.md +492 -492
  444. tapps_agents/experts/knowledge/observability-monitoring/open-telemetry.md +573 -573
  445. tapps_agents/experts/knowledge/observability-monitoring/slo-sli-sla.md +419 -419
  446. tapps_agents/experts/knowledge/performance/anti-patterns.md +284 -284
  447. tapps_agents/experts/knowledge/performance/api-performance.md +256 -256
  448. tapps_agents/experts/knowledge/performance/caching.md +327 -327
  449. tapps_agents/experts/knowledge/performance/database-performance.md +252 -252
  450. tapps_agents/experts/knowledge/performance/optimization-patterns.md +327 -327
  451. tapps_agents/experts/knowledge/performance/profiling.md +297 -297
  452. tapps_agents/experts/knowledge/performance/resource-management.md +293 -293
  453. tapps_agents/experts/knowledge/performance/scalability.md +306 -306
  454. tapps_agents/experts/knowledge/security/owasp-top10.md +209 -209
  455. tapps_agents/experts/knowledge/security/secure-coding-practices.md +207 -207
  456. tapps_agents/experts/knowledge/security/threat-modeling.md +220 -220
  457. tapps_agents/experts/knowledge/security/vulnerability-patterns.md +342 -342
  458. tapps_agents/experts/knowledge/software-architecture/docker-compose-patterns.md +314 -314
  459. tapps_agents/experts/knowledge/software-architecture/microservices-patterns.md +379 -379
  460. tapps_agents/experts/knowledge/software-architecture/service-communication.md +316 -316
  461. tapps_agents/experts/knowledge/testing/best-practices.md +310 -310
  462. tapps_agents/experts/knowledge/testing/coverage-analysis.md +293 -293
  463. tapps_agents/experts/knowledge/testing/mocking.md +256 -256
  464. tapps_agents/experts/knowledge/testing/test-automation.md +276 -276
  465. tapps_agents/experts/knowledge/testing/test-data.md +271 -271
  466. tapps_agents/experts/knowledge/testing/test-design-patterns.md +280 -280
  467. tapps_agents/experts/knowledge/testing/test-maintenance.md +236 -236
  468. tapps_agents/experts/knowledge/testing/test-strategies.md +311 -311
  469. tapps_agents/experts/knowledge/user-experience/information-architecture.md +325 -325
  470. tapps_agents/experts/knowledge/user-experience/interaction-design.md +363 -363
  471. tapps_agents/experts/knowledge/user-experience/prototyping.md +293 -293
  472. tapps_agents/experts/knowledge/user-experience/usability-heuristics.md +337 -337
  473. tapps_agents/experts/knowledge/user-experience/usability-testing.md +311 -311
  474. tapps_agents/experts/knowledge/user-experience/user-journeys.md +296 -296
  475. tapps_agents/experts/knowledge/user-experience/user-research.md +373 -373
  476. tapps_agents/experts/knowledge/user-experience/ux-principles.md +340 -340
  477. tapps_agents/experts/knowledge_freshness.py +321 -321
  478. tapps_agents/experts/knowledge_ingestion.py +438 -438
  479. tapps_agents/experts/knowledge_need_detector.py +93 -93
  480. tapps_agents/experts/knowledge_validator.py +382 -382
  481. tapps_agents/experts/observability.py +440 -440
  482. tapps_agents/experts/passive_notifier.py +238 -238
  483. tapps_agents/experts/proactive_orchestrator.py +32 -32
  484. tapps_agents/experts/rag_chunker.py +205 -205
  485. tapps_agents/experts/rag_embedder.py +152 -152
  486. tapps_agents/experts/rag_evaluation.py +299 -299
  487. tapps_agents/experts/rag_index.py +303 -303
  488. tapps_agents/experts/rag_metrics.py +293 -293
  489. tapps_agents/experts/rag_safety.py +263 -263
  490. tapps_agents/experts/report_generator.py +296 -296
  491. tapps_agents/experts/setup_wizard.py +441 -441
  492. tapps_agents/experts/simple_rag.py +431 -431
  493. tapps_agents/experts/vector_rag.py +354 -354
  494. tapps_agents/experts/weight_distributor.py +304 -304
  495. tapps_agents/health/__init__.py +24 -24
  496. tapps_agents/health/base.py +75 -75
  497. tapps_agents/health/checks/__init__.py +22 -22
  498. tapps_agents/health/checks/automation.py +127 -127
  499. tapps_agents/health/checks/context7_cache.py +210 -210
  500. tapps_agents/health/checks/environment.py +116 -116
  501. tapps_agents/health/checks/execution.py +170 -170
  502. tapps_agents/health/checks/knowledge_base.py +187 -187
  503. tapps_agents/health/checks/outcomes.backup_20260204_064058.py +324 -0
  504. tapps_agents/health/checks/outcomes.backup_20260204_064256.py +324 -0
  505. tapps_agents/health/checks/outcomes.backup_20260204_064600.py +324 -0
  506. tapps_agents/health/checks/outcomes.py +324 -324
  507. tapps_agents/health/collector.py +280 -280
  508. tapps_agents/health/dashboard.py +137 -137
  509. tapps_agents/health/metrics.py +151 -151
  510. tapps_agents/health/registry.py +166 -166
  511. tapps_agents/hooks/__init__.py +33 -33
  512. tapps_agents/hooks/config.py +140 -140
  513. tapps_agents/hooks/events.py +135 -135
  514. tapps_agents/hooks/executor.py +128 -128
  515. tapps_agents/hooks/manager.py +143 -143
  516. tapps_agents/integration/__init__.py +8 -8
  517. tapps_agents/integration/service_integrator.py +121 -121
  518. tapps_agents/integrations/__init__.py +10 -10
  519. tapps_agents/integrations/clawdbot.py +525 -525
  520. tapps_agents/integrations/memory_bridge.py +356 -356
  521. tapps_agents/mcp/__init__.py +18 -18
  522. tapps_agents/mcp/gateway.py +112 -112
  523. tapps_agents/mcp/servers/__init__.py +13 -13
  524. tapps_agents/mcp/servers/analysis.py +204 -204
  525. tapps_agents/mcp/servers/context7.py +198 -198
  526. tapps_agents/mcp/servers/filesystem.py +218 -218
  527. tapps_agents/mcp/servers/git.py +201 -201
  528. tapps_agents/mcp/tool_registry.py +115 -115
  529. tapps_agents/quality/__init__.py +54 -54
  530. tapps_agents/quality/coverage_analyzer.py +379 -379
  531. tapps_agents/quality/enforcement.py +82 -82
  532. tapps_agents/quality/gates/__init__.py +37 -37
  533. tapps_agents/quality/gates/approval_gate.py +255 -255
  534. tapps_agents/quality/gates/base.py +84 -84
  535. tapps_agents/quality/gates/exceptions.py +43 -43
  536. tapps_agents/quality/gates/policy_gate.py +195 -195
  537. tapps_agents/quality/gates/registry.py +239 -239
  538. tapps_agents/quality/gates/security_gate.py +156 -156
  539. tapps_agents/quality/quality_gates.py +369 -369
  540. tapps_agents/quality/secret_scanner.py +335 -335
  541. tapps_agents/resources/__init__.py +5 -0
  542. tapps_agents/resources/claude/__init__.py +1 -0
  543. tapps_agents/resources/claude/commands/README.md +156 -0
  544. tapps_agents/resources/claude/commands/__init__.py +1 -0
  545. tapps_agents/resources/claude/commands/build-fix.md +22 -0
  546. tapps_agents/resources/claude/commands/build.md +77 -0
  547. tapps_agents/resources/claude/commands/debug.md +53 -0
  548. tapps_agents/resources/claude/commands/design.md +68 -0
  549. tapps_agents/resources/claude/commands/docs.md +53 -0
  550. tapps_agents/resources/claude/commands/e2e.md +22 -0
  551. tapps_agents/resources/claude/commands/fix.md +54 -0
  552. tapps_agents/resources/claude/commands/implement.md +53 -0
  553. tapps_agents/resources/claude/commands/improve.md +53 -0
  554. tapps_agents/resources/claude/commands/library-docs.md +64 -0
  555. tapps_agents/resources/claude/commands/lint.md +52 -0
  556. tapps_agents/resources/claude/commands/plan.md +65 -0
  557. tapps_agents/resources/claude/commands/refactor-clean.md +21 -0
  558. tapps_agents/resources/claude/commands/refactor.md +55 -0
  559. tapps_agents/resources/claude/commands/review.md +67 -0
  560. tapps_agents/resources/claude/commands/score.md +60 -0
  561. tapps_agents/resources/claude/commands/security-review.md +22 -0
  562. tapps_agents/resources/claude/commands/security-scan.md +54 -0
  563. tapps_agents/resources/claude/commands/tdd.md +24 -0
  564. tapps_agents/resources/claude/commands/test-coverage.md +21 -0
  565. tapps_agents/resources/claude/commands/test.md +54 -0
  566. tapps_agents/resources/claude/commands/update-codemaps.md +20 -0
  567. tapps_agents/resources/claude/commands/update-docs.md +21 -0
  568. tapps_agents/resources/claude/skills/__init__.py +1 -0
  569. tapps_agents/resources/claude/skills/analyst/SKILL.md +272 -0
  570. tapps_agents/resources/claude/skills/analyst/__init__.py +1 -0
  571. tapps_agents/resources/claude/skills/architect/SKILL.md +282 -0
  572. tapps_agents/resources/claude/skills/architect/__init__.py +1 -0
  573. tapps_agents/resources/claude/skills/backend-patterns/SKILL.md +30 -0
  574. tapps_agents/resources/claude/skills/backend-patterns/__init__.py +1 -0
  575. tapps_agents/resources/claude/skills/coding-standards/SKILL.md +29 -0
  576. tapps_agents/resources/claude/skills/coding-standards/__init__.py +1 -0
  577. tapps_agents/resources/claude/skills/debugger/SKILL.md +203 -0
  578. tapps_agents/resources/claude/skills/debugger/__init__.py +1 -0
  579. tapps_agents/resources/claude/skills/designer/SKILL.md +243 -0
  580. tapps_agents/resources/claude/skills/designer/__init__.py +1 -0
  581. tapps_agents/resources/claude/skills/documenter/SKILL.md +252 -0
  582. tapps_agents/resources/claude/skills/documenter/__init__.py +1 -0
  583. tapps_agents/resources/claude/skills/enhancer/SKILL.md +307 -0
  584. tapps_agents/resources/claude/skills/enhancer/__init__.py +1 -0
  585. tapps_agents/resources/claude/skills/evaluator/SKILL.md +204 -0
  586. tapps_agents/resources/claude/skills/evaluator/__init__.py +1 -0
  587. tapps_agents/resources/claude/skills/frontend-patterns/SKILL.md +29 -0
  588. tapps_agents/resources/claude/skills/frontend-patterns/__init__.py +1 -0
  589. tapps_agents/resources/claude/skills/implementer/SKILL.md +188 -0
  590. tapps_agents/resources/claude/skills/implementer/__init__.py +1 -0
  591. tapps_agents/resources/claude/skills/improver/SKILL.md +218 -0
  592. tapps_agents/resources/claude/skills/improver/__init__.py +1 -0
  593. tapps_agents/resources/claude/skills/ops/SKILL.md +281 -0
  594. tapps_agents/resources/claude/skills/ops/__init__.py +1 -0
  595. tapps_agents/resources/claude/skills/orchestrator/SKILL.md +390 -0
  596. tapps_agents/resources/claude/skills/orchestrator/__init__.py +1 -0
  597. tapps_agents/resources/claude/skills/planner/SKILL.md +254 -0
  598. tapps_agents/resources/claude/skills/planner/__init__.py +1 -0
  599. tapps_agents/resources/claude/skills/reviewer/SKILL.md +434 -0
  600. tapps_agents/resources/claude/skills/reviewer/__init__.py +1 -0
  601. tapps_agents/resources/claude/skills/security-review/SKILL.md +31 -0
  602. tapps_agents/resources/claude/skills/security-review/__init__.py +1 -0
  603. tapps_agents/resources/claude/skills/simple-mode/SKILL.md +695 -0
  604. tapps_agents/resources/claude/skills/simple-mode/__init__.py +1 -0
  605. tapps_agents/resources/claude/skills/tester/SKILL.md +219 -0
  606. tapps_agents/resources/claude/skills/tester/__init__.py +1 -0
  607. tapps_agents/resources/cursor/.cursorignore +35 -0
  608. tapps_agents/resources/cursor/__init__.py +1 -0
  609. tapps_agents/resources/cursor/commands/__init__.py +1 -0
  610. tapps_agents/resources/cursor/commands/build-fix.md +11 -0
  611. tapps_agents/resources/cursor/commands/build.md +11 -0
  612. tapps_agents/resources/cursor/commands/e2e.md +11 -0
  613. tapps_agents/resources/cursor/commands/fix.md +11 -0
  614. tapps_agents/resources/cursor/commands/refactor-clean.md +11 -0
  615. tapps_agents/resources/cursor/commands/review.md +11 -0
  616. tapps_agents/resources/cursor/commands/security-review.md +11 -0
  617. tapps_agents/resources/cursor/commands/tdd.md +11 -0
  618. tapps_agents/resources/cursor/commands/test-coverage.md +11 -0
  619. tapps_agents/resources/cursor/commands/test.md +11 -0
  620. tapps_agents/resources/cursor/commands/update-codemaps.md +10 -0
  621. tapps_agents/resources/cursor/commands/update-docs.md +11 -0
  622. tapps_agents/resources/cursor/rules/__init__.py +1 -0
  623. tapps_agents/resources/cursor/rules/agent-capabilities.mdc +687 -0
  624. tapps_agents/resources/cursor/rules/coding-style.mdc +31 -0
  625. tapps_agents/resources/cursor/rules/command-reference.mdc +2081 -0
  626. tapps_agents/resources/cursor/rules/cursor-mode-usage.mdc +125 -0
  627. tapps_agents/resources/cursor/rules/git-workflow.mdc +29 -0
  628. tapps_agents/resources/cursor/rules/performance.mdc +29 -0
  629. tapps_agents/resources/cursor/rules/project-context.mdc +163 -0
  630. tapps_agents/resources/cursor/rules/project-profiling.mdc +197 -0
  631. tapps_agents/resources/cursor/rules/quick-reference.mdc +630 -0
  632. tapps_agents/resources/cursor/rules/security.mdc +32 -0
  633. tapps_agents/resources/cursor/rules/simple-mode.mdc +500 -0
  634. tapps_agents/resources/cursor/rules/testing.mdc +31 -0
  635. tapps_agents/resources/cursor/rules/when-to-use.mdc +156 -0
  636. tapps_agents/resources/cursor/rules/workflow-presets.mdc +179 -0
  637. tapps_agents/resources/customizations/__init__.py +1 -0
  638. tapps_agents/resources/customizations/example-custom.yaml +83 -0
  639. tapps_agents/resources/hooks/__init__.py +1 -0
  640. tapps_agents/resources/hooks/templates/README.md +5 -0
  641. tapps_agents/resources/hooks/templates/__init__.py +1 -0
  642. tapps_agents/resources/hooks/templates/add-project-context.yaml +8 -0
  643. tapps_agents/resources/hooks/templates/auto-format-js.yaml +10 -0
  644. tapps_agents/resources/hooks/templates/auto-format-python.yaml +10 -0
  645. tapps_agents/resources/hooks/templates/git-commit-check.yaml +7 -0
  646. tapps_agents/resources/hooks/templates/notify-on-complete.yaml +8 -0
  647. tapps_agents/resources/hooks/templates/quality-gate.yaml +8 -0
  648. tapps_agents/resources/hooks/templates/security-scan-on-edit.yaml +10 -0
  649. tapps_agents/resources/hooks/templates/session-end-log.yaml +7 -0
  650. tapps_agents/resources/hooks/templates/show-beads-ready.yaml +8 -0
  651. tapps_agents/resources/hooks/templates/test-on-edit.yaml +10 -0
  652. tapps_agents/resources/hooks/templates/update-docs-on-complete.yaml +8 -0
  653. tapps_agents/resources/hooks/templates/user-prompt-log.yaml +7 -0
  654. tapps_agents/resources/scripts/__init__.py +1 -0
  655. tapps_agents/resources/scripts/set_bd_path.ps1 +51 -0
  656. tapps_agents/resources/workflows/__init__.py +1 -0
  657. tapps_agents/resources/workflows/presets/__init__.py +1 -0
  658. tapps_agents/resources/workflows/presets/brownfield-analysis.yaml +235 -0
  659. tapps_agents/resources/workflows/presets/fix.yaml +78 -0
  660. tapps_agents/resources/workflows/presets/full-sdlc.yaml +122 -0
  661. tapps_agents/resources/workflows/presets/quality.yaml +82 -0
  662. tapps_agents/resources/workflows/presets/rapid-dev.yaml +84 -0
  663. tapps_agents/session/__init__.py +19 -19
  664. tapps_agents/session/manager.py +256 -256
  665. tapps_agents/simple_mode/__init__.py +66 -66
  666. tapps_agents/simple_mode/agent_contracts.py +357 -357
  667. tapps_agents/simple_mode/beads_hooks.py +151 -151
  668. tapps_agents/simple_mode/code_snippet_handler.py +382 -382
  669. tapps_agents/simple_mode/documentation_manager.py +395 -395
  670. tapps_agents/simple_mode/documentation_reader.py +187 -187
  671. tapps_agents/simple_mode/file_inference.py +292 -292
  672. tapps_agents/simple_mode/framework_change_detector.py +268 -268
  673. tapps_agents/simple_mode/intent_parser.py +510 -510
  674. tapps_agents/simple_mode/learning_progression.py +358 -358
  675. tapps_agents/simple_mode/nl_handler.py +700 -700
  676. tapps_agents/simple_mode/onboarding.py +253 -253
  677. tapps_agents/simple_mode/orchestrators/__init__.py +38 -38
  678. tapps_agents/simple_mode/orchestrators/breakdown_orchestrator.py +49 -49
  679. tapps_agents/simple_mode/orchestrators/brownfield_orchestrator.py +135 -135
  680. tapps_agents/simple_mode/orchestrators/deliverable_checklist.py +349 -349
  681. tapps_agents/simple_mode/orchestrators/enhance_orchestrator.py +53 -53
  682. tapps_agents/simple_mode/orchestrators/epic_orchestrator.py +122 -122
  683. tapps_agents/simple_mode/orchestrators/explore_orchestrator.py +184 -184
  684. tapps_agents/simple_mode/orchestrators/plan_analysis_orchestrator.py +206 -206
  685. tapps_agents/simple_mode/orchestrators/pr_orchestrator.py +237 -237
  686. tapps_agents/simple_mode/orchestrators/refactor_orchestrator.py +222 -222
  687. tapps_agents/simple_mode/orchestrators/requirements_tracer.py +262 -262
  688. tapps_agents/simple_mode/orchestrators/resume_orchestrator.py +210 -210
  689. tapps_agents/simple_mode/orchestrators/review_orchestrator.py +161 -161
  690. tapps_agents/simple_mode/orchestrators/test_orchestrator.py +82 -82
  691. tapps_agents/simple_mode/output_aggregator.py +340 -340
  692. tapps_agents/simple_mode/result_formatters.py +598 -598
  693. tapps_agents/simple_mode/step_dependencies.py +382 -382
  694. tapps_agents/simple_mode/step_results.py +276 -276
  695. tapps_agents/simple_mode/streaming.py +388 -388
  696. tapps_agents/simple_mode/variations.py +129 -129
  697. tapps_agents/simple_mode/visual_feedback.py +238 -238
  698. tapps_agents/simple_mode/zero_config.py +274 -274
  699. tapps_agents/suggestions/__init__.py +8 -8
  700. tapps_agents/suggestions/inline_suggester.py +52 -52
  701. tapps_agents/templates/__init__.py +8 -8
  702. tapps_agents/templates/microservice_generator.py +274 -274
  703. tapps_agents/utils/env_validator.py +291 -291
  704. tapps_agents/workflow/__init__.py +171 -171
  705. tapps_agents/workflow/acceptance_verifier.py +132 -132
  706. tapps_agents/workflow/agent_handlers/__init__.py +41 -41
  707. tapps_agents/workflow/agent_handlers/analyst_handler.py +75 -75
  708. tapps_agents/workflow/agent_handlers/architect_handler.py +107 -107
  709. tapps_agents/workflow/agent_handlers/base.py +84 -84
  710. tapps_agents/workflow/agent_handlers/debugger_handler.py +100 -100
  711. tapps_agents/workflow/agent_handlers/designer_handler.py +110 -110
  712. tapps_agents/workflow/agent_handlers/documenter_handler.py +94 -94
  713. tapps_agents/workflow/agent_handlers/implementer_handler.py +235 -235
  714. tapps_agents/workflow/agent_handlers/ops_handler.py +62 -62
  715. tapps_agents/workflow/agent_handlers/orchestrator_handler.py +43 -43
  716. tapps_agents/workflow/agent_handlers/planner_handler.py +98 -98
  717. tapps_agents/workflow/agent_handlers/registry.py +119 -119
  718. tapps_agents/workflow/agent_handlers/reviewer_handler.py +119 -119
  719. tapps_agents/workflow/agent_handlers/tester_handler.py +69 -69
  720. tapps_agents/workflow/analytics_accessor.py +337 -337
  721. tapps_agents/workflow/analytics_alerts.py +416 -416
  722. tapps_agents/workflow/analytics_dashboard_cursor.py +281 -281
  723. tapps_agents/workflow/analytics_dual_write.py +103 -103
  724. tapps_agents/workflow/analytics_integration.py +119 -119
  725. tapps_agents/workflow/analytics_query_parser.py +278 -278
  726. tapps_agents/workflow/analytics_visualizer.py +259 -259
  727. tapps_agents/workflow/artifact_helper.py +204 -204
  728. tapps_agents/workflow/audit_logger.py +263 -263
  729. tapps_agents/workflow/auto_execution_config.py +340 -340
  730. tapps_agents/workflow/auto_progression.py +586 -586
  731. tapps_agents/workflow/branch_cleanup.py +349 -349
  732. tapps_agents/workflow/checkpoint.py +256 -256
  733. tapps_agents/workflow/checkpoint_manager.py +178 -178
  734. tapps_agents/workflow/code_artifact.py +179 -179
  735. tapps_agents/workflow/common_enums.py +96 -96
  736. tapps_agents/workflow/confirmation_handler.py +130 -130
  737. tapps_agents/workflow/context_analyzer.py +222 -222
  738. tapps_agents/workflow/context_artifact.py +230 -230
  739. tapps_agents/workflow/cursor_chat.py +94 -94
  740. tapps_agents/workflow/cursor_skill_helper.py +516 -516
  741. tapps_agents/workflow/dependency_resolver.py +244 -244
  742. tapps_agents/workflow/design_artifact.py +156 -156
  743. tapps_agents/workflow/detector.py +751 -751
  744. tapps_agents/workflow/direct_execution_fallback.py +301 -301
  745. tapps_agents/workflow/docs_artifact.py +168 -168
  746. tapps_agents/workflow/enforcer.py +389 -389
  747. tapps_agents/workflow/enhancement_artifact.py +142 -142
  748. tapps_agents/workflow/error_recovery.py +806 -806
  749. tapps_agents/workflow/event_bus.py +183 -183
  750. tapps_agents/workflow/event_log.py +612 -612
  751. tapps_agents/workflow/events.py +63 -63
  752. tapps_agents/workflow/exceptions.py +43 -43
  753. tapps_agents/workflow/execution_graph.py +498 -498
  754. tapps_agents/workflow/execution_plan.py +126 -126
  755. tapps_agents/workflow/file_utils.py +186 -186
  756. tapps_agents/workflow/gate_evaluator.py +182 -182
  757. tapps_agents/workflow/gate_integration.py +200 -200
  758. tapps_agents/workflow/graph_visualizer.py +130 -130
  759. tapps_agents/workflow/health_checker.py +206 -206
  760. tapps_agents/workflow/logging_helper.py +243 -243
  761. tapps_agents/workflow/manifest.py +582 -582
  762. tapps_agents/workflow/marker_writer.py +250 -250
  763. tapps_agents/workflow/messaging.py +325 -325
  764. tapps_agents/workflow/metadata_models.py +91 -91
  765. tapps_agents/workflow/metrics_integration.py +226 -226
  766. tapps_agents/workflow/migration_utils.py +116 -116
  767. tapps_agents/workflow/models.py +148 -148
  768. tapps_agents/workflow/nlp_config.py +198 -198
  769. tapps_agents/workflow/nlp_error_handler.py +207 -207
  770. tapps_agents/workflow/nlp_executor.py +163 -163
  771. tapps_agents/workflow/nlp_parser.py +528 -528
  772. tapps_agents/workflow/observability_dashboard.py +451 -451
  773. tapps_agents/workflow/observer.py +170 -170
  774. tapps_agents/workflow/ops_artifact.py +257 -257
  775. tapps_agents/workflow/output_passing.py +214 -214
  776. tapps_agents/workflow/parallel_executor.py +463 -463
  777. tapps_agents/workflow/planning_artifact.py +179 -179
  778. tapps_agents/workflow/preset_loader.py +285 -285
  779. tapps_agents/workflow/preset_recommender.py +270 -270
  780. tapps_agents/workflow/progress_logger.py +145 -145
  781. tapps_agents/workflow/progress_manager.py +303 -303
  782. tapps_agents/workflow/progress_monitor.py +186 -186
  783. tapps_agents/workflow/progress_updates.py +423 -423
  784. tapps_agents/workflow/quality_artifact.py +158 -158
  785. tapps_agents/workflow/quality_loopback.py +101 -101
  786. tapps_agents/workflow/recommender.py +387 -387
  787. tapps_agents/workflow/remediation_loop.py +166 -166
  788. tapps_agents/workflow/result_aggregator.py +300 -300
  789. tapps_agents/workflow/review_artifact.py +185 -185
  790. tapps_agents/workflow/schema_validator.py +522 -522
  791. tapps_agents/workflow/session_handoff.py +178 -178
  792. tapps_agents/workflow/skill_invoker.py +648 -648
  793. tapps_agents/workflow/state_manager.py +756 -756
  794. tapps_agents/workflow/state_persistence_config.py +331 -331
  795. tapps_agents/workflow/status_monitor.py +449 -449
  796. tapps_agents/workflow/step_checkpoint.py +314 -314
  797. tapps_agents/workflow/step_details.py +201 -201
  798. tapps_agents/workflow/story_models.py +147 -147
  799. tapps_agents/workflow/streaming.py +416 -416
  800. tapps_agents/workflow/suggestion_engine.py +552 -552
  801. tapps_agents/workflow/testing_artifact.py +186 -186
  802. tapps_agents/workflow/timeline.py +158 -158
  803. tapps_agents/workflow/token_integration.py +209 -209
  804. tapps_agents/workflow/validation.py +217 -217
  805. tapps_agents/workflow/visual_feedback.py +391 -391
  806. tapps_agents/workflow/workflow_chain.py +95 -95
  807. tapps_agents/workflow/workflow_summary.py +219 -219
  808. tapps_agents/workflow/worktree_manager.py +724 -724
  809. {tapps_agents-3.6.0.dist-info → tapps_agents-3.6.1.dist-info}/METADATA +672 -672
  810. tapps_agents-3.6.1.dist-info/RECORD +883 -0
  811. {tapps_agents-3.6.0.dist-info → tapps_agents-3.6.1.dist-info}/licenses/LICENSE +22 -22
  812. tapps_agents-3.6.0.dist-info/RECORD +0 -758
  813. {tapps_agents-3.6.0.dist-info → tapps_agents-3.6.1.dist-info}/WHEEL +0 -0
  814. {tapps_agents-3.6.0.dist-info → tapps_agents-3.6.1.dist-info}/entry_points.txt +0 -0
  815. {tapps_agents-3.6.0.dist-info → tapps_agents-3.6.1.dist-info}/top_level.txt +0 -0
@@ -0,0 +1,125 @@
1
+ ---
2
+ description: Critical guidance on using CLI commands vs Cursor Skills in Cursor IDE. Prevents common mistakes when running tapps-agents commands.
3
+ globs: []
4
+ alwaysApply: true
5
+ ---
6
+
7
+ # Cursor Mode Usage Guide - CLI vs Cursor Skills
8
+
9
+ ## ⚠️ CRITICAL: CLI Workflow Commands Not Recommended in Cursor Mode
10
+
11
+ **If you see this warning:**
12
+ ```
13
+ ⚠️ CLI Workflow Commands Not Recommended in Cursor Mode
14
+ ```
15
+
16
+ **This means:** You're trying to run a CLI workflow command (`tapps-agents workflow ...`) inside Cursor IDE, which is not recommended.
17
+
18
+ ## Quick Fix
19
+
20
+ ### ✅ Use Cursor Skills Instead (Recommended)
21
+
22
+ **In Cursor IDE chat, use:**
23
+ ```cursor
24
+ @simple-mode *fix <file> "description"
25
+ @simple-mode *build "description"
26
+ @simple-mode *review <file>
27
+ @simple-mode *test <file>
28
+ ```
29
+
30
+ **NOT:**
31
+ ```bash
32
+ # ❌ Don't use CLI workflow commands in Cursor IDE
33
+ tapps-agents workflow fix --file <file> --auto
34
+ ```
35
+
36
+ ### ✅ Use CLI Commands in Terminal/CI (Outside Cursor)
37
+
38
+ **CLI commands work perfectly in:**
39
+ - ✅ Standalone terminal (outside Cursor IDE)
40
+ - ✅ CI/CD pipelines
41
+ - ✅ Shell scripts
42
+ - ✅ Automated workflows
43
+
44
+ ```bash
45
+ # ✅ This works in terminal/CI
46
+ tapps-agents workflow fix --file <file> --auto
47
+ tapps-agents workflow rapid --prompt "description" --auto
48
+ ```
49
+
50
+ ## Why This Matters
51
+
52
+ ### Cursor Mode vs CLI Mode
53
+
54
+ **Cursor Mode** (when running in Cursor IDE):
55
+ - Uses Cursor Skills (`@agent-name *command`)
56
+ - Leverages Cursor's native integration
57
+ - Better context awareness
58
+ - Skill-based execution
59
+ - **Recommended for interactive development**
60
+
61
+ **CLI Mode** (when running in terminal/CI):
62
+ - Uses direct CLI commands (`tapps-agents <agent> <command>`)
63
+ - Designed for automation and scripting
64
+ - Structured output (JSON, text)
65
+ - **Recommended for batch processing and CI/CD**
66
+
67
+ ### The Problem
68
+
69
+ When you run CLI workflow commands in Cursor IDE:
70
+ - ❌ May fail due to dependency issues
71
+ - ❌ Bypasses Cursor's skill orchestration
72
+ - ❌ Doesn't leverage workspace context
73
+ - ❌ Poorer integration experience
74
+
75
+ ## Command Mapping
76
+
77
+ | What You Want | In Cursor IDE | In Terminal/CI |
78
+ |--------------|---------------|----------------|
79
+ | Fix a bug | `@simple-mode *fix <file> "desc"` | `tapps-agents workflow fix --file <file> --auto` |
80
+ | Build feature | `@simple-mode *build "desc"` | `tapps-agents workflow rapid --prompt "desc" --auto` |
81
+ | Review code | `@simple-mode *review <file>` | `tapps-agents reviewer review <file>` |
82
+ | Generate tests | `@simple-mode *test <file>` | `tapps-agents tester test <file>` |
83
+ | Full SDLC | `@simple-mode *full "desc"` | `tapps-agents workflow full --prompt "desc" --auto` |
84
+
85
+ ## How to Verify Your Setup
86
+
87
+ ### Check if Simple Mode is Ready
88
+
89
+ ```bash
90
+ tapps-agents simple-mode status
91
+ tapps-agents cursor verify
92
+ ```
93
+
94
+ ### If Not Set Up, Run Init
95
+
96
+ ```bash
97
+ tapps-agents init
98
+ ```
99
+
100
+ This installs:
101
+ - ✅ Cursor Rules (`.cursor/rules/`)
102
+ - ✅ Cursor Skills (`.claude/skills/`) - **Required for `@simple-mode`**
103
+ - ✅ Configuration (`.tapps-agents/config.yaml`)
104
+ - ✅ Workflow presets
105
+
106
+ ## Override (Not Recommended)
107
+
108
+ If you absolutely must use CLI commands in Cursor mode:
109
+
110
+ ```bash
111
+ tapps-agents workflow fix --file <file> --auto --cli-mode
112
+ ```
113
+
114
+ **Why this is not recommended:**
115
+ - May fail due to dependency issues
116
+ - Doesn't leverage Cursor's native capabilities
117
+ - Poorer integration with workspace context
118
+ - Better to use `@simple-mode` commands instead
119
+
120
+ ## Related Documentation
121
+
122
+ - `.cursor/rules/simple-mode.mdc` - Simple Mode usage guide
123
+ - `.cursor/rules/quick-reference.mdc` - Quick command reference
124
+ - `.cursor/rules/command-reference.mdc` - Complete command reference
125
+ - `docs/CURSOR_MODE_CLI_WORKFLOW_WARNING_ANALYSIS.md` - Detailed analysis
@@ -0,0 +1,29 @@
1
+ ---
2
+ description: Commit format, when to use *build/*fix branches, PR flow
3
+ alwaysApply: false
4
+ ---
5
+
6
+ # Git Workflow Rules
7
+
8
+ ## Commit Format
9
+
10
+ - Use clear, imperative subject lines (e.g. "Add auth endpoint", "Fix null check in validator")
11
+ - Optionally include scope: `feat(auth): add login endpoint`
12
+ - Keep the body concise when needed; reference issues or PRs
13
+
14
+ ## Branching for Agent Workflows
15
+
16
+ - **`*build` and `*full`**: when `human_oversight.branch_for_agent_changes` is true, work runs on `tapps-agents/build-{workflow_id}`; merge to main only after human review
17
+ - **`*fix`**: typically on a short-lived branch or main, depending on project policy
18
+ - Use `checkpoints_before_steps` (e.g. before implementer, designer) to review before large changes
19
+
20
+ ## PR Flow
21
+
22
+ - Run `@simple-mode *review` on changed files before opening a PR
23
+ - Use `@simple-mode *pr {title}` to generate PR description and quality summary
24
+ - Ensure tests pass and quality gates meet thresholds (e.g. overall ≥70, security ≥6.5)
25
+
26
+ ## References
27
+
28
+ - `tapps_agents/experts/knowledge/development-workflow/git-workflows.md`
29
+ - `.cursor/rules/simple-mode.mdc` for workflow and human oversight options
@@ -0,0 +1,29 @@
1
+ ---
2
+ description: Context and MCP usage - MCP/tool limits, when to delegate, model selection
3
+ alwaysApply: false
4
+ ---
5
+
6
+ # Performance and Context Rules
7
+
8
+ ## Context Window and MCP Usage
9
+
10
+ - **MCPs**: Prefer ~20–30 MCPs configured total; enable **&lt;10 per project** to avoid shrinking the effective context
11
+ - **Tools**: Keep **&lt;80 tools** active; disable unused MCPs via `disabledMcpServers` or project/local MCP config (e.g. `.cursor/mcp.json`)
12
+ - Enable only MCPs needed for the current project (e.g. Context7 for docs; Playwright for E2E)
13
+
14
+ ## When to Delegate
15
+
16
+ - Use `@simple-mode *build` for features; `*fix` for bugs; `*review` for quality—avoids ad-hoc context bloat
17
+ - Prefer targeted agents (`@reviewer *score`, `@tester *test`) over loading many skills at once
18
+ - For large codebases, narrow scope (file, module) before inviting broad search
19
+
20
+ ## Model and Resource Selection
21
+
22
+ - Skills reference `model_profile` (e.g. `reviewer_profile`, `implementer_profile`); override in `requirements/model_profiles.yaml` or project config
23
+ - Use higher-accuracy models for reviewer and security-review; lighter models for lint/score when acceptable
24
+ - See `docs/MODEL_SELECTION.md` (or agent-capabilities) for profile resolution and overrides
25
+
26
+ ## References
27
+
28
+ - `tapps_agents/core/doctor.py` - run `tapps-agents doctor` to check MCP and tool setup
29
+ - `.cursor/mcp.json` and project MCP configuration for `disabledMcpServers` and enabled servers
@@ -0,0 +1,163 @@
1
+ # TappsCodingAgents Project Context
2
+
3
+ ## Important: Dual Nature of This Project
4
+
5
+ **This project has TWO distinct roles:**
6
+
7
+ ### 1. Framework Development (Primary Role)
8
+ **TappsCodingAgents is a framework** that provides:
9
+ - 14 workflow agents (analyst, planner, architect, implementer, tester, reviewer, evaluator, etc.)
10
+ - Industry Experts system
11
+ - Cursor Skills integration (model-agnostic)
12
+ - Code quality analysis tools
13
+ - Workflow orchestration with CLI flags for control
14
+
15
+ **When working on framework development:**
16
+ - You're modifying the framework code itself (`tapps_agents/` package)
17
+ - You're adding new agents, features, or capabilities
18
+ - You're fixing bugs or improving the framework
19
+ - Focus on: `tapps_agents/`, `tests/`, `requirements/`, `docs/`
20
+
21
+ **⚠️ CRITICAL: Framework Changes MUST Use Full SDLC Workflow**
22
+
23
+ When modifying the TappsCodingAgents framework itself, you **MUST** use Simple Mode Full SDLC workflow:
24
+
25
+ ```bash
26
+ # CLI
27
+ tapps-agents simple-mode full --prompt "Implement [enhancement description]" --auto
28
+
29
+ # Or in Cursor chat
30
+ @simple-mode *full "Implement [enhancement description]"
31
+ ```
32
+
33
+ **Why?** The full SDLC workflow ensures:
34
+ - ✅ Proper requirements analysis (analyst)
35
+ - ✅ Architecture design (architect)
36
+ - ✅ Quality gates with automatic loopbacks (reviewer)
37
+ - ✅ Test generation and execution (tester)
38
+ - ✅ Security validation (ops)
39
+ - ✅ Complete documentation (documenter)
40
+ - ✅ Full traceability (requirements → stories → architecture → implementation)
41
+
42
+ **DO NOT:**
43
+ - ❌ Directly implement code without using the workflow
44
+ - ❌ Skip planning, design, or architecture phases
45
+ - ❌ Validate only afterward (use quality gates during development)
46
+ - ❌ Skip test generation (tests should be part of workflow)
47
+
48
+ **Example:**
49
+ ```
50
+ ❌ WRONG: Directly implement Context7 enhancements
51
+ ✅ CORRECT: @simple-mode *full "Implement Context7 automatic integration enhancements"
52
+ ```
53
+
54
+ ### 2. Self-Hosting (Secondary Role)
55
+ **TappsCodingAgents uses its own framework** for its own development:
56
+ - Configuration: `.tapps-agents/` directory
57
+ - 5 Industry Experts configured (AI frameworks, code quality, architecture, DevOps, documentation)
58
+ - Enhancer Agent used for prompt enhancement
59
+ - Context7 integration for library documentation
60
+
61
+ **When working on self-hosted development:**
62
+ - You're using the framework to develop the framework itself
63
+ - You're using agents via CLI or Python API
64
+ - You're configuring experts and knowledge bases
65
+ - Focus on: `.tapps-agents/`, `workflows/`, project-specific tasks
66
+
67
+ ## Context Awareness
68
+
69
+ **When AI assistants work in this project, they should:**
70
+
71
+ 1. **Understand the dual context:**
72
+ - Framework code (`tapps_agents/`) = developing the framework
73
+ - Project configuration (`.tapps-agents/`) = using the framework
74
+
75
+ 2. **Distinguish between:**
76
+ - **Framework users**: People who install and use TappsCodingAgents in their projects
77
+ - **Framework developers**: People working on TappsCodingAgents itself (us)
78
+
79
+ 3. **Documentation clarity:**
80
+ - User-facing docs should focus on "how to use the framework"
81
+ - Developer docs should focus on "how to develop the framework"
82
+ - Self-hosting docs should explain "how we use our own framework"
83
+
84
+ ## Current Self-Hosting Configuration
85
+
86
+ **Version**: 2.0.0 (self-hosting)
87
+
88
+ **Configured Experts:**
89
+ - `expert-ai-frameworks` - AI agent orchestration, workflow management
90
+ - `expert-code-quality` - Static analysis, code scoring, quality metrics
91
+ - `expert-software-architecture` - System design patterns, architecture decisions
92
+ - `expert-devops` - CI/CD integration, testing strategies, deployment
93
+ - `expert-documentation` - Technical documentation, knowledge bases
94
+
95
+ **Active Usage:**
96
+ - Enhancer Agent: 23+ enhancement sessions in `.tapps-agents/sessions/`
97
+ - Context7: KB cache in `.tapps-agents/kb/context7-cache/`
98
+ - Workflows: `workflows/prompt-enhancement.yaml`
99
+
100
+ ## Guidelines for AI Assistants
101
+
102
+ 1. **When asked about "using TappsCodingAgents":**
103
+ - Explain how to use the framework in a user's project
104
+ - Reference user-facing documentation (QUICK_START.md, DEVELOPER_GUIDE.md)
105
+ - Show CLI and Python API examples
106
+
107
+ 2. **When asked about "developing TappsCodingAgents":**
108
+ - Explain how to modify the framework code
109
+ - Reference developer documentation (ARCHITECTURE.md, API.md)
110
+ - Show how to add agents, extend functionality
111
+
112
+ 3. **When asked about "this project's setup":**
113
+ - Explain the self-hosting configuration
114
+ - Reference `.tapps-agents/` configuration
115
+ - Show how the framework is used internally
116
+
117
+ 4. **Always clarify context:**
118
+ - If unclear, ask: "Are you asking about using the framework or developing it?"
119
+ - Provide examples for both contexts when relevant
120
+
121
+ 5. **When asked for feedback on tapps-agents effectiveness** (e.g. "provide feedback on how well tapps-agents helps you as an LLM"):
122
+ - **Include health metrics in the feedback report or document.** Run `tapps-agents health overview` (or `tapps-agents health usage dashboard`) and include the output or a summary.
123
+ - This ensures feedback is actionable and comparable (subsystem health, usage, top agents/workflows). See `docs/feedback/README.md` for placement.
124
+
125
+ ## File Organization
126
+
127
+ ```
128
+ TappsCodingAgents/
129
+ ├── tapps_agents/ # Framework code (developing the framework)
130
+ │ ├── agents/ # Agent implementations
131
+ │ ├── core/ # Core framework components
132
+ │ └── ...
133
+
134
+ ├── .tapps-agents/ # Self-hosting configuration (using the framework)
135
+ │ ├── experts.yaml # Our project's experts
136
+ │ ├── domains.md # Our project's domains
137
+ │ └── sessions/ # Enhancement sessions
138
+
139
+ ├── docs/ # User-facing documentation (how to use)
140
+ ├── requirements/ # Framework specifications (developing)
141
+ └── docs/implementation/ # Implementation notes and EPIC/PHASE docs
142
+ ```
143
+
144
+ ## Examples
145
+
146
+ ### Example 1: User Question
147
+ **Q: "How do I use the reviewer agent?"**
148
+ **A:** Explain CLI usage, Python API, configuration - focus on user perspective
149
+
150
+ ### Example 2: Developer Question
151
+ **Q: "How do I add a new agent?"**
152
+ **A:** Explain framework architecture, BaseAgent class, agent registration - focus on development
153
+
154
+ ### Example 3: Self-Hosting Question
155
+ **Q: "What experts are configured in this project?"**
156
+ **A:** Explain `.tapps-agents/experts.yaml`, the 5 experts, how they're used internally
157
+
158
+ ## References
159
+
160
+ - **Self-Hosting Setup**: `docs/implementation/SELF_HOSTING_SETUP_COMPLETE.md`
161
+ - **User Guide**: `QUICK_START.md`, `docs/DEVELOPER_GUIDE.md`
162
+ - **Framework Architecture**: `docs/ARCHITECTURE.md`
163
+ - **Configuration**: `.tapps-agents/` directory
@@ -0,0 +1,197 @@
1
+ ---
2
+ description: Documentation of TappsCodingAgents automatic project profiling system for context-aware recommendations
3
+ alwaysApply: false
4
+ ---
5
+
6
+ # Project Profiling System
7
+
8
+ ## Overview
9
+
10
+ TappsCodingAgents automatically detects and profiles project characteristics to provide context-aware recommendations and ensure compliance with project constraints. This profiling happens automatically during workflow execution and requires no manual configuration.
11
+
12
+ ## Automatic Detection
13
+
14
+ The profiling system analyzes your codebase to detect:
15
+
16
+ ### Deployment Type
17
+ - **Cloud**: AWS, Azure, GCP, or other cloud providers
18
+ - **On-Premise**: Self-hosted infrastructure
19
+ - **Hybrid**: Combination of cloud and on-premise
20
+ - **Serverless**: Function-as-a-Service (Lambda, Cloud Functions, etc.)
21
+ - **Container**: Docker, Kubernetes, or container orchestration
22
+
23
+ ### Tenancy Model
24
+ - **Single-Tenant**: One customer per instance
25
+ - **Multi-Tenant**: Multiple customers share resources
26
+ - **Hybrid**: Mix of single and multi-tenant components
27
+
28
+ ### User Scale
29
+ - **Small**: < 1,000 users
30
+ - **Medium**: 1,000 - 100,000 users
31
+ - **Large**: 100,000 - 1,000,000 users
32
+ - **Enterprise**: > 1,000,000 users
33
+
34
+ ### Compliance Requirements
35
+ - **HIPAA**: Healthcare data protection
36
+ - **GDPR**: European data privacy
37
+ - **PCI DSS**: Payment card industry
38
+ - **SOC 2**: Security and availability
39
+ - **ISO 27001**: Information security management
40
+ - **None**: No specific compliance requirements
41
+
42
+ ### Security Level
43
+ - **Low**: Basic security requirements
44
+ - **Medium**: Standard security practices
45
+ - **High**: Enhanced security controls
46
+ - **Critical**: Maximum security requirements
47
+
48
+ ## Profile Storage
49
+
50
+ **Location:** `.tapps-agents/project-profile.yaml`
51
+
52
+ **Format:**
53
+ ```yaml
54
+ deployment_type: cloud
55
+ tenancy: multi-tenant
56
+ user_scale: large
57
+ compliance:
58
+ - GDPR
59
+ - SOC 2
60
+ security_level: high
61
+ detected_at: 2025-12-13T10:00:00Z
62
+ ```
63
+
64
+ ## How It Works
65
+
66
+ ### Detection Process
67
+
68
+ 1. **Codebase Analysis**: Scans project files for indicators
69
+ - Infrastructure as Code (Terraform, CloudFormation)
70
+ - Deployment configurations (Docker, Kubernetes)
71
+ - Database schemas and data models
72
+ - Security configurations
73
+ - Compliance documentation
74
+
75
+ 2. **Pattern Matching**: Identifies patterns that indicate:
76
+ - Deployment type (cloud provider configs, serverless functions)
77
+ - Tenancy model (tenant_id fields, isolation patterns)
78
+ - Scale indicators (caching, load balancing, scaling configs)
79
+ - Compliance (privacy policies, security docs, compliance mentions)
80
+ - Security level (encryption, authentication, authorization patterns)
81
+
82
+ 3. **Profile Generation**: Creates profile YAML file with detected characteristics
83
+
84
+ 4. **Context Injection**: Automatically includes profile in all agent commands
85
+
86
+ ### When Detection Happens
87
+
88
+ - **First Workflow Run**: Profile is created during initial workflow execution
89
+ - **Project Initialization**: Can be generated during `tapps-agents init` (optional)
90
+ - **Manual Refresh**: Profile can be regenerated by deleting the file
91
+
92
+ ## Usage in Workflows
93
+
94
+ ### Automatic Inclusion
95
+
96
+ Project profile is **automatically included** in all agent commands:
97
+
98
+ - **Analyst**: Uses profile for requirements analysis and risk assessment
99
+ - **Planner**: Ensures stories align with project constraints
100
+ - **Architect**: Designs architecture matching deployment and tenancy model
101
+ - **Designer**: Creates APIs and data models with compliance in mind
102
+ - **Implementer**: Generates code following security and compliance requirements
103
+ - **Ops**: Performs audits based on compliance and security level
104
+
105
+ ### Example Impact
106
+
107
+ **Multi-Tenant Project:**
108
+ - Architect designs tenant isolation patterns
109
+ - Designer creates APIs with tenant context
110
+ - Implementer adds tenant_id to all data models
111
+ - Ops ensures tenant data isolation
112
+
113
+ **GDPR-Compliant Project:**
114
+ - Designer includes data privacy fields (consent, right to deletion)
115
+ - Implementer adds data export and deletion endpoints
116
+ - Ops verifies GDPR compliance in audit
117
+
118
+ **High-Security Project:**
119
+ - Architect designs defense-in-depth security
120
+ - Implementer adds encryption, authentication, authorization
121
+ - Reviewer checks for security vulnerabilities
122
+ - Ops performs comprehensive security audit
123
+
124
+ ## Manual Override
125
+
126
+ If automatic detection is incorrect, you can manually edit `.tapps-agents/project-profile.yaml`:
127
+
128
+ ```yaml
129
+ deployment_type: cloud # Override detected value
130
+ tenancy: multi-tenant
131
+ user_scale: large
132
+ compliance:
133
+ - GDPR
134
+ - HIPAA # Add additional compliance
135
+ security_level: critical # Increase security level
136
+ ```
137
+
138
+ **Note:** Manual edits are preserved and not overwritten by automatic detection.
139
+
140
+ ## Best Practices
141
+
142
+ 1. **Review Profile**: Check `.tapps-agents/project-profile.yaml` after first workflow run
143
+ 2. **Update as Needed**: Manually update if project characteristics change
144
+ 3. **Share with Team**: Commit profile to version control for team consistency
145
+ 4. **Use in CI/CD**: Reference profile in CI/CD pipelines for compliance checks
146
+
147
+ ## Integration with Agents
148
+
149
+ ### Analyst Agent
150
+ - Uses profile for requirements analysis
151
+ - Considers compliance requirements in risk assessment
152
+ - Adjusts effort estimates based on security level
153
+
154
+ ### Planner Agent
155
+ - Creates stories aligned with project constraints
156
+ - Prioritizes compliance-related stories
157
+ - Estimates effort considering security requirements
158
+
159
+ ### Architect Agent
160
+ - Designs architecture matching deployment type
161
+ - Implements tenant isolation for multi-tenant projects
162
+ - Includes security architecture for high-security projects
163
+
164
+ ### Designer Agent
165
+ - Creates APIs with tenant context (multi-tenant)
166
+ - Includes compliance fields (GDPR, HIPAA)
167
+ - Designs data models with security in mind
168
+
169
+ ### Implementer Agent
170
+ - Generates code following security best practices
171
+ - Adds compliance-related functionality
172
+ - Implements tenant isolation patterns
173
+
174
+ ### Ops Agent
175
+ - Performs audits based on compliance requirements
176
+ - Verifies security controls match security level
177
+ - Checks deployment configuration matches deployment type
178
+
179
+ ## Troubleshooting
180
+
181
+ ### Profile Not Detected
182
+ - **Issue**: Profile file doesn't exist
183
+ - **Solution**: Run a workflow - profile is created automatically
184
+
185
+ ### Incorrect Detection
186
+ - **Issue**: Profile shows wrong characteristics
187
+ - **Solution**: Manually edit `.tapps-agents/project-profile.yaml`
188
+
189
+ ### Profile Not Used
190
+ - **Issue**: Agents don't seem to use profile
191
+ - **Solution**: Ensure profile file exists and is valid YAML
192
+
193
+ ## Related Documentation
194
+
195
+ - [Quick Reference](quick-reference.mdc) - Command reference
196
+ - [Agent Capabilities](agent-capabilities.mdc) - Agent documentation
197
+ - [Cursor Native Integration](../../../CURSOR_NATIVE_INTEGRATION_DESIGN.md) - Integration details