@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
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  id: workflow.tasklifecycle-long.phase-0-acceptance-criteria
3
- description: Convierte el task candidate en una tarea definitiva. El arquitecto define los acceptance criteria mediante 5 preguntas obligatorias basadas en la tarea y su objetivo, y crea el current task necesario para iniciar el ciclo de vida.
3
+ description: Converts the task candidate into a definitive task. The architect defines acceptance criteria through 5 mandatory questions based on the task and its objective, and creates the current task required to start the lifecycle.
4
4
  owner: architect-agent
5
5
  version: 1.2.1
6
6
  severity: PERMANENT
@@ -12,172 +12,162 @@ blocking: true
12
12
  # WORKFLOW: tasklifecycle.phase-0-acceptance-criteria
13
13
 
14
14
  ## Input (REQUIRED)
15
- - Task candidate creado por `workflows.tasklifecycle-long`:
15
+ - Task candidate created by `workflows.tasklifecycle-long`:
16
16
  - `artifacts.candidate.task`
17
- - El `task.md` candidate **DEBE** incluir:
18
- - descripción de la tarea
19
- - objetivo de la tarea
17
+ - The `task.md` candidate **MUST** include:
18
+ - task description
19
+ - task objective
20
20
 
21
21
  > [!IMPORTANT]
22
- > **Constitución activa (OBLIGATORIO)**:
23
- > - Cargar `constitution.clean_code` antes de iniciar
24
- > - Cargar `constitution.agents_behavior` (sección 7: Gates, sección 8: Constitución)
25
- > - **Activar `skill.runtime-governance`** (Uso exclusivo del Architect para validación y trazabilidad)
22
+ > **Active constitution (MANDATORY)**:
23
+ > - Load `constitution.clean_code` before starting
24
+ > - Load `constitution.agents_behavior` (section 7: Gates, section 8: Constitution)
26
25
 
27
26
  ## Output (REQUIRED)
28
- - Current task (definitiva) con acceptance criteria completos:
27
+ - Current task (definitive) with complete acceptance criteria:
29
28
  - `.agent/artifacts/<taskId>-<taskTitle>/task.md`
30
29
 
31
- ## Template (OBLIGATORIO)
32
- - La current task **DEBE** crearse usando el template:
30
+ ## Template (MANDATORY)
31
+ - The current task **MUST** be created using the template:
33
32
  - `templates.task`
34
- - Si el template no existe o no se puede cargar → **FAIL**.
35
-
36
- ## Objetivo (ONLY)
37
- - Pasar de **task candidate** a **current task** (definitiva).
38
- - **Calcular el `taskId` definitivo**.
39
- - Definir acceptance criteria **obligatorios** a partir de 5 preguntas al desarrollador.
40
- - Registrar los acceptance criteria dentro del fichero de current task.
41
-
42
- ## Pasos obligatorios
43
- 0. **Verificar Gobernanza (OBLIGATORIO)**:
44
- - Activar `skill.runtime-governance`.
45
- - Ejecutar el procedimiento de trazabilidad inicial (Paso 0 del Skill).
46
- - El agente **DEBE** confirmar que el sistema de logs está activo antes de proceder.
47
- - Usar prefijo obligatorio en cada mensaje.
48
- 1. Cargar y leer el task candidate:
33
+ - If the template does not exist or cannot be loaded → **FAIL**.
34
+
35
+ ## Objective (ONLY)
36
+ - Move from **task candidate** to **current task** (definitive).
37
+ - **Calculate the definitive `taskId`**.
38
+ - Define **mandatory** acceptance criteria from 5 questions to the developer.
39
+ - Record acceptance criteria within the current task file.
40
+
41
+ ## Mandatory Steps
42
+ 0. Activate `architect-agent` and use the mandatory prefix in every message.
43
+ 1. Load and read the task candidate:
49
44
  - `artifacts.candidate.task`
50
- - Extraer:
51
- - descripción de la tarea
52
- - objetivo de la tarea
53
- - Si faltanir a **Paso 10 (FAIL)**.
45
+ - Extract:
46
+ - task description
47
+ - task objective
48
+ - If missinggo to **Step 10 (FAIL)**.
54
49
 
55
- 2. Cargar template contractual de task
56
- - Cargar `templates.task`
57
- - Si no existe o no se puede cargarir a **Paso 10 (FAIL)**.
50
+ 2. Load contractual task template
51
+ - Load `templates.task`
52
+ - If it does not exist or cannot be loaded go to **Step 10 (FAIL)**.
58
53
 
