takt 0.1.3 → 0.1.5

package/resources/global/en/workflows/expert-review.yaml

@@ -9,6 +9,16 @@
 # Fix destination is determined by Coder based on change impact:
 # - fix_security: MINOR→security_review, MAJOR→cqrs_es_review
 # - fix_qa: MINOR→qa_review, SECURITY→security_review, MAJOR→cqrs_es_review
+#
+# Template Variables:
+#   {iteration}      - Workflow-wide turn count (total steps executed across all agents)
+#   {max_iterations} - Maximum iterations allowed for the workflow
+#   {step_iteration} - Per-step iteration count (how many times THIS step has been executed)
+#   {task}           - Original user request
+#   {previous_response} - Output from the previous step
+#   {git_diff}       - Current uncommitted changes (git diff)
+#   {user_inputs}    - Accumulated user inputs during workflow
+#   {report_dir}     - Report directory name (e.g., "20250126-143052-task-summary")
 
 name: expert-review
 description: CQRS+ES, Frontend, Security, QA Expert Review
@@ -30,9 +40,22 @@ steps:
       - Bash
       - WebSearch
       - WebFetch
+    status_rules_prompt: |
+      # ⚠️ REQUIRED: Status Output Rules ⚠️
+
+      **Without this tag, the workflow will stop.**
+      Your final output MUST include a status tag following the rules below.
+
+      ## Output Format
+
+      | Situation | Tag |
+      |-----------|-----|
+      | Analysis complete | `[PLANNER:DONE]` |
+      | Requirements unclear | `[PLANNER:BLOCKED]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations} (workflow-wide)
+      - Step Iteration: {step_iteration} (times this step has run)
       - Step: plan (Task Analysis)
       - Report Directory: .takt/reports/{report_dir}/
       - Report File: .takt/reports/{report_dir}/00-plan.md
@@ -56,7 +79,7 @@ steps:
 
       **Report output:** Output to the `Report File` specified above.
       - If file does not exist: Create new file
-      - If file exists: Append with `## Iteration {iteration}` section
+      - If file exists: Append with `## Iteration {step_iteration}` section
 
       **Report format:**
       ```markdown
@@ -103,9 +126,22 @@ steps:
       - Bash
       - WebSearch
       - WebFetch
+    status_rules_prompt: |
+      # ⚠️ REQUIRED: Status Output Rules ⚠️
+
+      **Without this tag, the workflow will stop.**
+      Your final output MUST include a status tag following the rules below.
+
+      ## Output Format
+
+      | Situation | Tag |
+      |-----------|-----|
+      | Implementation complete | `[CODER:DONE]` |
+      | Cannot proceed | `[CODER:BLOCKED]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations} (workflow-wide)
+      - Step Iteration: {step_iteration} (times this step has run)
       - Step: implement
       - Report Directory: .takt/reports/{report_dir}/
       - Report Files:
@@ -124,7 +160,7 @@ steps:
 
       **Report output:** Output to the `Report Files` specified above.
       - If file does not exist: Create new file
-      - If file exists: Append with `## Iteration {iteration}` section
+      - If file exists: Append with `## Iteration {step_iteration}` section
 
       **Scope report format (create at implementation start):**
       ```markdown
@@ -175,9 +211,22 @@ steps:
       - Grep
       - WebSearch
       - WebFetch
+    status_rules_prompt: |
+      # ⚠️ REQUIRED: Status Output Rules ⚠️
+
+      **Without this tag, the workflow will stop.**
+      Your final output MUST include a status tag following the rules below.
+
+      ## Output Format
+
+      | Situation | Tag |
+      |-----------|-----|
+      | Design is sound | `[CQRS-ES:APPROVE]` |
+      | Design issues found | `[CQRS-ES:REJECT]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations} (workflow-wide)
+      - Step Iteration: {step_iteration} (times this step has run)
       - Step: cqrs_es_review (CQRS+ES Expert Review)
       - Report Directory: .takt/reports/{report_dir}/
       - Report File: .takt/reports/{report_dir}/03-cqrs-es-review.md
