takt 0.2.3 → 0.3.1

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

@@ -1,19 +1,23 @@
 # Simple TAKT Workflow
-# Plan -> Coder -> Architect Review -> AI Review -> Supervisor Approval
-# (Simplified version of default - removed improve, fix, ai_fix, security_review, security_fix)
+# Plan -> Implement -> AI Review -> Architect Review -> Supervisor Approval
 #
-# 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")
+# Template Variables (auto-injected by engine):
+#   {iteration}          - Workflow-wide turn count
+#   {max_iterations}     - Maximum iterations allowed
+#   {step_iteration}     - Per-step iteration count
+#   {task}               - Original user request
+#   {previous_response}  - Output from the previous step
+#   {user_inputs}        - Accumulated user inputs during workflow
+#   {report_dir}         - Report directory name
+#
+# Auto-injected sections (do NOT include in instruction_template):
+#   ## Workflow Context       - iteration, step_iteration, report info
+#   ## User Request           - {task}
+#   ## Previous Response      - {previous_response}
+#   ## Additional User Inputs - {user_inputs}
 
 name: simple
-description: Simplified development workflow (plan -> implement -> review -> ai_review -> supervise)
+description: Simplified development workflow (plan -> implement -> ai_review -> review -> supervise)
 
 max_iterations: 20
 
@@ -21,7 +25,31 @@ initial_step: plan
 
 steps:
   - name: plan
-    agent: ~/.takt/agents/default/planner.md
+    edit: false
+    agent: ../agents/default/planner.md
+    report:
+      name: 00-plan.md
+      format: |
+        ```markdown
+        # Task Plan
+
+        ## Original Request
+        {User's request as-is}
+
+        ## Analysis Results
+
+        ### Objective
+        {What needs to be achieved}
+
+        ### Scope
+        {Impact scope}
+
+        ### Implementation Approach
+        {How to proceed}
+
+        ## Clarifications Needed (if any)
+        - {Unclear points or items requiring confirmation}
+        ```
     allowed_tools:
       - Read
       - Glob
@@ -30,67 +58,20 @@ steps:
       - Bash
       - WebSearch
       - WebFetch
-    status_rules_prompt: |
-      ## Judgment Criteria
-
-      | Situation | Judgment |
-      |-----------|----------|
-      | Requirements clear and implementable | DONE |
-      | User is asking a question (not an implementation task) | ANSWER |
-      | Requirements unclear, insufficient info | BLOCKED |
-
-      ## Output Format
-
-      | Situation | Tag |
-      |-----------|-----|
-      | Analysis complete | `[PLANNER:DONE]` |
-      | Question answered | `[PLANNER:ANSWER]` |
-      | Insufficient info | `[PLANNER:BLOCKED]` |
-
-      ### Output Examples
-
-      **DONE case:**
-      ```
-      [PLANNER:DONE]
-      ```
-
-      **ANSWER case:**
-      ```
-      {Answer to the question}
-
-      [PLANNER:ANSWER]
-      ```
-
-      **BLOCKED case:**
-      ```
-      [PLANNER:BLOCKED]
-
-      Clarifications needed:
-      - {Question 1}
-      - {Question 2}
-      ```
+    rules:
+      - condition: Requirements are clear and implementable
+        next: implement
+      - condition: User is asking a question
+        next: COMPLETE
+      - condition: Requirements unclear, insufficient info
+        next: ABORT
+    pass_previous_response: true
     instruction_template: |
-      ## Workflow Context
-      - 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
-
-      ## User Request
-      {task}
-
       ## Previous Response (when returned from implement)
       {previous_response}
 
-      ## Instructions
       Analyze the task and create an implementation plan.
 
-      **Judgment criteria:**
-      - If the user input is an implementation task → create a plan and output `[PLANNER:DONE]`
-      - If the user input is a question → research, answer, and output `[PLANNER:ANSWER]`
-      - If there is insufficient information → output `[PLANNER:BLOCKED]`
-
       **Note:** If returned from implement step (Previous Response exists),
       review and revise the plan based on that feedback (replan).
 