59
- 3. **Calcular `taskId` (OBLIGATORIO – architect)**
60
- - El `architect-agent` **DEBE** ejecutar el siguiente comando:
54
+ 3. **Calculate `taskId` (MANDATORY – architect)**
55
+ - The `architect-agent` **MUST** execute the following command:
61
56
  ```bash
62
57
  ls .agent/artifacts/ | grep -E "^[0-9]" | sort -n | tail -1 | cut -d'-' -f1
63
58
  ```
64
- - El output muestra el último taskId (ej: "8")
65
- - El nuevo `taskId = output + 1` (ej: si output es "8", nuevo taskId es "9")
66
- - Si no hay output (sin tareas previas) → `taskId = 1`
67
- - El valor final de `taskId` es **obligatorio** para continuar.
68
-
69
- 4. Definir `taskTitle` (architect)
70
- - Derivar `taskTitle` desde la solicitud del desarrollador (candidate).
71
- - Normalizar para filesystem:
72
- - minúsculas
73
- - espacios → `-`
74
- - sin caracteres especiales
75
-
76
- 5. Formular preguntas de clarificación (OBLIGATORIO, adaptativas a la tarea)
77
- - El `architect-agent` **DEBE** analizar:
59
+ - The output shows the last taskId (e.g.: "8")
60
+ - The new `taskId = output + 1` (e.g.: if output is "8", new taskId is "9")
61
+ - If there is no output (no previous tasks) → `taskId = 1`
62
+ - The final `taskId` value is **mandatory** to continue.
63
+
64
+ 4. Define `taskTitle` (architect)
65
+ - Derive `taskTitle` from the developer's request (candidate).
66
+ - Normalize for filesystem:
67
+ - lowercase
68
+ - spaces → `-`
69
+ - no special characters
70
+
71
+ 5. Formulate clarification questions (MANDATORY, adaptive to the task)
72
+ - The `architect-agent` **MUST** analyze:
78
73
  - `task.description`
79
74
  - `task.goal`
80
- - A partir de ese análisis, **DEBE formular exactamente 5 preguntas** cuyo objetivo sea:
81
- - eliminar ambigüedades
82
- - completar información faltante
83
- - permitir definir acceptance criteria verificables
84
- - Las preguntas:
85
- - **NO deben** duplicar información ya explícita
86
- - **DEBEN** estar directamente relacionadas con la tarea concreta
87
- - **PUEDEN** variar según el contexto de la tarea
88
-
89
- 6. Validar respuestas y cerrar definición (OBLIGATORIO)
90
- - Confirmar que las 5 preguntas formuladas tienen respuesta explícita.
91
- - A partir de las respuestas, el `architect-agent` **DEBE**:
92
- - consolidar una definición completa de la tarea
93
- - derivar acceptance criteria verificables
94
- - Si alguna respuesta falta o sigue existiendo ambigüedadir a **Paso 10 (FAIL)**.
95
-
96
- 7. Crear current task (OBLIGATORIO)
97
- - Crear el directorio de la tarea (si no existe):
75
+ - Based on that analysis, **MUST formulate exactly 5 questions** whose purpose is to:
76
+ - eliminate ambiguities
77
+ - complete missing information
78
+ - enable defining verifiable acceptance criteria
79
+ - The questions:
80
+ - **MUST NOT** duplicate already explicit information
81
+ - **MUST** be directly related to the specific task
82
+ - **MAY** vary depending on the task context
83
+
84
+ 6. Validate responses and close definition (MANDATORY)
85
+ - Confirm that all 5 formulated questions have explicit answers.
86
+ - Based on the responses, the `architect-agent` **MUST**:
87
+ - consolidate a complete task definition
88
+ - derive verifiable acceptance criteria
89
+ - If any response is missing or ambiguity persistsgo to **Step 10 (FAIL)**.
90
+
91
+ 7. Create current task (MANDATORY)
92
+ - Create the task directory (if it does not exist):
98
93
  - `.agent/artifacts/<taskId>-<taskTitle>/`
