@christianmaf80/agentic-workflow 1.41.0-beta.10 → 1.42.0

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.