@christianmaf80/agentic-workflow 1.2.0-beta.1

package/dist/templates/task.md

@@ -0,0 +1,151 @@
+# Task (Template)
+
+## Agent Identification (MANDATORY)
+First line of the document:
+`<icon> **<agent-name>**: <message>`
+
+## Identification
+- id: {{task.id}}
+- title: {{task.title}}
+- scope: candidate | current
+- owner: architect-agent
+
+## Source
+- created_from:
+  - workflow: tasklifecycle
+  - source: init / tasklifecycle
+  - candidate_path: artifacts.candidate.task
+
+## Task Description
+{{task.description}}
+
+## Objective
+{{task.goal}}
+
+## Lifecycle Status (SINGLE SOURCE OF TRUTH)
+
+```yaml
+task:
+  id: "{{task.id}}"
+  title: "{{task.title}}"
+  strategy: "{{task.strategy}}"  # long | short
+  artifacts:
+    supplemental: []
+  phase:
+    current: "phase-0-acceptance-criteria"
+    validated_by: "architect-agent"
+    updated_at: "{{timestamp}}"
+  lifecycle:
+    phases:
+      phase-0-acceptance-criteria:
+        completed: false
+        validated_by: null
+        validated_at: null
+      phase-1-research:
+        completed: false
+        validated_by: null
+        validated_at: null
+      phase-2-analysis:
+        completed: false
+        validated_by: null
+        validated_at: null
+      phase-3-planning:
+        completed: false
+        validated_by: null
+        validated_at: null
+      phase-4-implementation:
+        completed: false
+        validated_by: null
+        validated_at: null
+      phase-5-verification:
+        completed: false
+        validated_by: null
+        validated_at: null
+      phase-6-results-acceptance:
+        completed: false
+        validated_by: null
+        validated_at: null
+      phase-7-evaluation:
+        completed: false
+        validated_by: null
+        validated_at: null
+      phase-8-commit-push:
+        completed: false
+        validated_by: null
+        validated_at: null
+    subflows:
+      drivers:
+        create:
+          - name: <driver-name>
+            completed: false
+            validated_by: null
+            validated_at: null
+        refactor:
+          - name: <driver-name>
+            completed: false
+            validated_by: null
+            validated_at: null
+        delete:
+          - name: <driver-name>
+            completed: false
+            validated_by: null
+            validated_at: null
+      modules:
+        create:
+          - name: <module-name>
+            completed: false
+            validated_by: null
+            validated_at: null
+        refactor:
+          - name: <module-name>
+            completed: false
+            validated_by: null
+            validated_at: null
+        delete:
+          - name: <module-name>
+            completed: false
+            validated_by: null
+            validated_at: null
+      pages:
+        create:
+          - name: <page-name>
+            completed: false
+            validated_by: null
+            validated_at: null
+      shards:
+        create:
+          - name: <shard-name>
+            completed: false
+            validated_by: null
+            validated_at: null
+      short-phase-1-brief:
+        completed: false
+        validated_by: null
+        validated_at: null
+      short-phase-2-implementation:
+        completed: false
+        validated_by: null
+        validated_at: null
+      short-phase-3-closure:
+        completed: false
+        validated_by: null
+        validated_at: null
+```
+
+---
+
+## 2. Definition and Scope (Contract)
+- **Acceptance Criteria**: [acceptance.md](file:///{{task.acceptance_path}})
+- **Alias**: `task.acceptance`
+
+---
+
+## Contractual Rules
+- This file is the **single source of truth** for the task status.
+- The `task.phase.current` field **ONLY can be modified by `architect-agent`**.
+- The `task.lifecycle.phases.*` field **ONLY can be marked as completed by `architect-agent`**.
+- A phase **cannot be marked as completed** if it is not the current phase.
+- Advancing to the next phase requires:
+  1. Marking the current phase as `completed: true`
+  2. Explicit validation from the architect
+  3. Updating `task.phase.current` to the next phase

package/dist/templates/todo-item.md

@@ -0,0 +1,49 @@
+---
+artifact: todo_item
+owner: architect-agent
+status: open | in-progress | done | cancelled
+priority: high | medium | low
+---
+
+# TODO: <brief title>
+
+## Agent Identification (MANDATORY)
+First line of the document:
+`<icon> **<agent-name>**: <message>`
+
+## Source
+- **Detected in task**: <taskId>-<taskTitle>
+- **Phase**: <phase where it was detected>
+- **Date**: <ISO-8601>
+- **Agent**: <agent who detected it>
+
+## Description
+<Clear description of the proposed improvement>
+
+## Justification
+<Why it is important to make this change>
+
+## Estimated Impact
+- **Complexity**: low | medium | high
+- **Affected Areas**: <components/workflows/templates>
+
+## Acceptance Criteria
+- [ ] <Verifiable condition 1>
+- [ ] <Verifiable condition 2>
+
+## Notes
+<Additional relevant information>
+
+---
+
+## History
+```yaml
+history:
+  - action: created
+    date: <ISO-8601>
+    by: <agent>
+  # - action: started | completed | cancelled
+  #   date: <ISO-8601>
+  #   by: <agent>
+  #   task: <taskId where it was implemented>
+```

package/dist/templates/verification.md

@@ -0,0 +1,77 @@
+---
+artifact: verification
+phase: phase-5-verification
+owner: qa-agent
+status: pending | approved | rejected
+related_task: <taskId>-<taskTitle>
+related_plan: .agent/artifacts/<taskId>-<taskTitle>/plan.md
+related_review: .agent/artifacts/<taskId>-<taskTitle>/architect/review.md
+---
+
+# Verification Report — <taskId>-<taskTitle>
+
+## Agent Identification (MANDATORY)
+First line of the document:
+`<icon> **<agent-name>**: <message>`
+
+## 1. Verification Scope
+- What was verified
+- What was excluded
+
+---
+
+## 2. Executed Tests
+- Unit tests (as per `constitution.project_architecture`)
+  - Suites
+  - Result (pass/fail)
+- Integration tests (as per `constitution.project_architecture`, if applicable)
+  - Suites
+  - Result (pass/fail)
+- E2E tests (as per `constitution.project_architecture`, if applicable)
+  - Suites
+  - Result (pass/fail)
+
+---
+
+## 3. Coverage and Thresholds
+- Total Coverage (%)
+- Coverage per area (if applicable)
+- Thresholds defined in the plan (met / not met)
+
+---
+
+## 4. Performance (if applicable)
+- Collected metrics
+- Thresholds (met / not met)
+
+---
+
+## 5. Evidence
+- Logs
+- Test reports
+- Screenshots (if applicable)
+
+---
+
+## 6. Issues
+- Bugs found
+- Severity
+- Status
+
+---
+
+## 7. Checklist
+- [ ] Verification completed
+- [ ] Testing thresholds met
+- [ ] Ready for Phase 6
+
+---
+
+## 8. Developer Approval (MANDATORY)
+```yaml
+approval:
+  developer:
+    decision: YES | NO
+    date: <ISO-8601>
+    comments: <optional>
+```

package/dist/workflows/index.md

@@ -0,0 +1,44 @@
+---
+id: workflows.index
+owner: architect-agent
+version: 1.0.0
+severity: PERMANENT
+---
+
+# INDEX — Workflows
+
+## Agent identification (MANDATORY)
+First line of the document:
+`<icon> **<agent-name>**: <message>`
+
+## Objective
+List workflow entry points and indexes for the workflow domain.
+
+## Input (REQUIRED)
+- None (index).
+
+## Output (REQUIRED)
+- Workflow index updated with current aliases.
+
+## Aliases (YAML)
+```yaml
+workflows:
+  init: .agent/workflows/init.md
+  tasklifecycle_long: .agent/workflows/tasklifecycle-long/index.md
+  tasklifecycle_short: .agent/workflows/tasklifecycle-short/index.md
+```
+
+## Pass
+- Alias list is up to date and valid.
+
+## Gate (REQUIRED)
+Requirements (all mandatory):
+1. This index file exists.
+2. All aliased workflows resolve to valid paths.
+
+If Gate FAIL:
+- Block until resolved.
+
+## Rules
+- Any new workflow entry point MUST be added here.
+- Phase workflows should be listed in their domain indexes (e.g., tasklifecycle-long).

package/dist/workflows/init.md

@@ -0,0 +1,61 @@
+---
+id: workflow.init
+owner: architect-agent
+version: 4.1.0
+severity: PERMANENT
+trigger:
+  commands: ["init", "/init", "/bootstrap", "/agentic-init"]
+blocking: true
+---
+
+# WORKFLOW: init
+
+## 0. Role Activation and Prefix (MANDATORY)
+- The agent **MUST** start their intervention by identifying themselves.
+- Message: `🏛️ **architect-agent**: Starting work session.`
+
+## Input (REQUIRED)
+- None (init).
+
+## Objective (ONLY)
+- Activate the **architect-agent** role.
+- Load the minimum bootstrap indices.
+- Load the constitution rules into context.
+- Detect the conversation language and confirm explicitly.
+- **Select the lifecycle strategy (Long/Short)**.
+- Create the **task candidate** artifact `init.md`.
+
+## Mandatory Steps
+1. **Reasoning (MANDATORY)**
+   - Explain to the developer what will be done in this phase and why.
+2. Use the `bootstrap_context` tool to load indices, constitutions, and core roles in a single step.
+3. If the tool is unavailable, load the bootstrap indices and base constitutions manually.
+4. Save the bundle output to `.agent/artifacts/candidate/bootstrap.md`.
+5. Detect preferred language and ask for explicit confirmation (**YES**).
+6. Select lifecycle strategy (**Long** or **Short**).
+7. Create the `init.md` artifact using `templates.init`.
+8. Evaluate Gate.
+   - The developer **MUST** explicitly confirm with a **YES**.
+
+## Output (REQUIRED)
+- Created artifact: `artifacts.candidate.init` (from `templates.init`).
+- Created artifact: `artifacts.candidate.bootstrap` (bundle from `bootstrap_context`).
+
+## Reasoning (MANDATORY)
+- Before executing, the architect-agent must explain to the developer what will be done and why.
+- No document is required for this step.
+
+## Pass
+- `init.md` is created from `templates.init`.
+- Language is confirmed and strategy is set.
+- `bootstrap.md` exists and contains the bundle.
+
+## Gate (REQUIRED)
+Requirements (all mandatory):
+1. `artifacts.candidate.init` exists.
+2. `artifacts.candidate.bootstrap` exists.
+3. In `init.md` YAML: `language.confirmed == true` and `strategy` is defined.
+4. The developer has explicitly approved with **YES**.
+
+If Gate FAIL:
+- Block until resolved.

package/dist/workflows/tasklifecycle-long/index.md

@@ -0,0 +1,176 @@
+---
+id: workflow.tasklifecycle-long
+owner: architect-agent
+version: 6.0.0
+severity: PERMANENT
+description: Orchestrates the complete (Long) lifecycle of a task starting from a valid init.
+trigger:
+  commands: ["tasklifecycle-long", "/tasklifecycle-long"]
+blocking: true
+---
+
+# WORKFLOW: tasklifecycle-long (Index)
+
+## Required Indexes (MANDATORY)
+This workflow does **NOT** define aliases outside its domain (`taskcycle-long`).
+To use artifacts and templates, global indexes **MUST** be loaded:
+
+- Artifacts index: `.agent/artifacts/index.md`
+- Templates index: `.agent/templates/index.md`
+
+## Domain Aliases: `taskcycle-long` (MANDATORY)
+This workflow defines aliases **only** for the `taskcycle-long` (task lifecycle long) domain.
+There is **one unique namespace** `aliases.taskcycle-long.phases.*` containing:
+- `id`: Phase ID
+- `workflow`: Path to the phase workflow file
+
+## Aliases (YAML)
+```yaml
+aliases:
+  taskcycle-long:
+    phases:
+      phase_0:
+        id: phase-0-acceptance-criteria
+        workflow: .agent/workflows/tasklifecycle-long/phase-0-acceptance-criteria.md
+      phase_1:
+        id: phase-1-research
+        workflow: .agent/workflows/tasklifecycle-long/phase-1-research.md
+      phase_2:
+        id: phase-2-analysis
+        workflow: .agent/workflows/tasklifecycle-long/phase-2-analysis.md
+      phase_3:
+        id: phase-3-planning
+        workflow: .agent/workflows/tasklifecycle-long/phase-3-planning.md
+      phase_4:
+        id: phase-4-implementation
+        workflow: .agent/workflows/tasklifecycle-long/phase-4-implementation.md
+      phase_5:
+        id: phase-5-verification
+        workflow: .agent/workflows/tasklifecycle-long/phase-5-verification.md
+      phase_6:
+        id: phase-6-results-acceptance
+        workflow: .agent/workflows/tasklifecycle-long/phase-6-results-acceptance.md
+      phase_7:
+        id: phase-7-evaluation
+        workflow: .agent/workflows/tasklifecycle-long/phase-7-evaluation.md
+      phase_8:
+        id: phase-8-commit-push
+        workflow: .agent/workflows/tasklifecycle-long/phase-8-commit-push.md
+```
+
+## Input (REQUIRED)
+- `init` artifact (bootstrap contract) exists as defined in the **Artifacts index**:
+  - `artifacts.candidate.init`
+- The `init` artifact **MUST** contain in its YAML block:
+  - `language.value`: Not empty
+  - `language.confirmed == true`
+- The developer **MUST have responded** to the question in **Section 8 of the `init` workflow**:
+  - Task definition
+  - Task objective
+
+## Output (REQUIRED)
+- Create task candidate (defined in the **Artifacts index**):
+  - `artifacts.candidate.task`
+- The `task candidate` file **MUST** exactly follow the template (defined in the **Templates index**):
+  - `templates.task`
+
+## Objective (ONLY)
+- Verify minimum requirements to **start Phase 0** (mandatory inputs).
+- Create the **task candidate** using the contractual template.
+- Verify that phase workflows for the `taskcycle-long` domain exist and can be loaded.
+- If any requirement is missing, **block** and request the minimum action needed to start **Phase 0**.
+
+> This workflow does **NOT** track phase completion.
+> Phase validation and advancement is the responsibility of the `architect-agent` within each phase (via its own gate).
+
+## Dispatch / Routing (MANDATORY)
+- Phase routing **MUST** be based on `task.phase.current`.
+- The active phase **MUST** be mapped to `aliases.taskcycle-long.phases.*.workflow`.
+- If no mapping exists → **FAIL** (invalid phase or corrupt index).
+- Only the `architect-agent` can change `task.phase.current`.
+
+## Mandatory Steps
+1. Load global indexes:
+   - Load `.agent/artifacts/index.md` and `.agent/templates/index.md`.
+   - If they cannot be loaded → go to **Step 7 (FAIL)**.
+
+2. Verify input:
+   - Check if `artifacts.candidate.init` exists.
+   - Read its YAML block and validate:
+     - `language.value`: Not empty
+     - `language.confirmed == true`
+   - If validation fails → go to **Step 7 (FAIL)**.
+
+3. Load task contractual template:
+   - `templates.task`
+   - If it doesn't exist or cannot be loaded → go to **Step 7 (FAIL)**.
+
+4. Create candidate directory (if missing):
+   - `artifacts.candidate.dir`
+
+5. Create task candidate artifact:
+   - Write `artifacts.candidate.task`
+   - Content **MUST** comply with the template (do not omit mandatory keys).
+   - **MUST include** information provided by the developer:
+     - Task description
+     - Task objective
+   - Initialize `task.phase.current` to `aliases.taskcycle-long.phases.phase_0.id`.
+   - If creation/writing fails → go to **Step 7 (FAIL)**.
+
+6. Verify phase availability (existence/load check only)
+   - Phase workflows **MUST** exist as files (they are not executed here):
+     - `aliases.taskcycle-long.phases.phase_0.workflow`
+     - `aliases.taskcycle-long.phases.phase_1.workflow`
+     - `aliases.taskcycle-long.phases.phase_2.workflow`
+     - `aliases.taskcycle-long.phases.phase_3.workflow`
+     - `aliases.taskcycle-long.phases.phase_4.workflow`
+     - `aliases.taskcycle-long.phases.phase_5.workflow`
+     - `aliases.taskcycle-long.phases.phase_6.workflow`
+     - `aliases.taskcycle-long.phases.phase_7.workflow`
+     - `aliases.taskcycle-long.phases.phase_8.workflow`
+   - If any are missing → go to **Step 7 (FAIL)**.
+
+7. FAIL (mandatory)
+   - Declare `tasklifecycle` as **NOT ready to start Phase 0**.
+   - Specify the applicable case(s):
+     - Global indexes not loadable (`.agent/artifacts/index.md` / `.agent/templates/index.md`)
+     - `init` does not exist (`artifacts.candidate.init`)
+     - Language undefined or unconfirmed in `init`
+     - Template inaccessible (`templates.task`)
+     - Could not create `task candidate` (`artifacts.candidate.task`)
+     - One or more phase workflows are missing (`aliases.taskcycle-long.phases.*.workflow`)
+   - Request minimum corrective action:
+     - Run `init` logic
+     - Confirm language
+     - Fix global indexes
+     - Fix permissions/path for candidate creation
+     - Create/restore missing phase workflow
+   - End blocked: until errors are fixed, **Phase 0 cannot begin**.
+
+## Official Phase Execution Order
+Lifecycle phases **MUST be executed strictly in the established numerical order**.
+Skipping, reordering, or parallelizing phases is not permitted.
+
+Mandatory Order:
+0. `aliases.taskcycle-long.phases.phase_0.id`
+1. `aliases.taskcycle-long.phases.phase_1.id`
+2. `aliases.taskcycle-long.phases.phase_2.id`
+3. `aliases.taskcycle-long.phases.phase_3.id`
+4. `aliases.taskcycle-long.phases.phase_4.id`
+5. `aliases.taskcycle-long.phases.phase_5.id`
+6. `aliases.taskcycle-long.phases.phase_6.id`
+7. `aliases.taskcycle-long.phases.phase_7.id`
+8. `aliases.taskcycle-long.phases.phase_8.id`
+
+## Pass
+- `artifacts.candidate.task` is created from `templates.task`.
+- All required phase workflows exist.
+
+## Gate (REQUIRED)
+Requirements (all mandatory):
+1. `artifacts.candidate.task` exists.
+2. `artifacts.candidate.task` complies with the `templates.task` template.
+3. All phase workflows listed in Step 6 are available (exist).
+
+If Gate FAIL:
+- Execute **Step 7 (FAIL)**.