99
- - Crear el fichero de estado:
100
- - `.agent/artifacts/<taskId>-<taskTitle>/task.md` (usando `templates.task`)
101
- - Crear el fichero de aceptación (NUEVO):
102
- - `.agent/artifacts/<taskId>-<taskTitle>/acceptance.md` (usando `templates.acceptance`)
103
- - El `task.md` **solo contendrá**:
104
- - metadatos (id, title, owner, strategy)
105
- - historial de fases
106
- - alias `task.acceptance` apuntando al nuevo fichero
107
- - El `acceptance.md` **contendrá**:
108
- - definición consolidada
109
- - las 5 respuestas detalladas
110
- - checklist de criterios verificables (AC)
111
- - Si no se puede crear/escribirir a **Paso 10 (FAIL)**.
112
-
113
- 8. Solicitar aprobacion del desarrollador (OBLIGATORIA, por consola)
114
- - El desarrollador **DEBE** aprobar explicitamente:
94
+ - Create the state file:
95
+ - `.agent/artifacts/<taskId>-<taskTitle>/task.md` (using `templates.task`)
96
+ - Create the acceptance file (NEW):
97
+ - `.agent/artifacts/<taskId>-<taskTitle>/acceptance.md` (using `templates.acceptance`)
98
+ - The `task.md` **will only contain**:
99
+ - metadata (id, title, owner, strategy)
100
+ - phase history
101
+ - alias `task.acceptance` pointing to the new file
102
+ - The `acceptance.md` **will contain**:
103
+ - consolidated definition
104
+ - the 5 detailed answers
105
+ - verifiable acceptance criteria (AC) checklist
106
+ - If it cannot be created/writtengo to **Step 10 (FAIL)**.
107
+
108
+ 8. Request developer approval (MANDATORY, via console)
109
+ - The developer **MUST** explicitly approve:
115
110
  - Acceptance criteria
116
- - Current task creada
117
- - Registrar la decision en `acceptance.md`:
111
+ - Current task created
112
+ - Record the decision in `acceptance.md`:
118
113
  ```yaml
119
114
  approval:
120
115
  developer:
121
116
  decision: SI | NO
122
117
  date: <ISO-8601>
123
- comments: <opcional>
118
+ comments: <optional>
124
119
  ```
125
- - Si `decision != SI` → ir a **Paso 10 (FAIL)**.
120
+ - If `decision != SI` → go to **Step 10 (FAIL)**.
126
121
 
127
122
  9. PASS
128
- - Informar que la Fase 0 está completada correctamente.
129
- - Seguimiento del protocolo de cierre en `skill.runtime-governance`:
130
- - Llamar `runtime.validate_gate` para verificar integridad.
131
- - Solicitar aprobación final al usuario.
132
- - Llamar `runtime.advance_phase` tras el "SI".
133
- - El `architect-agent` **DEBE realizar explícitamente** las siguientes acciones:
134
- - Marcar la Fase 0 como completada en el `task.md`.
135
- - Establecer `task.lifecycle.phases.phase-0-acceptance-criteria.validated_at = <ISO-8601>`.
136
- - Actualizar `task.phase.updated_at = <ISO-8601>`.
137
- - Actualizar el estado:
123
+ - Report that Phase 0 is correctly completed.
124
+ - The `architect-agent` **MUST explicitly perform** the following actions:
125
+ - Mark Phase 0 as completed in `task.md`.
126
+ - Set `task.lifecycle.phases.phase-0-acceptance-criteria.validated_at = <ISO-8601>`.
127
+ - Update `task.phase.updated_at = <ISO-8601>`.
128
+ - Update the state:
138
129
  - `task.phase.current = aliases.tasklifecycle-long.phases.phase_1.id`
139
- - Esta actualización **NO es automática** y **NO puede ser inferida**.
140
- - Hasta que este cambio no se refleje en el `task.md`, **no se puede iniciar la Fase 1**.
141
-
142
- 10. FAIL (obligatorio)
143
- - Declarar Fase 0 como **NO completada**.
144
- - Indicar exactamente qué falló:
145
- - falta candidate
146
- - template inaccesible (`templates.task`)
147
- - falta descripción/objetivo
148
- - no se pudo calcular `taskId`
149
- - respuestas incompletas (menos de 5)
150
- - no se pudo crear current task
151
- - Pedir la acción mínima:
152
- - completar datos del candidate
153
- - responder preguntas faltantes
154
- - corregir permisos/rutas de artifacts
155
- - Terminar bloqueado: no avanzar de fase.
130
+ - This update is **NOT automatic** and **CANNOT be inferred**.
131
+ - Until this change is reflected in `task.md`, **Phase 1 cannot be started**.
132
+
133
+ 10. FAIL (mandatory)
134
+ - Declare Phase 0 as **NOT completed**.
135
+ - Indicate exactly what failed:
136
+ - missing candidate
137
+ - inaccessible template (`templates.task`)
138
+ - missing description/objective
139
+ - could not calculate `taskId`
140
+ - incomplete responses (fewer than 5)
141
+ - could not create current task
142
+ - Request the minimum action:
143
+ - complete candidate data
144
+ - answer missing questions
145
+ - fix artifacts permissions/paths
146
+ - Terminate blocked: do not advance phase.
156
147
 
