takt 0.16.0 → 0.17.0

package/README.md

@@ -304,7 +304,7 @@ takt reset categories
 | Piece | Recommended Use |
 |----------|-----------------|
 | `default` | Serious development tasks. Used for TAKT's own development. Multi-stage review with parallel reviews (architect + security). |
-| `minimal` | Simple fixes and straightforward tasks. Minimal piece with basic review. |
+| `default-mini` | Simple fixes and straightforward tasks. Lightweight piece with AI antipattern review + supervisor. |
 | `review-fix-minimal` | Review & fix piece. Specialized for iterative improvement based on review feedback. |
 | `research` | Investigation and research. Autonomously executes research without asking questions. |
 
@@ -460,13 +460,15 @@ TAKT includes multiple builtin pieces:
 | Piece | Description |
 |----------|-------------|
 | `default` | Full development piece: plan → implement → AI review → parallel review (architect + QA) → supervisor approval. Includes fix loops at each review stage. |
-| `minimal` | Quick piece: plan → implement → review → supervisor. Minimal steps for fast iteration. |
+| `default-mini` | Mini development piece: plan → implement → parallel review (AI antipattern + supervisor) → fix if needed. Lightweight with review. |
+| `frontend-mini` | Mini frontend piece: plan → implement → parallel review (AI antipattern + supervisor) with frontend knowledge injection. |
+| `backend-mini` | Mini backend piece: plan → implement → parallel review (AI antipattern + supervisor) with backend knowledge injection. |
+| `backend-cqrs-mini` | Mini CQRS+ES piece: plan → implement → parallel review (AI antipattern + supervisor) with CQRS+ES knowledge injection. |
 | `review-fix-minimal` | Review-focused piece: review → fix → supervisor. For iterative improvement based on review feedback. |
 | `research` | Research piece: planner → digger → supervisor. Autonomously executes research without asking questions. |
 | `expert` | Full-stack development piece: architecture, frontend, security, QA reviews with fix loops. |
 | `expert-cqrs` | Full-stack development piece (CQRS+ES specialized): CQRS+ES, frontend, security, QA reviews with fix loops. |
 | `magi` | Deliberation system inspired by Evangelion. Three AI personas (MELCHIOR, BALTHASAR, CASPER) analyze and vote. |
-| `coding` | Lightweight development piece: planner → implement → parallel review (AI antipattern + architecture) → fix. Fast feedback loop without supervisor. |
 | `passthrough` | Thinnest wrapper. Pass task directly to coder as-is. No review. |
 | `compound-eye` | Multi-model review: sends the same instruction to Claude and Codex simultaneously, then synthesizes both responses. |
 | `review-only` | Read-only code review piece that makes no changes. |

package/builtins/en/instructions/supervise.md

@@ -4,7 +4,11 @@ Run tests, verify the build, and perform final approval.
 1. Whether the plan and implementation results are consistent
 2. Whether findings from each review movement have been addressed
 3. Whether each task spec requirement has been achieved
-   - Do not rely on the plan report's judgment; independently verify each requirement against actual code (file:line)
+   - Extract requirements one by one from the task spec
+   - For each requirement, identify the implementing code (file:line)
+   - Verify the code actually fulfills the requirement (read the file, run the test)
+   - Do not rely on the plan report's judgment; independently verify each requirement
+   - If any requirement is unfulfilled, REJECT
 
 **Report verification:** Read all reports in the Report Directory and
 check for any unaddressed improvement suggestions.
@@ -15,10 +19,22 @@ check for any unaddressed improvement suggestions.
 
 ## Result: APPROVE / REJECT
 
+## Requirements Fulfillment Check
+
+Extract requirements from the task spec and verify each one individually against actual code.
+
+| # | Requirement (extracted from task spec) | Met | Evidence (file:line) |
+|---|---------------------------------------|-----|---------------------|
+| 1 | {requirement 1} | ✅/❌ | `src/file.ts:42` |
+| 2 | {requirement 2} | ✅/❌ | `src/file.ts:55` |
+
+- If any ❌ exists, REJECT is mandatory
+- ✅ without evidence is invalid (must verify against actual code)
+- Do not rely on plan report's judgment; independently verify each requirement
+
 ## Verification Summary
 | Item | Status | Verification method |
 |------|--------|-------------------|
