mcp-efficiency-engine 0.1.0

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 (360) hide show
  1. package/.github/CODEOWNERS +40 -0
  2. package/.github/GITHUB_MCP_INTEGRATION.md +366 -0
  3. package/.github/ISSUE_TEMPLATE/bug.md +51 -0
  4. package/.github/ISSUE_TEMPLATE/feature_request.md +45 -0
  5. package/.github/ISSUE_TEMPLATE/question.md +18 -0
  6. package/.github/agents/backend.agent.md +18 -0
  7. package/.github/agents/community-manager.agent.md +18 -0
  8. package/.github/agents/dba.agent.md +18 -0
  9. package/.github/agents/frontend-agent.agent.md +18 -0
  10. package/.github/agents/github-repository-manager.agent.md +338 -0
  11. package/.github/agents/iot.agent.md +20 -0
  12. package/.github/agents/legacy.agent.md +18 -0
  13. package/.github/agents/rag-azure.agent.md +18 -0
  14. package/.github/agents/rag-local.agent.md +18 -0
  15. package/.github/agents/snapshot.agent.md +18 -0
  16. package/.github/agents/ux-ui.agent.md +18 -0
  17. package/.github/agents/wiki-agent.agent.md +23 -0
  18. package/.github/copilot-instructions.md +44 -0
  19. package/.github/instructions/always-on-optimization.instructions.md +54 -0
  20. package/.github/prompts/auto-route.prompt.md +33 -0
  21. package/.github/prompts/azure-rag.query.prompt.md +19 -0
  22. package/.github/prompts/backend.fix-bug.prompt.md +13 -0
  23. package/.github/prompts/cavecrew.prompt.md +16 -0
  24. package/.github/prompts/caveman-commit.prompt.md +14 -0
  25. package/.github/prompts/caveman-compress.prompt.md +15 -0
  26. package/.github/prompts/caveman-debug.prompt.md +13 -0
  27. package/.github/prompts/caveman-help.prompt.md +11 -0
  28. package/.github/prompts/caveman-review.prompt.md +15 -0
  29. package/.github/prompts/caveman-stats.prompt.md +11 -0
  30. package/.github/prompts/caveman.prompt.md +11 -0
  31. package/.github/prompts/community.post.prompt.md +14 -0
  32. package/.github/prompts/dba.query-review.prompt.md +15 -0
  33. package/.github/prompts/dev.fix-bug.prompt.md +13 -0
  34. package/.github/prompts/frontend.code.prompt.md +13 -0
  35. package/.github/prompts/legacy.impact-analysis.prompt.md +14 -0
  36. package/.github/prompts/project.kickoff-analysis.prompt.md +51 -0
  37. package/.github/prompts/rag.knowledge-answer.prompt.md +13 -0
  38. package/.github/prompts/token-saver-review.prompt.md +14 -0
  39. package/.github/prompts/ux-ui.review.prompt.md +14 -0
  40. package/.github/pull_request_template.md +71 -0
  41. package/.github/skills/ahorro-tokens/SKILL.md +36 -0
  42. package/.github/skills/azure-rag-enterprise/SKILL.md +24 -0
  43. package/.github/skills/backend-coding/SKILL.md +24 -0
  44. package/.github/skills/cavecrew/SKILL.md +17 -0
  45. package/.github/skills/caveman/SKILL.md +25 -0
  46. package/.github/skills/caveman-commit/SKILL.md +15 -0
  47. package/.github/skills/caveman-compress/SKILL.md +14 -0
  48. package/.github/skills/caveman-help/SKILL.md +19 -0
  49. package/.github/skills/caveman-mode/SKILL.md +43 -0
  50. package/.github/skills/caveman-review/SKILL.md +16 -0
  51. package/.github/skills/caveman-stats/SKILL.md +13 -0
  52. package/.github/skills/community-content/SKILL.md +22 -0
  53. package/.github/skills/database-analysis/SKILL.md +23 -0
  54. package/.github/skills/dev-coding/SKILL.md +24 -0
  55. package/.github/skills/frontend-coding/SKILL.md +24 -0
  56. package/.github/skills/human-in-the-loop/SKILL.md +47 -0
  57. package/.github/skills/iot-architecture/SKILL.md +22 -0
  58. package/.github/skills/legacy-migration/SKILL.md +22 -0
  59. package/.github/skills/rag-knowledge/SKILL.md +21 -0
  60. package/.github/skills/token-saver/SKILL.md +36 -0
  61. package/.github/skills/ux-ui-governance/SKILL.md +24 -0
  62. package/.github/skills/wiki-tools.json +24 -0
  63. package/.github/workflows/auto-devlog.yml +56 -0
  64. package/.github/workflows/auto-manage-issues.yml +64 -0
  65. package/.github/workflows/auto-sync.yml +54 -0
  66. package/.github/workflows/autodocs-sync.yml +114 -0
  67. package/.github/workflows/ci.yml +68 -0
  68. package/.github/workflows/pages.yml +59 -0
  69. package/.github/workflows/routing-evals.yml +59 -0
  70. package/.github/workflows/techriders-coverage-effective.yml +91 -0
  71. package/.vscode/mcp.json +44 -0
  72. package/AGENTS.md +160 -0
  73. package/ARCHITECTURE.md +57 -0
  74. package/FINAL_USAGE_GUIDE.md +106 -0
  75. package/LICENSE +21 -0
  76. package/README.md +385 -0
  77. package/README_WIKI.md +130 -0
  78. package/autodocs/README.md +22 -0
  79. package/autodocs/schema/wiki-node.schema.json +56 -0
  80. package/autolearning/feedback-loop.md +90 -0
  81. package/bin/install-host.js +326 -0
  82. package/bin/mcpee.js +116 -0
  83. package/context/repomix/repomix.config.json +20 -0
  84. package/memory/cross-memory-reasoning.md +17 -0
  85. package/memory/mempry-registry.yml +16 -0
  86. package/observability/evals/chat-token-usage-report.json +64 -0
  87. package/observability/evals/chat-token-usage-report.md +33 -0
  88. package/observability/evals/iteration-value-report.json +76 -0
  89. package/observability/evals/iteration-value-report.md +39 -0
  90. package/observability/evals/learning-loop-report.json +268 -0
  91. package/observability/evals/learning-loop-report.md +37 -0
  92. package/observability/evals/repo-intake-eval-cases.md +23 -0
  93. package/observability/evals/routing-eval-cases.json +68 -0
  94. package/observability/evals/routing-eval-cases.md +25 -0
  95. package/observability/evals/routing-eval-report.json +72 -0
  96. package/observability/evaluation.md +34 -0
  97. package/observability/logs/copilot-usage-ingest-report.json +13 -0
  98. package/observability/logs/iteration-metrics.jsonl +75 -0
  99. package/observability/logs/learning-feedback.jsonl +152 -0
  100. package/observability/logs/routing-decisions.jsonl +333 -0
  101. package/observability/logs/session/agent-pipeline-preflight-20260701-004146.log +8 -0
  102. package/observability/logs/session/agent-pipeline-preflight-20260701-005554.log +8 -0
  103. package/observability/logs/session/agent-pipeline-preflight-20260701-010351.log +8 -0
  104. package/observability/logs/session/agent-pipeline-preflight-20260704-145829.log +8 -0
  105. package/observability/logs/session/agent-pipeline-preflight-20260704-150021.log +8 -0
  106. package/observability/logs/session/agent-pipeline-preflight-20260704-154328.log +8 -0
  107. package/observability/logs/session/bye-20260629-221513.json +39 -0
  108. package/observability/logs/session/bye-20260629-221545.json +59 -0
  109. package/observability/logs/session/bye-20260629-222007.json +52 -0
  110. package/observability/logs/session/bye-20260629-222133.json +59 -0
  111. package/observability/logs/session/bye-20260629-222412.json +45 -0
  112. package/observability/logs/session/bye-20260629-223224.json +52 -0
  113. package/observability/logs/session/bye-20260629-224050.json +59 -0
  114. package/observability/logs/session/bye-20260630-105732.json +24 -0
  115. package/observability/logs/session/bye-20260630-211536.json +87 -0
  116. package/observability/logs/session/bye-20260630-223423.json +87 -0
  117. package/observability/logs/session/bye-20260630-232534.json +87 -0
  118. package/observability/logs/session/bye-20260701-003638.json +126 -0
  119. package/observability/logs/session/bye-20260701-003849.json +126 -0
  120. package/observability/logs/session/bye-20260701-004315.json +138 -0
  121. package/observability/logs/session/bye-20260701-004559.json +76 -0
  122. package/observability/logs/session/bye-20260701-005913.json +138 -0
  123. package/observability/logs/session/bye-20260701-010753.json +138 -0
  124. package/observability/logs/session/bye-20260703-194106.json +24 -0
  125. package/observability/logs/session/bye-20260703-233443.json +76 -0
  126. package/observability/logs/session/bye-20260703-233653.json +76 -0
  127. package/observability/logs/session/bye-20260704-150317.json +152 -0
  128. package/observability/logs/session/bye-20260704-150929.json +75 -0
  129. package/observability/logs/session/bye-20260704-151050.json +75 -0
  130. package/observability/logs/session/bye-20260705-115458.json +165 -0
  131. package/observability/logs/session/codegraph-status-20260701-004228.log +39 -0
  132. package/observability/logs/session/codegraph-status-20260701-004310.log +39 -0
  133. package/observability/logs/session/codegraph-status-20260701-005637.log +39 -0
  134. package/observability/logs/session/codegraph-status-20260701-005908.log +39 -0
  135. package/observability/logs/session/codegraph-status-20260701-010444.log +39 -0
  136. package/observability/logs/session/codegraph-status-20260701-010747.log +39 -0
  137. package/observability/logs/session/codegraph-status-20260704-150137.log +26 -0
  138. package/observability/logs/session/codegraph-status-20260704-150313.log +28 -0
  139. package/observability/logs/session/codegraph-status-20260704-154445.log +26 -0
  140. package/observability/logs/session/codegraph-status-20260705-115454.log +27 -0
  141. package/observability/logs/session/codegraph-sync-20260701-004211.log +88 -0
  142. package/observability/logs/session/codegraph-sync-20260701-004241.log +82 -0
  143. package/observability/logs/session/codegraph-sync-20260701-005620.log +89 -0
  144. package/observability/logs/session/codegraph-sync-20260701-005840.log +88 -0
  145. package/observability/logs/session/codegraph-sync-20260701-010419.log +93 -0
  146. package/observability/logs/session/codegraph-sync-20260701-010609.log +90 -0
  147. package/observability/logs/session/codegraph-sync-20260704-145856.log +70 -0
  148. package/observability/logs/session/codegraph-sync-20260704-150047.log +53 -0
  149. package/observability/logs/session/codegraph-sync-20260704-150204.log +44 -0
  150. package/observability/logs/session/codegraph-sync-20260704-154353.log +26 -0
  151. package/observability/logs/session/codegraph-sync-20260705-115337.log +32 -0
  152. package/observability/logs/session/hi-20260629-221459.json +38 -0
  153. package/observability/logs/session/hi-20260629-221945.json +59 -0
  154. package/observability/logs/session/hi-20260629-222108.json +66 -0
  155. package/observability/logs/session/hi-20260629-222352.json +45 -0
  156. package/observability/logs/session/hi-20260629-225719.json +59 -0
  157. package/observability/logs/session/hi-20260629-233722.json +52 -0
  158. package/observability/logs/session/hi-20260629-233913.json +198 -0
  159. package/observability/logs/session/hi-20260630-110156.json +177 -0
  160. package/observability/logs/session/hi-20260630-191243.json +184 -0
  161. package/observability/logs/session/hi-20260630-230050.json +234 -0
  162. package/observability/logs/session/hi-20260630-230523.json +227 -0
  163. package/observability/logs/session/hi-20260630-230855.json +227 -0
  164. package/observability/logs/session/hi-20260630-231638.json +227 -0
  165. package/observability/logs/session/hi-20260630-231756.json +219 -0
  166. package/observability/logs/session/hi-20260701-002842.json +234 -0
  167. package/observability/logs/session/hi-20260701-003458.json +282 -0
  168. package/observability/logs/session/hi-20260701-004233.json +290 -0
  169. package/observability/logs/session/hi-20260701-004554.json +236 -0
  170. package/observability/logs/session/hi-20260701-005641.json +290 -0
  171. package/observability/logs/session/hi-20260701-010450.json +290 -0
  172. package/observability/logs/session/hi-20260703-233854.json +312 -0
  173. package/observability/logs/session/hi-20260703-234448.json +318 -0
  174. package/observability/logs/session/hi-20260704-145907.json +353 -0
  175. package/observability/logs/session/hi-20260704-150141.json +392 -0
  176. package/observability/logs/session/hi-20260704-154448.json +392 -0
  177. package/observability/logs/session/iteration-value-refresh-20260701-004309.log +3 -0
  178. package/observability/logs/session/iteration-value-refresh-20260701-005907.log +3 -0
  179. package/observability/logs/session/iteration-value-refresh-20260701-010747.log +3 -0
  180. package/observability/logs/session/iteration-value-refresh-20260704-150312.log +3 -0
  181. package/observability/logs/session/iteration-value-refresh-20260705-115453.log +3 -0
  182. package/observability/logs/session/learning-loop-refresh-20260701-004309.log +3 -0
  183. package/observability/logs/session/learning-loop-refresh-20260701-005906.log +3 -0
  184. package/observability/logs/session/learning-loop-refresh-20260701-010745.log +3 -0
  185. package/observability/logs/session/learning-loop-refresh-20260704-150309.log +3 -0
  186. package/observability/logs/session/learning-loop-refresh-20260705-115450.log +3 -0
  187. package/observability/logs/session/project-notes-refresh-20260701-004227.log +1 -0
  188. package/observability/logs/session/project-notes-refresh-20260701-004308.log +1 -0
  189. package/observability/logs/session/project-notes-refresh-20260701-005636.log +1 -0
  190. package/observability/logs/session/project-notes-refresh-20260701-005906.log +1 -0
  191. package/observability/logs/session/project-notes-refresh-20260701-010443.log +1 -0
  192. package/observability/logs/session/project-notes-refresh-20260701-010744.log +1 -0
  193. package/observability/logs/session/project-notes-refresh-20260704-150133.log +1 -0
  194. package/observability/logs/session/project-notes-refresh-20260704-150309.log +1 -0
  195. package/observability/logs/session/project-notes-refresh-20260704-154442.log +1 -0
  196. package/observability/logs/session/project-notes-refresh-20260705-115449.log +1 -0
  197. package/observability/logs/session/repo-intake-20260701-004218.log +6 -0
  198. package/observability/logs/session/repo-intake-20260701-005626.log +6 -0
  199. package/observability/logs/session/repo-intake-20260701-010433.log +6 -0
  200. package/observability/logs/session/repo-intake-20260704-150053.log +6 -0
  201. package/observability/logs/session/repo-intake-20260704-154404.log +6 -0
  202. package/observability/logs/session/repo-intake-refresh-20260701-004247.log +6 -0
  203. package/observability/logs/session/repo-intake-refresh-20260701-005847.log +6 -0
  204. package/observability/logs/session/repo-intake-refresh-20260701-010615.log +6 -0
  205. package/observability/logs/session/repo-intake-refresh-20260704-150209.log +6 -0
  206. package/observability/logs/session/repo-intake-refresh-20260705-115342.log +6 -0
  207. package/observability/logs/session/repo-registry-validation-20260701-004234.log +2 -0
  208. package/observability/logs/session/repo-registry-validation-20260701-004556.log +2 -0
  209. package/observability/logs/session/repo-registry-validation-20260701-005833.log +2 -0
  210. package/observability/logs/session/repo-registry-validation-20260701-010601.log +2 -0
  211. package/observability/logs/session/repo-registry-validation-20260704-150155.log +2 -0
  212. package/observability/logs/session/repo-registry-validation-20260705-115323.log +2 -0
  213. package/observability/logs/session/repomix-refresh-20260701-003823.log +4236 -0
  214. package/observability/logs/session/repomix-refresh-20260701-004251.log +4275 -0
  215. package/observability/logs/session/repomix-refresh-20260701-005850.log +4248 -0
  216. package/observability/logs/session/repomix-refresh-20260701-010619.log +6531 -0
  217. package/observability/logs/session/repomix-refresh-20260704-150239.log +652 -0
  218. package/observability/logs/session/repomix-refresh-20260705-115419.log +178 -0
  219. package/observability/logs/session/routing-evals-20260701-004221.log +2 -0
  220. package/observability/logs/session/routing-evals-20260701-004235.log +2 -0
  221. package/observability/logs/session/routing-evals-20260701-005629.log +2 -0
  222. package/observability/logs/session/routing-evals-20260701-005834.log +2 -0
  223. package/observability/logs/session/routing-evals-20260701-010437.log +2 -0
  224. package/observability/logs/session/routing-evals-20260701-010603.log +2 -0
  225. package/observability/logs/session/routing-evals-20260704-150125.log +2 -0
  226. package/observability/logs/session/routing-evals-20260704-150157.log +2 -0
  227. package/observability/logs/session/routing-evals-20260704-154434.log +2 -0
  228. package/observability/logs/session/routing-evals-20260705-115327.log +2 -0
  229. package/observability/logs/session/sibling-discovery-refresh-20260701-004250.log +3 -0
  230. package/observability/logs/session/sibling-discovery-refresh-20260701-005850.log +3 -0
  231. package/observability/logs/session/sibling-discovery-refresh-20260701-010618.log +3 -0
  232. package/observability/logs/session/sibling-discovery-refresh-20260704-150238.log +3 -0
  233. package/observability/logs/session/sibling-discovery-refresh-20260705-115418.log +3 -0
  234. package/observability/logs.schema.json +95 -0
  235. package/observability/logs.schema.md +26 -0
  236. package/observability/metrics.md +35 -0
  237. package/observability/routing-evaluator.md +37 -0
  238. package/observability/scoring-rubric.md +38 -0
  239. package/optimization/ALWAYS_ON_OPTIMIZATION.md +98 -0
  240. package/optimization/caveman-mode.md +62 -0
  241. package/optimization/examples/login-bug.md +25 -0
  242. package/optimization/examples/sla-query.md +25 -0
  243. package/optimization/optimization-routing.md +30 -0
  244. package/optimization/policies/response-style.policy.md +45 -0
  245. package/optimization/policies/token-budget.policy.md +28 -0
  246. package/optimization/profiles/always-on.profile.md +19 -0
  247. package/optimization/profiles/architecture.profile.md +20 -0
  248. package/optimization/profiles/debug.profile.md +20 -0
  249. package/optimization/profiles/enterprise-rag.profile.md +20 -0
  250. package/optimization/profiles/training.profile.md +20 -0
  251. package/optimization/token-saver.md +58 -0
  252. package/orchestrator/corporate-routing.md +51 -0
  253. package/orchestrator/decision-matrix.md +33 -0
  254. package/orchestrator/fallback.md +29 -0
  255. package/orchestrator/repo-routing.md +58 -0
  256. package/orchestrator/router.md +75 -0
  257. package/orchestrator/wiki/__init__.py +5 -0
  258. package/orchestrator/wiki/graph_consolidator.py +506 -0
  259. package/orchestrator/wiki/incremental_engine.py +57 -0
  260. package/orchestrator/wiki/plugin_manager.py +40 -0
  261. package/package.json +70 -0
  262. package/policies/context-policy.md +25 -0
  263. package/policies/cost-policy.md +25 -0
  264. package/policies/repo-intake-policy.md +36 -0
  265. package/policies/security-policy.md +25 -0
  266. package/repo-intake/README.md +81 -0
  267. package/repo-intake/templates/agent.template.md +4 -0
  268. package/repo-intake/templates/context-manifest.template.md +4 -0
  269. package/repo-intake/templates/skill.template.md +3 -0
  270. package/repo-registry/repos.schema.json +102 -0
  271. package/repo-registry/repos.template.json +26 -0
  272. package/requirements.txt +1 -0
  273. package/scripts/README.md +109 -0
  274. package/scripts/__init__.py +0 -0
  275. package/scripts/bootstrap-portable.cmd +4 -0
  276. package/scripts/bootstrap-portable.ps1 +90 -0
  277. package/scripts/context/azure-rag-mcp-adapter.py +1 -0
  278. package/scripts/context/build-graphify.ps1 +1 -0
  279. package/scripts/context/build-repomix.ps1 +1 -0
  280. package/scripts/discovery/discover-boost-repos.cmd +4 -0
  281. package/scripts/discovery/discover-boost-repos.py +186 -0
  282. package/scripts/discovery/refresh-project-notes.py +179 -0
  283. package/scripts/github/INSTALL.md +295 -0
  284. package/scripts/github/README.md +455 -0
  285. package/scripts/github/apply-boost-templates.ps1 +163 -0
  286. package/scripts/github/apply-single-repo.ps1 +85 -0
  287. package/scripts/github/create-devlog.ps1 +380 -0
  288. package/scripts/github/manage-issues.ps1 +332 -0
  289. package/scripts/github/sync-repo.ps1 +267 -0
  290. package/scripts/intake/agent-pipeline-preflight.py +151 -0
  291. package/scripts/intake/init-template-registry.cmd +4 -0
  292. package/scripts/intake/init-template-registry.ps1 +258 -0
  293. package/scripts/intake/repo-intake.py +354 -0
  294. package/scripts/intake/resolve-routing.py +620 -0
  295. package/scripts/intake/run-repo-intake.cmd +4 -0
  296. package/scripts/intake/run-repo-intake.ps1 +46 -0
  297. package/scripts/intake/run-routing-evals.py +147 -0
  298. package/scripts/intake/validate-database-routing.py +91 -0
  299. package/scripts/intake/validate-rag-routing.py +85 -0
  300. package/scripts/intake/validate-repo-registry.ps1 +20 -0
  301. package/scripts/intake/validate-repo-registry.py +286 -0
  302. package/scripts/intake/validate-security.py +170 -0
  303. package/scripts/learning/autolearning-gate.py +71 -0
  304. package/scripts/learning/chat-token-usage-report.py +326 -0
  305. package/scripts/learning/ingest-copilot-session-usage.py +421 -0
  306. package/scripts/learning/iteration-value-report.py +275 -0
  307. package/scripts/learning/learning-loop-report.py +272 -0
  308. package/scripts/learning/record-iteration-metrics.py +116 -0
  309. package/scripts/learning/record-learning-feedback.py +91 -0
  310. package/scripts/ops/bye.ps1 +620 -0
  311. package/scripts/ops/compare-demo-results.ps1 +826 -0
  312. package/scripts/ops/demo1.ps1 +11 -0
  313. package/scripts/ops/demo2.ps1 +11 -0
  314. package/scripts/ops/demo3.ps1 +11 -0
  315. package/scripts/ops/demo4.ps1 +11 -0
  316. package/scripts/ops/hi.ps1 +1045 -0
  317. package/scripts/ops/llm-token-probe.py +164 -0
  318. package/scripts/ops/run-all-demos.ps1 +39 -0
  319. package/scripts/ops/run-demo-block.ps1 +85 -0
  320. package/scripts/ops/run-demo-session.ps1 +532 -0
  321. package/scripts/setup/optimize-engines.ps1 +183 -0
  322. package/scripts/setup/setup-codegraph.ps1 +3 -0
  323. package/scripts/setup/setup-gitnexus.ps1 +3 -0
  324. package/scripts/setup/setup-graphify.ps1 +2 -0
  325. package/scripts/setup/setup-prerequisites.ps1 +205 -0
  326. package/scripts/setup/start-gitnexus.ps1 +71 -0
  327. package/scripts/setup/validate-context.ps1 +361 -0
  328. package/scripts/wiki/__init__.py +0 -0
  329. package/scripts/wiki/compiler_main.py +189 -0
  330. package/scripts/wiki/normalizer.py +206 -0
  331. package/scripts/wiki/providers/base_provider.py +25 -0
  332. package/scripts/wiki/providers/codegraph_provider.py +49 -0
  333. package/scripts/wiki/providers/graphify_provider.py +49 -0
  334. package/scripts/wiki/providers/repo_content_provider.py +408 -0
  335. package/scripts/wiki/query_autodocs.py +60 -0
  336. package/scripts/wiki/validator.py +183 -0
  337. package/scripts/wiki/wiki_compiler.py +5 -0
  338. package/specs/architecture.spec.md +32 -0
  339. package/specs/azure-rag.spec.md +28 -0
  340. package/specs/coding-standards.spec.md +24 -0
  341. package/specs/database.spec.md +29 -0
  342. package/specs/migration.spec.md +26 -0
  343. package/specs/observability.spec.md +24 -0
  344. package/specs/optimization.spec.md +31 -0
  345. package/specs/rag.spec.md +30 -0
  346. package/specs/repo-intake.spec.md +25 -0
  347. package/specs/routing.spec.md +24 -0
  348. package/specs/security.spec.md +30 -0
  349. package/specs/wiki/provider-contract.json +33 -0
  350. package/specs/wiki/unified-knowledge-graph.json +25 -0
  351. package/templates/BOOST_README_TEMPLATE.md +96 -0
  352. package/templates/CODEOWNERS_TEMPLATE.txt +29 -0
  353. package/templates/LICENSE_MIT_TEMPLATE.txt +21 -0
  354. package/templates/PERSONAL_README_TEMPLATE.md +90 -0
  355. package/templates/README_boost_RAG_Azure.md +46 -0
  356. package/templates/README_boost_azure_iot_edge.md +48 -0
  357. package/templates/README_boost_backend.md +47 -0
  358. package/templates/README_boost_dba.md +57 -0
  359. package/templates/ci.yml.template +73 -0
  360. package/tooling/tooling.manifest.json +72 -0