157
148
  ## Gate (REQUIRED)
158
149
 
159
- Requisitos (todos obligatorios):
160
- 1. Existe el directorio y el fichero de estado:
150
+ Requirements (all mandatory):
151
+ 1. The directory and state file exist:
161
152
  - `.agent/artifacts/<taskId>-<taskTitle>/task.md`
162
- 2. Existe el artefacto de aceptación:
153
+ 2. The acceptance artifact exists:
163
154
  - `.agent/artifacts/<taskId>-<taskTitle>/acceptance.md`
164
- 3. Ambos siguen sus respectivos templates.
165
- 4. El `acceptance.md` inicia con el prefijo del `architect-agent`.
166
- 5. El `taskId` es secuencial:
167
- - Ejecutar: `ls .agent/artifacts/ | grep -E "^[0-9]" | sort -n | tail -1 | cut -d'-' -f1`
168
- - El taskId del nuevo directorio debe ser exactamente `output + 1`
169
- 6. El current task incluye acceptance criteria completos y verificables.
170
- 7. Existe aprobacion explicita del desarrollador (por consola) registrada en `acceptance.md`:
155
+ 3. Both follow their respective templates.
156
+ 4. The `acceptance.md` starts with the `architect-agent` prefix.
157
+ 5. The `taskId` is sequential:
158
+ - Execute: `ls .agent/artifacts/ | grep -E "^[0-9]" | sort -n | tail -1 | cut -d'-' -f1`
159
+ - The taskId of the new directory must be exactly `output + 1`
160
+ 6. The current task includes complete and verifiable acceptance criteria.
161
+ 7. Explicit developer approval (via console) is recorded in `acceptance.md`:
171
162
  - `approval.developer.decision == SI`
172
- 8. El `architect-agent` ha marcado explícitamente:
173
- - la Fase 0 como completada
163
+ 8. The `architect-agent` has explicitly marked:
164
+ - Phase 0 as completed
174
165
  - `task.phase.current == aliases.tasklifecycle-long.phases.phase_1.id`
175
- 9. `task.md` refleja timestamp y estado:
166
+ 9. `task.md` reflects timestamp and state:
176
167
  - `task.lifecycle.phases.phase-0-acceptance-criteria.completed == true`
177
- - `task.lifecycle.phases.phase-0-acceptance-criteria.validated_at` no nulo
178
- - `task.phase.updated_at` no nulo
179
- 10. Las 5 preguntas obligatorias fueron realizadas y respondidas por el desarrollador.
180
- 11. **Gobernanza verificada**: El historial de logs muestra la secuencia de herramientas MCP definida en `skill.runtime-governance`.
168
+ - `task.lifecycle.phases.phase-0-acceptance-criteria.validated_at` not null
169
+ - `task.phase.updated_at` not null
170
+ 10. The 5 mandatory questions were asked and answered by the developer.
181
171
 
182
- Si Gate FAIL:
183
- - Ejecutar **FAIL**.
172
+ If Gate FAIL:
173
+ - Execute **FAIL**.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  id: workflow.tasklifecycle-long.phase-1-research
3
- description: Fase 1 del ciclo de tarea. Investigacion tecnica exhaustiva de necesidades y alternativas. Requiere aprobacion explicita del desarrollador.
3
+ description: Phase 1 of the task lifecycle. Exhaustive technical research of needs and alternatives. Requires explicit developer approval.
4
4
  owner: researcher-agent
5
5
  version: 1.0.0
6
6
  severity: PERMANENT
@@ -12,145 +12,151 @@ blocking: true
12
12
  # WORKFLOW: tasklifecycle.phase-1-research
13
13
 
14
14
  ## Input (REQUIRED)