-| Requirements met | ✅ | Cross-checked with requirements list |
 | Tests | ✅ | `npm test` (N passed) |
 | Build | ✅ | `npm run build` succeeded |
 | Functional check | ✅ | Main flows verified |

package/builtins/en/output-contracts/ai-review.md

@@ -14,12 +14,26 @@
 | Context fit | ✅ | - |
 | Scope | ✅ | - |
 
-## Issues (if REJECT)
-| # | Category | Location | Issue |
-|---|----------|----------|-------|
-| 1 | Hallucinated API | `src/file.ts:23` | Non-existent method |
+## Current Iteration Findings (new)
+| # | finding_id | Category | Location | Issue | Fix Suggestion |
+|---|------------|----------|----------|-------|----------------|
+| 1 | AI-NEW-src-file-L23 | Hallucinated API | `src/file.ts:23` | Non-existent method | Replace with existing API |
+
+## Carry-over Findings (persists)
+| # | finding_id | Previous Evidence | Current Evidence | Issue | Fix Suggestion |
+|---|------------|-------------------|------------------|-------|----------------|
+| 1 | AI-PERSIST-src-file-L42 | `src/file.ts:42` | `src/file.ts:42` | Still unresolved | Apply prior fix plan |
+
+## Resolved Findings (resolved)
+| finding_id | Resolution Evidence |
+|------------|---------------------|
+| AI-RESOLVED-src-file-L10 | `src/file.ts:10` no longer contains the issue |
+
+## Rejection Gate
+- REJECT is valid only when at least one finding exists in `new` or `persists`
+- Findings without `finding_id` are invalid
 ```
 
 **Cognitive load reduction rules:**
-- No issues → Summary sentence + checklist only (10 lines or fewer)
-- Issues found → + Issues in table format (25 lines or fewer)
+- No issues → Summary sentence + checklist + empty finding sections (10 lines or fewer)
+- Issues found → include table rows only for impacted sections (30 lines or fewer)

package/builtins/en/output-contracts/architecture-review.md

@@ -14,22 +14,28 @@
 - [x] Dead code
 - [x] Call chain verification
 
-## Previous Open Findings
-| finding_id | Previous Status | Current Status (new/persists/resolved) | Evidence |
-|------------|-----------------|-----------------------------------------|----------|
-| ARCH-EXAMPLE-src-file-L42 | open | persists | `src/file.ts:42` |
-
-## Issues (if REJECT)
-| # | finding_id | Status (new/persists) | Scope | Location | Issue | Fix Suggestion |
-|---|------------|-----------------------|-------|----------|-------|----------------|
-| 1 | ARCH-EXAMPLE-src-file-L42 | new | In-scope | `src/file.ts:42` | Issue description | Fix approach |
+## Current Iteration Findings (new)
+| # | finding_id | Scope | Location | Issue | Fix Suggestion |
+|---|------------|-------|----------|-------|----------------|
+| 1 | ARCH-NEW-src-file-L42 | In-scope | `src/file.ts:42` | Issue description | Fix approach |
 
 Scope: "In-scope" (fixable in this change) / "Out-of-scope" (existing issue, non-blocking)
 
-## Existing Issues (reference, non-blocking)
-- {Record of existing issues unrelated to the current change}
+## Carry-over Findings (persists)
+| # | finding_id | Previous Evidence | Current Evidence | Issue | Fix Suggestion |
+|---|------------|-------------------|------------------|-------|----------------|
+| 1 | ARCH-PERSIST-src-file-L77 | `src/file.ts:77` | `src/file.ts:77` | Still unresolved | Apply prior fix plan |
+
+## Resolved Findings (resolved)
+| finding_id | Resolution Evidence |
+|------------|---------------------|
+| ARCH-RESOLVED-src-file-L10 | `src/file.ts:10` now satisfies the rule |
+
+## Rejection Gate
+- REJECT is valid only when at least one finding exists in `new` or `persists`
+- Findings without `finding_id` are invalid
 ```
 
 **Cognitive load reduction rules:**
 - APPROVE → Summary only (5 lines or fewer)
-- REJECT → Issues in table format (30 lines or fewer)
+- REJECT → Include only relevant finding rows (30 lines or fewer)