@@ -0,0 +1,32 @@
1
+ # architecture spec
2
+
3
+ ## Objetivo
4
+
5
+ Definir la arquitectura operativa del repo y el contrato entre orquestacion, agentes, motores de contexto y observabilidad.
6
+
7
+ ## Componentes canonicos
8
+
9
+ 1. Orquestacion: `orchestrator/`.
10
+ 2. Agentes: `AGENTS.md` y `.github/agents/`.
11
+ 3. Motores: CodeGraph, GitNexus, Graphify, Azure RAG Builder, Repomix.
12
+ 4. Politicas: `policies/` y `optimization/policies/`.
13
+ 5. Observabilidad: `observability/`.
14
+
15
+ ## Reglas
16
+
17
+ 1. Un evento de routing debe tener un motor principal.
18
+ 2. Si hay mezcla de motores, el secundario se justifica en `notes`.
19
+ 3. No se usa discovery amplio cuando hay evidencia estructurada suficiente.
20
+ 4. En ausencia de grounding, se declara gap explicito.
21
+
22
+ ## Flujo de ejecucion
23
+
24
+ 1. Memory-first.
25
+ 2. Resolucion de routing.
26
+ 3. Ejecucion de agente/motor.
27
+ 4. Registro en logs y evaluacion.
28
+
29
+ ## Validacion minima
30
+
31
+ 1. `python .\scripts\intake\resolve-routing.py --input "test" --intent info --domain dev --source-type code` emite evento valido.
32
+ 2. `python .\scripts\intake\run-routing-evals.py` mantiene casos en verde.
@@ -0,0 +1,28 @@
1
+ # azure-rag spec
2
+
3
+ ## Objetivo
4
+
5
+ Definir cuando usar Azure RAG Builder para conocimiento corporativo y como evitar respuestas sin fuente.
6
+
7
+ ## Alcance
8
+
9
+ 1. Contratos, SLA, politicas y documentacion corporativa no contenida en el repo.
10
+ 2. Consultas donde la fuente oficial debe citarse.
11
+
12
+ ## Reglas
13
+
14
+ 1. Azure RAG no se usa para modificar codigo del repo.
15
+ 2. Si no hay fuente recuperada, se declara gap en lugar de inferir.
16
+ 3. La respuesta debe separar claramente evidencia recuperada y recomendacion.
17
+ 4. En tareas mixtas codigo + corporativo, usar motor principal y secundario justificado.
18
+
19
+ ## Entradas esperadas
20
+
21
+ 1. Intencion de consulta clara.
22
+ 2. Contexto de dominio (seguridad, compliance, contrato, operaciones).
23
+
24
+ ## Validacion minima
25
+
26
+ 1. El evento de routing debe seleccionar `rag-azure` cuando `source_type=corporate-docs`.
27
+ 2. Debe existir traza en `observability/logs/routing-decisions.jsonl` con `grounded=true` solo si hay fuentes.
28
+
@@ -0,0 +1,24 @@
1
+ # coding-standards spec
2
+
3
+ ## Objetivo
4
+
5
+ Establecer reglas de cambio seguro y minimo para scripts, docs operativas y artefactos de soporte.
6
+
7
+ ## Reglas
8
+
9
+ 1. Cambios minimos y acotados al alcance de la tarea.
10
+ 2. Sin refactor amplio fuera de scope.
11
+ 3. Mantener rutas canonicas en `scripts/setup|intake|ops|discovery|context|learning`.
12
+ 4. Priorizar JSON-first en artefactos operativos.
13
+ 5. Evitar duplicar logica entre wrappers y scripts canonicos.
14
+
15
+ ## Estilo por tecnologia
16
+
17
+ 1. Python: repo root correcto para scripts en subcarpetas (`parents[2]` en utilidades bajo `scripts/*/*`).
18
+ 2. PowerShell: resolver root con `Join-Path $PSScriptRoot '..\\..'` cuando el script vive en subcarpeta.
19
+ 3. Markdown: contratos claros, accionables y verificables.
20
+
21
+ ## Validacion minima
22
+
23
+ 1. `py -3 -m compileall -q .\scripts` sin errores.
24
+ 2. `pwsh -NoProfile -ExecutionPolicy Bypass -File .\scripts\setup\validate-context.ps1` en verde.
@@ -0,0 +1,29 @@
1
+ # database spec
2
+
3
+ ## Objetivo
4
+
5
+ Definir reglas para tareas de SQL/esquema/procedimientos en el routing corporativo.
6
+
7
+ ## Alcance
8
+
9
+ 1. Analisis de contratos SQL, esquemas y procedimientos.
10
+ 2. Consultas tecnicas de base de datos documentadas en specs o artefactos de conocimiento.
11
+
12
+ ## Reglas
13
+
14
+ 1. Para intenciones SQL, el agente objetivo es `dba`.
15
+ 2. Si falta esquema/fuente, declarar gap y pedir minimo dato faltante.
16
+ 3. No ejecutar cambios destructivos sin confirmacion explicita.
17
+ 4. Mantener trazabilidad de decisiones en logs de routing.
18
+
19
+ ## Evidencia requerida
20
+
21
+ 1. Fuente de esquema o contrato tecnico.
22
+ 2. Contexto de entorno objetivo (dev/test/prod) cuando aplique.
23
+
24
+ ## Validacion minima
25
+
26
+ 1. `py -3 .\scripts\intake\validate-database-routing.py` completa sin errores.
27
+ 2. Evento de routing para `intent=sql` selecciona `dba` (verificado por el script anterior).
28
+ 3. El evento declara `grounded=false` si no hay fuente resoluble (verificado por el script anterior).
29
+
@@ -0,0 +1,26 @@
1
+ # migration spec
2
+
3
+ ## Objetivo
4
+
5
+ Definir el contrato para migraciones de repos, rutas y componentes sin romper operatividad.
6
+
7
+ ## Reglas
8
+
9
+ 1. Preferir migracion incremental con verificacion por etapas.
10
+ 2. Mantener compatibilidad operativa durante la transicion cuando sea necesario.
11
+ 3. Al finalizar migracion, eliminar deuda/legacy solo cuando exista validacion en verde.
12
+ 4. Toda migracion debe actualizar scripts, docs y workflows afectados.
13
+
14
+ ## Flujo minimo
15
+
16
+ 1. Inventario de referencias antiguas.
17
+ 2. Cambio canonicamente en codigo/scripts.
18
+ 3. Actualizacion documental.
19
+ 4. Validacion tecnica.
20
+ 5. Limpieza final.
21
+
22
+ ## Validacion minima
23
+
24
+ 1. `pwsh -NoProfile -ExecutionPolicy Bypass -File .\scripts\setup\validate-context.ps1` en verde.
25
+ 2. `py -3 .\scripts\intake\run-routing-evals.py` con casos aprobados.
26
+ 3. `py -3 -m compileall -q .\scripts` sin errores.
@@ -0,0 +1,24 @@
1
+ # observability spec
2
+
3
+ ## Objetivo
4
+
5
+ Definir el contrato de telemetria para decisiones de routing, evaluacion y trazabilidad operacional.
6
+
7
+ ## Reglas
8
+
9
+ 1. Toda decision de routing debe registrarse en JSONL.
10
+ 2. Los eventos deben cumplir el esquema de logs.
11
+ 3. Debe existir reporte de evaluacion de routing actualizado.
12
+ 4. Las rutas con riesgo alto deben registrar estado HITL.
13
+ 5. No se aceptan eventos sin campos minimos de contexto.
14
+
15
+ ## Artefactos canonicos
16
+
17
+ 1. `observability/logs/routing-decisions.jsonl`.
18
+ 2. `observability/logs.schema.json`.
19
+ 3. `observability/evals/routing-eval-report.json`.
20
+
21
+ ## Validacion minima
22
+
23
+ 1. `py -3 .\scripts\intake\run-routing-evals.py` genera reporte en `observability/evals/routing-eval-report.json`.
24
+ 2. `py -3 .\scripts\intake\resolve-routing.py --input "test" --intent info --domain dev --source-type code` agrega evento en `observability/logs/routing-decisions.jsonl`.
@@ -0,0 +1,31 @@
1
+ # optimization spec
2
+
3
+ Contrato operativo de optimizacion always-on para routing, contexto y enforcement.
4
+
5
+ ## Routing Robustness Contract (Production)
6
+
7
+ 1. El routing debe seleccionar un agent y engine principal por evento.
8
+ 2. El evento debe declarar `sources` explicitas o marcar `grounded=false`.
9
+ 3. Si hay fallback y no hay `sources`, `grounded` debe ser `false`.
10
+ 4. `requirements` se calculan por engine real elegido, no solo por `source_type`.
11
+ 5. En rutas mixtas, se declara engine principal y secundarios en `notes`.
12
+ 6. Si falta evidencia o fuente resoluble, se declara gap explicito.
13
+
14
+ ## Token Efficiency Contract (Ahorro de Tokens)
15
+
16
+ 1. El flujo debe usar scope quirurgico y evitar discovery abierto por defecto.
17
+ 2. La ejecucion debe separar planificacion y cambios atomicos cuando aplique.
18
+ 3. Si existe CLI determinista para scaffolding/boilerplate, se usa antes que generacion manual.
19
+ 4. La respuesta operativa debe mantener formato corto accionable: diagnostico, accion, validacion, riesgo/gap.
20
+ 5. La base canonica para esta logica es `docs/00-Ahorro_Tokens.md`.
21
+
22
+ ## Enforcement
23
+
24
+ 1. Antes de merge, ejecutar `py -3 .\\scripts\\intake\\run-routing-evals.py`.
25
+ 2. El merge queda bloqueado si `cases_failed > 0` en `observability/evals/routing-eval-report.json`.
26
+
27
+ ## Validacion minima
28
+
29
+ 1. `py -3 .\scripts\intake\run-routing-evals.py` completa con `cases_failed=0`.
30
+ 2. `py -3 .\scripts\intake\resolve-routing.py --input "test" --intent info --domain dev --source-type code` emite evento con `agent` y `grounded` presentes.
31
+ 3. El reporte `observability/evals/routing-eval-report.json` existe y refleja `cases_failed=0`.
@@ -0,0 +1,30 @@
1
+ # rag spec
2
+
3
+ ## Objetivo
4
+
5
+ Definir el uso de RAG local para documentacion tecnica del repo y artefactos internos.
6
+
7
+ ## Alcance
8
+
9
+ 1. Consultas sobre arquitectura, guias y politicas locales.
10
+ 2. Navegacion de conocimiento indexado en `context/graphify-out/`.
11
+
12
+ ## Reglas
13
+
14
+ 1. Preferir RAG local para conocimiento interno antes de consultas externas.
15
+ 2. No mezclar RAG local y Azure RAG sin justificar el caso mixto.
16
+ 3. Si no hay evidencia local suficiente, declarar gap y escalar motor.
17
+ 4. Mantener respuestas trazables a fuente local.
18
+
19
+ ## Artefactos clave
20
+
21
+ 1. `context/graphify-out/graph.json`.
22
+ 2. `context/graphify-out/manifest.json`.
23
+ 3. `docs/` y `project-notes/` como base documental.
24
+
25
+ ## Validacion minima
26
+
27
+ 1. `py -3 .\scripts\intake\validate-rag-routing.py` completa sin errores.
28
+ 2. La decision de routing para docs locales selecciona `rag-local` (verificado por el script anterior).
29
+ 3. La salida mantiene grounding explicito a fuentes del repo (verificado por el script anterior).
30
+
@@ -0,0 +1,25 @@
1
+ # repo-intake spec
2
+
3
+ ## Objetivo
4
+
5
+ Definir el contrato de intake para mantener metadata de repos consistente y utilizable por routing.
6
+
7
+ ## Reglas
8
+
9
+ 1. Todo repo debe existir en `repo-registry/repos.yml`.
10
+ 2. El registry debe validar en modo estricto antes de intake.
11
+ 3. El intake debe generar capacidades, manifests y reportes.
12
+ 4. Repos opcionales pueden generar warning, no error bloqueante.
13
+ 5. No se debe depender de rutas legacy fuera de `scripts/intake`.
14
+
15
+ ## Flujo minimo
16
+
17
+ 1. Validar registry.
18
+ 2. Ejecutar intake.
19
+ 3. Verificar artefactos generados.
20
+
21
+ ## Validacion minima
22
+
23
+ 1. `pwsh -NoProfile -File .\scripts\intake\validate-repo-registry.ps1 -Strict` en verde.
24
+ 2. `.\scripts\intake\run-repo-intake.cmd` completado sin errores bloqueantes.
25
+ 3. Reporte disponible en `repo-intake/generated/reports/repo-registry-validation.json`.
@@ -0,0 +1,24 @@
1
+ # routing spec
2
+
3
+ ## Objetivo
4
+
5
+ Definir el contrato de enrutamiento entre intencion, dominio, agente, motor y nivel de grounding.
6
+
7
+ ## Reglas
8
+
9
+ 1. Cada evento debe seleccionar un agente y motor principal.
10
+ 2. Si hay fallback, debe quedar marcado en el evento.
11
+ 3. `grounded` solo puede ser `true` cuando existan `sources` resolubles.
12
+ 4. Rutas de alto impacto deben activar HITL.
13
+ 5. En casos mixtos, el motor secundario se justifica en `notes`.
14
+
15
+ ## Entradas esperadas
16
+
17
+ 1. `input`, `intent`, `domain`, `source_type`.
18
+ 2. `capability` opcional para ruta dirigida.
19
+
20
+ ## Validacion minima
21
+
22
+ 1. `py -3 .\scripts\intake\resolve-routing.py --input "consulta contrato" --intent info --domain azure-rag --source-type corporate-docs` debe enrutar a `rag-azure`.
23
+ 2. `py -3 .\scripts\intake\run-routing-evals.py` debe pasar sin casos fallidos.
24
+
@@ -0,0 +1,30 @@
1
+ # security spec
2
+
3
+ ## Objetivo
4
+
5
+ Definir reglas de seguridad para routing, memoria, snapshots y respuestas.
6
+
7
+ ## Reglas
8
+
9
+ 1. No exponer secretos, tokens, credenciales ni datos sensibles.
10
+ 2. No persistir secretos en memorias ni logs.
11
+ 3. Acciones destructivas o de alto impacto requieren confirmacion humana.
12
+ 4. En duda de sensibilidad, bloquear cacheado y declarar gap.
13
+
14
+ ## Controles
15
+
16
+ 1. Revisar artefactos generados antes de publicarlos.
17
+ 2. Mantener exclusions de secretos en flujos de empaquetado/indexado.
18
+ 3. Verificar que respuestas no contengan valores sensibles reales.
19
+
20
+ ## Senales de incumplimiento
21
+
22
+ 1. Secretos en texto plano en snapshots o logs.
23
+ 2. Comandos de alto riesgo ejecutados sin aprobacion.
24
+ 3. Memoria persistente con informacion sensible.
25
+
26
+ ## Validacion minima
27
+
28
+ 1. `py -3 .\scripts\intake\validate-security.py` completa sin errores.
29
+ 2. Alineado con `policies/security-policy.md` (verificado por el script anterior).
30
+ 3. Eventos de riesgo alto deben reflejar ruta HITL en observabilidad (verificado por el script anterior).
@@ -0,0 +1,33 @@
1
+ {
2
+ "$schema": "http://json-schema.org",
3
+ "title": "WikiProviderContract",
4
+ "type": "object",
5
+ "properties": {
6
+ "provider_id": { "type": "string" },
7
+ "entities": {
8
+ "type": "array",
9
+ "items": {
10
+ "type": "object",
11
+ "properties": {
12
+ "id": { "type": "string" },
13
+ "type": { "type": "string" },
14
+ "checksum": { "type": "string" },
15
+ "raw_data": { "type": "object" },
16
+ "relations": {
17
+ "type": "array",
18
+ "items": {
19
+ "type": "object",
20
+ "properties": {
21
+ "target": { "type": "string" },
22
+ "type": { "type": "string" }
23
+ },
24
+ "required": ["target", "type"]
25
+ }
26
+ }
27
+ },
28
+ "required": ["id", "type", "checksum", "raw_data", "relations"]
29
+ }
30
+ }
31
+ },
32
+ "required": ["provider_id", "entities"]
33
+ }
@@ -0,0 +1,25 @@
1
+ {
2
+ "$schema": "http://json-schema.org",
3
+ "title": "UnifiedKnowledgeGraph",
4
+ "type": "object",
5
+ "properties": {
6
+ "last_updated": { "type": "string" },
7
+ "nodes": {
8
+ "type": "object",
9
+ "additionalProperties": {
10
+ "type": "object",
11
+ "properties": {
12
+ "node_id": { "type": "string" },
13
+ "provider": { "type": "string" },
14
+ "type": { "type": "string" },
15
+ "checksum": { "type": "string" },
16
+ "metadata": { "type": "object" },
17
+ "relations": { "type": "array" },
18
+ "semantic_summary": { "type": "string" }
19
+ },
20
+ "required": ["node_id", "provider", "type", "checksum", "relations"]
21
+ }
22
+ }
23
+ },
24
+ "required": ["last_updated", "nodes"]
25
+ }
@@ -0,0 +1,96 @@
1
+ # boost_{FEATURE_NAME}
2
+
3
+ [![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
4
+ [![GitHub Actions](https://github.com/Sertxito/boost_{FEATURE_NAME}/workflows/CI/badge.svg)](https://github.com/Sertxito/boost_{FEATURE_NAME}/actions)
5
+
6
+ > {ONE_LINE_DESCRIPTION}
7
+
8
+ ## Overview
9
+
10
+ {2-3 SENTENCE EXPLANATION OF WHAT THIS BOOST DOES}
11
+
12
+ ### Key Features
13
+
14
+ - ✅ {Feature 1}
15
+ - ✅ {Feature 2}
16
+ - ✅ {Feature 3}
17
+
18
+ ## Quick Start
19
+
20
+ ### Prerequisites
21
+
22
+ - {Requirement 1}
23
+ - {Requirement 2}
24
+
25
+ ### Installation
26
+
27
+ ```bash
28
+ git clone https://github.com/Sertxito/boost_{FEATURE_NAME}.git
29
+ cd boost_{FEATURE_NAME}
30
+ # Setup instructions
31
+ ```
32
+
33
+ ### Basic Usage
34
+
35
+ ```bash
36
+ # Example command
37
+ ```
38
+
39
+ ## Architecture
40
+
41
+ ```
42
+ {ASCII diagram or high-level component overview}
43
+ ```
44
+
45
+ ## Use Cases
46
+
47
+ ### Use Case 1
48
+ {Description of first main use case}
49
+
50
+ ### Use Case 2
51
+ {Description of second main use case}
52
+
53
+ ### Use Case 3
54
+ {Description of third main use case}
55
+
56
+ ## Configuration
57
+
58
+ {Configuration options, environment variables, etc.}
59
+
60
+ ## API Reference
61
+
62
+ {Main functions/methods, parameters, returns}
63
+
64
+ ## Contributing
65
+
66
+ 1. Fork the repository
67
+ 2. Create a feature branch (`git checkout -b feature/AmazingFeature`)
68
+ 3. Commit your changes (`git commit -m 'Add AmazingFeature'`)
69
+ 4. Push to the branch (`git push origin feature/AmazingFeature`)
70
+ 5. Open a Pull Request
71
+
72
+ ## Troubleshooting
73
+
74
+ ### {Common Issue}
75
+ **Solution:** {How to fix}
76
+
77
+ ### {Another Common Issue}
78
+ **Solution:** {How to fix}
79
+
80
+ ## Related Resources
81
+
82
+ - Main Platform: [mcp-efficiency-engine](https://github.com/Sertxito/mcp-efficiency-engine)
83
+ - Other Boosts: [boost_backend](https://github.com/Sertxito/boost_backend), [boost_RAG-Azure](https://github.com/Sertxito/boost_RAG-Azure)
84
+
85
+ ## License
86
+
87
+ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
88
+
89
+ ## Support
90
+
91
+ For questions or issues, please open a GitHub Issue or contact via GitHub Discussions.
92
+
93
+ ---
94
+
95
+ **Last Updated:** {DATE}
96
+ **Maintainer:** Sertxito
@@ -0,0 +1,29 @@
1
+ # CODEOWNERS — Sertxito Repositories
2
+ # Defines code ownership and review requirements
3
+ #
4
+ # Format: <path or pattern> <@username or team>
5
+ # More info: https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners
6
+
7
+ # All code requires Sertxito review
8
+ * @Sertxito
9
+
10
+ # GitHub-specific configuration always needs review
11
+ .github/ @Sertxito
12
+ .github/workflows/ @Sertxito
13
+
14
+ # Infrastructure and configuration
15
+ *.yml @Sertxito
16
+ *.yaml @Sertxito
17
+ *.json @Sertxito
18
+ *.bicep @Sertxito
19
+ Dockerfile @Sertxito
20
+
21
+ # Documentation
22
+ *.md @Sertxito
23
+ docs/ @Sertxito
24
+ README.md @Sertxito
25
+
26
+ # Tests always require review
27
+ **/test* @Sertxito
28
+ **/spec* @Sertxito
29
+ **/__tests__/ @Sertxito
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Sertxito
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,90 @@
1
+ # 👋 Sertxito — Ingeniería de IA & Arquitectura Cloud
2
+
3
+ **Arquitecto Cloud | AI/ML Ops | Ingeniería de Agentes**
4
+
5
+ Bienvenido a mi perfil de GitHub. Me enfoco en construir sistemas de IA empresariales, infraestructura cloud y frameworks especializados de agentes en Azure.
6
+
7
+ ---
8
+
9
+ ## 🎯 Misión
10
+
11
+ Acelerar la adopción de IA a través de arquitectura **modular, reutilizable y driven by specs**. Todo el trabajo está organizado alrededor de **boost_*** repositories — cada una es una capacidad auto-contenida que encaja en una plataforma mayor.
12
+
13
+ ---
14
+
15
+ ## 🚀 Proyectos Principales
16
+
17
+ ### Plataforma Primaria
18
+ - **[mcp-efficiency-engine](https://github.com/Sertxito/mcp-efficiency-engine)** — Plataforma empresarial de routing MCP, optimización y orquestación de agentes
19
+ ↳ Spec-driven | Optimización de tokens | Coordinación multi-agente | Automatización GitHub Actions
20
+
21
+ ### Boost Repositories (Agentes Especializados & Capacidades)
22
+
23
+ | Repo | Enfoque | Estado |
24
+ |------|---------|--------|
25
+ | **[boost_RAG-Azure](https://github.com/Sertxito/boost_RAG-Azure)** | RAG empresarial con Azure AI Search, semantic caching, contexto multi-turno | Público |
26
+ | **[boost_backend](https://github.com/Sertxito/boost_backend)** | Patrones backend, APIs, routing de base datos, optimización CRUD | Público |
27
+ | **[boost_azure-iot-edge](https://github.com/Sertxito/boost_azure-iot-edge)** | Despliegue IoT Edge, gestión de dispositivos, pipelines de telemetría | Público |
28
+ | boost_frontend | Patrones UI/UX, librerías de componentes, design systems | Privado |
29
+ | boost_sertxIA | Framework de agentes IA, orquestación de herramientas, execution flows | Privado |
30
+ | boost_architect-forensics-expert | Forensics de infraestructura, análisis de costos, auditorías de compliance | Privado |
31
+ | boost_design-UX-with-Intent | Diseño intent-driven, accesibilidad, patrones de experiencia de usuario | Privado |
32
+
33
+ ---
34
+
35
+ ## 📚 Recursos
36
+
37
+ ### Documentación
38
+ - **[Guía de Onboarding](https://github.com/Sertxito/mcp-efficiency-engine/blob/main/docs/01-onboarding.md)** — Quick start de la plataforma
39
+ - **[Desarrollo Spec-Driven](https://github.com/Sertxito/mcp-efficiency-engine/tree/main/specs)** — 11 especificaciones arquitectónicas
40
+ - **[Agent Routing](https://github.com/Sertxito/mcp-efficiency-engine/blob/main/orchestrator/router.md)** — Cómo se seleccionan y coordinan agentes
41
+ - **[Optimización de Tokens](https://github.com/Sertxito/mcp-efficiency-engine/blob/main/optimization/token-saver.md)** — Patrones de eficiencia de costos
42
+
43
+ ### Herramientas & Scripts
44
+ - **[Framework de Validación](https://github.com/Sertxito/mcp-efficiency-engine/tree/main/scripts/intake)** — Compliance de routing Database/RAG
45
+ - **[Automatización GitHub](https://github.com/Sertxito/mcp-efficiency-engine/tree/main/scripts/github)** — Sincronización de repos, generación de devlog, gestión de issues via gh CLI
46
+ - **[Setup & CI/CD](https://github.com/Sertxito/mcp-efficiency-engine/tree/main/.github/workflows)** — GitHub Actions para validación, despliegue de pages, orquestación multi-repo
47
+
48
+ ---
49
+
50
+ ## 🔧 Tech Stack
51
+
52
+ - **Cloud**: Azure (App Service, Functions, Container Apps, AKS, Cosmos DB, Cognitive Search, OpenAI)
53
+ - **AI/ML**: Routing de modelos, prompt engineering, patrones RAG, orquestación de agentes
54
+ - **IaC**: Bicep, Terraform (planeado)
55
+ - **Automatización**: GitHub Actions, PowerShell 7, Python 3.11+
56
+ - **Herramientas**: gh CLI, Azure CLI, Docker, Kubernetes
57
+ - **Code Intelligence**: GitNexus, CodeGraph, Repomix
58
+
59
+ ---
60
+
61
+ ## 📊 Estadísticas GitHub
62
+
63
+ ![GitHub Stats](https://github-readme-stats.vercel.app/api?username=Sertxito&show_icons=true&theme=dark)
64
+
65
+ ---
66
+
67
+ ## 🎓 Aprendizaje & Contribuciones
68
+
69
+ - 📖 Escribí: [Guía de Arquitectura Spec-Driven](https://github.com/Sertxito/mcp-efficiency-engine/blob/main/ARCHITECTURE.md)
70
+ - 📝 Publicado: [Patrones de Optimización de Tokens](https://github.com/Sertxito/mcp-efficiency-engine/blob/main/docs/00-Ahorro_Tokens.md)
71
+ - 🛠️ Construí: [Workflows de sincronización multi-repo](https://github.com/Sertxito/mcp-efficiency-engine/blob/main/.github/workflows/auto-sync.yml)
72
+ - 🤖 Mantengo: [Framework de routing empresarial](https://github.com/Sertxito/mcp-efficiency-engine/blob/main/AGENTS.md)
73
+
74
+ ---
75
+
76
+ ## 📬 Contacto
77
+
78
+ - **GitHub Issues**: Usa las [discussions de mcp-efficiency-engine](https://github.com/Sertxito/mcp-efficiency-engine/discussions)
79
+ - **Colaboración**: Abierto a partnerships empresariales en proyectos de IA/cloud
80
+
81
+ ---
82
+
83
+ ## 📜 Licencia
84
+
85
+ Todos los repositorios públicos están bajo licencia **MIT License** — ver repos individuales para detalles.
86
+
87
+ ---
88
+
89
+ **Última Actualización**: 2026-07-04
90
+ **Estado**: 🟢 Desarrollo Activo
@@ -0,0 +1,46 @@
1
+ # boost_RAG-Azure
2
+
3
+ [![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
4
+ [![GitHub Repo](https://img.shields.io/badge/repo-boost__RAG--Azure-blue)](https://github.com/Sertxito/boost_RAG-Azure)
5
+
6
+ > RAG Builder — Base de Conocimiento Empresarial en ~45 minutos
7
+
8
+ ## Overview
9
+
10
+ Framework llave en mano para construir sistemas RAG (Retrieval-Augmented Generation) sobre Azure. Conecta documentos empresariales (PDF, Word, Excel, SQL, code) → Azure AI Search con hybrid search → respuestas precisas sobre conocimiento corporativo con citas verificables.
11
+
12
+ ### Key Features
13
+
14
+ - ✅ **8 Agentes Especializados** — Indexación, búsqueda, síntesis, auditoría
15
+ - ✅ **15 Skills Reutilizables** — Modelos reusables para dominios específicos
16
+ - ✅ **Tres Tiers Predefinidos** — Mínima, Estándar, Producción
17
+ - ✅ **Hybrid Search** — Búsqueda vector + keyword para máxima precisión
18
+ - ✅ **Telemetría Completa** — Observabilidad integrada con Application Insights
19
+ - ✅ **Budget Alerts** — Control de costes en tiempo real
20
+ - ✅ **Despliegue Automatizado** — Onboarding guiado step-by-step
21
+
22
+ ## Quick Start
23
+
24
+ ### Prerequisites
25
+
26
+ - Azure subscription
27
+ - Azure CLI (`az`) installed
28
+ - GitHub CLI (`gh`) authenticated
29
+
30
+ ### Installation
31
+
32
+ ```bash
33
+ git clone https://github.com/Sertxito/boost_RAG-Azure.git
34
+ cd boost_RAG-Azure
35
+ # Follow deployment guide in docs/
36
+ ```
37
+
38
+ ## Documentation
39
+
40
+ - [Architecture](docs/ARCHITECTURE.md)
41
+ - [Deployment Guide](docs/DEPLOYMENT.md)
42
+ - [Configuration](docs/CONFIG.md)
43
+
44
+ ## License
45
+
46
+ MIT — See [LICENSE](LICENSE)