15
- - Existe la current task:
15
+ - The current task exists:
16
16
  - `.agent/artifacts/<taskId>-<taskTitle>/task.md`
17
- - El `task.md` **DEBE** reflejar:
17
+ - The `task.md` **MUST** reflect:
18
18
  - `task.phase.current == aliases.tasklifecycle-long.phases.phase_1.id`
19
- - El `task.md` **DEBE** incluir:
20
- - descripcion
21
- - objetivo
22
- - acceptance criteria definidos
19
+ - The `task.md` **MUST** include:
20
+ - description
21
+ - objective
22
+ - defined acceptance criteria
23
23
 
24
24
  > [!IMPORTANT]
25
- > **Constitución activa (OBLIGATORIO)**:
26
- > - Cargar `constitution.clean_code` antes de iniciar
27
- > - Cargar `constitution.agents_behavior` (sección 7: Gates, sección 8: Constitución)
28
- > - **Activar `skill.runtime-governance`** (Para validación de gate y trazabilidad)
25
+ > **Active constitution (MANDATORY)**:
26
+ > - Load `constitution.clean_code` before starting
27
+ > - Load `constitution.agents_behavior` (section 7: Gates, section 8: Constitution)
29
28
 
30
29
  ## Output (REQUIRED)
31
- - Research report (obligatorio, generado por researcher-agent):
30
+ - Research report (mandatory, generated by researcher-agent):
32
31
  - `.agent/artifacts/<taskId>-<taskTitle>/researcher/research.md`
33
- - Actualizacion del estado en la current task:
32
+ - State update in the current task:
34
33
  - `.agent/artifacts/<taskId>-<taskTitle>/task.md`
35
34
 
36
- ## Objetivo (ONLY)
37
- - Investigar necesidades tecnicas detectadas para la tarea.
38
- - Explorar alternativas y APIs relevantes.
39
- - Documentar compatibilidad y riesgos.
40
- - Entregar un informe riguroso y verificable para el architect-agent.
35
+ ## Objective (ONLY)
36
+ - Investigate technical needs detected for the task.
37
+ - Explore alternatives and relevant APIs.
38
+ - Document compatibility and risks.
39
+ - Deliver a rigorous and verifiable report for the architect-agent.
41
40
 
42
- > Esta fase **NO implementa código**.
43
- > Esta fase **REQUIERE aprobación explícita del desarrollador**.
41
+ > This phase **DOES NOT implement code**.
42
+ > This phase **REQUIRES explicit developer approval**.
44
43
 
45
44
  > [!CAUTION]
46
- > **REGLA PERMANENT**: Research DOCUMENTA, NO analiza.
47
- > El researcher-agent recopila información de fuentes oficiales.
48
- > **PROHIBIDO**: proponer soluciones, evaluar trade-offs, recomendar alternativas.
49
- > El análisis corresponde a Phase 2.
45
+ > **PERMANENT RULE**: Research DOCUMENTS, it does NOT analyze.
46
+ > The researcher-agent gathers information from official sources.
47
+ > **PROHIBITED**: proposing solutions, evaluating trade-offs, recommending alternatives.
48
+ > Analysis belongs to Phase 2.
50
49
 
51
- ## Template (OBLIGATORIO)
52
- - El informe **DEBE** crearse usando el template:
50
+ ## Template (MANDATORY)
51
+ - The report **MUST** be created using the template:
53
52
  - `templates.research`
54
- - Si el template no existe o no se puede cargar → **FAIL**.
53
+ - If the template does not exist or cannot be loaded → **FAIL**.
55
54
 
56
55
  ---
57
56
 
58
- ## Pasos obligatorios
59
- 0. Activar `researcher-agent` y usar prefijo obligatorio en cada mensaje.
57
+ ## Mandatory Steps
58
+ 0. Activate `researcher-agent` and use the mandatory prefix in every message.
60
59
 
61
- 1. Verificar inputs (architect-agent)
62
- - Existe `task.md`
60
+ 1. Verify inputs (architect-agent)
61
+ - `task.md` exists
63
62
  - `task.phase.current == aliases.tasklifecycle-long.phases.phase_1.id`
64
- - `task.md` contiene acceptance criteria
65
- - Si fallair a **Paso 8 (FAIL)**.
63
+ - `task.md` contains acceptance criteria
64
+ - If it fails go to **Step 8 (FAIL)**.
66
65
 