package/builtins/en/output-contracts/qa-review.md

@@ -15,13 +15,22 @@
 | Documentation | ✅ | - |
 | Maintainability | ✅ | - |
 
-## Previous Open Findings
-| finding_id | Previous Status | Current Status (new/persists/resolved) | Evidence |
-|------------|-----------------|-----------------------------------------|----------|
-| QA-EXAMPLE-src-file-L42 | open | persists | `src/file.ts:42` |
+## Current Iteration Findings (new)
+| # | finding_id | Category | Location | Issue | Fix Suggestion |
+|---|------------|----------|----------|-------|----------------|
+| 1 | QA-NEW-src-test-L42 | Testing | `src/test.ts:42` | Missing negative test | Add failure-path test |
 
-## Issues (if REJECT)
-| # | finding_id | Status (new/persists) | Category | Issue | Fix Suggestion |
-|---|------------|-----------------------|----------|-------|----------------|
-| 1 | QA-EXAMPLE-src-file-L42 | new | Testing | Issue description | Fix approach |
+## Carry-over Findings (persists)
+| # | finding_id | Previous Evidence | Current Evidence | Issue | Fix Suggestion |
+|---|------------|-------------------|------------------|-------|----------------|
+| 1 | QA-PERSIST-src-test-L77 | `src/test.ts:77` | `src/test.ts:77` | Still flaky | Stabilize assertion & setup |
+
+## Resolved Findings (resolved)
+| finding_id | Resolution Evidence |
+|------------|---------------------|
+| QA-RESOLVED-src-test-L10 | `src/test.ts:10` now covers error path |
+
+## Rejection Gate
+- REJECT is valid only when at least one finding exists in `new` or `persists`
+- Findings without `finding_id` are invalid
 ```

package/builtins/en/output-contracts/security-review.md

@@ -13,16 +13,30 @@
 | Data Protection | ✅ | - |
 | Dependencies | ✅ | - |
 
-## Vulnerabilities (if REJECT)
-| # | Severity | Type | Location | Fix Suggestion |
-|---|----------|------|----------|----------------|
-| 1 | High | SQLi | `src/db.ts:42` | Use parameterized queries |
+## Current Iteration Findings (new)
+| # | finding_id | Severity | Type | Location | Issue | Fix Suggestion |
+|---|------------|----------|------|----------|-------|----------------|
+| 1 | SEC-NEW-src-db-L42 | High | SQLi | `src/db.ts:42` | Raw query string | Use parameterized queries |
+
+## Carry-over Findings (persists)
+| # | finding_id | Previous Evidence | Current Evidence | Issue | Fix Suggestion |
+|---|------------|-------------------|------------------|-------|----------------|
+| 1 | SEC-PERSIST-src-auth-L18 | `src/auth.ts:18` | `src/auth.ts:18` | Weak validation persists | Harden validation |
+
+## Resolved Findings (resolved)
+| finding_id | Resolution Evidence |
+|------------|---------------------|
+| SEC-RESOLVED-src-db-L10 | `src/db.ts:10` now uses bound parameters |
 
 ## Warnings (non-blocking)
 - {Security recommendations}
+
+## Rejection Gate
+- REJECT is valid only when at least one finding exists in `new` or `persists`
+- Findings without `finding_id` are invalid
 ```
 
 **Cognitive load reduction rules:**
 - No issues → Checklist only (10 lines or fewer)
-- Warnings present → + Warnings in 1-2 lines (15 lines or fewer)
-- Vulnerabilities found → + Table format (30 lines or fewer)
+- Warnings only → + Warnings in 1-2 lines (15 lines or fewer)
+- Vulnerabilities found → + finding tables (30 lines or fewer)

package/builtins/en/output-contracts/supervisor-validation.md

