@christianmaf80/agentic-workflow 1.41.0-beta.10 → 1.42.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 (339) hide show
  1. package/README.es.md +13 -94
  2. package/README.md +14 -94
  3. package/RELEASE_PROCESS.md +3 -6
  4. package/bin/cli.js +31 -72
  5. package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/acceptance.md +70 -0
  6. package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/agent-scores.md +22 -0
  7. package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/agent-tasks/1-dev-agent-scaffold.md +106 -0
  8. package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/agent-tasks/2-dev-agent-manifest-command.md +105 -0
  9. package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/agent-tasks/3-dev-agent-marketplace-evidence.md +103 -0
  10. package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/agent-tasks/4-qa-agent-verify-build.md +103 -0
  11. package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/analysis.md +197 -0
  12. package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/architect/review.md +131 -0
  13. package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/changelog.md +26 -0
  14. package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/metrics.md +40 -0
  15. package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/plan.md +175 -0
  16. package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/researcher/research.md +157 -0
  17. package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/results-acceptance.md +168 -0
  18. package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/task.md +119 -0
  19. package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/verification.md +79 -0
  20. package/dist/agent/artifacts/11-refinement-capas-constitution/analysis.md +24 -0
  21. package/dist/agent/artifacts/11-refinement-capas-constitution/roadmap-audit.md +34 -0
  22. package/dist/agent/artifacts/11-refinement-capas-constitution/task.md +58 -0
  23. package/dist/agent/artifacts/12-npm-workspaces/acceptance.md +78 -0
  24. package/dist/agent/artifacts/12-npm-workspaces/analysis.md +179 -0
  25. package/dist/agent/artifacts/12-npm-workspaces/plan.md +237 -0
  26. package/dist/agent/artifacts/12-npm-workspaces/researcher/research.md +186 -0
  27. package/dist/agent/artifacts/12-npm-workspaces/task.md +126 -0
  28. package/dist/agent/artifacts/13-implement-custom-chat-with-a2ui/acceptance.md +75 -0
  29. package/dist/agent/artifacts/13-implement-custom-chat-with-a2ui/researcher/research.md +121 -0
  30. package/dist/agent/artifacts/13-implement-custom-chat-with-a2ui/task.md +104 -0
  31. package/dist/agent/artifacts/14-re-implement-setup-config-d1/acceptance.md +75 -0
  32. package/dist/agent/artifacts/14-re-implement-setup-config-d1/architect/analysis.md +90 -0
  33. package/dist/agent/artifacts/14-re-implement-setup-config-d1/planner/implementation_plan.md +44 -0
  34. package/dist/agent/artifacts/14-re-implement-setup-config-d1/researcher/research.md +113 -0
  35. package/dist/agent/artifacts/14-re-implement-setup-config-d1/task.md +107 -0
  36. package/dist/agent/artifacts/14-re-implement-setup-config-d1/verification/walkthrough.md +37 -0
  37. package/dist/agent/artifacts/14-re-implement-setup-config-d1/verifier/walkthrough.md +0 -0
  38. package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/acceptance.md +68 -0
  39. package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/agent-tasks/1-dev-agent-contribution-points-assets.md +107 -0
  40. package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/agent-tasks/2-dev-agent-webview-provider.md +106 -0
  41. package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/agent-tasks/3-dev-agent-webview-ui.md +104 -0
  42. package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/agent-tasks/4-dev-agent-chat-participant.md +104 -0
  43. package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/agent-tasks/5-dev-agent-migrate-to-root.md +103 -0
  44. package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/agent-tasks/fix-1-dev-agent-chat-participant-types.md +108 -0
  45. package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/agent-tasks/fix-2-dev-agent-view-container-id.md +106 -0
  46. package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/agent-tasks/fix-3-dev-agent-container-id-lowercase.md +105 -0
  47. package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/agent-tasks/fix-4-dev-agent-container-id-hyphen.md +105 -0
  48. package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/agent-tasks/fix-5-dev-agent-view-type-webview.md +103 -0
  49. package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/analysis.md +179 -0
  50. package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/architect/review.md +118 -0
  51. package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/plan.md +171 -0
  52. package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/researcher/research.md +113 -0
  53. package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/results-acceptance.md +171 -0
  54. package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/task.md +119 -0
  55. package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/verification.md +85 -0
  56. package/dist/agent/artifacts/3-new-vscode-agentic-activitybar-chat/acceptance.md +69 -0
  57. package/dist/agent/artifacts/3-new-vscode-agentic-activitybar-chat/agent-scores.md +23 -0
  58. package/dist/agent/artifacts/3-new-vscode-agentic-activitybar-chat/agent-tasks/1-dev-agent-create-project.md +89 -0
  59. package/dist/agent/artifacts/3-new-vscode-agentic-activitybar-chat/agent-tasks/2-dev-agent-contributes-activitybar.md +88 -0
  60. package/dist/agent/artifacts/3-new-vscode-agentic-activitybar-chat/agent-tasks/3-dev-agent-webview-panel.md +88 -0
  61. package/dist/agent/artifacts/3-new-vscode-agentic-activitybar-chat/agent-tasks/4-dev-agent-chat-participant.md +88 -0
  62. package/dist/agent/artifacts/3-new-vscode-agentic-activitybar-chat/agent-tasks/5-dev-agent-launch-config.md +90 -0
  63. package/dist/agent/artifacts/3-new-vscode-agentic-activitybar-chat/agent-tasks/fix-1-dev-agent-view-container-ids.md +90 -0
  64. package/dist/agent/artifacts/3-new-vscode-agentic-activitybar-chat/analysis.md +175 -0
  65. package/dist/agent/artifacts/3-new-vscode-agentic-activitybar-chat/architect/review.md +118 -0
  66. package/dist/agent/artifacts/3-new-vscode-agentic-activitybar-chat/changelog.md +26 -0
  67. package/dist/agent/artifacts/3-new-vscode-agentic-activitybar-chat/metrics.md +43 -0
  68. package/dist/agent/artifacts/3-new-vscode-agentic-activitybar-chat/plan.md +167 -0
  69. package/dist/agent/artifacts/3-new-vscode-agentic-activitybar-chat/researcher/research.md +115 -0
  70. package/dist/agent/artifacts/3-new-vscode-agentic-activitybar-chat/results-acceptance.md +122 -0
  71. package/dist/agent/artifacts/3-new-vscode-agentic-activitybar-chat/task.md +119 -0
  72. package/dist/agent/artifacts/3-new-vscode-agentic-activitybar-chat/verification.md +85 -0
  73. package/dist/agent/artifacts/4-copiar-estructura-agentic-cliente/acceptance.md +67 -0
  74. package/dist/agent/artifacts/4-copiar-estructura-agentic-cliente/architect/implementation.md +31 -0
  75. package/dist/agent/artifacts/4-copiar-estructura-agentic-cliente/brief.md +103 -0
  76. package/dist/agent/artifacts/4-copiar-estructura-agentic-cliente/closure.md +101 -0
  77. package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/acceptance.md +72 -0
  78. package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/agent-scores.md +20 -0
  79. package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/agent-tasks/1-dev-agent-reestructurar-carpetas.md +101 -0
  80. package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/agent-tasks/2-dev-agent-scaffolding-yeoman.md +111 -0
  81. package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/agent-tasks/3-dev-agent-merge-extension.md +110 -0
  82. package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/agent-tasks/4-dev-agent-merge-config.md +107 -0
  83. package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/agent-tasks/5-dev-agent-update-scripts.md +111 -0
  84. package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/agent-tasks/6-qa-agent-validation-install.md +108 -0
  85. package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/agent-tasks/7-dev-agent-fix-cli-entrypoint.md +104 -0
  86. package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/agent-tasks/8-qa-agent-validation-install-retry.md +106 -0
  87. package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/analysis.md +125 -0
  88. package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/architect/review.md +84 -0
  89. package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/changelog.md +34 -0
  90. package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/metrics.md +44 -0
  91. package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/plan.md +157 -0
  92. package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/researcher/research.md +105 -0
  93. package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/results-acceptance.md +105 -0
  94. package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/task.md +107 -0
  95. package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/verification.md +79 -0
  96. package/dist/agent/artifacts/6-release-beta-11/agent-tasks/1-dev-agent-release-bump.md +44 -0
  97. package/dist/agent/artifacts/6-release-beta-11/architect/implementation.md +37 -0
  98. package/dist/agent/artifacts/6-release-beta-11/brief.md +89 -0
  99. package/dist/agent/artifacts/6-release-beta-11/closure.md +83 -0
  100. package/dist/agent/artifacts/6-release-beta-11/task.md +65 -0
  101. package/dist/agent/artifacts/7-extension-vscode-webview/acceptance.md +70 -0
  102. package/dist/agent/artifacts/7-extension-vscode-webview/agent-scores.md +24 -0
  103. package/dist/agent/artifacts/7-extension-vscode-webview/agent-tasks/1-vscode-specialist-scaffold-extension.md +99 -0
  104. package/dist/agent/artifacts/7-extension-vscode-webview/agent-tasks/2-vscode-specialist-update-manifest.md +101 -0
  105. package/dist/agent/artifacts/7-extension-vscode-webview/agent-tasks/3-vscode-specialist-webview-provider.md +96 -0
  106. package/dist/agent/artifacts/7-extension-vscode-webview/agent-tasks/4-vscode-specialist-activitybar-icon.md +95 -0
  107. package/dist/agent/artifacts/7-extension-vscode-webview/agent-tasks/5-qa-agent-manual-verify.md +97 -0
  108. package/dist/agent/artifacts/7-extension-vscode-webview/analysis.md +195 -0
  109. package/dist/agent/artifacts/7-extension-vscode-webview/architect/review.md +124 -0
  110. package/dist/agent/artifacts/7-extension-vscode-webview/changelog.md +9 -0
  111. package/dist/agent/artifacts/7-extension-vscode-webview/metrics.md +43 -0
  112. package/dist/agent/artifacts/7-extension-vscode-webview/plan.md +181 -0
  113. package/dist/agent/artifacts/7-extension-vscode-webview/researcher/research.md +118 -0
  114. package/dist/agent/artifacts/7-extension-vscode-webview/results-acceptance.md +146 -0
  115. package/dist/agent/artifacts/7-extension-vscode-webview/task.md +119 -0
  116. package/dist/agent/artifacts/7-extension-vscode-webview/verification.md +81 -0
  117. package/dist/agent/artifacts/8-create-agentic-runtime-cli-first-as-the-single-execution-engine/task.md +126 -0
  118. package/dist/agent/artifacts/candidate/acceptance.md +23 -0
  119. package/dist/agent/artifacts/candidate/brief.md +39 -0
  120. package/dist/agent/artifacts/candidate/init.md +24 -0
  121. package/dist/agent/artifacts/candidate/task.md +5 -0
  122. package/dist/agent/artifacts/task-20260128-reorganize-structure/acceptance.md +68 -0
  123. package/dist/agent/artifacts/task-20260128-reorganize-structure/brief.md +100 -0
  124. package/dist/agent/artifacts/task-20260128-reorganize-structure/closure.md +40 -0
  125. package/dist/agent/artifacts/task-20260128-reorganize-structure/implementation.md +48 -0
  126. package/dist/agent/artifacts/task-20260128-reorganize-structure/task.md +66 -0
  127. package/dist/agent/artifacts/task-20260130-chatkit-mainview/acceptance.md +65 -0
  128. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-scores.md +26 -0
  129. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/1-neo-agent-deps-chatkit.md +108 -0
  130. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/15-vscode-specialist-views-router.md +89 -0
  131. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/1b-vscode-specialist-review-deps.md +106 -0
  132. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/2-neo-agent-local-server.md +111 -0
  133. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/22-vscode-specialist-external-js.md +84 -0
  134. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/23-qa-agent-coverage-tests.md +85 -0
  135. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/24-vscode-specialist-class-refactor.md +84 -0
  136. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/25-vscode-specialist-external-html.md +88 -0
  137. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/26-vscode-specialist-template-js-html.md +110 -0
  138. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/27-vscode-specialist-fix-loading-setup.md +110 -0
  139. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/28-vscode-specialist-webview-debug-setup.md +107 -0
  140. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/29-vscode-specialist-webview-logging.md +109 -0
  141. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/3-neo-agent-webview-ui.md +107 -0
  142. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/30-vscode-specialist-csp-source.md +88 -0
  143. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/31-vscode-specialist-logging-prefix.md +83 -0
  144. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/32-vscode-specialist-logging-visibility.md +85 -0
  145. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/33-vscode-specialist-lit-setup.md +85 -0
  146. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/34-vscode-specialist-core-lit-base.md +89 -0
  147. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/35-vscode-specialist-lit-decorators-ts.md +88 -0
  148. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/36-vscode-specialist-lit-module-start.md +85 -0
  149. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/37-vscode-specialist-lit-ready-state.md +86 -0
  150. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/4-qa-agent-verification.md +106 -0
  151. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/5-vscode-specialist-api-key-ui.md +107 -0
  152. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/6-vscode-specialist-refactor-protocol.md +108 -0
  153. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/7-qa-agent-unit-tests.md +104 -0
  154. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/fix-10-vscode-specialist-api-key-handshake.md +84 -0
  155. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/fix-11-vscode-specialist-api-key-button-style.md +83 -0
  156. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/fix-12-vscode-specialist-key-gate-view.md +84 -0
  157. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/fix-13-vscode-specialist-status-timeout.md +83 -0
  158. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/fix-14-vscode-specialist-init-flow.md +84 -0
  159. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/fix-16-vscode-specialist-view-context.md +87 -0
  160. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/fix-17-vscode-specialist-clear-key-command.md +85 -0
  161. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/fix-18-vscode-specialist-context-sync.md +84 -0
  162. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/fix-19-vscode-specialist-setup-visible.md +88 -0
  163. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/fix-20-vscode-specialist-loading-state.md +83 -0
  164. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/fix-21-vscode-specialist-loading-label.md +84 -0
  165. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/fix-8-vscode-specialist-api-key-detect.md +89 -0
  166. package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/fix-9-vscode-specialist-api-key-state.md +84 -0
  167. package/dist/agent/artifacts/task-20260130-chatkit-mainview/analysis.md +156 -0
  168. package/dist/agent/artifacts/task-20260130-chatkit-mainview/architect/review.md +141 -0
  169. package/dist/agent/artifacts/task-20260130-chatkit-mainview/changelog.md +30 -0
  170. package/dist/agent/artifacts/task-20260130-chatkit-mainview/metrics.md +43 -0
  171. package/dist/agent/artifacts/task-20260130-chatkit-mainview/plan.md +151 -0
  172. package/dist/agent/artifacts/task-20260130-chatkit-mainview/research.md +115 -0
  173. package/dist/agent/artifacts/task-20260130-chatkit-mainview/results-acceptance.md +171 -0
  174. package/dist/agent/artifacts/task-20260130-chatkit-mainview/verification.md +87 -0
  175. package/dist/agent/artifacts/task-20260130-fix-mainview-provider/acceptance.md +64 -0
  176. package/dist/agent/artifacts/task-20260130-fix-mainview-provider/architect/implementation.md +30 -0
  177. package/dist/agent/artifacts/task-20260130-fix-mainview-provider/brief.md +102 -0
  178. package/dist/agent/artifacts/task-20260130-fix-mainview-provider/closure.md +95 -0
  179. package/dist/agent/artifacts/task-20260130-rol-vscode/acceptance.md +68 -0
  180. package/dist/agent/artifacts/task-20260130-rol-vscode/architect/implementation.md +33 -0
  181. package/dist/agent/artifacts/task-20260130-rol-vscode/brief.md +104 -0
  182. package/dist/agent/artifacts/task-20260130-rol-vscode/closure.md +100 -0
  183. package/dist/agent/artifacts/task-beta-release/acceptance.md +23 -0
  184. package/dist/agent/artifacts/task-beta-release/brief.md +39 -0
  185. package/dist/agent/artifacts/task-beta-release/closure.md +29 -0
  186. package/dist/agent/artifacts/task-beta-release/init.md +26 -0
  187. package/dist/agent/artifacts/task-beta-release/task.md +64 -0
  188. package/dist/agent/index.md +69 -30
  189. package/dist/agent/rules/constitution/agents-behavior.md +110 -158
  190. package/dist/agent/rules/constitution/backend.md +27 -0
  191. package/dist/agent/rules/constitution/background.md +30 -0
  192. package/dist/agent/rules/constitution/clean-code.md +5 -6
  193. package/dist/agent/rules/constitution/modular-architecture.md +66 -0
  194. package/dist/agent/rules/constitution/view.md +41 -0
  195. package/dist/agent/rules/constitution/vscode-extensions.md +32 -0
  196. package/dist/agent/rules/roles/architect.md +1 -2
  197. package/dist/agent/rules/roles/backend.md +21 -0
  198. package/dist/agent/rules/roles/background.md +20 -0
  199. package/dist/agent/rules/roles/devops.md +20 -0
  200. package/dist/agent/rules/roles/engine.md +26 -0
  201. package/dist/agent/rules/roles/neo.md +12 -13
  202. package/dist/agent/rules/roles/researcher.md +2 -2
  203. package/dist/agent/rules/roles/view.md +22 -0
  204. package/dist/agent/rules/roles/vscode-specialist.md +24 -0
  205. package/dist/agent/templates/acceptance.md +19 -25
  206. package/dist/agent/templates/agent-task.md +39 -39
  207. package/dist/agent/templates/analysis.md +92 -92
  208. package/dist/agent/templates/brief.md +96 -0
  209. package/dist/agent/templates/changelog.md +8 -8
  210. package/dist/agent/templates/closure.md +95 -0
  211. package/dist/agent/templates/coding/coding-integration-report.md +102 -0
  212. package/dist/agent/templates/coding/coding-layer-report.md +78 -0
  213. package/dist/agent/templates/init.md +2 -23
  214. package/dist/agent/templates/planning.md +73 -73
  215. package/dist/agent/templates/research.md +43 -43
  216. package/dist/agent/templates/results-acceptance.md +94 -94
  217. package/dist/agent/templates/review.md +59 -59
  218. package/dist/agent/templates/subtask-implementation.md +29 -29
  219. package/dist/agent/templates/supplemental-report.md +0 -6
  220. package/dist/agent/templates/task-metrics.md +14 -14
  221. package/dist/agent/templates/task.md +18 -33
  222. package/dist/agent/templates/todo-item.md +23 -23
  223. package/dist/agent/workflows/coding/coding-backend.md +147 -0
  224. package/dist/agent/workflows/coding/coding-background.md +149 -0
  225. package/dist/agent/workflows/coding/coding-integration.md +174 -0
  226. package/dist/agent/workflows/coding/coding-view.md +151 -0
  227. package/dist/agent/workflows/init.md +93 -133
  228. package/dist/agent/workflows/scaffold-module.md +38 -0
  229. package/dist/agent/workflows/tasklifecycle-long/phase-0-acceptance-criteria.md +124 -134
  230. package/dist/agent/workflows/tasklifecycle-long/phase-1-research.md +103 -97
  231. package/dist/agent/workflows/tasklifecycle-long/phase-2-analysis.md +107 -102
  232. package/dist/agent/workflows/tasklifecycle-long/phase-3-planning.md +125 -120
  233. package/dist/agent/workflows/tasklifecycle-long/phase-4-implementation.md +121 -125
  234. package/dist/agent/workflows/tasklifecycle-long/phase-5-verification.md +105 -101
  235. package/dist/agent/workflows/tasklifecycle-long/phase-6-results-acceptance.md +82 -78
  236. package/dist/agent/workflows/tasklifecycle-long/phase-7-evaluation.md +84 -75
  237. package/dist/agent/workflows/tasklifecycle-long/phase-8-commit-push.md +94 -89
  238. package/dist/agent/workflows/tasklifecycle-short/short-phase-1-brief.md +117 -0
  239. package/dist/agent/workflows/tasklifecycle-short/short-phase-2-implementation.md +114 -0
  240. package/dist/agent/workflows/tasklifecycle-short/short-phase-3-closure.md +111 -0
  241. package/dist/cli/commands/create.js +4 -29
  242. package/dist/cli/commands/create.js.map +1 -1
  243. package/dist/cli/commands/fork.js +45 -0
  244. package/dist/cli/commands/fork.js.map +1 -0
  245. package/dist/cli/commands/init.js +4 -78
  246. package/dist/cli/commands/init.js.map +1 -1
  247. package/dist/cli/commands/mcp.js +3 -17
  248. package/dist/cli/commands/mcp.js.map +1 -1
  249. package/dist/cli/commands/scaffold.js +57 -0
  250. package/dist/cli/commands/scaffold.js.map +1 -0
  251. package/dist/cli/index.js +0 -1
  252. package/dist/cli/index.js.map +1 -1
  253. package/dist/infrastructure/context/manager.js +0 -2
  254. package/dist/infrastructure/context/manager.js.map +1 -1
  255. package/dist/infrastructure/index.js +0 -5
  256. package/dist/infrastructure/index.js.map +1 -1
  257. package/dist/runtime/engine/emitter.js +28 -0
  258. package/dist/runtime/engine/emitter.js.map +1 -0
  259. package/dist/runtime/engine/engine.js +128 -0
  260. package/dist/runtime/engine/engine.js.map +1 -0
  261. package/dist/runtime/engine/index.js +7 -0
  262. package/dist/runtime/engine/index.js.map +1 -0
  263. package/dist/runtime/engine/service.js +78 -0
  264. package/dist/runtime/engine/service.js.map +1 -0
  265. package/dist/runtime/engine/state-store.js +24 -0
  266. package/dist/runtime/engine/state-store.js.map +1 -0
  267. package/dist/runtime/{task-loader.js → engine/task-loader.js} +24 -5
  268. package/dist/runtime/engine/task-loader.js.map +1 -0
  269. package/dist/runtime/engine/workflow-loader.js +82 -0
  270. package/dist/runtime/engine/workflow-loader.js.map +1 -0
  271. package/dist/runtime/index.js +2 -4
  272. package/dist/runtime/index.js.map +1 -1
  273. package/dist/runtime/mcp/index.js +2 -0
  274. package/dist/runtime/mcp/index.js.map +1 -0
  275. package/dist/runtime/mcp/server.js +249 -0
  276. package/dist/runtime/mcp/server.js.map +1 -0
  277. package/media/agent-chat.svg +20 -0
  278. package/media/codicons/codicon.css +698 -0
  279. package/media/codicons/codicon.ttf +0 -0
  280. package/media/providers/claude.png +0 -0
  281. package/media/providers/gemini.png +0 -0
  282. package/media/providers/openai.png +0 -0
  283. package/package.json +124 -56
  284. package/dist/agent/artifacts/candidate/index.md +0 -26
  285. package/dist/agent/artifacts/index.md +0 -25
  286. package/dist/agent/rules/constitution/index.md +0 -26
  287. package/dist/agent/rules/constitution/runtime-integration.md +0 -102
  288. package/dist/agent/rules/index.md +0 -70
  289. package/dist/agent/rules/roles/index.md +0 -44
  290. package/dist/agent/skills/index.md +0 -23
  291. package/dist/agent/skills/runtime-governance/SKILL.md +0 -62
  292. package/dist/agent/templates/analisis.md +0 -86
  293. package/dist/agent/templates/index.md +0 -43
  294. package/dist/agent/templates/plan.md +0 -49
  295. package/dist/agent/templates/qa-results.md +0 -70
  296. package/dist/agent/workflows/index.md +0 -30
  297. package/dist/agent/workflows/tasklifecycle-long/index.md +0 -172
  298. package/dist/agent/workflows/tasklifecycle-short/index.md +0 -77
  299. package/dist/agent/workflows/tasklifecycle-short/short-phase-1-analisis.md +0 -116
  300. package/dist/agent/workflows/tasklifecycle-short/short-phase-2-plan.md +0 -81
  301. package/dist/agent/workflows/tasklifecycle-short/short-phase-3-implementation.md +0 -115
  302. package/dist/agent/workflows/tasklifecycle-short/short-phase-4-qa-results.md +0 -84
  303. package/dist/cli/commands/bootstrap.js +0 -111
  304. package/dist/cli/commands/bootstrap.js.map +0 -1
  305. package/dist/cli/commands/register-mcp.js +0 -135
  306. package/dist/cli/commands/register-mcp.js.map +0 -1
  307. package/dist/infrastructure/context/index.js +0 -2
  308. package/dist/infrastructure/context/index.js.map +0 -1
  309. package/dist/infrastructure/logger/index.js +0 -41
  310. package/dist/infrastructure/logger/index.js.map +0 -1
  311. package/dist/infrastructure/mapping/index.js +0 -2
  312. package/dist/infrastructure/mapping/index.js.map +0 -1
  313. package/dist/infrastructure/migration/index.js +0 -4
  314. package/dist/infrastructure/migration/index.js.map +0 -1
  315. package/dist/infrastructure/utils/index.js +0 -2
  316. package/dist/infrastructure/utils/index.js.map +0 -1
  317. package/dist/mcp/emitter.js +0 -24
  318. package/dist/mcp/emitter.js.map +0 -1
  319. package/dist/mcp/handlers.js +0 -74
  320. package/dist/mcp/handlers.js.map +0 -1
  321. package/dist/mcp/index.js +0 -3
  322. package/dist/mcp/index.js.map +0 -1
  323. package/dist/mcp/resources.js +0 -69
  324. package/dist/mcp/resources.js.map +0 -1
  325. package/dist/mcp/server.js +0 -94
  326. package/dist/mcp/server.js.map +0 -1
  327. package/dist/mcp/tools.js +0 -189
  328. package/dist/mcp/tools.js.map +0 -1
  329. package/dist/runtime/frontmatter-sync.js +0 -100
  330. package/dist/runtime/frontmatter-sync.js.map +0 -1
  331. package/dist/runtime/reconcile.js +0 -37
  332. package/dist/runtime/reconcile.js.map +0 -1
  333. package/dist/runtime/runtime.js +0 -427
  334. package/dist/runtime/runtime.js.map +0 -1
  335. package/dist/runtime/task-loader.js.map +0 -1
  336. package/dist/runtime/task-resolver.js +0 -401
  337. package/dist/runtime/task-resolver.js.map +0 -1
  338. package/dist/runtime/write-guard.js +0 -200
  339. package/dist/runtime/write-guard.js.map +0 -1