@@ -99,42 +80,12 @@ steps:
       2. Identify impact scope
       3. Decide implementation approach
 
-      **Report output:** Output to the `Report File` specified above.
-      - If file does not exist: Create new file
-      - If file exists: Append with `## Iteration {step_iteration}` section
-
-      **Report format:**
-      ```markdown
-      # Task Plan
-
-      ## Original Request
-      {User's request as-is}
-
-      ## Analysis Results
-
-      ### Objective
-      {What needs to be achieved}
-
-      ### Scope
-      {Impact scope}
-
-      ### Implementation Approach
-      {How to proceed}
-
-      ## Clarifications Needed (if any)
-      - {Unclear points or items requiring confirmation}
-      ```
-    pass_previous_response: true
-    transitions:
-      - condition: done
-        next_step: implement
-      - condition: answer
-        next_step: COMPLETE
-      - condition: blocked
-        next_step: ABORT
-
   - name: implement
-    agent: ~/.takt/agents/default/coder.md
+    edit: true
+    agent: ../agents/default/coder.md
+    report:
+      - Scope: 01-coder-scope.md
+      - Decisions: 02-coder-decisions.md
     allowed_tools:
       - Read
       - Glob
@@ -145,58 +96,15 @@ steps:
       - WebSearch
       - WebFetch
     permission_mode: acceptEdits
-    status_rules_prompt: |
-      ## Output Format
-
-      | Situation | Tag |
-      |-----------|-----|
-      | Implementation complete | `[CODER:DONE]` |
-      | Cannot decide/insufficient info | `[CODER:BLOCKED]` |
-
-      **Important**: When in doubt, `[BLOCKED]`. Don't decide on your own.
-
-      ### Output Examples
-
-      **DONE case:**
-      ```
-      Implementation complete.
-      - Created: `src/auth/service.ts`, `tests/auth.test.ts`
-      - Modified: `src/routes.ts`
-
-      [CODER:DONE]
-      ```
-
-      **BLOCKED case:**
-      ```
-      [CODER:BLOCKED]
-
-      Reason: DB schema is undefined, cannot implement
-      Required info: users table structure
-      ```
+    rules:
+      - condition: Implementation complete
+        next: ai_review
+      - condition: Cannot proceed, insufficient info
+        next: plan
     instruction_template: |
-      ## Workflow Context
-      - 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:
-        - Scope: .takt/reports/{report_dir}/01-coder-scope.md
-        - Decisions: .takt/reports/{report_dir}/02-coder-decisions.md
-
-      ## User Request
-      {task}
-
-      ## Additional User Inputs
-      {user_inputs}
-
-      ## Instructions
       Follow the plan from the plan step and implement.
       Refer to the plan report (00-plan.md) and proceed with implementation.
 
-      **Report output:** Output to the `Report Files` specified above.
-      - If file does not exist: Create new file
-      - If file exists: Append with `## Iteration {step_iteration}` section
-
       **Scope report format (create at implementation start):**
       ```markdown
       # Change Scope Declaration
@@ -226,14 +134,38 @@ steps:
       - **Options Considered**: {List of options}
       - **Reason**: {Why this option was chosen}
       ```
-    transitions:
-      - condition: done
-        next_step: review
-      - condition: blocked
-        next_step: plan
 
