@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.
- package/README.es.md +13 -94
- package/README.md +14 -94
- package/RELEASE_PROCESS.md +3 -6
- package/bin/cli.js +31 -72
- package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/acceptance.md +70 -0
- package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/agent-scores.md +22 -0
- package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/agent-tasks/1-dev-agent-scaffold.md +106 -0
- package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/agent-tasks/2-dev-agent-manifest-command.md +105 -0
- package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/agent-tasks/3-dev-agent-marketplace-evidence.md +103 -0
- package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/agent-tasks/4-qa-agent-verify-build.md +103 -0
- package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/analysis.md +197 -0
- package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/architect/review.md +131 -0
- package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/changelog.md +26 -0
- package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/metrics.md +40 -0
- package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/plan.md +175 -0
- package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/researcher/research.md +157 -0
- package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/results-acceptance.md +168 -0
- package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/task.md +119 -0
- package/dist/agent/artifacts/1-scaffold-extension-vscode-agentinc/verification.md +79 -0
- package/dist/agent/artifacts/11-refinement-capas-constitution/analysis.md +24 -0
- package/dist/agent/artifacts/11-refinement-capas-constitution/roadmap-audit.md +34 -0
- package/dist/agent/artifacts/11-refinement-capas-constitution/task.md +58 -0
- package/dist/agent/artifacts/12-npm-workspaces/acceptance.md +78 -0
- package/dist/agent/artifacts/12-npm-workspaces/analysis.md +179 -0
- package/dist/agent/artifacts/12-npm-workspaces/plan.md +237 -0
- package/dist/agent/artifacts/12-npm-workspaces/researcher/research.md +186 -0
- package/dist/agent/artifacts/12-npm-workspaces/task.md +126 -0
- package/dist/agent/artifacts/13-implement-custom-chat-with-a2ui/acceptance.md +75 -0
- package/dist/agent/artifacts/13-implement-custom-chat-with-a2ui/researcher/research.md +121 -0
- package/dist/agent/artifacts/13-implement-custom-chat-with-a2ui/task.md +104 -0
- package/dist/agent/artifacts/14-re-implement-setup-config-d1/acceptance.md +75 -0
- package/dist/agent/artifacts/14-re-implement-setup-config-d1/architect/analysis.md +90 -0
- package/dist/agent/artifacts/14-re-implement-setup-config-d1/planner/implementation_plan.md +44 -0
- package/dist/agent/artifacts/14-re-implement-setup-config-d1/researcher/research.md +113 -0
- package/dist/agent/artifacts/14-re-implement-setup-config-d1/task.md +107 -0
- package/dist/agent/artifacts/14-re-implement-setup-config-d1/verification/walkthrough.md +37 -0
- package/dist/agent/artifacts/14-re-implement-setup-config-d1/verifier/walkthrough.md +0 -0
- package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/acceptance.md +68 -0
- package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/agent-tasks/1-dev-agent-contribution-points-assets.md +107 -0
- package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/agent-tasks/2-dev-agent-webview-provider.md +106 -0
- package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/agent-tasks/3-dev-agent-webview-ui.md +104 -0
- package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/agent-tasks/4-dev-agent-chat-participant.md +104 -0
- package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/agent-tasks/5-dev-agent-migrate-to-root.md +103 -0
- package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/agent-tasks/fix-1-dev-agent-chat-participant-types.md +108 -0
- package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/agent-tasks/fix-2-dev-agent-view-container-id.md +106 -0
- package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/agent-tasks/fix-3-dev-agent-container-id-lowercase.md +105 -0
- package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/agent-tasks/fix-4-dev-agent-container-id-hyphen.md +105 -0
- package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/agent-tasks/fix-5-dev-agent-view-type-webview.md +103 -0
- package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/analysis.md +179 -0
- package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/architect/review.md +118 -0
- package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/plan.md +171 -0
- package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/researcher/research.md +113 -0
- package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/results-acceptance.md +171 -0
- package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/task.md +119 -0
- package/dist/agent/artifacts/2-scaffold-vscode-chat-ai-panel/verification.md +85 -0
- package/dist/agent/artifacts/3-new-vscode-agentic-activitybar-chat/acceptance.md +69 -0
- package/dist/agent/artifacts/3-new-vscode-agentic-activitybar-chat/agent-scores.md +23 -0
- package/dist/agent/artifacts/3-new-vscode-agentic-activitybar-chat/agent-tasks/1-dev-agent-create-project.md +89 -0
- package/dist/agent/artifacts/3-new-vscode-agentic-activitybar-chat/agent-tasks/2-dev-agent-contributes-activitybar.md +88 -0
- package/dist/agent/artifacts/3-new-vscode-agentic-activitybar-chat/agent-tasks/3-dev-agent-webview-panel.md +88 -0
- package/dist/agent/artifacts/3-new-vscode-agentic-activitybar-chat/agent-tasks/4-dev-agent-chat-participant.md +88 -0
- package/dist/agent/artifacts/3-new-vscode-agentic-activitybar-chat/agent-tasks/5-dev-agent-launch-config.md +90 -0
- package/dist/agent/artifacts/3-new-vscode-agentic-activitybar-chat/agent-tasks/fix-1-dev-agent-view-container-ids.md +90 -0
- package/dist/agent/artifacts/3-new-vscode-agentic-activitybar-chat/analysis.md +175 -0
- package/dist/agent/artifacts/3-new-vscode-agentic-activitybar-chat/architect/review.md +118 -0
- package/dist/agent/artifacts/3-new-vscode-agentic-activitybar-chat/changelog.md +26 -0
- package/dist/agent/artifacts/3-new-vscode-agentic-activitybar-chat/metrics.md +43 -0
- package/dist/agent/artifacts/3-new-vscode-agentic-activitybar-chat/plan.md +167 -0
- package/dist/agent/artifacts/3-new-vscode-agentic-activitybar-chat/researcher/research.md +115 -0
- package/dist/agent/artifacts/3-new-vscode-agentic-activitybar-chat/results-acceptance.md +122 -0
- package/dist/agent/artifacts/3-new-vscode-agentic-activitybar-chat/task.md +119 -0
- package/dist/agent/artifacts/3-new-vscode-agentic-activitybar-chat/verification.md +85 -0
- package/dist/agent/artifacts/4-copiar-estructura-agentic-cliente/acceptance.md +67 -0
- package/dist/agent/artifacts/4-copiar-estructura-agentic-cliente/architect/implementation.md +31 -0
- package/dist/agent/artifacts/4-copiar-estructura-agentic-cliente/brief.md +103 -0
- package/dist/agent/artifacts/4-copiar-estructura-agentic-cliente/closure.md +101 -0
- package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/acceptance.md +72 -0
- package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/agent-scores.md +20 -0
- package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/agent-tasks/1-dev-agent-reestructurar-carpetas.md +101 -0
- package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/agent-tasks/2-dev-agent-scaffolding-yeoman.md +111 -0
- package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/agent-tasks/3-dev-agent-merge-extension.md +110 -0
- package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/agent-tasks/4-dev-agent-merge-config.md +107 -0
- package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/agent-tasks/5-dev-agent-update-scripts.md +111 -0
- package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/agent-tasks/6-qa-agent-validation-install.md +108 -0
- package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/agent-tasks/7-dev-agent-fix-cli-entrypoint.md +104 -0
- package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/agent-tasks/8-qa-agent-validation-install-retry.md +106 -0
- package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/analysis.md +125 -0
- package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/architect/review.md +84 -0
- package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/changelog.md +34 -0
- package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/metrics.md +44 -0
- package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/plan.md +157 -0
- package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/researcher/research.md +105 -0
- package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/results-acceptance.md +105 -0
- package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/task.md +107 -0
- package/dist/agent/artifacts/5-reestructurar-src-para-extension-vscode/verification.md +79 -0
- package/dist/agent/artifacts/6-release-beta-11/agent-tasks/1-dev-agent-release-bump.md +44 -0
- package/dist/agent/artifacts/6-release-beta-11/architect/implementation.md +37 -0
- package/dist/agent/artifacts/6-release-beta-11/brief.md +89 -0
- package/dist/agent/artifacts/6-release-beta-11/closure.md +83 -0
- package/dist/agent/artifacts/6-release-beta-11/task.md +65 -0
- package/dist/agent/artifacts/7-extension-vscode-webview/acceptance.md +70 -0
- package/dist/agent/artifacts/7-extension-vscode-webview/agent-scores.md +24 -0
- package/dist/agent/artifacts/7-extension-vscode-webview/agent-tasks/1-vscode-specialist-scaffold-extension.md +99 -0
- package/dist/agent/artifacts/7-extension-vscode-webview/agent-tasks/2-vscode-specialist-update-manifest.md +101 -0
- package/dist/agent/artifacts/7-extension-vscode-webview/agent-tasks/3-vscode-specialist-webview-provider.md +96 -0
- package/dist/agent/artifacts/7-extension-vscode-webview/agent-tasks/4-vscode-specialist-activitybar-icon.md +95 -0
- package/dist/agent/artifacts/7-extension-vscode-webview/agent-tasks/5-qa-agent-manual-verify.md +97 -0
- package/dist/agent/artifacts/7-extension-vscode-webview/analysis.md +195 -0
- package/dist/agent/artifacts/7-extension-vscode-webview/architect/review.md +124 -0
- package/dist/agent/artifacts/7-extension-vscode-webview/changelog.md +9 -0
- package/dist/agent/artifacts/7-extension-vscode-webview/metrics.md +43 -0
- package/dist/agent/artifacts/7-extension-vscode-webview/plan.md +181 -0
- package/dist/agent/artifacts/7-extension-vscode-webview/researcher/research.md +118 -0
- package/dist/agent/artifacts/7-extension-vscode-webview/results-acceptance.md +146 -0
- package/dist/agent/artifacts/7-extension-vscode-webview/task.md +119 -0
- package/dist/agent/artifacts/7-extension-vscode-webview/verification.md +81 -0
- package/dist/agent/artifacts/8-create-agentic-runtime-cli-first-as-the-single-execution-engine/task.md +126 -0
- package/dist/agent/artifacts/candidate/acceptance.md +23 -0
- package/dist/agent/artifacts/candidate/brief.md +39 -0
- package/dist/agent/artifacts/candidate/init.md +24 -0
- package/dist/agent/artifacts/candidate/task.md +5 -0
- package/dist/agent/artifacts/task-20260128-reorganize-structure/acceptance.md +68 -0
- package/dist/agent/artifacts/task-20260128-reorganize-structure/brief.md +100 -0
- package/dist/agent/artifacts/task-20260128-reorganize-structure/closure.md +40 -0
- package/dist/agent/artifacts/task-20260128-reorganize-structure/implementation.md +48 -0
- package/dist/agent/artifacts/task-20260128-reorganize-structure/task.md +66 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/acceptance.md +65 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-scores.md +26 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/1-neo-agent-deps-chatkit.md +108 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/15-vscode-specialist-views-router.md +89 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/1b-vscode-specialist-review-deps.md +106 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/2-neo-agent-local-server.md +111 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/22-vscode-specialist-external-js.md +84 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/23-qa-agent-coverage-tests.md +85 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/24-vscode-specialist-class-refactor.md +84 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/25-vscode-specialist-external-html.md +88 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/26-vscode-specialist-template-js-html.md +110 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/27-vscode-specialist-fix-loading-setup.md +110 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/28-vscode-specialist-webview-debug-setup.md +107 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/29-vscode-specialist-webview-logging.md +109 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/3-neo-agent-webview-ui.md +107 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/30-vscode-specialist-csp-source.md +88 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/31-vscode-specialist-logging-prefix.md +83 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/32-vscode-specialist-logging-visibility.md +85 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/33-vscode-specialist-lit-setup.md +85 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/34-vscode-specialist-core-lit-base.md +89 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/35-vscode-specialist-lit-decorators-ts.md +88 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/36-vscode-specialist-lit-module-start.md +85 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/37-vscode-specialist-lit-ready-state.md +86 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/4-qa-agent-verification.md +106 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/5-vscode-specialist-api-key-ui.md +107 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/6-vscode-specialist-refactor-protocol.md +108 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/7-qa-agent-unit-tests.md +104 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/fix-10-vscode-specialist-api-key-handshake.md +84 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/fix-11-vscode-specialist-api-key-button-style.md +83 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/fix-12-vscode-specialist-key-gate-view.md +84 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/fix-13-vscode-specialist-status-timeout.md +83 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/fix-14-vscode-specialist-init-flow.md +84 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/fix-16-vscode-specialist-view-context.md +87 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/fix-17-vscode-specialist-clear-key-command.md +85 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/fix-18-vscode-specialist-context-sync.md +84 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/fix-19-vscode-specialist-setup-visible.md +88 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/fix-20-vscode-specialist-loading-state.md +83 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/fix-21-vscode-specialist-loading-label.md +84 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/fix-8-vscode-specialist-api-key-detect.md +89 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/fix-9-vscode-specialist-api-key-state.md +84 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/analysis.md +156 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/architect/review.md +141 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/changelog.md +30 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/metrics.md +43 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/plan.md +151 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/research.md +115 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/results-acceptance.md +171 -0
- package/dist/agent/artifacts/task-20260130-chatkit-mainview/verification.md +87 -0
- package/dist/agent/artifacts/task-20260130-fix-mainview-provider/acceptance.md +64 -0
- package/dist/agent/artifacts/task-20260130-fix-mainview-provider/architect/implementation.md +30 -0
- package/dist/agent/artifacts/task-20260130-fix-mainview-provider/brief.md +102 -0
- package/dist/agent/artifacts/task-20260130-fix-mainview-provider/closure.md +95 -0
- package/dist/agent/artifacts/task-20260130-rol-vscode/acceptance.md +68 -0
- package/dist/agent/artifacts/task-20260130-rol-vscode/architect/implementation.md +33 -0
- package/dist/agent/artifacts/task-20260130-rol-vscode/brief.md +104 -0
- package/dist/agent/artifacts/task-20260130-rol-vscode/closure.md +100 -0
- package/dist/agent/artifacts/task-beta-release/acceptance.md +23 -0
- package/dist/agent/artifacts/task-beta-release/brief.md +39 -0
- package/dist/agent/artifacts/task-beta-release/closure.md +29 -0
- package/dist/agent/artifacts/task-beta-release/init.md +26 -0
- package/dist/agent/artifacts/task-beta-release/task.md +64 -0
- package/dist/agent/index.md +69 -30
- package/dist/agent/rules/constitution/agents-behavior.md +110 -158
- package/dist/agent/rules/constitution/backend.md +27 -0
- package/dist/agent/rules/constitution/background.md +30 -0
- package/dist/agent/rules/constitution/clean-code.md +5 -6
- package/dist/agent/rules/constitution/modular-architecture.md +66 -0
- package/dist/agent/rules/constitution/view.md +41 -0
- package/dist/agent/rules/constitution/vscode-extensions.md +32 -0
- package/dist/agent/rules/roles/architect.md +1 -2
- package/dist/agent/rules/roles/backend.md +21 -0
- package/dist/agent/rules/roles/background.md +20 -0
- package/dist/agent/rules/roles/devops.md +20 -0
- package/dist/agent/rules/roles/engine.md +26 -0
- package/dist/agent/rules/roles/neo.md +12 -13
- package/dist/agent/rules/roles/researcher.md +2 -2
- package/dist/agent/rules/roles/view.md +22 -0
- package/dist/agent/rules/roles/vscode-specialist.md +24 -0
- package/dist/agent/templates/acceptance.md +19 -25
- package/dist/agent/templates/agent-task.md +39 -39
- package/dist/agent/templates/analysis.md +92 -92
- package/dist/agent/templates/brief.md +96 -0
- package/dist/agent/templates/changelog.md +8 -8
- package/dist/agent/templates/closure.md +95 -0
- package/dist/agent/templates/coding/coding-integration-report.md +102 -0
- package/dist/agent/templates/coding/coding-layer-report.md +78 -0
- package/dist/agent/templates/init.md +2 -23
- package/dist/agent/templates/planning.md +73 -73
- package/dist/agent/templates/research.md +43 -43
- package/dist/agent/templates/results-acceptance.md +94 -94
- package/dist/agent/templates/review.md +59 -59
- package/dist/agent/templates/subtask-implementation.md +29 -29
- package/dist/agent/templates/supplemental-report.md +0 -6
- package/dist/agent/templates/task-metrics.md +14 -14
- package/dist/agent/templates/task.md +18 -33
- package/dist/agent/templates/todo-item.md +23 -23
- package/dist/agent/workflows/coding/coding-backend.md +147 -0
- package/dist/agent/workflows/coding/coding-background.md +149 -0
- package/dist/agent/workflows/coding/coding-integration.md +174 -0
- package/dist/agent/workflows/coding/coding-view.md +151 -0
- package/dist/agent/workflows/init.md +93 -133
- package/dist/agent/workflows/scaffold-module.md +38 -0
- package/dist/agent/workflows/tasklifecycle-long/phase-0-acceptance-criteria.md +124 -134
- package/dist/agent/workflows/tasklifecycle-long/phase-1-research.md +103 -97
- package/dist/agent/workflows/tasklifecycle-long/phase-2-analysis.md +107 -102
- package/dist/agent/workflows/tasklifecycle-long/phase-3-planning.md +125 -120
- package/dist/agent/workflows/tasklifecycle-long/phase-4-implementation.md +121 -125
- package/dist/agent/workflows/tasklifecycle-long/phase-5-verification.md +105 -101
- package/dist/agent/workflows/tasklifecycle-long/phase-6-results-acceptance.md +82 -78
- package/dist/agent/workflows/tasklifecycle-long/phase-7-evaluation.md +84 -75
- package/dist/agent/workflows/tasklifecycle-long/phase-8-commit-push.md +94 -89
- package/dist/agent/workflows/tasklifecycle-short/short-phase-1-brief.md +117 -0
- package/dist/agent/workflows/tasklifecycle-short/short-phase-2-implementation.md +114 -0
- package/dist/agent/workflows/tasklifecycle-short/short-phase-3-closure.md +111 -0
- package/dist/cli/commands/create.js +4 -29
- package/dist/cli/commands/create.js.map +1 -1
- package/dist/cli/commands/fork.js +45 -0
- package/dist/cli/commands/fork.js.map +1 -0
- package/dist/cli/commands/init.js +4 -78
- package/dist/cli/commands/init.js.map +1 -1
- package/dist/cli/commands/mcp.js +3 -17
- package/dist/cli/commands/mcp.js.map +1 -1
- package/dist/cli/commands/scaffold.js +57 -0
- package/dist/cli/commands/scaffold.js.map +1 -0
- package/dist/cli/index.js +0 -1
- package/dist/cli/index.js.map +1 -1
- package/dist/infrastructure/context/manager.js +0 -2
- package/dist/infrastructure/context/manager.js.map +1 -1
- package/dist/infrastructure/index.js +0 -5
- package/dist/infrastructure/index.js.map +1 -1
- package/dist/runtime/engine/emitter.js +28 -0
- package/dist/runtime/engine/emitter.js.map +1 -0
- package/dist/runtime/engine/engine.js +128 -0
- package/dist/runtime/engine/engine.js.map +1 -0
- package/dist/runtime/engine/index.js +7 -0
- package/dist/runtime/engine/index.js.map +1 -0
- package/dist/runtime/engine/service.js +78 -0
- package/dist/runtime/engine/service.js.map +1 -0
- package/dist/runtime/engine/state-store.js +24 -0
- package/dist/runtime/engine/state-store.js.map +1 -0
- package/dist/runtime/{task-loader.js → engine/task-loader.js} +24 -5
- package/dist/runtime/engine/task-loader.js.map +1 -0
- package/dist/runtime/engine/workflow-loader.js +82 -0
- package/dist/runtime/engine/workflow-loader.js.map +1 -0
- package/dist/runtime/index.js +2 -4
- package/dist/runtime/index.js.map +1 -1
- package/dist/runtime/mcp/index.js +2 -0
- package/dist/runtime/mcp/index.js.map +1 -0
- package/dist/runtime/mcp/server.js +249 -0
- package/dist/runtime/mcp/server.js.map +1 -0
- package/media/agent-chat.svg +20 -0
- package/media/codicons/codicon.css +698 -0
- package/media/codicons/codicon.ttf +0 -0
- package/media/providers/claude.png +0 -0
- package/media/providers/gemini.png +0 -0
- package/media/providers/openai.png +0 -0
- package/package.json +124 -56
- package/dist/agent/artifacts/candidate/index.md +0 -26
- package/dist/agent/artifacts/index.md +0 -25
- package/dist/agent/rules/constitution/index.md +0 -26
- package/dist/agent/rules/constitution/runtime-integration.md +0 -102
- package/dist/agent/rules/index.md +0 -70
- package/dist/agent/rules/roles/index.md +0 -44
- package/dist/agent/skills/index.md +0 -23
- package/dist/agent/skills/runtime-governance/SKILL.md +0 -62
- package/dist/agent/templates/analisis.md +0 -86
- package/dist/agent/templates/index.md +0 -43
- package/dist/agent/templates/plan.md +0 -49
- package/dist/agent/templates/qa-results.md +0 -70
- package/dist/agent/workflows/index.md +0 -30
- package/dist/agent/workflows/tasklifecycle-long/index.md +0 -172
- package/dist/agent/workflows/tasklifecycle-short/index.md +0 -77
- package/dist/agent/workflows/tasklifecycle-short/short-phase-1-analisis.md +0 -116
- package/dist/agent/workflows/tasklifecycle-short/short-phase-2-plan.md +0 -81
- package/dist/agent/workflows/tasklifecycle-short/short-phase-3-implementation.md +0 -115
- package/dist/agent/workflows/tasklifecycle-short/short-phase-4-qa-results.md +0 -84
- package/dist/cli/commands/bootstrap.js +0 -111
- package/dist/cli/commands/bootstrap.js.map +0 -1
- package/dist/cli/commands/register-mcp.js +0 -135
- package/dist/cli/commands/register-mcp.js.map +0 -1
- package/dist/infrastructure/context/index.js +0 -2
- package/dist/infrastructure/context/index.js.map +0 -1
- package/dist/infrastructure/logger/index.js +0 -41
- package/dist/infrastructure/logger/index.js.map +0 -1
- package/dist/infrastructure/mapping/index.js +0 -2
- package/dist/infrastructure/mapping/index.js.map +0 -1
- package/dist/infrastructure/migration/index.js +0 -4
- package/dist/infrastructure/migration/index.js.map +0 -1
- package/dist/infrastructure/utils/index.js +0 -2
- package/dist/infrastructure/utils/index.js.map +0 -1
- package/dist/mcp/emitter.js +0 -24
- package/dist/mcp/emitter.js.map +0 -1
- package/dist/mcp/handlers.js +0 -74
- package/dist/mcp/handlers.js.map +0 -1
- package/dist/mcp/index.js +0 -3
- package/dist/mcp/index.js.map +0 -1
- package/dist/mcp/resources.js +0 -69
- package/dist/mcp/resources.js.map +0 -1
- package/dist/mcp/server.js +0 -94
- package/dist/mcp/server.js.map +0 -1
- package/dist/mcp/tools.js +0 -189
- package/dist/mcp/tools.js.map +0 -1
- package/dist/runtime/frontmatter-sync.js +0 -100
- package/dist/runtime/frontmatter-sync.js.map +0 -1
- package/dist/runtime/reconcile.js +0 -37
- package/dist/runtime/reconcile.js.map +0 -1
- package/dist/runtime/runtime.js +0 -427
- package/dist/runtime/runtime.js.map +0 -1
- package/dist/runtime/task-loader.js.map +0 -1
- package/dist/runtime/task-resolver.js +0 -401
- package/dist/runtime/task-resolver.js.map +0 -1
- package/dist/runtime/write-guard.js +0 -200
- 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:
|
|
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
|
|
15
|
+
- Task candidate created by `workflows.tasklifecycle-long`:
|
|
16
16
|
- `artifacts.candidate.task`
|
|
17
|
-
-
|
|
18
|
-
-
|
|
19
|
-
-
|
|
17
|
+
- The `task.md` candidate **MUST** include:
|
|
18
|
+
- task description
|
|
19
|
+
- task objective
|
|
20
20
|
|
|
21
21
|
> [!IMPORTANT]
|
|
22
|
-
> **
|
|
23
|
-
> -
|
|
24
|
-
> -
|
|
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 (
|
|
27
|
+
- Current task (definitive) with complete acceptance criteria:
|
|
29
28
|
- `.agent/artifacts/<taskId>-<taskTitle>/task.md`
|
|
30
29
|
|
|
31
|
-
## Template (
|
|
32
|
-
-
|
|
30
|
+
## Template (MANDATORY)
|
|
31
|
+
- The current task **MUST** be created using the template:
|
|
33
32
|
- `templates.task`
|
|
34
|
-
-
|
|
35
|
-
|
|
36
|
-
##
|
|
37
|
-
-
|
|
38
|
-
- **
|
|
39
|
-
-
|
|
40
|
-
-
|
|
41
|
-
|
|
42
|
-
##
|
|
43
|
-
0.
|
|
44
|
-
|
|
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
|
-
-
|
|
51
|
-
-
|
|
52
|
-
-
|
|
53
|
-
-
|
|
45
|
+
- Extract:
|
|
46
|
+
- task description
|
|
47
|
+
- task objective
|
|
48
|
+
- If missing → go to **Step 10 (FAIL)**.
|
|
54
49
|
|
|
55
|
-
2.
|
|
56
|
-
-
|
|
57
|
-
-
|
|
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. **
|
|
60
|
-
-
|
|
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
|
-
-
|
|
65
|
-
-
|
|
66
|
-
-
|
|
67
|
-
-
|
|
68
|
-
|
|
69
|
-
4.
|
|
70
|
-
-
|
|
71
|
-
-
|
|
72
|
-
-
|
|
73
|
-
-
|
|
74
|
-
-
|
|
75
|
-
|
|
76
|
-
5.
|
|
77
|
-
-
|
|
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
|
-
-
|
|
81
|
-
-
|
|
82
|
-
-
|
|
83
|
-
-
|
|
84
|
-
-
|
|
85
|
-
- **
|
|
86
|
-
- **
|
|
87
|
-
- **
|
|
88
|
-
|
|
89
|
-
6.
|
|
90
|
-
-
|
|
91
|
-
-
|
|
92
|
-
-
|
|
93
|
-
-
|
|
94
|
-
-
|
|
95
|
-
|
|
96
|
-
7.
|
|
97
|
-
-
|
|
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 persists → go 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
|
-
-
|
|
100
|
-
- `.agent/artifacts/<taskId>-<taskTitle>/task.md` (
|
|
101
|
-
-
|
|
102
|
-
- `.agent/artifacts/<taskId>-<taskTitle>/acceptance.md` (
|
|
103
|
-
-
|
|
104
|
-
-
|
|
105
|
-
-
|
|
106
|
-
- alias `task.acceptance`
|
|
107
|
-
-
|
|
108
|
-
-
|
|
109
|
-
-
|
|
110
|
-
-
|
|
111
|
-
-
|
|
112
|
-
|
|
113
|
-
8.
|
|
114
|
-
-
|
|
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/written → go 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
|
|
117
|
-
-
|
|
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: <
|
|
118
|
+
comments: <optional>
|
|
124
119
|
```
|
|
125
|
-
-
|
|
120
|
+
- If `decision != SI` → go to **Step 10 (FAIL)**.
|
|
126
121
|
|
|
127
122
|
9. PASS
|
|
128
|
-
-
|
|
129
|
-
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
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
|
-
-
|
|
140
|
-
-
|
|
141
|
-
|
|
142
|
-
10. FAIL (
|
|
143
|
-
-
|
|
144
|
-
-
|
|
145
|
-
-
|
|
146
|
-
- template
|
|
147
|
-
-
|
|
148
|
-
-
|
|
149
|
-
-
|
|
150
|
-
-
|
|
151
|
-
-
|
|
152
|
-
-
|
|
153
|
-
-
|
|
154
|
-
-
|
|
155
|
-
-
|
|
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
|
-
|
|
160
|
-
1.
|
|
150
|
+
Requirements (all mandatory):
|
|
151
|
+
1. The directory and state file exist:
|
|
161
152
|
- `.agent/artifacts/<taskId>-<taskTitle>/task.md`
|
|
162
|
-
2.
|
|
153
|
+
2. The acceptance artifact exists:
|
|
163
154
|
- `.agent/artifacts/<taskId>-<taskTitle>/acceptance.md`
|
|
164
|
-
3.
|
|
165
|
-
4.
|
|
166
|
-
5.
|
|
167
|
-
-
|
|
168
|
-
-
|
|
169
|
-
6.
|
|
170
|
-
7.
|
|
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.
|
|
173
|
-
-
|
|
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`
|
|
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`
|
|
178
|
-
- `task.phase.updated_at`
|
|
179
|
-
10.
|
|
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
|
-
|
|
183
|
-
-
|
|
172
|
+
If Gate FAIL:
|
|
173
|
+
- Execute **FAIL**.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
id: workflow.tasklifecycle-long.phase-1-research
|
|
3
|
-
description:
|
|
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
|
-
-
|
|
15
|
+
- The current task exists:
|
|
16
16
|
- `.agent/artifacts/<taskId>-<taskTitle>/task.md`
|
|
17
|
-
-
|
|
17
|
+
- The `task.md` **MUST** reflect:
|
|
18
18
|
- `task.phase.current == aliases.tasklifecycle-long.phases.phase_1.id`
|
|
19
|
-
-
|
|
20
|
-
-
|
|
21
|
-
-
|
|
22
|
-
- acceptance criteria
|
|
19
|
+
- The `task.md` **MUST** include:
|
|
20
|
+
- description
|
|
21
|
+
- objective
|
|
22
|
+
- defined acceptance criteria
|
|
23
23
|
|
|
24
24
|
> [!IMPORTANT]
|
|
25
|
-
> **
|
|
26
|
-
> -
|
|
27
|
-
> -
|
|
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 (
|
|
30
|
+
- Research report (mandatory, generated by researcher-agent):
|
|
32
31
|
- `.agent/artifacts/<taskId>-<taskTitle>/researcher/research.md`
|
|
33
|
-
-
|
|
32
|
+
- State update in the current task:
|
|
34
33
|
- `.agent/artifacts/<taskId>-<taskTitle>/task.md`
|
|
35
34
|
|
|
36
|
-
##
|
|
37
|
-
-
|
|
38
|
-
-
|
|
39
|
-
-
|
|
40
|
-
-
|
|
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
|
-
>
|
|
43
|
-
>
|
|
41
|
+
> This phase **DOES NOT implement code**.
|
|
42
|
+
> This phase **REQUIRES explicit developer approval**.
|
|
44
43
|
|
|
45
44
|
> [!CAUTION]
|
|
46
|
-
> **
|
|
47
|
-
>
|
|
48
|
-
> **
|
|
49
|
-
>
|
|
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 (
|
|
52
|
-
-
|
|
50
|
+
## Template (MANDATORY)
|
|
51
|
+
- The report **MUST** be created using the template:
|
|
53
52
|
- `templates.research`
|
|
54
|
-
-
|
|
53
|
+
- If the template does not exist or cannot be loaded → **FAIL**.
|
|
55
54
|
|
|
56
55
|
---
|
|
57
56
|
|
|
58
|
-
##
|
|
59
|
-
0.
|
|
57
|
+
## Mandatory Steps
|
|
58
|
+
0. Activate `researcher-agent` and use the mandatory prefix in every message.
|
|
60
59
|
|
|
61
|
-
1.
|
|
62
|
-
-
|
|
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`
|
|
65
|
-
-
|
|
63
|
+
- `task.md` contains acceptance criteria
|
|
64
|
+
- If it fails → go to **Step 8 (FAIL)**.
|
|
66
65
|
|
|
67
|
-
2.
|
|
68
|
-
-
|
|
69
|
-
-
|
|
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. **
|
|
72
|
-
> ⚠️ **
|
|
73
|
-
>
|
|
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
|
-
|
|
76
|
-
a)
|
|
77
|
-
-
|
|
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
|
|
80
|
-
b)
|
|
81
|
-
c)
|
|
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
|
-
**
|
|
82
|
+
**Mandatory researcher-agent prefix**: `🔬 **researcher-agent**:`
|
|
84
83
|
|
|
85
|
-
|
|
86
|
-
-
|
|
87
|
-
-
|
|
88
|
-
-
|
|
89
|
-
-
|
|
90
|
-
-
|
|
91
|
-
-
|
|
92
|
-
-
|
|
93
|
-
-
|
|
94
|
-
-
|
|
95
|
-
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
4.
|
|
99
|
-
-
|
|
100
|
-
- **SI** →
|
|
101
|
-
- **NO** →
|
|
102
|
-
-
|
|
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: <
|
|
107
|
+
comments: <optional>
|
|
109
108
|
```
|
|
110
|
-
-
|
|
109
|
+
- If `decision != SI` → go to **Step 8 (FAIL)**.
|
|
111
110
|
|
|
112
111
|
5. PASS
|
|
113
|
-
-
|
|
114
|
-
|
|
115
|
-
-
|
|
116
|
-
-
|
|
117
|
-
-
|
|
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 (
|
|
128
|
+
## FAIL (MANDATORY)
|
|
122
129
|
|
|
123
|
-
8.
|
|
124
|
-
-
|
|
125
|
-
- task
|
|
126
|
-
-
|
|
127
|
-
- template
|
|
128
|
-
-
|
|
129
|
-
-
|
|
130
|
-
-
|
|
131
|
-
-
|
|
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
|
-
|
|
138
|
-
1.
|
|
139
|
-
2.
|
|
140
|
-
3.
|
|
141
|
-
4.
|
|
142
|
-
> ⚠️
|
|
143
|
-
5.
|
|
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.
|
|
146
|
-
7.
|
|
147
|
-
8. `task.md`
|
|
148
|
-
-
|
|
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`
|
|
152
|
-
- `task.phase.updated_at`
|
|
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
|
-
|
|
156
|
-
-
|
|
161
|
+
If Gate FAIL:
|
|
162
|
+
- Execute **Step 8 (FAIL)**.
|