Binary file
Binary file
Binary file
Binary file
package/package.json CHANGED
@@ -1,10 +1,15 @@
1
1
  {
2
2
  "name": "@christianmaf80/agentic-workflow",
3
- "publisher": "christianmaf80",
4
- "version": "1.41.0-beta.10",
3
+ "displayName": "Agentic Workflow",
4
+ "publisher": "christian-marino-alvarez",
5
+ "version": "1.42.0",
5
6
  "description": "Portable agentic workflow orchestration system with strict identity and gate discipline",
6
7
  "type": "module",
7
- "displayName": "Agentic Workflow",
8
+ "workspaces": [
9
+ "src/extension/modules/core",
10
+ "src/extension/modules/app",
11
+ "src/cli"
12
+ ],
8
13
  "main": "./dist/extension/extension.js",
9
14
  "engines": {
10
15
  "vscode": "^1.108.2"
@@ -12,15 +17,12 @@
12
17
  "categories": [
13
18
  "Other"
14
19
  ],
15
- "activationEvents": [
16
- "onStartupFinished"
17
- ],
18
20
  "contributes": {
19
21
  "viewsContainers": {
20
22
  "activitybar": [
21
23
  {
22
24
  "id": "main",
23
- "title": "Agent Chat",
25
+ "title": "Agentic Workflow",
24
26
  "icon": "media/agent-chat.svg"
25
27
  }
26
28
  ]
@@ -28,27 +30,95 @@
28
30
  "views": {
29
31
  "main": [
30
32
  {
31
- "id": "keyView",
32
- "name": "Security",
33
+ "id": "mainView",
34
+ "name": "Agentic Workflow",
33
35
  "icon": "media/agent-chat.svg",
34
36
  "type": "webview"
35
- },
36
- {
37
- "id": "chatView",
38
- "name": "Agent Chat",
39
- "icon": "media/agent-chat.svg",
40
- "type": "webview",
41
- "when": "agenticWorkflow.hasKey"
42
37
  }
43
38
  ]
44
39
  },
45
- "commands": [
46
- {
47
- "command": "agentic-workflow.runPoc",
48
- "title": "AgentPoc: Run POC",
49
- "category": "Agentic Workflow"
40
+ "configuration": {
41
+ "title": "Agentic Workflow",
42
+ "properties": {
43
+ "agenticWorkflow.models": {
44
+ "type": "array",
45
+ "default": [],
46
+ "description": "List of LLM models configured for Agentic Workflow",
47
+ "items": {
48
+ "type": "object",
49
+ "properties": {
50
+ "id": {
51
+ "type": "string"
52
+ },
53
+ "name": {
54
+ "type": "string"
55
+ },
56
+ "modelName": {
57
+ "type": "string"
58
+ },
59
+ "provider": {
60
+ "type": "string",
61
+ "enum": [
62
+ "gemini",
63
+ "codex",
64
+ "claude"
65
+ ]
66
+ },
67
+ "apiKey": {
68
+ "type": "string"
69
+ },
70
+ "maxTokens": {
71
+ "type": "number"
72
+ },
73
+ "temperature": {
74
+ "type": "number"
75
+ }
76
+ }
77
+ }
78
+ },
79
+ "agenticWorkflow.activeModelId": {
80
+ "type": "string",
81
+ "default": "",
82
+ "description": "ID of the currently active LLM model"
83
+ },
84
+ "agenticWorkflow.googleClientId": {
85
+ "type": "string",
86
+ "default": "",
87
+ "description": "Google OAuth Client ID for Gemini authentication. Create one at console.cloud.google.com/apis/credentials (Desktop app type)."
88
+ },
89
+ "agenticWorkflow.googleClientSecret": {
90
+ "type": "string",
91
+ "default": "",
92
+ "description": "Google OAuth Client Secret for Gemini authentication (from the same Desktop app credential)."
93
+ },
94
+ "agenticWorkflow.openaiClientId": {
95
+ "type": "string",
96
+ "default": "",
97
+ "description": "OpenAI OAuth Client ID for PKCE authentication. Get one at platform.openai.com/settings."
98
+ },
99
+ "agenticWorkflow.roleBindings": {
100
+ "type": "object",
101
+ "default": {},
102
+ "description": "Map of Agent Roles to Model IDs",
103
+ "additionalProperties": {
104
+ "type": "string"
105
+ }
106
+ },
107
+ "agenticWorkflow.discoveredModelsCache": {
108
+ "type": "object",
109
+ "default": {},
110
+ "description": "Cached discovered models per provider (persists across restarts)"
111
+ },
112
+ "agenticWorkflow.disabledRoles": {
113
+ "type": "array",
114
+ "default": [],
115
+ "description": "List of disabled agent role names (hidden from Chat dropdown)",
116
+ "items": {
117
+ "type": "string"
118
+ }
119
+ }
50
120
  }
51
- ]
121
+ }
52
122
  },
53
123
  "bin": {
54
124
  "agentic-workflow": "bin/cli.js"
@@ -58,35 +128,28 @@
58
128
  "dist/core",
59
129
  "dist/infrastructure",
60
130
  "dist/agent",
61
- "dist/mcp",
62
131
  "dist/runtime",
63
132
  "bin",
64
133
  "README.md",
65
134
  "LICENSE",
66
- "RELEASE_PROCESS.md"
135
+ "RELEASE_PROCESS.md",
136
+ "media"
67
137
  ],
68
138
  "scripts": {
69
- "build": "node scripts/build/clean-dist.mjs && tsc -p tsconfig.build.json && npm run copy-assets && node scripts/build/bundle-webviews.mjs",
70
- "copy-assets": "mkdir -p dist/agent && cp -r src/agentic-system-structure/* dist/agent/",
139
+ "build": "node scripts/clean-dist.mjs && tsc -p tsconfig.build.json && npm run copy-assets",
140
+ "copy-assets": "mkdir -p dist/agent && cp -r src/agentic-system-structure/rules src/agentic-system-structure/workflows src/agentic-system-structure/templates src/agentic-system-structure/artifacts dist/agent/ && cp src/agentic-system-structure/index.md dist/agent/index.md",
71
141
  "start": "node dist/index.js",
72
142
  "publish:npm": "npm publish --registry https://registry.npmjs.org --access public",
73
143
  "publish:github": "npm publish --registry https://npm.pkg.github.com",
74
144
  "vscode:prepublish": "npm run compile",
75
- "compile": "tsc -p ./ && node scripts/build/bundle-webviews.mjs",
76
- "watch": "tsc -watch -p ./",
77
- "pretest": "npm run compile && npm run lint",
145
+ "compile": "tsc -p ./ && node scripts/build-view.mjs",
146
+ "watch": "tsc -watch -p ./ & node scripts/build-view.mjs --watch",
78
147
  "lint": "eslint src",
79
- "test": "vscode-test",
148
+ "test": "npx playwright test",
80
149
  "test:e2e": "npx playwright test",
81
- "test:coverage": "npm run build && vitest run --exclude test/chatkit-protocol.test.js --exclude test/view-templates.test.js --exclude 'src/**/e2e/**' --coverage --coverage.include='src/runtime/**' --coverage.include='src/mcp/**' --coverage.thresholds.lines=100 --coverage.thresholds.functions=100 --coverage.thresholds.branches=100 --coverage.thresholds.statements=100",
82
- "package": "npm pack && mv *.tgz .backups/npm-packages/",
83
- "dev:setup": "npm run build && npm link",
84
- "dev:refresh": "npm run build",
85
- "dev:clean": "npm run clean && rm -rf dist node_modules && npm install",
86
- "build:backend": "tsc -p tsconfig.backend.json",
87
- "start:backend": "node dist-backend/backend/index.js",
88
- "clean:poc": "rm -rf .vscode-test",
89
- "gen:module": "yo ./scripts/scaffolding/generator-agw-module"
150
+ "test:e2e:legacy": "vscode-test",
151
+ "test:unit": "vitest run src/extension",
152
+ "package": "npm pack && mv *.tgz .backups/npm-packages/"
90
153
  },
91
154
  "repository": {
92
155
  "type": "git",
@@ -108,39 +171,44 @@
108
171
  "author": "Christian Marino Alvarez",
109
172
  "license": "ISC",
110
173
  "dependencies": {
111
- "@christianmaf80/agentic-workflow": "^1.38.0-beta.10",
174
+ "@anthropic-ai/sdk": "^0.76.0",
112
175
  "@clack/prompts": "^0.7.0",
113
- "@fastify/autoload": "^6.3.1",
114
176
  "@fastify/cors": "^11.2.0",
115
- "@modelcontextprotocol/sdk": "^1.25.3",
116
- "@openai/agents": "^0.4.6",
117
- "@openai/agents-openai": "^0.4.6",
118
- "@openai/agents-realtime": "^0.4.6",
177
+ "@google/generative-ai": "^0.24.1",
178
+ "@material/web": "^2.4.1",
179
+ "@openai/agents": "^0.4.12",
180
+ "@vscode/codicons": "^0.0.44",
119
181
  "commander": "^11.1.0",
120
182
  "fastify": "^5.7.4",
121
183
  "gray-matter": "^4.0.3",
122
184
  "lit": "^3.3.2",
123
- "openai": "^6.18.0"
185
+ "lowdb": "^7.0.1",
186
+ "marked": "^17.0.3",
187
+ "openai": "^6.17.0",
188
+ "vscode-jsonrpc": "^8.2.1",
189
+ "xstate": "^5.28.0",
190
+ "zod": "^4.3.6"
124
191
  },
125
192
  "devDependencies": {
126
193
  "@playwright/test": "^1.58.2",
127
- "@serenity-js/assertions": "^3.40.0",
128
- "@serenity-js/console-reporter": "^3.40.0",
129
- "@serenity-js/core": "^3.40.0",
130
- "@serenity-js/playwright-test": "^3.40.0",
131
- "@serenity-js/web": "^3.40.0",
194
+ "@types/chai": "^5.2.3",
195
+ "@types/glob": "^8.1.0",
196
+ "@types/js-yaml": "^4.0.9",
132
197
  "@types/mocha": "^10.0.10",
133
- "@types/node": "^20.19.33",
198
+ "@types/node": "^20.10.6",
199
+ "@types/sinon": "^21.0.0",
134
200
  "@types/vscode": "^1.108.1",
135
- "@vitest/coverage-v8": "^4.0.18",
136
201
  "@vscode/test-cli": "^0.0.12",
137
202
  "@vscode/test-electron": "^2.5.2",
138
- "cpy-cli": "^7.0.0",
203
+ "chai": "^6.2.2",
204
+ "esbuild": "^0.27.3",
139
205
  "eslint": "^9.39.2",
140
- "fastify-plugin": "^5.1.0",
206
+ "glob": "^13.0.3",
207
+ "jsdom": "^28.1.0",
208
+ "sinon": "^21.0.1",
209
+ "ts-node": "^10.9.2",
141
210
  "typescript": "^5.9.3",
142
211
  "typescript-eslint": "^8.52.0",
143
- "vi": "^1.0.0",
144
212
  "vitest": "^4.0.18",
145
213
  "yeoman-generator": "^7.5.1",
146
214
  "yo": "^6.0.0"
@@ -1,26 +0,0 @@
1
- ---
2
- id: artifacts.candidate.index
3
- owner: architect-agent
4
- version: 1.0.0
5
- severity: PERMANENT
6
- ---
7
-
8
- # INDEX — Artifacts / Candidate
9
-
10
- ## Objetivo
11
- Este fichero define el indice del dominio artifacts.candidate.
12
- Declara la carpeta base para candidates.
13
-
14
- ## Aliases (YAML)
15
- ```yaml
16
- artifacts:
17
- candidate:
18
- dir: .agent/artifacts/candidate
19
- ```
20
-
21
- ## Reglas
22
- - No declarar rutas de archivos canonicos aqui.
23
- - Los candidates son dinamicos y se generan por workflow.
24
-
25
- ## Candidates (auto)
26
- <!-- AUTO-GENERATED: candidates -->
@@ -1,25 +0,0 @@
1
- ---
2
- id: artifacts.index
3
- owner: architect-agent
4
- version: 1.0.0
5
- severity: PERMANENT
6
- ---
7
-
8
- # INDEX — Artifacts
9
-
10
- ## Objetivo
11
- Este fichero es el índice del dominio artifacts.
12
- Define rutas y alias contractuales para los artifacts generados dinámicamente.
13
-
14
- ## Aliases (YAML)
15
- ```yaml
16
- artifacts:
17
- candidate:
18
- dir: .agent/artifacts/candidate
19
- index: .agent/artifacts/candidate/index.md
20
- task: .agent/artifacts/candidate/task.md
21
- ```
22
-
23
- ## Reglas
24
- - Los artifacts dinámicos por tarea no se declaran aquí.
25
- - Solo se declaran rutas canónicas de candidate.
@@ -1,26 +0,0 @@
1
- ---
2
- id: rules.constitution.index
3
- owner: architect-agent
4
- version: 2.0.0
5
- severity: PERMANENT
6
- trigger: always_on
7
- ---
8
-
9
- # INDEX — Rules / Constitution
10
-
11
- ## Objetivo
12
- Este fichero enumera todas las rules del dominio `constitution`.
13
- Los workflows y agentes **DEBEN** referenciar estas reglas
14
- por alias en lugar de rutas directas.
15
-
16
- ## Aliases (YAML)
17
- ```yaml
18
- constitution:
19
- clean_code: .agent/rules/constitution/clean-code.md
20
- agents_behavior: .agent/rules/constitution/agents-behavior.md
21
- runtime_integration: .agent/rules/constitution/runtime-integration.md
22
- ```
23
-
24
- ## Reglas
25
- - Este índice **solo** declara reglas del dominio `constitution`.
26
- - Cualquier nueva regla del dominio **DEBE** añadirse aquí.
@@ -1,102 +0,0 @@
1
- ---
2
- id: constitution.runtime_integration
3
- owner: architect-agent
4
- version: 1.0.0
5
- severity: PERMANENT
6
- scope: global
7
- ---
8
-
9
- # RUNTIME INTEGRATION CONSTITUTION
10
-
11
- Este documento define las reglas obligatorias para la integración del runtime MCP en la ejecución de workflows.
12
-
13
- ---
14
-
15
- ## 1. REGLA DE INTEGRACIÓN RUNTIME (PERMANENT - CRITICAL)
16
-
17
- Cuando cualquier agente ejecute un workflow del sistema (`init`, `tasklifecycle-short`, `tasklifecycle-long`), **DEBE** utilizar las herramientas del runtime MCP para garantizar trazabilidad y persistencia de estado.
18
-
19
- ### 1.1 Herramientas Obligatorias
20
-
21
- | Evento | Herramienta MCP | Cuándo usar |
22
- |--------|-----------------|-------------|
23
- | Inicio de tarea | `runtime_run` | Al crear una nueva tarea |
24
- | Avance de fase | `runtime_advance_phase` | Al completar cada fase del ciclo |
25
- | Obtener estado | `runtime_get_state` | Para consultar el estado actual |
26
- | Validar gate | `runtime_validate_gate` | Antes de solicitar aprobación |
27
- | Evento importante | `runtime_emit_event` | Para eventos de chat, errores, etc. |
28
-
29
- ### 1.2 Flujo Obligatorio
30
-
31
- ```
32
- 1. Al iniciar workflow:
33
- → Llamar `runtime_run` con taskPath y agent
34
-
35
- 2. Al completar cada fase:
36
- → Llamar `runtime_validate_gate` para verificar precondiciones
37
- → Solicitar aprobación al desarrollador (notify_user)
38
- → Llamar `runtime_advance_phase` tras aprobación
39
-
40
- 3. Durante la ejecución:
41
- → Usar `runtime_emit_event` para eventos significativos
42
- → Usar `runtime_get_state` para consultar estado si es necesario
43
- ```
44
-
45
- ### 1.3 Regla de Nulidad (Bypass Detection)
46
- Cualquier acción técnica de cambio de estado (creación de artefactos, avance de fase) realizada sin una llamada correspondiente registrada en el Runtime MCP será considerada **nula e inválida**.
47
- - La "Huella Digital de Gobernanza" (logs de `validate_gate` y `advance_phase`) generada mediante el **Skill de Gobernanza** es el único comprobante legal de cumplimiento de proceso.
48
-
49
- ### 1.4 Skill de Gobernanza (Mejor Práctica)
50
- El uso del `skill.runtime-governance` es la **mejor práctica y el método obligatorio** para el `architect-agent`.
51
- - **Por qué**: Centraliza la complejidad técnica de las herramientas MCP y permite auditorías reactivas consistentes sin sobrecargar los archivos de workflow.
52
- - **Invocación**: Los workflows deben simplemente invocar la acción de control, y el Arquitecto debe proveer el "Cómo" mediante este Skill exclusivo.
53
- ```
54
-
55
- ---
56
-
57
- ## 2. REQUISITOS PREVIOS (PERMANENT)
58
-
59
- Para que esta constitución sea aplicable:
60
-
61
- 1. El servidor MCP debe estar registrado en el cliente (Antigravity/Codex).
62
- - Si no está registrado, ejecutar: `agentic-workflow register-mcp`
63
-
64
- 2. El servidor MCP debe estar corriendo en background o ser invocable.
65
-
66
- ### 2.1 Verificación de Registro
67
-
68
- Al iniciar cualquier workflow, el agente **DEBE** verificar que las herramientas del runtime están disponibles. Si no lo están:
69
- - Informar al desarrollador.
70
- - Sugerir ejecutar `agentic-workflow register-mcp`.
71
- - Continuar con ejecución fallback (sin runtime) si el desarrollador lo autoriza.
72
-
73
- ---
74
-
75
- ## 3. LOGS Y TRAZABILIDAD (PERMANENT)
76
-
77
- Todas las llamadas al runtime generan logs en stderr. Estos logs son la **fuente de verdad** para auditar la ejecución de workflows.
78
-
79
- ### 3.1 Formato de Logs
80
- ```
81
- [LEVEL] [SOURCE] Message {context}
82
- ```
83
-
84
- ### 3.2 Herramienta de Debug
85
- - `debug_read_logs`: Permite leer los logs almacenados en el buffer del runtime.
86
-
87
- ---
88
-
89
- ## 4. EXCEPCIONES (PERMANENT)
90
-
91
- Esta constitución **NO aplica** cuando:
92
- - El desarrollador solicita explícitamente ejecución sin runtime.
93
- - Las herramientas MCP no están disponibles y el desarrollador autoriza fallback.
94
- - Se trata de operaciones de solo lectura (consultas, investigación).
95
-
96
- ---
97
-
98
- ## Authority
99
-
100
- Esta constitución es **binding** cuando referenciada como `INJECTED` o `PERMANENT`.
101
- Creada por: architect-agent
102
- Fecha: 2026-02-02
@@ -1,70 +0,0 @@
1
- ---
2
- id: rules.index
3
- owner: architect-agent
4
- version: 1.0.3
5
- severity: PERMANENT
6
- trigger: always_on
7
- ---
8
-
9
- # INDEX — Rules
10
-
11
- ## Objetivo
12
- Este fichero enumera los **dominios de rules contractuales** del proyecto
13
- y dónde están sus índices locales. Los workflows y agentes **DEBEN**
14
- referenciar estas reglas por alias.
15
-
16
- ## Aliases (YAML)
17
- ```yaml
18
- rules:
19
- constitution:
20
- index: .agent/rules/constitution/index.md
21
-
22
- roles:
23
- index: .agent/rules/roles/index.md
24
- ```
25
-
26
- ---
27
-
28
- ## Reglas Globales (PERMANENT)
29
-
30
- ### Comportamiento e Identificación de Agentes
31
- **Severidad**: PERMANENT
32
- **Alcance**: Todos los agentes
33
-
34
- **NUNCA puede ocurrir una respuesta sin identificación.** Todos los agentes deben comenzar sus mensajes con su icono y nombre en negrita: `<icono> **<nombre-agente>**`, salvo la excepcion de compatibilidad definida en `constitution.agents_behavior`.
35
-
36
- Esta regla es el pilar de la trazabilidad y su incumplimiento invalida la respuesta.
37
- Referencia completa: `constitution.agents_behavior`
38
-
39
- ### Modificación de Reglas - Autoridad Exclusiva del Architect
40
- **Severidad**: PERMANENT
41
- **Alcance**: Todos los agentes
42
-
43
- **Solo el 🏛️ architect-agent puede modificar archivos de reglas.**
44
-
45
- Archivos protegidos:
46
- - `.agent/rules/**/*.md` (todas las reglas)
47
- - `.agent/workflows/**/*.md` (todos los workflows)
48
- - `.agent/index.md`
49
-
50
- **Prohibiciones**:
51
- - ❌ Ningún agente (qa, researcher, neo) puede modificar reglas
52
- - ❌ Ningún agente puede modificar workflows
53
- - ❌ Ningún agente puede modificar índices
54
-
55
- **Excepciones**:
56
- - ✅ El architect-agent puede modificar cualquier regla
57
- - ✅ Los agentes pueden **proponer** cambios en sus informes
58
- - ✅ El desarrollador puede solicitar cambios explícitamente
59
-
60
- **Violación**:
61
- Si un agente modifica una regla sin autorización:
62
- 1. El cambio DEBE revertirse inmediatamente
63
- 2. El architect-agent DEBE documentar la violación
64
- 3. El agente DEBE ser reactivado con la regla reforzada
65
-
66
- ---
67
-
68
- ## Reglas de Índice
69
- - Este índice **solo** declara dominios de rules.
70
- - Cada dominio **DEBE** tener su propio `index.md`.
@@ -1,44 +0,0 @@
1
- ---
2
- id: rules.roles.index
3
- owner: architect-agent
4
- version: 1.0.1
5
- severity: PERMANENT
6
- trigger: always_on
7
- ---
8
-
9
- # INDEX — Rules / Roles
10
-
11
- ## Objetivo
12
- Este fichero enumera todas las rules del dominio `roles`.
13
- Los workflows/agentes **DEBEN** referenciar estas reglas
14
- por alias en lugar de rutas directas.
15
-
16
- ## Reglas Globales (PERMANENT)
17
-
18
- ### Comportamiento e Identificación de Agentes
19
- **Severidad**: PERMANENT
20
- **Alcance**: Todos los roles
21
-
22
- Todos los agentes DEBEN seguir estrictamente las normas de identificación e interacción definidas en:
23
- `constitution.agents_behavior`
24
-
25
- **Resumen**:
26
- - Identificación obligatoria mediante `<icono> **<nombre-agente>**`, con la excepcion de compatibilidad definida en `constitution.agents_behavior`.
27
- - Solo el Architect puede modificar reglas.
28
- - QA no implementa código funcional.
29
-
30
- ---
31
-
32
- ## Aliases (YAML)
33
- ```yaml
34
- roles:
35
- architect: .agent/rules/roles/architect.md
36
- qa: .agent/rules/roles/qa.md
37
- researcher: .agent/rules/roles/researcher.md
38
- neo: .agent/rules/roles/neo.md
39
- ```
40
-
41
- ## Reglas
42
- - Este índice **solo** declara reglas del dominio `roles`.
43
- - Cada nuevo rol **DEBE** añadirse aquí antes de ser utilizado.
44
- - Cada rol **DEBE** incluir la regla de prefijo obligatorio en su definición.
@@ -1,23 +0,0 @@
1
- ---
2
- id: skills.index
3
- owner: architect-agent
4
- version: 1.0.0
5
- severity: PERMANENT
6
- ---
7
-
8
- # INDEX — Skills
9
-
10
- ## Objetivo
11
- Este fichero enumera los **skills (habilidades)** disponibles en el sistema.
12
- Los agentes **DEBEN** referenciar estas habilidades por alias.
13
-
14
- ## Aliases (YAML)
15
- ```yaml
16
- skills:
17
- runtime-governance: .agent/skills/runtime-governance/SKILL.md
18
- ```
19
-
20
- ## Reglas
21
- - Este índice solo declara skills del sistema.
22
- - Cada skill debe estar en su propia carpeta en `.agent/skills/`.
23
- - Cualquier nuevo skill **DEBE** añadirse aquí antes de ser referenciado.
@@ -1,62 +0,0 @@
1
- # SKILL: runtime-governance
2
-
3
- > [!IMPORTANT]
4
- > **Exclusividad**: Este skill es de uso exclusivo para el **architect-agent**.
5
- > **Severidad**: PERMANENT
6
-
7
- ## Objetivo
8
- Proveer al arquitecto de un conjunto de herramientas y procedimientos para garantizar que el LLM (y otros agentes) utilicen estrictamente el Runtime MCP para la gobernanza del workflow, detectando evasiones de forma reactiva.
9
-
10
- ## 1. Procedimiento de Trazabilidad (Step 0)
11
-
12
- Cuando un workflow solicite "Verificar Trazabilidad", el arquitecto debe:
13
- 1. Llamar a `runtime_chat` o `runtime_emit_event` con un mensaje de activación (ej: "Verifying traceability for session [ID]").
14
- 2. Esperar la confirmación del runtime (`{status: "ok"}`).
15
- 3. Solo tras recibir confirmación, registrar `traceability.verified: true` en el artefacto correspondiente.
16
- 4. **Ruta obligatoria para init**:
17
- - `runtime_run` **DEBE** llamarse con `taskPath: ".agent/artifacts/candidate"` (sin `/` final).
18
- - **PROHIBIDO** usar:
19
- - `.agent/artifacts/candidate/`
20
- - `.agent/artifacts/candidate/init.md`
21
- 5. **Completar init vía Runtime (OBLIGATORIO)**:
22
- - Tras `runtime_run`, llamar a `runtime_update_init` con los datos recolectados.
23
- - El init candidate **NO** puede quedar con placeholders `{{...}}`.
24
-
25
- ## 2. Huella Digital de Gobernanza (Obligatoria)
26
-
27
- Antes de cada transición de fase (Gate), el arquitecto debe asegurar que los logs de stderr contienen la siguiente secuencia para el `runId` actual:
28
-
29
- 1. `runtime_run`: Debe existir para la tarea activa.
30
- 2. `runtime_update_init`: Debe existir para init antes de validar gate.
31
- 2. `runtime_validate_gate`: Llamado antes del `notify_user` de fin de fase.
32
- 3. `runtime_advance_phase`: Llamado inmediatamente después de recibir el "SI" del usuario.
33
-
34
- ## 2. Detección Reactiva de Bypasses
35
-
36
- El arquitecto debe comparar el estado del sistema de archivos con los logs obtenidos mediante `debug_read_logs`:
37
-
38
- - **Anomalía A**: Existe un artefacto de fase (ej: `planning.md`) cuyas marcas de tiempo son posteriores a un mensaje de chat de aprobación, pero **NO** hay registro de `runtime_advance_phase`.
39
- - **Anomalía B**: El archivo `task.md` marca un paso como completado (`[x]`) sin que el log de runtime muestre la actividad correspondiente en esa ventana temporal.
40
- - **Anomalía C (Init)**: El init candidate contiene placeholders `{{...}}` o no hay log de `runtime_update_init`.
41
-
42
- **Acción ante Bypass**:
43
- - Invalidar la fase actual.
44
- - Realizar rollback de los archivos modificados sin gobernanza.
45
- - Notificar al usuario la violación de gobernanza y solicitar re-ejecución del gate.
46
-
47
- ## 3. Procedimiento de Validación de Gate
48
-
49
- 1. Cargar el artefacto de la fase (ej: `analysis.md`).
50
- 2. Llamar a `runtime_validate_gate` con `expectedPhase`.
51
- 3. Si el runtime falla (error visualizado en stdout), **CORREGIR** el artefacto antes de pedir aprobación al usuario.
52
- 4. Una vez aprobado por el usuario, llamar a `runtime_advance_phase`.
53
-
54
- ## 4. Auditoría de Logs (Checklist)
55
-
56
- Para verificar que el sistema está funcionando, busca estos patrones en los logs:
57
- - `[INFO] [MCP] Server started` -> Servidor activo.
58
- - `[INFO] [Runtime] Chat message received` -> Comunicación activa.
59
- - `[INFO] [MCP] Tool called: runtime_...` -> Uso de herramientas.
60
-
61
- ---
62
- *Garantizando la integridad del proceso agentic-workflow.*