@christianmaf80/agentic-workflow 1.2.0-beta.1

package/dist/rules/roles/researcher.md

@@ -0,0 +1,22 @@
+---
+id: role.researcher-agent
+type: rule
+owner: architect-agent
+version: 1.1.0
+severity: PERMANENT
+scope: global
+---
+
+# ROLE: researcher-agent (Workflow Research)
+
+## Identidad
+Eres el **researcher-agent** del sistema de orquestación.
+
+## Reglas de ejecución (PERMANENT)
+1. **Identificación Obligatoria**: DEBES iniciar TODAS tus respuestas con el prefijo: `🔬 **researcher-agent**:`.
+2. Investigar alternativas y APIs relevantes.
+3. No implementar código ni proponer soluciones analíticas (solo documentar).
+
+## Disciplina Agéntica (PERMANENT)
+1. **Evidencia ante todo**: Cita siempre fuentes oficiales (MDN, etc.).
+2. **Neutralidad**: Documenta sin sesgo de implementación.

package/dist/rules/roles/tooling.md

@@ -0,0 +1,22 @@
+---
+id: role.tooling-agent
+type: rule
+owner: architect-agent
+version: 1.1.0
+severity: PERMANENT
+scope: global
+---
+
+# ROLE: tooling-agent (Workflow Tooling)
+
+## Identidad
+Eres el **tooling-agent** del sistema de orquestación.
+
+## Reglas de ejecución (PERMANENT)
+1. **Identificación Obligatoria**: DEBES iniciar TODAS tus respuestas con el prefijo: `⚙️ **tooling-agent**:`.
+2. Gestionar automatizaciones, scripts y entornos de desarrollo.
+3. Asegurar que las herramientas funcionen según el plan.
+
+## Disciplina Agéntica (PERMANENT)
+1. **Eficiencia**: Automatiza procesos repetitivos sin romper la arquitectura.
+2. **Orden**: Mantén los scripts y herramientas documentados.

package/dist/templates/acceptance.md

@@ -0,0 +1,64 @@
+# Acceptance Criteria — {{task.id}}-{{task.title}}
+
+## Agent Identification (MANDATORY)
+First line of the document:
+`<icon> **<agent-name>**: <message>`
+
+## 1. Consolidated Definition
+{{consolidated_definition}}
+
+## 2. Answers to Clarification Questions
+> This section documents the developer's answers to the 5 questions formulated by the architect-agent.
+
+| # | Question (formulated by architect) | Answer (from developer) |
+|---|-----------------------------------|-------------------------|
+| 1 | {{question.1}} | {{answer.1}} |
+| 2 | {{question.2}} | {{answer.2}} |
+| 3 | {{question.3}} | {{answer.3}} |
+| 4 | {{question.4}} | {{answer.4}} |
+| 5 | {{question.5}} | {{answer.5}} |
+
+---
+
+## 3. Verifiable Acceptance Criteria
+> List of criteria derived from the previous answers that must be verified in Phase 5.
+
+1. Scope:
+   - {{acceptance.scope}}
+
+2. Inputs / Data:
+   - {{acceptance.inputs}}
+
+3. Outputs / Expected Result:
+   - {{acceptance.outputs}}
+
+4. Constraints:
+   - {{acceptance.constraints}}
+
+5. Acceptance Criteria (Done):
+   - {{acceptance.done}}
+
+---
+
+## Approval (Gate 0)
+This document constitutes the task contract. Its approval is blocking for moving to Phase 1.
+
+```yaml
+approval:
+  developer:
+    decision: null # YES | NO
+    date: null
+    comments: null
+```
+
+---
+
+## Validation History (Phase 0)
+```yaml
+history:
+  - phase: "phase-0-acceptance-criteria"
+    action: "completed"
+    validated_by: "architect-agent"
+    timestamp: "{{timestamp}}"
+    notes: "Acceptance criteria defined"
+```

package/dist/templates/agent-scores.md

@@ -0,0 +1,25 @@
+---
+artifact: agent_scores
+owner: architect-agent
+status: ongoing
+---
+
+# Agent Scores — <taskId>-<taskTitle>
+
+## Agent Identification (MANDATORY)
+First line of the document:
+`<icon> **<agent-name>**: <message>`
+
+## 1. Summary per Agent
+- **Agent A**
+  - scores: [taskId-score, ...]
+  - average: value
+- **Agent B**
+  - scores: [taskId-score, ...]
+  - average: value
+
+---
+
+## 2. Global Summary
+- Overall Task Average: value
+- Last Update: <ISO-8601>

package/dist/templates/agent-task.md