@@ -206,7 +255,7 @@ steps:
 
       **Report output:** Output to the `Report File` specified above.
       - If file does not exist: Create new file
-      - If file exists: Append with `## Iteration {iteration}` section
+      - If file exists: Append with `## Iteration {step_iteration}` section
 
       **Report format:**
       ```markdown
@@ -252,9 +301,22 @@ steps:
       - Bash
       - WebSearch
       - WebFetch
+    status_rules_prompt: |
+      # ⚠️ REQUIRED: Status Output Rules ⚠️
+
+      **Without this tag, the workflow will stop.**
+      Your final output MUST include a status tag following the rules below.
+
+      ## Output Format
+
+      | Situation | Tag |
+      |-----------|-----|
+      | Fix complete | `[CODER:DONE]` |
+      | Cannot proceed | `[CODER:BLOCKED]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations} (workflow-wide)
+      - Step Iteration: {step_iteration} (times this step has run)
       - Step: fix_cqrs_es
 
       ## CQRS+ES Review Feedback (This is the latest instruction - prioritize this)
@@ -296,9 +358,22 @@ steps:
       - Grep
       - WebSearch
       - WebFetch
+    status_rules_prompt: |
+      # ⚠️ REQUIRED: Status Output Rules ⚠️
+
+      **Without this tag, the workflow will stop.**
+      Your final output MUST include a status tag following the rules below.
+
+      ## Output Format
+
+      | Situation | Tag |
+      |-----------|-----|
+      | Frontend design is sound | `[FRONTEND:APPROVE]` |
+      | Design issues found | `[FRONTEND:REJECT]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations} (workflow-wide)
+      - Step Iteration: {step_iteration} (times this step has run)
       - Step: frontend_review (Frontend Expert Review)
       - Report Directory: .takt/reports/{report_dir}/
       - Report File: .takt/reports/{report_dir}/04-frontend-review.md
@@ -327,7 +402,7 @@ steps:
 
       **Report output:** Output to the `Report File` specified above.
       - If file does not exist: Create new file
-      - If file exists: Append with `## Iteration {iteration}` section
+      - If file exists: Append with `## Iteration {step_iteration}` section
 
       **Report format:**
       ```markdown
@@ -373,9 +448,22 @@ steps:
       - Bash
       - WebSearch
       - WebFetch
+    status_rules_prompt: |
+      # ⚠️ REQUIRED: Status Output Rules ⚠️
+
+      **Without this tag, the workflow will stop.**
+      Your final output MUST include a status tag following the rules below.
+
+      ## Output Format
+
+      | Situation | Tag |
+      |-----------|-----|
+      | Fix complete | `[CODER:DONE]` |
+      | Cannot proceed | `[CODER:BLOCKED]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations} (workflow-wide)
+      - Step Iteration: {step_iteration} (times this step has run)
       - Step: fix_frontend
 
       ## Frontend Review Feedback (This is the latest instruction - prioritize this)
@@ -417,9 +505,22 @@ steps:
       - Grep
       - WebSearch
       - WebFetch
+    status_rules_prompt: |
+      # ⚠️ REQUIRED: Status Output Rules ⚠️
+
+      **Without this tag, the workflow will stop.**
+      Your final output MUST include a status tag following the rules below.
+
+      ## Output Format
+
+      | Situation | Tag |
+      |-----------|-----|
+      | No AI-specific issues | `[AI_REVIEW:APPROVE]` |
+      | Issues found | `[AI_REVIEW:REJECT]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations} (workflow-wide)
+      - Step Iteration: {step_iteration} (times this step has run)
       - Step: ai_review (AI-Generated Code Review)
       - Report Directory: .takt/reports/{report_dir}/
       - Report File: .takt/reports/{report_dir}/05-ai-review.md
@@ -441,7 +542,7 @@ steps:
 
       **Report output:** Output to the `Report File` specified above.
       - If file does not exist: Create new file
-      - If file exists: Append with `## Iteration {iteration}` section
+      - If file exists: Append with `## Iteration {step_iteration}` section
 
       **Report format:**
       ```markdown
@@ -490,9 +591,22 @@ steps:
       - Bash
       - WebSearch
       - WebFetch
+    status_rules_prompt: |
+      # ⚠️ REQUIRED: Status Output Rules ⚠️
+
+      **Without this tag, the workflow will stop.**
+      Your final output MUST include a status tag following the rules below.
+
+      ## Output Format
+
+      | Situation | Tag |
+      |-----------|-----|
+      | Fix complete | `[CODER:DONE]` |
+      | Cannot proceed | `[CODER:BLOCKED]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations} (workflow-wide)
+      - Step Iteration: {step_iteration} (times this step has run)
       - Step: ai_fix
 
       ## AI Review Feedback (This is the latest instruction - prioritize this)
