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

package/dist/agent/artifacts/task-20260130-rol-vscode/brief.md

@@ -0,0 +1,104 @@
+---
+artifact: brief
+phase: short-phase-1-brief
+owner: architect-agent
+status: approved
+related_task: task-20260130-rol-vscode-Crear rol especifico para extensiones VS Code
+---
+
+# Brief — task-20260130-rol-vscode-Crear rol especifico para extensiones VS Code
+
+## Identificacion del agente (OBLIGATORIA)
+Primera linea del documento:
+`<icono> **<nombre-agente>**: <mensaje>`
+
+🏛️ **architect-agent**: Brief listo para rol VS Code.
+
+## 1. Identificacion de la tarea
+
+**Titulo**: Crear rol especifico para extensiones VS Code
+**Objetivo**: Definir un rol operativo claro y una constitution obligatoria para VS Code, basada en documentacion oficial.
+**Estrategia**: Short
+
+---
+
+## 2. Las 5 Preguntas Obligatorias
+
+| # | Pregunta (formulada por architect) | Respuesta (del desarrollador) |
+|---|-----------------------------------|-------------------------------|
+| 1 | Nombre exacto del rol e icono/prefijo obligatorio. | "vscode-specialist" y buscar un icono de VS Code. |
+| 2 | Alcance operativo del rol. | Todo lo relacionado con extension de VS Code. |
+| 3 | Limites de autoridad (archivos que puede tocar). | Solo podra tocar los ficheros que conforman la extension de VS Code. |
+| 4 | Entregables/artefactos esperados. | Archivos en `src/extension` y distribucion en `dist/extension`, y cambios en `package.json` relacionados con la extension. |
+| 5 | Constitution de VS Code (obligatoria u opcional) y temas clave. | Obligatoria; basada en links oficiales de extension guides y API de VS Code. |
+
+---
+
+## 3. Acceptance Criteria
+
+Derivados de las respuestas anteriores:
+
+1. **Alcance**: Rol cubre todo lo relacionado con extension de VS Code.
+2. **Entradas/Datos**: Documentacion oficial de VS Code (extension guides y API).
+3. **Salidas esperadas**: Rol nuevo, constitution VS Code obligatoria, limites de archivos permitidos, y cambios documentados.
+4. **Restricciones**: Solo modificar archivos de la extension (`src/extension/**`, `dist/extension/**`, y campos de `package.json` relacionados con la extension).
+5. **Criterio de Done**: Rol y constitution creados e indexados en reglas; limites y entregables definidos.
+
+---
+
+## 4. Analisis simplificado
+
+### Estado actual (As-Is)
+- Estructura afectada: reglas y roles en `.agent/rules/roles`, constitucion en `.agent/rules/constitution`, indices correspondientes.
+- Limitaciones conocidas: el uso de icono VS Code debe seguir guias oficiales de marca.
+
+### Evaluacion de complejidad
+
+| Indicador | Estado | Comentario |
+|-----------|--------|------------|
+| Afecta mas de 3 paquetes | ☐ Si ☒ No | Cambios concentrados en reglas y indices. |
+| Requiere investigacion APIs | ☒ Si ☐ No | Debe basarse en la documentacion oficial de VS Code. |
+| Cambios breaking | ☒ Si ☐ No | Agrega nuevo rol/constitution; afecta proceso y autoridad. |
+| Tests E2E complejos | ☐ Si ☒ No | No aplica. |
+
+**Resultado de complejidad**: ☒ ALTA (recomendar abortar a Long)
+
+---
+
+## 5. Plan de implementacion
+
+### Pasos ordenados
+
+1. **Paso 1**
+   - Descripcion: Analizar documentacion oficial (extension guides y API) y extraer reglas clave para VS Code.
+   - Entregables: resumen de reglas y fuentes citadas.
+
+2. **Paso 2**
+   - Descripcion: Definir nuevo rol `vscode-specialist` con prefijo y limites de autoridad.
+   - Entregables: archivo de rol y actualizacion del indice de roles.
+
+3. **Paso 3**
+   - Descripcion: Crear constitution VS Code obligatoria y actualizar el indice de constitucion.
+   - Entregables: regla de constitution y referencias en indices.
+
+4. **Paso 4**
+   - Descripcion: Actualizar reglas de autoridad si aplica (solo architect-agent).
+   - Entregables: reglas consistentes y sin conflictos.
+
+### Verificacion prevista
+- Tipo de tests: verificacion manual de reglas e indices.
+- Criterios de exito: rol y constitution presentes, indexados y coherentes con fuentes oficiales.
+
+---
+
+## 6. Aprobacion del desarrollador (OBLIGATORIA)
+
+```yaml
+approval:
+  developer:
+    decision: SI
+    date: 2026-01-30T14:42:29Z
+    comments: null
+```
+
+> Sin aprobacion, esta fase NO puede avanzar a Implementation.