@@ -0,0 +1,48 @@
+```markdown
+# Final Validation Results
+
+## Result: APPROVE / REJECT
+
+## Requirements Fulfillment Check
+
+Extract requirements from the task spec and verify each one individually against actual code.
+
+| # | Requirement (extracted from task spec) | Met | Evidence (file:line) |
+|---|---------------------------------------|-----|---------------------|
+| 1 | {requirement 1} | ✅/❌ | `src/file.ts:42` |
+| 2 | {requirement 2} | ✅/❌ | `src/file.ts:55` |
+
+- If any ❌ exists, REJECT is mandatory
+- ✅ without evidence is invalid (must verify against actual code)
+- Do not rely on plan report's judgment; independently verify each requirement
+
+## Validation Summary
+| Item | Status | Verification Method |
+|------|--------|-------------------|
+| Tests | ✅ | `npm test` (N passed) |
+| Build | ✅ | `npm run build` succeeded |
+| Functional check | ✅ | Main flow verified |
+
+## Current Iteration Findings (new)
+| # | finding_id | Item | Evidence | Reason | Required Action |
+|---|------------|------|----------|--------|-----------------|
+| 1 | VAL-NEW-src-file-L42 | Requirement mismatch | `file:line` | Description | Fix required |
+
+## Carry-over Findings (persists)
+| # | finding_id | Previous Evidence | Current Evidence | Reason | Required Action |
+|---|------------|-------------------|------------------|--------|-----------------|
+| 1 | VAL-PERSIST-src-file-L77 | `file:line` | `file:line` | Still unresolved | Apply fix |
+
+## Resolved Findings (resolved)
+| finding_id | Resolution Evidence |
+|------------|---------------------|
+| VAL-RESOLVED-src-file-L10 | `file:line` now passes validation |
+
+## Deliverables
+- Created: {Created files}
+- Modified: {Modified files}
+
+## Rejection Gate
+- REJECT is valid only when at least one finding exists in `new` or `persists`
+- Findings without `finding_id` are invalid
+```

package/builtins/en/output-contracts/validation.md

@@ -11,12 +11,26 @@
 | Build | ✅ | `npm run build` succeeded |
 | Functional check | ✅ | Main flow verified |
 
+## Current Iteration Findings (new)
+| # | finding_id | Item | Evidence | Reason | Required Action |
+|---|------------|------|----------|--------|-----------------|
+| 1 | VAL-NEW-src-file-L42 | Requirement mismatch | `file:line` | Description | Fix required |
+
+## Carry-over Findings (persists)
+| # | finding_id | Previous Evidence | Current Evidence | Reason | Required Action |
+|---|------------|-------------------|------------------|--------|-----------------|
+| 1 | VAL-PERSIST-src-file-L77 | `file:line` | `file:line` | Still unresolved | Apply fix |
+
+## Resolved Findings (resolved)
+| finding_id | Resolution Evidence |
+|------------|---------------------|
+| VAL-RESOLVED-src-file-L10 | `file:line` now passes validation |
+
 ## Deliverables
 - Created: {Created files}
 - Modified: {Modified files}
 