67
- 2. Cargar template de research (architect-agent)
68
- - Cargar `templates.research`
69
- - Si no existe o no se puede leerir a **Paso 8 (FAIL)**.
66
+ 2. Load research template (architect-agent)
67
+ - Load `templates.research`
68
+ - If it does not exist or cannot be read go to **Step 8 (FAIL)**.
70
69
 
71
- 3. **Delegar al researcher-agent (OBLIGATORIO)**
72
- > ⚠️ **REGLA PERMANENTE**: El `architect-agent` **NO PUEDE** crear el informe de research.
73
- > El `researcher-agent` es el **único agente autorizado** para crear `research.md`.
70
+ 3. **Delegate to researcher-agent (MANDATORY)**
71
+ > ⚠️ **PERMANENT RULE**: The `architect-agent` **CANNOT** create the research report.
72
+ > The `researcher-agent` is the **only authorized agent** to create `research.md`.
74
73
 
75
- El `architect-agent` **DEBE**:
76
- a) Activar al `researcher-agent` con el contexto de la tarea:
77
- - Descripción y objetivo de la tarea
74
+ The `architect-agent` **MUST**:
75
+ a) Activate the `researcher-agent` with the task context:
76
+ - Task description and objective
78
77
  - Acceptance criteria
79
- - Template a utilizar (`templates.research`)
80
- b) Esperar a que el `researcher-agent` complete su informe
81
- c) Verificar que el informe existe y cumple el template
78
+ - Template to use (`templates.research`)
79
+ b) Wait for the `researcher-agent` to complete the report
80
+ c) Verify that the report exists and follows the template
82
81
 
83
- **Prefijo obligatorio del researcher-agent**: `🔬 **researcher-agent**:`
82
+ **Mandatory researcher-agent prefix**: `🔬 **researcher-agent**:`
84
83
 
85
- El `researcher-agent` **DEBE**:
86
- - Crear el directorio: `.agent/artifacts/<taskId>-<taskTitle>/researcher/`
87
- - Crear el informe: `.agent/artifacts/<taskId>-<taskTitle>/researcher/research.md`
88
- - Seguir estrictamente el template `templates.research`
89
- - Cubrir todos los puntos obligatorios:
90
- - alternativas tecnicas y APIs relevantes
91
- - compatibilidad multi-browser
92
- - riesgos y trade-offs
93
- - recomendaciones AI-first
94
- - fuentes oficiales o de prestigio
95
- - Devolver el control al `architect-agent` al finalizar
96
-
97
-
98
- 4. Solicitar aprobacion del desarrollador (OBLIGATORIA, por consola)
99
- - El desarrollador **DEBE** emitir una decision binaria:
100
- - **SI** → aprobado
101
- - **NO** → rechazado
102
- - Registrar la decision en `research.md` con el formato:
84
+ The `researcher-agent` **MUST**:
85
+ - Create the directory: `.agent/artifacts/<taskId>-<taskTitle>/researcher/`
86
+ - Create the report: `.agent/artifacts/<taskId>-<taskTitle>/researcher/research.md`
87
+ - Strictly follow the `templates.research` template
88
+ - Cover all mandatory points:
89
+ - technical alternatives and relevant APIs
90
+ - multi-browser compatibility
91
+ - risks and trade-offs
92
+ - AI-first recommendations
93
+ - official or reputable sources
94
+ - Return control to the `architect-agent` upon completion
95
+
96
+
97
+ 4. Request developer approval (MANDATORY, via console)
98
+ - The developer **MUST** issue a binary decision:
99
+ - **SI** → approved
100
+ - **NO** → rejected
101
+ - Record the decision in `research.md` with the format:
103
102
  ```yaml
104
103
  approval:
105
104
  developer:
106
105
  decision: SI | NO
107
106
  date: <ISO-8601>
108
- comments: <opcional>
107
+ comments: <optional>
109
108
  ```
110
- - Si `decision != SI` → ir a **Paso 8 (FAIL)**.
109
+ - If `decision != SI` → go to **Step 8 (FAIL)**.
111
110
 
112
111
  5. PASS