package/dist/agent/artifacts/task-20260130-rol-vscode/closure.md

@@ -0,0 +1,100 @@
+---
+artifact: closure
+phase: short-phase-3-closure
+owner: architect-agent
+status: approved
+related_task: task-20260130-rol-vscode-Crear rol especifico para extensiones VS Code
+---
+
+# Closure — task-20260130-rol-vscode-Crear rol especifico para extensiones VS Code
+
+## Identificacion del agente (OBLIGATORIA)
+Primera linea del documento:
+`<icono> **<nombre-agente>**: <mensaje>`
+
+🏛️ **architect-agent**: Cierre de tarea preparado.
+
+## 1. Resumen de la tarea
+
+**Título**: Crear rol especifico para extensiones VS Code
+**Estrategia**: Short
+**Estado final**: ☒ Completada ☐ Abortada
+
+---
+
+## 2. Verificacion
+
+### Tests ejecutados
+
+| Tipo | Comando/Metodo | Resultado |
+|------|----------------|-----------|
+| Unit | N/A | ☐ Pass ☐ Fail ☒ N/A |
+| Integration | N/A | ☐ Pass ☐ Fail ☒ N/A |
+| E2E | N/A | ☐ Pass ☐ Fail ☒ N/A |
+
+### Justificacion (si no hay tests)
+Cambios limitados a reglas y documentos de proceso; verificacion manual suficiente.
+
+---
+
+## 3. Estado de Acceptance Criteria
+
+| AC | Descripcion | Estado |
+|----|-------------|--------|
+| 1 | Alcance: rol cubre todo lo relacionado con extension de VS Code. | ☒ ✅ ☐ ❌ |
+| 2 | Entradas/Datos: documentacion oficial de VS Code como fuente. | ☒ ✅ ☐ ❌ |
+| 3 | Salidas: rol y constitution creados e indexados. | ☒ ✅ ☐ ❌ |
+| 4 | Restricciones: limites de archivos definidos. | ☒ ✅ ☐ ❌ |
+| 5 | Done: reglas coherentes e indexadas. | ☒ ✅ ☐ ❌ |
+
+---
+
+## 4. Cambios realizados
+
+### Ficheros modificados/creados
+
+| Fichero | Accion | Descripcion |
+|---------|--------|-------------|
+| .agent/rules/roles/vscode-specialist.md | Created | Nuevo rol con limites y entregables. |
+| .agent/rules/roles/index.md | Modified | Registro del rol nuevo. |
+| .agent/rules/constitution/vscode-extensions.md | Created | Constitution obligatoria VS Code. |
+| .agent/rules/constitution/index.md | Modified | Registro de constitution nueva. |
+
+### Commits (si aplica)
+
+```
+N/A
+```
+
+---
+
+## 5. Aceptacion final del desarrollador (OBLIGATORIA)
+
+```yaml
+approval:
+  developer:
+    decision: SI
+    date: 2026-01-30T15:02:53Z
+    comments: null
+```
+
+> Sin aceptacion, la tarea NO puede marcarse como completada.
+
+---
+
+## 6. Puntuaciones de agentes (OBLIGATORIO)
+
+| Agente | Puntuacion (1-10) | Notas |
+|--------|-------------------|-------|
+| architect-agent | 6 | null |
+
+---
+
+## 7. Push final (si aplica)
+
+```yaml
+push:
+  approved: NO
+  branch: N/A
+  date: null
+```

package/dist/agent/artifacts/task-beta-release/acceptance.md

