@christianmaf80/agentic-workflow 1.24.0-beta.3 → 1.25.0-beta.3

package/dist/agent/templates/brief.md

@@ -8,22 +8,22 @@ related_task: <taskId>-<taskTitle>
 
 # Brief — <taskId>-<taskTitle>
 
-## Identificacion del agente (OBLIGATORIA)
-Primera linea del documento:
-`<icono> **<nombre-agente>**: <mensaje>`
+## Agent Identification (MANDATORY)
+First line of the document:
+`<icon> **<agent-name>**: <message>`
 
-## 1. Identificación de la tarea
+## 1. Task Identification
 
-**Título**: <título de la tarea>
-**Objetivo**: <objetivo principal>
-**Estrategia**: Short
+**Title**: <task title>
+**Objective**: <main objective>
+**Strategy**: Short
 
 ---
 
-## 2. Las 5 Preguntas Obligatorias
+## 2. The 5 Mandatory Questions
 
-| # | Pregunta (formulada por architect) | Respuesta (del desarrollador) |
-|---|-----------------------------------|-------------------------------|
+| # | Question (formulated by architect) | Answer (from developer) |
+|---|-----------------------------------|------------------------|
 | 1 | | |
 | 2 | | |
 | 3 | | |
@@ -34,63 +34,63 @@ Primera linea del documento:
 
 ## 3. Acceptance Criteria
 
-Derivados de las respuestas anteriores:
+Derived from the previous answers:
 
-1. **Alcance**: 
-2. **Entradas/Datos**: 
-3. **Salidas esperadas**: 
-4. **Restricciones**: 
-5. **Criterio de Done**: 
+1. **Scope**: 
+2. **Inputs/Data**: 
+3. **Expected Outputs**: 
+4. **Constraints**: 
+5. **Done Criterion**: 
 
 ---
 
-## 4. Análisis simplificado
+## 4. Simplified Analysis
 
-### Estado actual (As-Is)
-- Estructura afectada:
-- Limitaciones conocidas:
+### Current State (As-Is)
+- Affected structure:
+- Known limitations:
 
-### Evaluación de complejidad
+### Complexity Evaluation
 
-| Indicador | Estado | Comentario |
-|-----------|--------|------------|
-| Afecta más de 3 paquetes | ☐ Sí ☐ No | |
-| Requiere investigación APIs | ☐ Sí ☐ No | |
-| Cambios breaking | ☐ Sí ☐ No | |
-| Tests E2E complejos | ☐ Sí ☐ No | |
+| Indicator | Status | Comment |
+|-----------|--------|---------|
+| Affects more than 3 packages | ☐ Yes ☐ No | |
+| Requires API research | ☐ Yes ☐ No | |
+| Breaking changes | ☐ Yes ☐ No | |
+| Complex E2E tests | ☐ Yes ☐ No | |
 
-**Resultado de complejidad**: ☐ BAJA (continuar Short) ☐ ALTA (recomendar abortar a Long)
+**Complexity result**: ☐ LOW (continue Short) ☐ HIGH (recommend abort to Long)
 
 ---
 
-## 5. Plan de implementación
+## 5. Implementation Plan
 
-### Pasos ordenados
+### Ordered Steps
 
-1. **Paso 1**
-   - Descripción:
-   - Entregables:
+1. **Step 1**
+   - Description:
+   - Deliverables:
 
-2. **Paso 2**
-   - Descripción:
-   - Entregables:
+2. **Step 2**
+   - Description:
+   - Deliverables:
 
-(Añadir más pasos según necesidad)
+(Add more steps as needed)
 
-### Verificación prevista
-- Tipo de tests:
-- Criterios de éxito:
+### Planned Verification
+- Test type:
+- Success criteria:
 
 ---
 
-## 6. Aprobación del desarrollador (OBLIGATORIA)
+## 6. Developer Approval (MANDATORY)
 
 ```yaml
 approval:
   developer:
     decision: SI | NO
     date: <ISO-8601>
-    comments: <opcional>
+    comments: <optional>
 ```
 
-> Sin aprobación, esta fase NO puede avanzar a Implementation.
+> Without approval, this phase CANNOT advance to Implementation.

package/dist/agent/templates/changelog.md

@@ -9,18 +9,18 @@ target_branch: <branch-name>
 
 # Changelog — <taskId>-<taskTitle>
 
-## 1. Resumen general
-Descripción breve y clara de los cambios introducidos por esta tarea.
+## 1. General Summary
+Brief and clear description of the changes introduced by this task.
 
-- **Objetivo de la tarea**:
-- **Impacto principal**:
-- **Áreas afectadas** (componentes, workflows, etc.):
+- **Task objective**:
+- **Main impact**:
+- **Affected areas** (components, workflows, etc.):
 
 ---
 