-## Incomplete Items (if REJECT)
-| # | Item | Reason |
-|---|------|--------|
-| 1 | {Item} | {Reason} |
+## Rejection Gate
+- REJECT is valid only when at least one finding exists in `new` or `persists`
+- Findings without `finding_id` are invalid
 ```

package/builtins/en/personas/supervisor.md

@@ -36,12 +36,12 @@ You are the **human proxy** in the automated piece. Before approval, verify the
 
 ## Verification Perspectives
 
-### 1. Requirements Fulfillment
+### 1. Requirements Fulfillment (Most Critical)
 
-- Are **all** original task requirements met?
+- Verify all requirements individually; do NOT APPROVE if any single requirement is unfulfilled
 - Can it **actually** do what was claimed?
 - Are implicit requirements (naturally expected behavior) met?
-- Are there overlooked requirements?
+- "Mostly done" or "main parts complete" is NOT grounds for APPROVE. All requirements must be fulfilled
 
 **Note**: Don't take Coder's "complete" at face value. Actually verify.
 

package/builtins/en/piece-categories.yaml

@@ -1,23 +1,31 @@
 piece_categories:
   🚀 Quick Start:
     pieces:
+      - default-mini
+      - frontend-mini
+      - backend-mini
       - default
-      - passthrough
-      - coding
-      - minimal
       - compound-eye
+  ⚡ Mini:
+    pieces:
+      - default-mini
+      - frontend-mini
+      - backend-mini
+      - backend-cqrs-mini
   🎨 Frontend:
     pieces:
       - frontend
+      - frontend-mini
   ⚙️ Backend:
     pieces:
       - backend
+      - backend-mini
       - backend-cqrs
+      - backend-cqrs-mini
   🔧 Expert:
-    Full Stack:
-      pieces:
-        - expert
-        - expert-cqrs
+    pieces:
+      - expert
+      - expert-cqrs
   🛠️ Refactoring:
     pieces:
       - structural-reform

package/builtins/en/pieces/backend-cqrs-mini.yaml

@@ -0,0 +1,247 @@
+name: backend-cqrs-mini
+description: CQRS+ES-focused mini development piece (plan -> implement -> parallel review -> fix if needed -> complete)
+piece_config:
+  provider_options:
+    codex:
+      network_access: true
+    opencode:
+      network_access: true
+max_movements: 20
+initial_movement: plan
+movements:
+  - name: plan
+    edit: false
+    persona: planner
+    knowledge:
+      - backend
+      - cqrs-es
+      - security
+      - architecture
+    allowed_tools:
+      - Read
+      - Glob
+      - Grep
+      - Bash
+      - WebSearch
+      - WebFetch
+    rules:
+      - condition: Requirements are clear and implementation is possible
+        next: implement
+      - condition: User is asking a question (not an implementation task)
+        next: COMPLETE
+      - condition: Requirements are unclear, insufficient information
+        next: ABORT
+    instruction: plan
+    output_contracts:
+      report:
+        - name: 00-plan.md
+          format: plan
+  - name: implement
+    edit: true
+    persona: coder
+    policy:
+      - coding
+      - testing
+    knowledge:
+      - backend
+      - cqrs-es
+      - security
+      - architecture
+    allowed_tools:
+      - Read
+      - Glob
+      - Grep
+      - Edit
+      - Write
+      - Bash
+      - WebSearch
+      - WebFetch
+    required_permission_mode: edit
+    instruction: implement
+    rules:
+      - condition: Implementation complete
+        next: reviewers
+      - condition: Cannot proceed, insufficient info
+        next: ABORT
+      - condition: User input required because there are items to confirm with the user
+        next: implement
+        requires_user_input: true
+        interactive_only: true
+    output_contracts:
+      report:
+        - name: coder-scope.md
+          format: coder-scope
+        - name: coder-decisions.md
+          format: coder-decisions
+  - name: reviewers
+    parallel:
+      - name: ai_review
+        edit: false
+        persona: ai-antipattern-reviewer
+        policy:
+          - review
+          - ai-antipattern
+        allowed_tools:
+          - Read
+          - Glob
+          - Grep
+          - WebSearch
+          - WebFetch
+        instruction: review-ai
+        rules:
+          - condition: No AI-specific issues
+          - condition: AI-specific issues found
+        output_contracts:
+          report:
+            - name: 03-ai-review.md
+              format: ai-review
+      - name: supervise
+        edit: false
+        persona: supervisor
+        policy: review
+        knowledge:
+          - backend
+          - cqrs-es
+          - security
+          - architecture
+        allowed_tools:
+          - Read
+          - Glob
+          - Grep
+          - Bash
+          - WebSearch
+          - WebFetch
+        instruction: supervise
+        rules:
+          - condition: All checks passed
+          - condition: Requirements unmet, tests failing
+        output_contracts:
+          report:
+            - name: supervisor-validation.md
+              format: supervisor-validation
+            - name: summary.md
+              format: summary
+              use_judge: false
+    rules:
+      - condition: all("No AI-specific issues", "All checks passed")
+        next: COMPLETE
+      - condition: all("AI-specific issues found", "Requirements unmet, tests failing")
+        next: fix_both
+      - condition: any("AI-specific issues found")
+        next: ai_fix
+      - condition: any("Requirements unmet, tests failing")
+        next: supervise_fix
+  - name: fix_both
+    parallel:
+      - name: ai_fix_parallel
+        edit: true
+        persona: coder
+        policy:
+          - coding
+          - testing
+        knowledge:
+          - backend
+          - cqrs-es
+          - security
+          - architecture
+        allowed_tools:
+          - Read
+          - Glob
+          - Grep
+          - Edit
+          - Bash
+          - WebSearch
+          - WebFetch
+        required_permission_mode: edit
+        rules:
+          - condition: AI Reviewer's issues fixed
+          - condition: No fix needed (verified target files/spec)
+          - condition: Cannot proceed, insufficient info
+        instruction: ai-fix
+      - name: supervise_fix_parallel
+        edit: true
+        persona: coder
+        policy:
+          - coding
+          - testing
+        knowledge:
+          - backend
+          - cqrs-es
+          - security
+          - architecture
+        allowed_tools:
+          - Read
+          - Glob
+          - Grep
+          - Edit
+          - Bash
+          - WebSearch
+          - WebFetch
+        required_permission_mode: edit
+        rules:
+          - condition: Supervisor's issues fixed
+          - condition: Cannot proceed, insufficient info
+        instruction: fix-supervisor
+    rules:
+      - condition: all("AI Reviewer's issues fixed", "Supervisor's issues fixed")
+        next: reviewers
+      - condition: any("No fix needed (verified target files/spec)", "Cannot proceed, insufficient info")
+        next: implement
+  - name: ai_fix
+    edit: true
+    persona: coder
+    policy:
+      - coding
+      - testing
+    knowledge:
+      - backend
+      - cqrs-es
+      - security
+      - architecture
+    allowed_tools:
+      - Read
+      - Glob
+      - Grep
+      - Edit
+      - Write
+      - Bash
+      - WebSearch
+      - WebFetch
+    required_permission_mode: edit
+    pass_previous_response: false
+    rules:
+      - condition: AI Reviewer's issues fixed
+        next: reviewers
+      - condition: No fix needed (verified target files/spec)
+        next: implement
+      - condition: Cannot proceed, insufficient info
+        next: implement
+    instruction: ai-fix
+  - name: supervise_fix
+    edit: true
+    persona: coder
+    policy:
+      - coding
+      - testing
+    knowledge:
+      - backend
+      - cqrs-es
+      - security
+      - architecture
+    allowed_tools:
+      - Read
+      - Glob
+      - Grep
+      - Edit
+      - Write
+      - Bash
+      - WebSearch
+      - WebFetch
+    required_permission_mode: edit
+    pass_previous_response: false
+    rules:
+      - condition: Supervisor's issues fixed
+        next: reviewers
+      - condition: Cannot proceed, insufficient info
+        next: implement
+    instruction: fix-supervisor

package/builtins/en/pieces/backend-cqrs.yaml

@@ -6,7 +6,6 @@ piece_config:
       network_access: true
     opencode:
       network_access: true
-
 max_movements: 30
 initial_movement: plan
 movements:
@@ -65,8 +64,10 @@ movements:
         interactive_only: true
     output_contracts:
       report:
-        - Scope: 01-coder-scope.md
-        - Decisions: 02-coder-decisions.md
+        - name: coder-scope.md
+          format: coder-scope
+        - name: coder-decisions.md
+          format: coder-decisions
   - name: ai_review
     edit: false
     persona: ai-antipattern-reviewer
@@ -111,6 +112,7 @@ movements:
       - WebSearch
       - WebFetch
     instruction: ai-fix
+    pass_previous_response: false
     rules:
       - condition: AI Reviewer's issues have been fixed
         next: ai_review
@@ -220,6 +222,7 @@ movements:
       - WebSearch
       - WebFetch
     required_permission_mode: edit
+    pass_previous_response: false
     rules:
       - condition: Fix complete
         next: reviewers
@@ -237,6 +240,7 @@ movements:
       - WebSearch
       - WebFetch
     instruction: supervise
+    pass_previous_response: false
     rules:
       - condition: All validations pass and ready to merge
         next: COMPLETE
@@ -244,8 +248,11 @@ movements:
         next: fix_supervisor
     output_contracts:
       report:
-        - Validation: 07-supervisor-validation.md
-        - Summary: summary.md
+        - name: supervisor-validation.md
+          format: supervisor-validation
+        - name: summary.md
+          format: summary
+          use_judge: false
   - name: fix_supervisor
     edit: true
     persona: coder
@@ -267,6 +274,7 @@ movements:
       - WebSearch
       - WebFetch
     instruction: fix-supervisor
+    pass_previous_response: false
     rules:
       - condition: Supervisor's issues have been fixed
         next: supervise