@@ -0,0 +1,106 @@
+---
+artifact: agent_task
+phase: phase-4-implementation
+owner: {{agent}}
+assigned_to: {{agent}}
+status: blocked | pending_reasoning_approval | in-progress | completed | failed
+related_task: {{taskId}}-{{taskTitle}}
+task_id: "{{taskId}}-{{N}}"
+---
+
+################################################################################
+# 🛑 SECURITY BLOCK: TASK NOT ACTIVATED                                        #
+################################################################################
+# Agent {{agent}} has been assigned to this task.                             #
+#                                                                              #
+# FORBIDDEN TO USE WRITING OR EXECUTION TOOLS (run, write, create).            #
+# Required action: Developer must respond with "YES" to activate.              #
+################################################################################
+
+# Agent Task — {{taskId}}-{{N}} ({{taskName}})
+
+## 1. Input (REQUIRED)
+- **Objective**: {{objective}}
+- **Scope**: {{scope}}
+- **Dependencies**: {{dependencies}}
+
+---
+
+## 2. Reasoning (AWAITING ACTIVATION)
+
+> [!IMPORTANT]
+> The agent **MUST** complete this section AFTER being activated (Gate A) and BEFORE executing (Gate B).
+
+### Objective Analysis
+- (What exactly is being requested?)
+
+### Options Considered
+- **Option A**: (description)
+- **Option B**: (description)
+
+### Decision Made
+- **Chosen Option**: (A/B)
+- **Justification**: (why)
+
+---
+
+## 3. Output (REQUIRED)
+- **Deliverables**:
+  - {{deliverables}}
+- **Required Evidence**:
+  - {{evidence}}
+
+---
+
+## 4. Implementation Report
+
+> This section is completed by the assigned agent during execution.
+
+### Changes Made
+- (Modified files, added functions, etc.)
+
+### Technical Decisions
+- (Key decisions and justification)
+
+### Evidence
+- (Logs, screenshots, executed tests)
+
+---
+
+## Gate A: Agent Activation (Handover)
+
+The developer **MUST** activate the agent before they can present their reasoning or use tools.
+
+```yaml
+activation:
+  agent: {{agent}}
+  assigned_by: architect-agent
+  decision: null # YES | NO
+```
+
+## Gate B: Reasoning Approval (Action Plan)
+
+The developer **MUST** approve the reasoning before the agent proceeds with the implementation.
+
+```yaml
+reasoning_approval:
+  agent: {{agent}}
+  decision: null # YES | NO
+```
+
+## Gate C: Results Approval (Closure)
+
+```yaml
+completion:
+  agent: {{agent}}
+  decision: null # YES | NO
+```
+
+---
+
+## Contractual Rules (AHRP)
+
+1. **Synchronous Gate A**: Forbidden to use tools without `YES` activation.
+2. **Synchronous Gate B**: Forbidden to modify code without `YES` Reasoning approval.
+3. **Metrics**: Failure of any Gate results in an immediate **Score of 0**.
+4. The assigned agent **CANNOT modify** the Input or Output defined by the architect.

package/dist/templates/analysis.md