@@ -532,9 +646,22 @@ steps:
       - Grep
       - WebSearch
       - WebFetch
+    status_rules_prompt: |
+      # ⚠️ REQUIRED: Status Output Rules ⚠️
+
+      **Without this tag, the workflow will stop.**
+      Your final output MUST include a status tag following the rules below.
+
+      ## Output Format
+
+      | Situation | Tag |
+      |-----------|-----|
+      | No security issues | `[SECURITY:APPROVE]` |
+      | Vulnerabilities found | `[SECURITY:REJECT]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations} (workflow-wide)
+      - Step Iteration: {step_iteration} (times this step has run)
       - Step: security_review (Security Expert Review)
       - Report Directory: .takt/reports/{report_dir}/
       - Report File: .takt/reports/{report_dir}/06-security-review.md
@@ -559,7 +686,7 @@ steps:
 
       **Report output:** Output to the `Report File` specified above.
       - If file does not exist: Create new file
-      - If file exists: Append with `## Iteration {iteration}` section
+      - If file exists: Append with `## Iteration {step_iteration}` section
 
       **Report format:**
       ```markdown
@@ -606,9 +733,23 @@ steps:
       - Bash
       - WebSearch
       - WebFetch
+    status_rules_prompt: |
+      # ⚠️ REQUIRED: Status Output Rules ⚠️
+
+      **Without this tag, the workflow will stop.**
+      Your final output MUST include a status tag following the rules below.
+
+      ## Output Format
+
+      | Situation | Tag |
+      |-----------|-----|
+      | Minor fix complete | `[CODER:DONE]` |
+      | Major fix (restart from CQRS+ES) | `[CODER:REJECT]` |
+      | Cannot proceed | `[CODER:BLOCKED]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations} (workflow-wide)
+      - Step Iteration: {step_iteration} (times this step has run)
       - Step: fix_security
 
       ## Security Review Feedback (This is the latest instruction - prioritize this)
@@ -659,9 +800,22 @@ steps:
       - Grep
       - WebSearch
       - WebFetch
+    status_rules_prompt: |
+      # ⚠️ REQUIRED: Status Output Rules ⚠️
+
+      **Without this tag, the workflow will stop.**
+      Your final output MUST include a status tag following the rules below.
+
+      ## Output Format
+
+      | Situation | Tag |
+      |-----------|-----|
+      | Quality standards met | `[QA:APPROVE]` |
+      | Quality issues found | `[QA:REJECT]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations} (workflow-wide)
+      - Step Iteration: {step_iteration} (times this step has run)
       - Step: qa_review (QA Expert Review)
       - Report Directory: .takt/reports/{report_dir}/
       - Report File: .takt/reports/{report_dir}/07-qa-review.md
@@ -687,7 +841,7 @@ steps:
 
       **Report output:** Output to the `Report File` specified above.
       - If file does not exist: Create new file
-      - If file exists: Append with `## Iteration {iteration}` section
+      - If file exists: Append with `## Iteration {step_iteration}` section
 
       **Report format:**
       ```markdown
@@ -733,9 +887,24 @@ steps:
       - Bash
       - WebSearch
       - WebFetch
+    status_rules_prompt: |
+      # ⚠️ REQUIRED: Status Output Rules ⚠️
+
+      **Without this tag, the workflow will stop.**
+      Your final output MUST include a status tag following the rules below.
+
+      ## Output Format
+
+      | Situation | Tag |
+      |-----------|-----|
+      | Minor fix complete | `[CODER:DONE]` |
+      | Security-impacting fix | `[CODER:IMPROVE]` |
+      | Major fix (restart from CQRS+ES) | `[CODER:REJECT]` |
+      | Cannot proceed | `[CODER:BLOCKED]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations} (workflow-wide)
+      - Step Iteration: {step_iteration} (times this step has run)
       - Step: fix_qa
 
       ## QA Review Feedback (This is the latest instruction - prioritize this)