-  - name: review
-    agent: ~/.takt/agents/default/architect.md
+  - name: ai_review
+    edit: false
+    agent: ../agents/default/ai-antipattern-reviewer.md
+    report:
+      name: 03-ai-review.md
+      format: |
+        ```markdown
+        # AI-Generated Code Review
+
+        ## Result: APPROVE / REJECT
+
+        ## Summary
+        {One sentence summarizing result}
+
+        ## Verified Items
+        | Aspect | Result | Notes |
+        |--------|--------|-------|
+        | Assumption validity | ✅ | - |
+        | API/Library existence | ✅ | - |
+        | Context fit | ✅ | - |
+        | Scope | ✅ | - |
+
+        ## Issues (if REJECT)
+        | # | Category | Location | Issue |
+        |---|----------|----------|-------|
+        | 1 | Hallucinated API | `src/file.ts:23` | Non-existent method |
+        ```
+
+        **Cognitive load reduction rules:**
+        - No issues -> Summary 1 line + check table only (10 lines or less)
+        - Issues found -> + Issues in table format (25 lines or less)
     allowed_tools:
       - Read
       - Glob
@@ -241,110 +173,50 @@ steps:
       - Write
       - WebSearch
       - WebFetch
-    status_rules_prompt: |
-      ## Judgment Criteria
-
-      | Situation | Judgment |
-      |-----------|----------|
-      | Structural issues | REJECT |
-      | Design principle violations | REJECT |
-      | Security issues | REJECT |
-      | Insufficient tests | REJECT |
-      | No issues | APPROVE |
-
-      **Note:** In simple workflow, IMPROVE is not used.
-      If there are minor suggestions, use APPROVE + comments.
-
-      ## Output Format
-
-      | Situation | Tag |
-      |-----------|-----|
-      | No issues | `[ARCHITECT:APPROVE]` |
-      | Structural changes required | `[ARCHITECT:REJECT]` |
-
-      ### Output Examples
-
-      **APPROVE case:**
-      ```
-      [ARCHITECT:APPROVE]
-
-      Positive points:
-      - Appropriate module organization
-      - Single responsibility maintained
-      ```
-
-      **REJECT case:**
-      ```
-      [ARCHITECT:REJECT]
-
-      Issues:
-      1. File size exceeded
-         - Location: `src/services/user.ts` (523 lines)
-         - Fix: Split into 3 files
-      ```
+    rules:
+      - condition: No AI-specific issues
+        next: review
+      - condition: AI-specific issues found
+        next: plan
     instruction_template: |