113
- - Actualizar `.agent/artifacts/<taskId>-<taskTitle>/task.md`:
114
- - marcar Fase 1 como completada
115
- - establecer `task.lifecycle.phases.phase-1-research.validated_at = <ISO-8601>`
116
- - actualizar `task.phase.updated_at = <ISO-8601>`
117
- - avanzar `task.phase.current = aliases.tasklifecycle-long.phases.phase_2.id`
112
+ - Report that Phase 1 is correctly completed.
113
+ - The `architect-agent` **MUST explicitly perform** the following actions:
114
+ - Mark Phase 1 as completed in `task.md`.
115
+ - Set `task.lifecycle.phases.phase-1-research.completed = true`.
116
+ - Set `task.lifecycle.phases.phase-1-research.validated_at = <ISO-8601>`.
117
+ - Update `task.phase.updated_at = <ISO-8601>`.
118
+ - Update the state:
119
+ - `task.phase.current = aliases.tasklifecycle-long.phases.phase_2.id`
120
+ - This update is **NOT automatic** and **CANNOT be inferred**.
121
+ - Until this change is reflected in `task.md`, **Phase 2 cannot be started**.
122
+ - Indicate paths:
123
+ - `research.md`
124
+ - `task.md` updated
118
125
 
119
126
  ---
120
127
 
121
- ## FAIL (OBLIGATORIO)
128
+ ## FAIL (MANDATORY)
122
129
 
123
- 8. Declarar Fase 1 como **NO completada**
124
- - Indicar exactamente que fallo:
125
- - task inexistente
126
- - fase incorrecta
127
- - template inexistente
128
- - fallo al crear `research.md`
129
- - aprobacion del desarrollador = NO o inexistente
130
- - Pedir la accion minima para solventar
131
- - Terminar bloqueado: no avanzar de fase.
130
+ 8. Declare Phase 1 as **NOT completed**
131
+ - Indicate exactly what failed:
132
+ - non-existent task
133
+ - incorrect phase
134
+ - non-existent template
135
+ - failure creating `research.md`
136
+ - developer approval = NO or missing
137
+ - Request the minimum action to resolve
138
+ - Terminate blocked: do not advance phase.
132
139
 
133
140
  ---
134
141
 
135
142
  ## Gate (REQUIRED)
136
143
 
137
- Requisitos (todos obligatorios):
138
- 1. Existe `.agent/artifacts/<taskId>-<taskTitle>/researcher/research.md`.
139
- 2. El informe sigue la estructura del template `templates.research`.
140
- 3. El `research.md` inicia con el prefijo del `researcher-agent`.
141
- 4. El informe **DEBE** haber sido creado por el `researcher-agent`, **NO** por el `architect-agent`.
142
- > ⚠️ Si el informe fue creado por otro agente → **Gate FAIL**.
143
- 5. Existe aprobacion explicita del desarrollador:
144
+ Requirements (all mandatory):
145
+ 1. `.agent/artifacts/<taskId>-<taskTitle>/researcher/research.md` exists.
146
+ 2. The report follows the `templates.research` template structure.
147
+ 3. The `research.md` starts with the `researcher-agent` prefix.
148
+ 4. The report **MUST** have been created by the `researcher-agent`, **NOT** by the `architect-agent`.
149
+ > ⚠️ If the report was created by another agent → **Gate FAIL**.
150
+ 5. Explicit developer approval exists:
144
151
  - `approval.developer.decision == SI`
145
- 6. La investigación es profunda, detallada y basada en fuentes oficiales o de prestigio.
146
- 7. El informe **NO contiene** análisis, recomendaciones ni valoraciones.
147
- 8. `task.md` refleja:
148
- - Fase 1 completada
152
+ 6. The research is deep, detailed, and based on official or reputable sources.
153
+ 7. The report **DOES NOT contain** analysis, recommendations, or evaluations.
154
+ 8. `task.md` reflects:
155
+ - Phase 1 completed
149
156
  - `task.phase.current == aliases.tasklifecycle-long.phases.phase_2.id`
150
157
  - `task.lifecycle.phases.phase-1-research.completed == true`
151
- - `task.lifecycle.phases.phase-1-research.validated_at` no nulo
152
- - `task.phase.updated_at` no nulo
153
- 6. **Gobernanza verificada**: El historial de logs muestra la secuencia de herramientas MCP definida en `skill.runtime-governance`.
158
+ - `task.lifecycle.phases.phase-1-research.validated_at` not null
159
+ - `task.phase.updated_at` not null
154
160
 
155
- Si Gate FAIL:
156
- - Ejecutar **Paso 8 (FAIL)**.
161
+ If Gate FAIL:
162
+ - Execute **Step 8 (FAIL)**.