@@ -0,0 +1,23 @@
+# Acceptance Criteria: Beta Release of Agentic System Structure
+
+> **Task**: Beta Release of Agentic System Structure
+> **Strategy**: Short
+
+## 1. Scope & Deliverables
+- [ ] **README.md Updated**: Must reflect the latest capabilities and structure of `src/agentic-system-structure`.
+- [ ] **Clean Distribution**: The published package MUST NOT include the VSCode extension code, only CLI and Agnostic Agent System Structure.
+- [ ] **Core Structure**: The published package MUST include various core files (`dist/agent`) derived from `src/agentic-system-structure`.
+- [ ] **CLI Functionality**: The `agentic-workflow` CLI must function independently of VSCode.
+
+## 2. Release & Versioning
+- [ ] **Version Bump**: Update `package.json` to the next beta version (e.g., `1.22.0-beta.8`).
+- [ ] **Branching**: Create a release branch named `ci/publish/v<version>`.
+- [ ] **Automation**: rely on existing GitHub Action `publish.yml` for the actual npm publish.
+
+## 3. Verification (Pre-Release)
+- **Local Install Test**:
+    1. Build the project locally.
+    2. Create a clean, temporary directory.
+    3. Execute `init` using the local CLI build.
+    4. **Pass Condition**: The `.agent` directory is created, populated, and `init.md` can be generated without errors.
+    5. **Pass Condition**: No references to VSCode APIs cause runtime errors.

package/dist/agent/artifacts/task-beta-release/brief.md

@@ -0,0 +1,39 @@
+# Brief: Beta Release of Agentic System Structure
+
+> **Task**: Beta Release of Agentic System Structure
+> **Strategy**: Short
+
+## 1. Analysis (Current State)
+- **Repo**: `agentic-workflow`
+- **Current Version**: `1.22.0-beta.7`
+- **Structure**: `src/agentic-system-structure` contains the source of truth for the agentic system.
+- **Publishing**: Automated via `publish.yml` on `ci/publish` branch merge.
+- **Exclusion**: `package.json` correctly excludes `dist/extension` but includes `dist/agent` (copied from `src/agentic-system-structure`).
+
+## 2. Implementation Plan
+### Step 1: Verification (Pre-Flight)
+- Build the project locally (`npm run build`).
+- Validate that `dist/extension` is excluded effectively or ignored by the `files` directive.
+- Run a local `init` test in a clean directory to ensure the CLI works without the VSCode environment.
+
+### Step 2: Documentation
+- Update `README.md` to reflect the latest state of the structure (e.g., number of available workflows, rules, etc.).
+
+### Step 3: Versioning & Release
+- Bump version to `1.22.0-beta.8` (or next available).
+- Create branch `ci/publish/v1.22.0-beta.8`.
+- Commit changes (README + package.json).
+
+### Step 4: Publish
+- Push branch to origin.
+- (User action required to merge PR if branch protection exists, or push directly if allowed).
+
+## 3. Complexity Evaluation
+- **Level**: LOW
+- **Risk**: Low (Beta release, limited scope).
+- **Breaking Changes**: None expected in the CLI logic itself.
+
+## 4. Agent Evaluation
+- **Architect**: Plan defined.
+- **Verification**: Essential to prove CLI independence from VSCode.
+- **DevOps**: Standard release process.

package/dist/agent/artifacts/task-beta-release/closure.md