-      ## Workflow Context
-      - Iteration: {iteration}/{max_iterations} (workflow-wide)
-      - Step Iteration: {step_iteration} (times this step has run)
-      - Step: review (Architecture Review)
-      - Report Directory: .takt/reports/{report_dir}/
-      - Report File: .takt/reports/{report_dir}/03-architect-review.md
-
-      ## Original User Request (Initial request from workflow start)
-      {task}
-
-      ## Git Diff
-      ```diff
-      {git_diff}
-      ```
-
-      ## Instructions
-      Focus on **architecture and design** review. Do NOT review AI-specific issues (that's the next step).
-
-      Review the changes and provide feedback.
-
-      **Note:** In simple workflow, IMPROVE judgment is not used.
-      If there are minor suggestions, use APPROVE + comments.
-
-      **Report output:** Output to the `Report File` specified above.
-      - If file does not exist: Create new file
-      - If file exists: Append with `## Iteration {step_iteration}` section
-
-      **Report format:**
-      ```markdown
-      # Architecture Review
-
-      ## Result: APPROVE / REJECT
-
-      ## Summary
-      {1-2 sentences summarizing result}
-
-      ## Reviewed Perspectives
-      - [x] Structure & Design
-      - [x] Code Quality
-      - [x] Change Scope
-
-      ## Issues (if REJECT)
-      | # | Location | Issue | Fix |
-      |---|----------|-------|-----|
-      | 1 | `src/file.ts:42` | Issue description | Fix method |
-
-      ## Improvement Suggestions (optional, non-blocking)
-      - {Future improvement suggestions}
-      ```
-
-      **Cognitive load reduction rules:**
-      - APPROVE + no issues → Summary only (5 lines or less)
-      - APPROVE + minor suggestions → Summary + suggestions (15 lines or less)
-      - REJECT → Issues in table format (30 lines or less)
-    transitions:
-      - condition: approved
-        next_step: ai_review
-      - condition: rejected
-        next_step: plan
+      Review the code for AI-specific issues:
+      - Assumption validation
+      - Plausible but wrong patterns
+      - Context fit with existing codebase
+      - Scope creep detection
 
-  - name: ai_review
-    agent: ~/.takt/agents/default/ai-antipattern-reviewer.md
+  - name: review
+    edit: false
+    agent: ../agents/default/architecture-reviewer.md
+    report:
+      name: 04-architect-review.md
+      format: |
+        ```markdown
+        # Architecture Review
+
+        ## Result: APPROVE / REJECT
+
+        ## Summary
+        {1-2 sentences summarizing result}
+
+        ## Reviewed Perspectives
+        - [x] Structure & Design
+        - [x] Code Quality
+        - [x] Change Scope
+
+        ## Issues (if REJECT)
+        | # | Location | Issue | Fix |
+        |---|----------|-------|-----|
+        | 1 | `src/file.ts:42` | Issue description | Fix method |
+
+        ## Improvement Suggestions (optional, non-blocking)
+        - {Future improvement suggestions}
+        ```
+
+        **Cognitive load reduction rules:**
+        - APPROVE + no issues -> Summary only (5 lines or less)
+        - APPROVE + minor suggestions -> Summary + suggestions (15 lines or less)
+        - REJECT -> Issues in table format (30 lines or less)
     allowed_tools:
       - Read
       - Glob
@@ -352,104 +224,25 @@ steps:
       - Write
       - WebSearch
       - WebFetch
-    status_rules_prompt: |
-      ## Judgment Criteria
-
-      | Situation | Judgment |
-      |-----------|----------|
-      | Incorrect assumptions (affecting behavior) | REJECT |
-      | Plausible-but-wrong code | REJECT |
-      | Significant context mismatch with codebase | REJECT |
-      | Scope creep | APPROVE (with warning noted) |
-      | Minor style deviations only | APPROVE |
-      | Code fits context and works | APPROVE |
-
-      **Note:** Scope creep is noted as a warning but doesn't warrant REJECT alone.
-
-      ## Output Format
-
-      | Situation | Tag |
-      |-----------|-----|
-      | No AI-specific issues | `[AI_REVIEW:APPROVE]` |
-      | Issues found | `[AI_REVIEW:REJECT]` |
-
-      ### Output Examples
-
-      **APPROVE case:**
-      ```
-      [AI_REVIEW:APPROVE]
-
-      Verification result: No issues
-      ```
-
-      **REJECT case:**
-      ```
-      [AI_REVIEW:REJECT]
-
-      Issues:
-      1. Non-existent API used: `fetch.json()` → `response.json()`
-      ```
+    rules:
+      - condition: No issues found
+        next: supervise
+      - condition: Structural fix required
+        next: plan
     instruction_template: |
-      ## Workflow Context
-      - 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}/04-ai-review.md
-
-      ## Original User Request (Initial request from workflow start)
-      {task}
-
-      ## Git Diff
-      ```diff
-      {git_diff}
-      ```
+      Focus on **architecture and design** review. Do NOT review AI-specific issues (that's already done).
 
-      ## Instructions
-      Review the code for AI-specific issues:
-      - Assumption validation
-      - Plausible but wrong patterns
-      - Context fit with existing codebase
-      - Scope creep detection
-
-      **Report output:** Output to the `Report File` specified above.
-      - If file does not exist: Create new file
-      - If file exists: Append with `## Iteration {step_iteration}` section
-
-      **Report format:**
-      ```markdown
-      # AI-Generated Code Review
-
-      ## Result: APPROVE / REJECT
-
-      ## Summary
-      {One sentence summarizing result}
-
-      ## Verified Items
-      | Aspect | Result | Notes |
-      |--------|--------|-------|
-      | Assumption validity | ✅ | - |
-      | API/Library existence | ✅ | - |
-      | Context fit | ✅ | - |
-      | Scope | ✅ | - |
-
-      ## Issues (if REJECT)
-      | # | Category | Location | Issue |
-      |---|----------|----------|-------|
-      | 1 | Hallucinated API | `src/file.ts:23` | Non-existent method |
-      ```
+      Review the changes and provide feedback.
 
-      **Cognitive load reduction rules:**
-      - No issues → Summary 1 line + check table only (10 lines or less)
-      - Issues found → + Issues in table format (25 lines or less)
-    transitions:
-      - condition: approved
-        next_step: supervise
-      - condition: rejected
-        next_step: plan
+      **Note:** In simple workflow, IMPROVE judgment is not used.
+      If there are minor suggestions, use APPROVE + comments.
 
   - name: supervise
-    agent: ~/.takt/agents/default/supervisor.md
+    edit: false
+    agent: ../agents/default/supervisor.md
+    report:
+      - Validation: 05-supervisor-validation.md
+      - Summary: summary.md
     allowed_tools:
       - Read
       - Glob
@@ -458,65 +251,12 @@ steps:
       - Bash
       - WebSearch
       - WebFetch
-    status_rules_prompt: |
-      ## Judgment Criteria
-
-      | Situation | Judgment |
-      |-----------|----------|
-      | Requirements not met | REJECT |
-      | Tests failing | REJECT |
-      | Build fails | REJECT |
-      | Workarounds remaining | REJECT |
-      | All OK | APPROVE |
-
-      **Principle**: When in doubt, REJECT. Don't give ambiguous approval.
-
-      ## Output Format
-
-      | Situation | Tag |
-      |-----------|-----|
-      | Final approval | `[SUPERVISOR:APPROVE]` |
-      | Return for fixes | `[SUPERVISOR:REJECT]` |
-
-      ### Output Examples
-
-      **APPROVE case:**
-      ```
-      [SUPERVISOR:APPROVE]
-
-      Verification results:
-      - Tests: ✅ All passed
-      - Build: ✅ Succeeded
-      - Requirements met: ✅
-      ```
-
-      **REJECT case:**
-      ```
-      [SUPERVISOR:REJECT]
-
-      Issues:
-      1. Tests failing: `npm test` - 2 failures
-      2. Requirements not met: Login feature not implemented
-      ```
+    rules:
+      - condition: All checks passed
+        next: COMPLETE
+      - condition: Requirements unmet, tests failing
+        next: plan
     instruction_template: |
-      ## Workflow Context
-      - Iteration: {iteration}/{max_iterations} (workflow-wide)
-      - Step Iteration: {step_iteration} (times this step has run)
-      - Step: supervise (final verification)
-      - Report Directory: .takt/reports/{report_dir}/
-      - Report Files:
-        - Validation: .takt/reports/{report_dir}/05-supervisor-validation.md
-        - Summary: .takt/reports/{report_dir}/summary.md
-
-      ## Original User Request
-      {task}
-
-      ## Git Diff
-      ```diff
-      {git_diff}
-      ```
-
-      ## Instructions
       Run tests, verify the build, and perform final approval.
 
       **Workflow Overall Review:**
@@ -527,10 +267,6 @@ steps:
       **Review Reports:** Read all reports in Report Directory and
       check for any unaddressed improvement suggestions.
 
-      **Report output:** Output to the `Report Files` specified above.
-      - If file does not exist: Create new file
-      - If file exists: Append with `## Iteration {step_iteration}` section
-
       **Validation report format:**
       ```markdown
       # Final Validation Results
@@ -573,8 +309,8 @@ steps:
       ## Review Results
       | Review | Result |
       |--------|--------|
-      | Architect | ✅ APPROVE |
       | AI Review | ✅ APPROVE |
+      | Architect | ✅ APPROVE |
       | Supervisor | ✅ APPROVE |
 
       ## Verification Commands
@@ -583,8 +319,3 @@ steps:
       npm run build
       ```
       ```
-    transitions:
-      - condition: approved
-        next_step: COMPLETE
-      - condition: rejected
-        next_step: plan