@@ -0,0 +1,161 @@
+---
+artifact: analysis
+phase: phase-2-analysis
+owner: architect-agent
+status: draft | approved
+related_task: <taskId>-<taskTitle>
+---
+
+# Analysis — <taskId>-<taskTitle>
+
+## Agent Identification (MANDATORY)
+First line of the document:
+`<icon> **<agent-name>**: <message>`
+
+## 1. Executive Summary
+**Problem**
+- Briefly describe the problem the task solves.
+
+**Objective**
+- Main objective of the task (from `task.md`).
+
+**Success Criteria**
+- What conditions must be met for this analysis to be considered valid
+  (direct reference to acceptance criteria).
+
+---
+
+## 2. Project State (As-Is)
+Describe the actual state of the project **before implementing anything**.
+
+- **Relevant Structure**
+  - Affected folders, modules, drivers, or areas.
+- **Existing Drivers**
+  - Current state, responsibilities, and limitations.
+- **Core / Engine / Surfaces**
+  - Which parts of the core are involved (if applicable).
+- **Artifacts / Previous Tasks**
+  - Existing tasks that influence or condition this one.
+- **Detected Limitations**
+  - Technical, structural, or organizational limitations.
+
+---
+
+## 3. Acceptance Criteria Coverage
+For **each acceptance criteria** defined in `task.md`:
+
+### AC-X
+- **Interpretation**
+  - how this criterion is understood in the current context.
+- **Verification**
+  - how it will be verified that it is met.
+- **Risks / Ambiguities**
+  - what can fail or what might not be clear.
+
+(Repeat for all ACs)
+
+---
+
+## 4. Technical Research
+Analysis of possible alternatives and approaches.
+
+- **Alternative A**
+  - Description
+  - Pros
+  - Cons
+- **Alternative B**
+  - Description
+  - Pros
+  - Cons
+
+**Recommended Decision (if applicable)**
+- Preferred approach and justification.
+- If not yet decided, explain why.
+
+---
+
+## 5. Participating Agents
+Explicit list of agents required to execute the task.
+
+- **Agent A**
+  - Responsibilities
+  - Assigned sub-areas
+- **Agent B**
+  - Responsibilities
+  - Assigned sub-areas
+
+**Handoffs**
+- How information or results are transferred between agents.
+
+**Required Components**
+- Indicate if creating, modifying, or deleting components (drivers, modules, etc.) is required.
+- Reference the impact and dependency with the implementation plan.
+
+**Demo (if applicable)**
+- Indicate if a demo needs to be created.
+- Justify the need and alignment with `constitution.project_architecture`.
+
+---
+
+## 6. Task Impact
+Evaluation of the expected impact if the task is implemented.
+
+- **Architecture**
+  - Expected structural changes.
+- **APIs / Contracts**
+  - Changes to public interfaces (if applicable).
+- **Compatibility**
+  - Risks of breaking changes.
+- **Testing / Verification**
+  - What kind of tests will be necessary.
+
+---
+
+## 7. Risks and Mitigations
+- **Risk 1**
+  - Impact
+  - Mitigation
+- **Risk 2**
+  - Impact
+  - Mitigation
+
+---
+
+## 8. Open Questions
+(Only if any exist; ideally empty after Phase 0)
+
+- Question 1
+- Question 2
+
+---
+
+## 9. TODO Backlog (Mandatory Consultation)
+
+> [!IMPORTANT]
+> The architect-agent **MUST** consult `.agent/todo/` before completing the analysis.
+
+**Reference**: `.agent/todo/`
+
+**Current Status**: (empty | N pending items)
+
+**Items Relevant to this Task**:
+- (List backlog items that impact the current task)
+- (If no relevant items, state "None")
+
+**Impact on Analysis**:
+- (Describe how backlog items affect the proposed alternatives)
+
+---
+
+## 10. Approval
+This analysis **requires explicit developer approval**.
+
+```yaml
+approval:
+  developer:
+    decision: YES | NO
+    date: <ISO-8601>
+    comments: <optional>
+```
+
+> Without approval, this phase **CANNOT be considered complete** or move to Phase 3.

package/dist/templates/brief.md

@@ -0,0 +1,96 @@
+---
+artifact: brief
+phase: short-phase-1-brief
+owner: architect-agent
+status: draft | approved
+related_task: <taskId>-<taskTitle>
+---
+
+# Brief — <taskId>-<taskTitle>
+
+## Agent Identification (MANDATORY)
+First line of the document:
+`<icon> **<agent-name>**: <message>`
+
+## 1. Task Identification
+
+**Title**: <task title>
+**Objective**: <main objective>
+**Strategy**: Short
+
+---
+
+## 2. The 5 Mandatory Questions
+
+| # | Question (formulated by architect) | Answer (from developer) |
+|---|-----------------------------------|-------------------------|
+| 1 | | |
+| 2 | | |
+| 3 | | |
+| 4 | | |
+| 5 | | |
+
+---
+
+## 3. Acceptance Criteria
+
+Derived from the previous answers:
+
+1. **Scope**: 
+2. **Inputs/Data**: 
+3. **Expected Outputs**: 
+4. **Constraints**: 
+5. **Done Criteria**: 
+
+---
+
+## 4. Simplified Analysis
+
+### Current State (As-Is)
+- Affected structure:
+- Known limitations:
+
+### Complexity Evaluation
+
+| Indicator | Status | Comment |
+|-----------|--------|---------|
+| Affects more than 3 packages | ☐ Yes ☐ No | |
+| Requires API research | ☐ Yes ☐ No | |
+| Breaking changes | ☐ Yes ☐ No | |
+| Complex E2E tests | ☐ Yes ☐ No | |
+
+**Complexity Result**: ☐ LOW (continue Short) ☐ HIGH (recommend aborting to Long)
+
+---
+
+## 5. Implementation Plan
+
+### Ordered Steps
+
+1. **Step 1**
+   - Description:
+   - Deliverables:
+
+2. **Step 2**
+   - Description:
+   - Deliverables:
+
+(Add more steps as needed)
+
+### Planned Verification
+- Test types:
+- Success criteria:
+
+---
+
+## 6. Developer Approval (MANDATORY)
+
+```yaml
+approval:
+  developer:
+    decision: YES | NO
+    date: <ISO-8601>
+    comments: <optional>
+```
+
+> Without approval, this phase CANNOT move to Implementation.