@@ -790,9 +959,22 @@ steps:
       - Grep
       - WebSearch
       - WebFetch
+    status_rules_prompt: |
+      # ⚠️ REQUIRED: Status Output Rules ⚠️
+
+      **Without this tag, the workflow will stop.**
+      Your final output MUST include a status tag following the rules below.
+
+      ## Output Format
+
+      | Situation | Tag |
+      |-----------|-----|
+      | Ready to merge | `[SUPERVISOR:APPROVE]` |
+      | Issues found | `[SUPERVISOR:REJECT]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations} (workflow-wide)
+      - Step Iteration: {step_iteration} (times this step has run)
       - Step: supervise (Final Review)
       - Report Directory: .takt/reports/{report_dir}/
       - Report Files:
@@ -828,7 +1010,7 @@ steps:
 
       **Report output:** Output to the `Report Files` specified above.
       - If file does not exist: Create new file
-      - If file exists: Append with `## Iteration {iteration}` section
+      - If file exists: Append with `## Iteration {step_iteration}` section
 
       **Validation report format:**
       ```markdown
@@ -906,9 +1088,22 @@ steps:
       - Bash
       - WebSearch
       - WebFetch
+    status_rules_prompt: |
+      # ⚠️ REQUIRED: Status Output Rules ⚠️
+
+      **Without this tag, the workflow will stop.**
+      Your final output MUST include a status tag following the rules below.
+
+      ## Output Format
+
+      | Situation | Tag |
+      |-----------|-----|
+      | Fix complete | `[CODER:DONE]` |
+      | Cannot proceed | `[CODER:BLOCKED]` |
     instruction_template: |
       ## Workflow Context
-      - Iteration: {iteration}/{max_iterations}
+      - Iteration: {iteration}/{max_iterations} (workflow-wide)
+      - Step Iteration: {step_iteration} (times this step has run)
       - Step: fix_supervisor
 
       ## Supervisor Feedback (This is the latest instruction - prioritize this)

package/resources/global/en/workflows/magi.yaml

@@ -1,6 +1,16 @@
 # MAGI System Workflow
 # A deliberation workflow modeled after Evangelion's MAGI system
 # Three personas (scientist, nurturer, pragmatist) analyze from different perspectives and vote
+#
+# Template Variables:
+#   {iteration}      - Workflow-wide turn count (total steps executed across all agents)
+#   {max_iterations} - Maximum iterations allowed for the workflow
+#   {step_iteration} - Per-step iteration count (how many times THIS step has been executed)
+#   {task}           - Original user request
+#   {previous_response} - Output from the previous step
+#   {git_diff}       - Current uncommitted changes (git diff)
+#   {user_inputs}    - Accumulated user inputs during workflow
+#   {report_dir}     - Report directory name (e.g., "20250126-143052-task-summary")
 
 name: magi
 description: MAGI Deliberation System - Analyze from 3 perspectives and decide by majority
@@ -16,6 +26,27 @@ steps:
       - Grep
       - WebSearch
       - WebFetch
+    status_rules_prompt: |
+      # ⚠️ REQUIRED: Status Output Rules ⚠️
+
+      **Without this tag, the workflow will stop.**
+      Your final output MUST include a status tag following the rules below.
+
+      ## Output Format
+
+      | Judgment | Tag |
+      |----------|-----|
+      | In favor | `[MELCHIOR:APPROVE]` |
+      | Against | `[MELCHIOR:REJECT]` |
+      | Conditional approval | `[MELCHIOR:CONDITIONAL]` |
+
+      ### Output Example
+
+      ```
+      [MELCHIOR:APPROVE]
+
+      Reason: {Reason for approval}
+      ```
     instruction_template: |
       # MAGI System Initiated
 
@@ -25,11 +56,6 @@ steps:
       ## Instructions
       You are MELCHIOR-1 of the MAGI System.
       Analyze the above from the perspective of a scientist/engineer and render your judgment.
-
-      Your judgment must be one of:
-      - [MELCHIOR:APPROVE] - In favor
-      - [MELCHIOR:REJECT] - Against
-      - [MELCHIOR:CONDITIONAL] - Conditional approval
     transitions:
       - condition: always
         next_step: balthasar
@@ -42,6 +68,27 @@ steps:
       - Grep
       - WebSearch
       - WebFetch
+    status_rules_prompt: |
+      # ⚠️ REQUIRED: Status Output Rules ⚠️
+
+      **Without this tag, the workflow will stop.**
+      Your final output MUST include a status tag following the rules below.
+
+      ## Output Format
+
+      | Judgment | Tag |
+      |----------|-----|
+      | In favor | `[BALTHASAR:APPROVE]` |
+      | Against | `[BALTHASAR:REJECT]` |
+      | Conditional approval | `[BALTHASAR:CONDITIONAL]` |
+
+      ### Output Example
+
+      ```
+      [BALTHASAR:APPROVE]
+
+      Reason: {Reason for approval}
+      ```
     instruction_template: |
       # MAGI System Continuing
 
@@ -55,11 +102,6 @@ steps:
       You are BALTHASAR-2 of the MAGI System.
       Analyze the above from the perspective of a nurturer and render your judgment.
       Consider MELCHIOR's judgment as reference, but make your own independent assessment.
-
-      Your judgment must be one of:
-      - [BALTHASAR:APPROVE] - In favor
-      - [BALTHASAR:REJECT] - Against
-      - [BALTHASAR:CONDITIONAL] - Conditional approval
     pass_previous_response: true
     transitions:
       - condition: always
@@ -73,28 +115,24 @@ steps:
       - Grep
       - WebSearch
       - WebFetch
-    instruction_template: |
-      # MAGI System Final Deliberation
+    status_rules_prompt: |
+      # ⚠️ REQUIRED: Status Output Rules ⚠️
 
-      ## Matter for Deliberation
-      {task}
+      **Without this tag, the workflow will stop.**
+      Your final output MUST include a status tag following the rules below.
 
-      ## Previous Judgments
-      {previous_response}
+      ## Output Format
 
-      ## Instructions
-      You are CASPER-3 of the MAGI System.
-      Analyze the above from a practical/realistic perspective and render your judgment.
+      Final conclusion by majority vote:
 
-      **Finally, tally the judgments from all three and provide the final conclusion.**
+      | Judgment | Tag |
+      |----------|-----|
+      | Approved (2+ in favor) | `[MAGI:APPROVE]` |
+      | Rejected (2+ against) | `[MAGI:REJECT]` |
+      | Conditional approval | `[MAGI:CONDITIONAL]` |
 
-      ### Final Conclusion (Required)
-      Determine the final judgment by majority vote:
-      - [MAGI:APPROVE] - Approved (2 or more in favor)
-      - [MAGI:REJECT] - Rejected (2 or more against)
-      - [MAGI:CONDITIONAL] - Conditional approval (majority conditional or split opinions)
+      ### Output Example
 
-      **Final Conclusion Format Example:**
       ```
       ## MAGI System Final Judgment
 
@@ -108,6 +146,20 @@ steps:
 
       [Reasoning/Summary]
       ```
+    instruction_template: |
+      # MAGI System Final Deliberation
+
+      ## Matter for Deliberation
+      {task}
+
+      ## Previous Judgments
+      {previous_response}
+
+      ## Instructions
+      You are CASPER-3 of the MAGI System.
+      Analyze the above from a practical/realistic perspective and render your judgment.
+
+      **Finally, tally the judgments from all three and provide the final conclusion.**
     pass_previous_response: true
     transitions:
       - condition: always