@@ -0,0 +1,29 @@
+# Closure Report: Beta Release of Agentic System Structure
+
+> **Task**: Beta Release of Agentic System Structure
+> **Strategy**: Short
+> **Status**: COMPLETED
+
+## 1. Summary of Changes
+- **Documentation**: Updated `README.md` to highlight CLI capabilities and new structure stats.
+- **Versioning**: Bumped `package.json` to `1.24.0-beta.4` (on top of `1.24.0-beta.3`).
+- **Release Channel**: Created and pushed branch `ci/publish-v1.24.0-beta.4` to trigger the automated publication workflow.
+
+## 2. Verification Results
+- [x] **Distribution Check**: Verified `npm pack` tarball.
+  - `dist/extension`: **EXCLUDED** (Confirmed).
+  - `dist/agent`: **INCLUDED** (Confirmed).
+- [x] **Functional Test**:
+  - `init` command executed successfully in a clean project.
+  - `.agent` structure created correctly.
+  - `agentic-init` command tested (simulated).
+
+## 3. Next Steps
+- **PR Conflict Resolution**: [Pull Request #167](https://github.com/christian-marino-alvarez/agentic-workflow/pull/167) **MERGED**.
+- The automation sequence is restored.
+- **PR Created**: [Pull Request #169](https://github.com/christian-marino-alvarez/agentic-workflow/pull/169) (Target: `develop`).
+- This PR #169 should now be mergeable (or rebasable) on top of the restored `develop`.
+- Once published, the beta version will be available as `@christianmaf80/agentic-workflow@1.24.0-beta.4`.
+
+## 4. Final Review
+The task is considered complete pending final CI execution.

package/dist/agent/artifacts/task-beta-release/init.md

@@ -0,0 +1,26 @@
+# init bootstrap
+
+- command: init
+- role.architect: architect-agent
+- constitution.loaded.in_context: true
+
+## Constitution (load order)
+1. .agent/index.md
+2. .agent/rules/constitution/clean-code.md
+3. .agent/rules/constitution/agents-behavior.md
+
+```yaml
+bootstrap:
+  done: true
+roles:
+  architect: architect-agent
+constitution:
+  loaded:
+    - .agent/index.md
+    - .agent/rules/constitution/clean-code.md
+    - .agent/rules/constitution/agents-behavior.md
+language:
+  value: Español
+  confirmed: true
+strategy: short
+```

package/dist/agent/artifacts/task-beta-release/task.md

@@ -0,0 +1,64 @@
+---
+id: task-beta-release
+title: Beta Release of Agentic System Structure
+owner: architect-agent
+strategy: short
+---
+
+# Task (Candidate)
+
+## Identification
+- id: task-beta-release
+- title: Beta Release of Agentic System Structure
+- scope: candidate
+- owner: architect-agent
+
+## Origin
+- created_from:
+  - workflow: tasklifecycle-short
+  - source: init
+  - candidate_path: .agent/artifacts/candidate/task.md
+
+## Task Description
+Create a new beta version to publish the new agent structure and distribute it.
+The distribution should NOT include the VSCode extension.
+It should only include the CLI and `/src/agentic-system-structure`.
+The goal is to certify that it can be installed in any project via the CLI commands and that the structure is copied exactly as it is.
+
+## Objective
+Create a beta version of the CLI that distributes the agentic-system-structure, excluding the VSCode extension, and verify that `init` command installs the structure correctly in a target project.
+
+## Lifecycle State (SINGLE SOURCE OF TRUTH)
+
+```yaml
+task:
+  id: "task-beta-release"
+  title: "Beta Release of Agentic System Structure"
+  strategy: "short"
+  artifacts:
+    supplemental: []
+  phase:
+    current: "short-phase-3-closure"
+    validated_by: "architect-agent"
+    updated_at: "2026-02-16T11:42:00+01:00"
+  lifecycle:
+    phases:
+      short-phase-1-brief:
+        completed: true
+        validated_by: "architect-agent"
+        validated_at: "2026-02-16T11:22:00+01:00"
+      short-phase-2-implementation:
+        completed: true
+        validated_by: "architect-agent"
+        validated_at: "2026-02-16T11:27:00+01:00"
+      short-phase-3-closure:
+        completed: true
+        validated_by: "architect-agent"
+        validated_at: "2026-02-16T11:42:00+01:00"
+```
+
+---
+
+## 2. Definition and Scope (Contract)
+- **Acceptance Criteria**: [acceptance.md](file:///.agent/artifacts/candidate/acceptance.md)
+- **Alias**: `task.acceptance`

package/dist/agent/index.md

@@ -1,49 +1,88 @@
 ---
 id: agent.index
 owner: architect-agent
-version: 1.0.0
+version: 1.1.1
 severity: PERMANENT
-description: Punto de entrada global del sistema .agent y sus dominios.
+description: "UNIFIED ROOT INDEX. Lists ALL system aliases in a single file."
 ---
 
-# INDEX — .agent (Root)
+# UNIFIED INDEX — .agent
 
-## Objetivo
-Este fichero define los dominios principales del sistema `.agent`
-y dónde está el `index.md` de cada dominio.
-
-## Patron de indices y alias
-- Cada dominio tiene un `index.md` que lista rutas de ficheros de ese dominio.
-- Los `index.md` definen alias (YAML) que se usan en workflows, rules y templates.
-- Los alias permiten referenciar ficheros sin rutas absolutas y ayudan a recordar
-  que ya se cargo un fichero y su ruta exacta.
-- Para acceder a un fichero, el LLM debe seguir la cadena:
-  `.agent/index.md` -> `dominio/index.md` -> alias -> ruta real.
+## Objective
+This file is the **Single Source of Truth** for file locations in the `.agent` system.
+It contains **ALL** aliases for Rules, Workflows, Templates, and Artifacts.
 
 ## Aliases (YAML)
 ```yaml
 agent:
-  version: 1.0.0
+  version: 1.1.1
 
-  domains:
-    workflows:
-      index: .agent/workflows/index.md
+  rules:
+    constitution:
+      clean_code: .agent/rules/constitution/clean-code.md
+      agents_behavior: .agent/rules/constitution/agents-behavior.md
+      vscode_extensions: .agent/rules/constitution/vscode-extensions.md
+      backend: .agent/rules/constitution/backend.md
+      background: .agent/rules/constitution/background.md
+      view: .agent/rules/constitution/view.md
+      modular_architecture: .agent/rules/constitution/modular-architecture.md
 
-    artifacts:
-      index: .agent/artifacts/index.md
+    roles:
+      architect: .agent/rules/roles/architect.md
+      qa: .agent/rules/roles/qa.md
+      researcher: .agent/rules/roles/researcher.md
+      neo: .agent/rules/roles/neo.md
+      engine: .agent/rules/roles/engine.md
+      vscode-specialist: .agent/rules/roles/vscode-specialist.md
+      backend: .agent/rules/roles/backend.md
+      background: .agent/rules/roles/background.md
+      view: .agent/rules/roles/view.md
+      devops: .agent/rules/roles/devops.md
 
-    templates:
-      index: .agent/templates/index.md
+  skills:
+    scaffolding: .agent/skills/scaffolding/SKILL.md
 
-    rules:
-      index: .agent/rules/index.md
+  workflows:
+    init: .agent/workflows/init.md
+    scaffold-module: .agent/workflows/scaffold-module.md
+    tasklifecycle-long: .agent/workflows/tasklifecycle-long/index.md
+    tasklifecycle-short: .agent/workflows/tasklifecycle-short/index.md
+    coding:
+      backend: .agent/workflows/coding/coding-backend.md
+      background: .agent/workflows/coding/coding-background.md
+      view: .agent/workflows/coding/coding-view.md
+      integration: .agent/workflows/coding/coding-integration.md
 
-    skills:
-      index: .agent/skills/index.md
+  templates:
+    task: .agent/templates/task.md
+    acceptance: .agent/templates/acceptance.md
+    init: .agent/templates/init.md
+    analysis: .agent/templates/analysis.md
+    planning: .agent/templates/planning.md
+    subtask_implementation: .agent/templates/subtask-implementation.md
+    review: .agent/templates/review.md
+    verification: .agent/templates/verification.md
+    results_acceptance: .agent/templates/results-acceptance.md
+    task_metrics: .agent/templates/task-metrics.md
+    agent_scores: .agent/templates/agent-scores.md
+    research: .agent/templates/research.md
+    agent_task: .agent/templates/agent-task.md
+    todo_item: .agent/templates/todo-item.md
+    changelog: .agent/templates/changelog.md
+    supplemental_report: .agent/templates/supplemental-report.md
+    brief: .agent/templates/brief.md
+    closure: .agent/templates/closure.md
+    coding:
+      layer_report: .agent/templates/coding/coding-layer-report.md
+      integration_report: .agent/templates/coding/coding-integration-report.md
 
+  artifacts:
+    candidate:
+      dir: .agent/artifacts/candidate
+      init: .agent/artifacts/candidate/init.md
+      task: .agent/artifacts/candidate/task.md
 ```
 
-## Reglas
-- Este fichero **solo** declara puntos de entrada por dominio.
-- Cada dominio es responsable de sus aliases internos mediante su propio `index.md`.
-- Si un dominio cambia de ruta, se actualiza aquí (y en su índice local si aplica).
+## Rules
+- **No valid sub-indexes exist**. Everything must be here.
+- If you add a file to the system, you **MUST** register it here.