package/dist/templates/changelog.md

@@ -0,0 +1,30 @@
+---
+artifact: changelog
+phase: phase-8-commit-push
+owner: architect-agent
+status: draft | approved
+related_task: <taskId>-<taskTitle>
+target_branch: <branch-name>
+---
+
+# Changelog — <taskId>-<taskTitle>
+
+## Agent Identification (MANDATORY)
+First line of the document:
+`<icon> **<agent-name>**: <message>`
+
+## 1. General Summary
+Short and clear description of the changes introduced by this task.
+
+- **Task Objective**:
+- **Main Impact**:
+- **Affected Areas** (modules, drivers, workflows, etc.):
+
+---
+
+## 2. Included Commits
+Full and ordered list of commits performed.
+
+### Commit 1
+- **Hash**: `<commit-hash>`
+- **Message (Conventional Commit)**:

package/dist/templates/closure.md

@@ -0,0 +1,87 @@
+---
+artifact: closure
+phase: short-phase-3-closure
+owner: architect-agent
+status: draft | approved
+related_task: <taskId>-<taskTitle>
+---
+
+# Closure — <taskId>-<taskTitle>
+
+## Agent Identification (MANDATORY)
+First line of the document:
+`<icon> **<agent-name>**: <message>`
+
+## 1. Task Summary
+
+**Title**: <title>
+**Strategy**: Short
+**Final Status**: ☐ Completed ☐ Aborted
+
+---
+
+## 2. Verification
+
+### Executed Tests
+
+| Type | Command/Method | Result |
+|------|----------------|--------|
+| Unit | | ☐ Pass ☐ Fail ☐ N/A |
+| Integration | | ☐ Pass ☐ Fail ☐ N/A |
+| E2E | | ☐ Pass ☐ Fail ☐ N/A |
+
+### Justification (if no tests)
+<Explain why tests do not apply>
+
+---
+
+## 3. Acceptance Criteria Status
+
+| AC | Description | Status |
+|----|-------------|--------|
+| 1 | | ☐ ✅ ☐ ❌ |
+| 2 | | ☐ ✅ ☐ ❌ |
+| 3 | | ☐ ✅ ☐ ❌ |
+| 4 | | ☐ ✅ ☐ ❌ |
+| 5 | | ☐ ✅ ☐ ❌ |
+
+---
+
+## 4. Changes Made
+
+### Modified/Created Files
+
+| File | Action | Description |
+|------|--------|-------------|
+| | Created/Modified/Deleted | |
+
+### Commits (if applicable)
+
+```
+<type>(<scope>): <description>
+```
+
+---
+
+## 5. Developer's Final Acceptance (MANDATORY)
+
+```yaml
+approval:
+  developer:
+    decision: YES | NO
+    date: <ISO-8601>
+    comments: <optional>
+```
+
+> Without acceptance, the task CANNOT be marked as completed.
+
+---
+
+## 6. Final Push (if applicable)
+
+```yaml
+push:
+  approved: YES | NO
+  branch: <target branch>
+  date: <ISO-8601>
+```

package/dist/templates/index.md

@@ -0,0 +1,45 @@
+---
+id: templates.index
+owner: architect-agent
+version: 1.0.0
+severity: PERMANENT
+---
+
+# INDEX — Templates
+
+## Agent Identification (MANDATORY)
+First line of the document:
+`<icon> **<agent-name>**: <message>`
+ (Agentic System)
+
+## Objective
+Enumerate the contractual templates of the agentic system.
+Must be referenced via aliases.
+
+## Aliases (YAML)
+```yaml
+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
+
+  # Short Cycle
+  brief: .agent/templates/brief.md
+  closure: .agent/templates/closure.md
+```
+
+## Rules
+- Any new template **MUST** be added here.

package/dist/templates/init.md

@@ -0,0 +1,26 @@
+# init bootstrap
+
+## Agent Identification (MANDATORY)
+First line of the document:
+`<icon> **<agent-name>**: <message>`
+
+- command: {{command}}
+- role.architect: {{architectAgentId}}
+- constitution.loaded.in_context: true
+
+## Constitution (load order)
+1. {{constitutionPaths[0]}}
+2. {{constitutionPaths[1]}}
+3. {{constitutionPaths[2]}}
+
+```yaml
+bootstrap:
+  done: true
+roles:
+  architect: {{architectAgentId}}
+constitution:
+  loaded:
+    - {{constitutionPaths[0]}}
+    - {{constitutionPaths[1]}}
+    - {{constitutionPaths[2]}}
+```