-## 2. Commits incluidos
-Listado completo y ordenado de los commits realizados.
+## 2. Included Commits
+Complete and ordered list of commits performed.
 
 ### Commit 1
 - **Hash**: `<commit-hash>`
-- **Mensaje (Conventional Commit)**:
+- **Message (Conventional Commit)**:

package/dist/agent/templates/closure.md

@@ -8,36 +8,36 @@ related_task: <taskId>-<taskTitle>
 
 # Closure — <taskId>-<taskTitle>
 
-## Identificacion del agente (OBLIGATORIA)
-Primera linea del documento:
-`<icono> **<nombre-agente>**: <mensaje>`
+## Agent Identification (MANDATORY)
+First line of the document:
+`<icon> **<agent-name>**: <message>`
 
-## 1. Resumen de la tarea
+## 1. Task Summary
 
-**Título**: <título>
-**Estrategia**: Short
-**Estado final**: ☐ Completada ☐ Abortada
+**Title**: <title>
+**Strategy**: Short
+**Final status**: ☐ Completed ☐ Aborted
 
 ---
 
-## 2. Verificación
+## 2. Verification
 
-### Tests ejecutados
+### Tests Executed
 
-| Tipo | Comando/Método | Resultado |
-|------|----------------|-----------|
+| Type | Command/Method | Result |
+|------|---------------|--------|
 | Unit | | ☐ Pass ☐ Fail ☐ N/A |
 | Integration | | ☐ Pass ☐ Fail ☐ N/A |
 | E2E | | ☐ Pass ☐ Fail ☐ N/A |
 
-### Justificación (si no hay tests)
-<Explicar por qué no aplican tests>
+### Justification (if no tests)
+<Explain why tests do not apply>
 
 ---
 
-## 3. Estado de Acceptance Criteria
+## 3. Acceptance Criteria Status
 
-| AC | Descripción | Estado |
+| AC | Description | Status |
 |----|-------------|--------|
 | 1 | | ☐ ✅ ☐ ❌ |
 | 2 | | ☐ ✅ ☐ ❌ |
@@ -47,49 +47,49 @@ Primera linea del documento:
 
 ---
 
-## 4. Cambios realizados
+## 4. Changes Made
 
-### Ficheros modificados/creados
+### Files Modified/Created
 
-| Fichero | Acción | Descripción |
-|---------|--------|-------------|
+| File | Action | Description |
+|------|--------|-------------|
 | | Created/Modified/Deleted | |
 
-### Commits (si aplica)
+### Commits (if applicable)
 
 ```
-<tipo>(<scope>): <descripción>
+<type>(<scope>): <description>
 ```
 
 ---
 
-## 5. Aceptación final del desarrollador (OBLIGATORIA)
+## 5. Final Developer Acceptance (MANDATORY)
 
 ```yaml
 approval:
   developer:
     decision: SI | NO
     date: <ISO-8601>
-    comments: <opcional>
+    comments: <optional>
 ```
 
-> Sin aceptación, la tarea NO puede marcarse como completada.
+> Without acceptance, the task CANNOT be marked as completed.
 
 ---
 
-## 6. Puntuaciones de agentes (OBLIGATORIO)
+## 6. Agent Scores (MANDATORY)
 
-| Agente | Puntuacion (1-10) | Notas |
-|--------|-------------------|-------|
+| Agent | Score (1-10) | Notes |
+|-------|-------------|-------|
 | | | |
 
 ---
 
-## 7. Push final (si aplica)
+## 7. Final Push (if applicable)
 
 ```yaml
 push:
   approved: SI | NO
-  branch: <rama destino>
+  branch: <target branch>
   date: <ISO-8601>
 ```

package/dist/agent/templates/coding/coding-integration-report.md

@@ -0,0 +1,102 @@
+---
+artifact: coding_integration_report
+phase: phase-4-implementation
+owner: architect-agent
+status: draft | completed
+related_task: "{{taskId}}-{{taskTitle}}"
+---
+
+# Coding Integration Report — {{taskId}}-{{taskTitle}}
+
+## 1. Layer Reports Summary
+
+| Layer | Agent | Status | Gate |
+|-------|-------|--------|------|
+| Backend | {{backend_agent}} | {{status}} | SI / NO / N/A |
+| Background | {{background_agent}} | {{status}} | SI / NO / N/A |
+| View | {{view_agent}} | {{status}} | SI / NO / N/A |
+
+---
+
+## 2. Communication Validation Matrix
+
+| Path | Method | Contract | Status |
+|------|--------|----------|--------|
+| View → Background | `core/messaging` Event Bus | `Message` interface | ✅ / ❌ |
+| Background → Backend | Abstract transport / direct | Structured response | ✅ / ❌ |
+| Background → View | `core/messaging` response | `Message` interface | ✅ / ❌ |
+| View → Backend | **FORBIDDEN** | N/A | ✅ (no path) / ❌ (violation) |
+
+### Validation Details
+- (Describe each communication path validated)
+- (Note any deviations or issues found and how they were resolved)
+
+---
+
+## 3. Constitution Compliance
+
+### Backend (`constitution.backend`)
+- [ ] Extends `AbstractServer`
+- [ ] No `vscode` or `dom` imports
+- [ ] Transport agnostic
+- [ ] Structured error handling
+- [ ] No direct View communication
+
+### Background (`constitution.background`)
+- [ ] Registered via `App.register()`
+- [ ] Uses `core/messaging` for View communication
+- [ ] Manages lifecycle correctly
+- [ ] Gateway role maintained
+
+### View (`constitution.view`)
+- [ ] Lit with `@customElement`
+- [ ] Triad structure (index/html/styles)
+- [ ] No business logic
+- [ ] Communication via Messaging wrapper
+
+---
+
+## 4. Cross-Layer Sequence Diagrams
+
+> Include mermaid sequence diagrams for key integration flows.
+
+```mermaid
+sequenceDiagram
+    participant V as View
+    participant B as Background
+    participant BE as Backend
+
+    V->>B: Message (Event Bus)
+    B->>BE: Request (Transport)
+    BE-->>B: Response (Structured)
+    B-->>V: State Update (Messaging)
+```
+
+---
+
+## 5. E2E Test Indications
+
+### Integration Scenarios
+- (List end-to-end scenarios that validate the full flow across layers)
+
+### Test Setup
+- (Prerequisites, extension host configuration, fixtures)
+
+### Key Assertions
+- (What to verify at each layer boundary)
+- (Expected UI behavior after full round-trip)
+
+---
+
+## 6. Issues and Resolutions
+
+| Issue | Layer | Severity | Resolution |
+|-------|-------|----------|------------|
+| (description) | (backend/background/view) | (critical/warning) | (action taken) |
+
+---
+
+## 7. Final Assessment
+- **Integration status**: PASS | FAIL
+- **Constitution compliance**: FULL | PARTIAL
+- **Ready for Phase 5 (Verification)**: YES | NO

package/dist/agent/templates/coding/coding-layer-report.md

@@ -0,0 +1,78 @@
+---
+artifact: coding_layer_report
+phase: phase-4-implementation
+owner: "{{agent}}"
+status: draft | completed
+related_task: "{{taskId}}-{{taskTitle}}"
+layer: "{{layer}}"
+---
+
+# Coding Layer Report — {{layer}} — {{taskId}}-{{taskTitle}}
+
+## 1. Who (Agent Identity)
+- **Agent**: {{agent}}
+- **Role**: {{role}} (`roles.{{layer}}`)
+- **Constitution**: `constitution.{{layer}}` + `constitution.clean_code`
+
+---
+
+## 2. How (Technical Details)
+
+### Changes Implemented
+- **Files created/modified**: (list with paths)
+- **APIs/contracts affected**: (interfaces, types, exports)
+- **New functions/classes**: (names and purpose)
+
+### Technical Specifications
+- (Detailed description of implementation approach)
+- (Architecture decisions and patterns used)
+
+### Diagrams
+> Include mermaid diagrams when the implementation involves:
+> - New communication flows
+> - State transitions
+> - Component relationships
+> - Data flow
+
+```mermaid
+graph TD
+    A[Component] --> B[Dependency]
+```
+
+---
+
+## 3. Why (Justification)
+- **Objective**: (What problem does this solve?)
+- **Reasoning**: (Why this approach over alternatives?)
+- **Alternatives discarded**: (Brief description and reason)
+
+---
+
+## 4. Results
+
+### Compilation
+- `npm run compile`: PASS | FAIL
+- Errors resolved: (list if any)
+
+### Self-Validation Checklist
+> Copy the checklist from the workflow and mark each item.
+
+### Code Quality
+- Clean code compliance: YES | NO
+- Constitution compliance: YES | NO
+
+---
+
+## 5. E2E Test Indications
+
+### Required Test Scenarios
+- (List scenarios that should be covered by e2e tests)
+
+### Test Setup
+- (Prerequisites, fixtures, or mock data needed)
+
+### Assertions
+- (Expected behaviors to verify per scenario)
+
+### Integration Points
+- (How this layer connects to others — what to test at boundaries)

package/dist/agent/templates/init.md

@@ -1,9 +1,3 @@
----
-kind: template
-name: init
-source: agentic-system-structure
----
-
 # init bootstrap
 
 - command: {{command}}