@leejungkiin/awkit 1.5.5 → 1.6.0

package/skills/symphony-enforcer/examples/mindful-stop.md

@@ -0,0 +1,141 @@
+# Mindful Stop Protocol — Detailed Logic
+
+> **Purpose:** Chống vòng xoáy tối ưu không hồi kết ("AI brain fry").
+> **Design:** Default-ON trong GEMINI.md, enforcement gắn vào TP1/TP2/TP4.
+> **Opt-out:** `.project-identity` → `mindfulCheckpoint: false`.
+
+## Gate Check (Init Chain Cache)
+
+```
+Trong awf-session-restore, khi đọc .project-identity:
+  → Cache mindful config vào session state:
+    mindful_enabled = .mindfulCheckpoint ?? true
+    iteration_threshold = .mindfulCheckpointConfig?.iterationThreshold ?? 3
+    scope_guard = .mindfulCheckpointConfig?.scopeGuard ?? true
+    milestone_rest = .mindfulCheckpointConfig?.milestoneRest ?? true
+
+Nếu .project-identity không tồn tại → dùng defaults (tất cả ON)
+```
+
+---
+
+## Session State Tracking
+
+```
+AI duy trì state xuyên suốt session:
+  iteration_map = {}       # feature_name → count
+  tasks_completed = 0      # count tasks done trong session
+  last_gate_completed = "" # "phase_c" | "gate_5" | ""
+```
+
+---
+
+## TP-ITER: Iteration Counter
+
+**Gắn vào:** TP1 (Progress Milestone) — mỗi lần report progress
+
+**Trigger:** User request chứa keywords refactor/polish/optimize TRÊN feature đã hoàn thành
+
+```
+IF NOT mindful_enabled → SKIP
+
+Khi nhận request iterate trên feature X:
+  iteration_map[X] = (iteration_map[X] ?? 0) + 1
+
+  IF iteration_map[X] >= iteration_threshold:
+    ⏸️ MINDFUL PAUSE
+    ──────────────────────────────────────
+    Cảnh báo: "⏸️ Đã iterate {N} lần trên [{feature}].
+    Code đang hoạt động ổn định. Đề xuất:
+    1. Commit code hiện tại
+    2. Trải nghiệm thực tế trên device/production
+    3. Quay lại sau nếu phát hiện vấn đề cụ thể"
+    ──────────────────────────────────────
+
+    User response:
+      "tiếp tục" / "tôi hiểu, tiếp" / "override" → reset iteration_map[X] = 0, proceed
+      Bất kỳ response khác → commit + dừng feature đó
+```
+
+---
+
+## TP-SCOPE: Scope Guard
+
+**Gắn vào:** Trước khi bắt đầu EXECUTION — khi nhận request mới
+
+**Trigger keywords:** `[polish, optimize, refine, tối ưu, cải thiện, tweak, mượt hơn, đẹp hơn, smooth, better]`
+
+```
+IF NOT mindful_enabled OR NOT scope_guard → SKIP
+
+Khi nhận request chứa trigger keyword:
+  Hỏi: "Thay đổi này giải quyết vấn đề cụ thể nào đang gặp trên device/production?
+         Hay đây là tối ưu phòng ngừa?"
+
+  User response:
+    Nêu vấn đề cụ thể (lỗi, lag, UX problem) → proceed bình thường
+    Không rõ / "muốn đẹp hơn thôi" → Đề xuất:
+      "📋 Bookmark vào Symphony backlog (P2):
+       symphony task create 'Optimize: {description}' --priority 2
+       Quay lại khi có feedback từ real users."
+```
+
+---
+
+## TP-REST: Milestone Rest Gate
+
+**Gắn vào:** TP4 (Auto-Next Suggestion) — sau khi task complete
+
+**Trigger conditions (BẤT KỲ 1):**
+1. `tasks_completed >= 3` trong session hiện tại
+2. `last_gate_completed` = "phase_c" hoặc "gate_5"
+
+```
+IF NOT mindful_enabled OR NOT milestone_rest → SKIP (TP4 chạy như cũ)
+
+Khi trigger:
+  TP4 output THAY ĐỔI thành:
+
+  ➡️ NEXT STEPS ({projectName})
+  ──────────────────────────────────────
+  🧘 Đề xuất: Dừng phiên tại đây.
+     Bạn đã hoàn thành {tasks_completed} tasks hôm nay.
+     Tiến độ project: {X}% → {Y}%
+     Commit, nghỉ ngơi, quay lại phiên mới sau.
+  ──────────────────────────────────────
+  Hoặc tiếp tục:
+  📋 #sym-A1 — Task Name (P0, ready)
+  📋 #sym-A2 — Task Name (P1, ready)
+
+  → 🧘 REST option hiển thị TRƯỚC danh sách tasks
+  → User vẫn có thể chọn task để tiếp tục
+```
+
+---
+
+## Enforcement Matrix
+
+| Mechanism | Gắn vào TP | Mandatory? | Opt-out key |
+|:---|:---|:---|:---|
+| Iteration Counter | TP1 | ✅ (khi enabled) | `mindfulCheckpoint: false` |
+| Scope Guard | Pre-EXECUTION | ✅ (khi enabled) | `scopeGuard: false` |
+| Milestone Rest | TP4 | ✅ (khi enabled) | `milestoneRest: false` |
+
+## .project-identity Config
+
+```json
+{
+  "mindfulCheckpoint": true,
+  "mindfulCheckpointConfig": {
+    "iterationThreshold": 3,
+    "scopeGuard": true,
+    "milestoneRest": true
+  }
+}
+```
+
+| Giá trị | Hành vi |
+|:---|:---|
+| Không khai báo | = `true` (an toàn mặc định) |
+| `true` | Bật toàn bộ, dùng defaults hoặc sub-config |
+| `false` | Tắt hoàn toàn, AI chạy full speed |

package/skills/symphony-enforcer/examples/task-completion.md

@@ -88,13 +88,22 @@ NEEDS_CONTEXT:
 2. symphony task list -P <projectId> -s ready (CHỈ tasks cùng project)
    ⚠️ TUYỆT ĐỐI KHÔNG dùng filter="ready" không có project filter
 3. Lọc top 2-3 ready tasks theo priority
-4. Present cho user:
+4. Kiểm tra Mindful Rest trigger:
+   IF mindful_enabled VÀ milestone_rest VÀ (tasks_completed >= 3 OR vừa xong Phase C / Gate 5):
+     → Hiển thị REST option TRƯỚC danh sách tasks:
+       🧘 Đề xuất: Dừng phiên tại đây.
+          Bạn đã hoàn thành {tasks_completed} tasks hôm nay.
+          Commit, nghỉ ngơi, quay lại phiên mới sau.
+       ─────────────
+       Hoặc tiếp tục:
+5. Present cho user:
    ➡️ NEXT STEPS ({projectName})
    📋 #sym-A1 — Auth Module (P0, ready)
    📋 #sym-A2 — Dashboard UI (P1, ready)
-5. Nếu KHÔNG CÓ ready tasks → "✨ Không còn task ready! Tạo task mới hoặc chuyển phase."
+6. Nếu KHÔNG CÓ ready tasks → "✨ Không còn task ready! Tạo task mới hoặc chuyển phase."
 ```
 
 **Enforcement:**
 - ❌ KHÔNG kết thúc conversation mà KHÔNG present next suggestion
 - ❌ KHÔNG show tasks từ project khác
+- ❌ KHÔNG bỏ qua Mindful Rest khi trigger conditions đạt (nếu enabled)

package/skills/symphony-enforcer/examples/trigger-points.md

@@ -35,6 +35,13 @@ symphony_report_progress(
 - ❌ KHÔNG được gọi `notify_user` mà chưa `report_progress` trước đó
 - ❌ KHÔNG được chuyển mode (task_boundary) mà chưa report
 
+**Mindful Check (gắn vào TP1):**
+```
+Nếu mindful_enabled VÀ request là iterate/polish trên feature đã done:
+  iteration_map[feature]++
+  IF >= iteration_threshold → ⏸️ MINDFUL PAUSE (xem mindful-stop.md)
+```
+
 ---
 
 ## TP1.5: Design Compliance Check (Gate 4 Enforcement)

package/skills/symphony-orchestrator/SKILL.md

@@ -20,6 +20,8 @@ invocation-type: auto
 priority: 0
 ---
 
+<!-- ⚠️ GATE 0 — Preflight checklist PHẢI hiển thị. Bỏ qua = VI PHẠM. DB centralized = cross-project. -->
+
 # Symphony Orchestrator Skill — Multi-Project & Agent Orchestration
 
 > **Purpose:** Đảm bảo Symphony server luôn sẵn sàng cho mọi session.

package/skills/telegram-notify/SKILL.md

@@ -55,3 +55,4 @@ awkit tg send --chat -100xxx --topic 456 --parse-mode md "**Done!**"
 3. **Use Markdown** for formatted messages (`--parse-mode md`)
 4. **Config location**: `~/.gemini/antigravity/.tg_config.json`
 5. If `awkit tg send` returns error about config, tell user to run `awkit tg setup`
+6. **Per-Project Automation**: AWKit CLI automatically reads `.project-identity` > `automation.telegram` to override `chatId`/`topicId` per project, or completely skip sending if `enabled: false`.

package/skills/trello-sync/SKILL.md

@@ -90,6 +90,13 @@ Lần 3 (vẫn lỗi): báo user "Trello chưa được cấu hình. Vui lòng c
 ### Tự Động Hóa Qua `awkit trello` (BẮT BUỘC)
 
 AI không cần tự inject ENV hay tìm kiếm cấu hình. Công cụ lệnh `awkit trello` v1.3.0+ sẽ TỰ ĐỘNG đọc từ env vars và `.project-identity`. MỌI thao tác Trello phải đi qua `awkit trello`.
+
+> **Proactive Auto-Sync Rule:** Nếu `.project-identity` có `automation.trello.autoSync: true`, AI **BẮT BUỘC** tự động gọi lệnh Trello tại các trigger points mà không cần user yêu cầu:
+> - Từng task complete → `awkit trello complete "<tên>"` + comment progress.
+> - Đạt milestone (chuyển Gate, đạt 40/60/80%) → `awkit trello comment`.
+> - Gặp lỗi Blocked → `awkit trello block`.
+> *(Nếu `autoSync: false` hoặc không có config, AI tiếp tục chế độ bị động).*
+
 ---
 
 ## 📚 Command Reference

package/skills/verification-gate/SKILL.md

@@ -3,6 +3,8 @@ name: verification-gate
 description: Use BEFORE claiming any work is complete, fixed, or passing. Requires running verification commands and confirming output before making success claims. Evidence before assertions, always. Auto-triggers on task completion, commit, deploy, or any positive status claim.
 ---
 
+<!-- ⚠️ IRON LAW — NO completion claims without FRESH verification evidence. Non-negotiable. -->
+
 # Verification Before Completion
 
 ## Overview

package/skills/visual-design-gate/SKILL.md

@@ -22,6 +22,8 @@ activation_keywords:
   - "pencil"
 ---
 
+<!-- ⚠️ GATE 2.5 — Không code UI khi chưa có design approval. Backend-only tasks SKIP gate này. -->
+
 # Visual Design Gate v1.0 (Gate 2.5) — UI/UX Sync Gate
 
 > **Purpose:** Giúp AI và người dùng đồng bộ cách hiểu về ý tưởng giao diện (UI/UX)

package/templates/project-identity/android.json

@@ -24,5 +24,30 @@
     "lineLength": 120
   },
   "createdDate": "{{DATE}}",
-  "lastUpdated": "{{DATE}}"
+  "lastUpdated": "{{DATE}}",
+  "automation": {
+    "telegram": {
+      "enabled": true,
+      "chatId": "",
+      "topicId": "",
+      "triggers": {
+        "git_push": true,
+        "task_complete": false,
+        "deploy": true
+      }
+    },
+    "trello": {
+      "enabled": true,
+      "autoSync": true,
+      "triggers": {
+        "task_complete": true,
+        "milestone": true,
+        "blocked": true
+      }
+    },
+    "git": {
+      "autoCommit": true,
+      "autoPush": true
+    }
+  }
 }

package/templates/project-identity/backend-nestjs.json

@@ -20,5 +20,30 @@
     "lineLength": 100
   },
   "createdDate": "{{DATE}}",
-  "lastUpdated": "{{DATE}}"
+  "lastUpdated": "{{DATE}}",
+  "automation": {
+    "telegram": {
+      "enabled": true,
+      "chatId": "",
+      "topicId": "",
+      "triggers": {
+        "git_push": true,
+        "task_complete": false,
+        "deploy": true
+      }
+    },
+    "trello": {
+      "enabled": true,
+      "autoSync": true,
+      "triggers": {
+        "task_complete": true,
+        "milestone": true,
+        "blocked": true
+      }
+    },
+    "git": {
+      "autoCommit": true,
+      "autoPush": true
+    }
+  }
 }

package/templates/project-identity/expo.json

@@ -23,5 +23,30 @@
     "lineLength": 100
   },
   "createdDate": "{{DATE}}",
-  "lastUpdated": "{{DATE}}"
+  "lastUpdated": "{{DATE}}",
+  "automation": {
+    "telegram": {
+      "enabled": true,
+      "chatId": "",
+      "topicId": "",
+      "triggers": {
+        "git_push": true,
+        "task_complete": false,
+        "deploy": true
+      }
+    },
+    "trello": {
+      "enabled": true,
+      "autoSync": true,
+      "triggers": {
+        "task_complete": true,
+        "milestone": true,
+        "blocked": true
+      }
+    },
+    "git": {
+      "autoCommit": true,
+      "autoPush": true
+    }
+  }
 }

package/templates/project-identity/ios.json

@@ -23,5 +23,30 @@
     "lineLength": 120
   },
   "createdDate": "{{DATE}}",
-  "lastUpdated": "{{DATE}}"
+  "lastUpdated": "{{DATE}}",
+  "automation": {
+    "telegram": {
+      "enabled": true,
+      "chatId": "",
+      "topicId": "",
+      "triggers": {
+        "git_push": true,
+        "task_complete": false,
+        "deploy": true
+      }
+    },
+    "trello": {
+      "enabled": true,
+      "autoSync": true,
+      "triggers": {
+        "task_complete": true,
+        "milestone": true,
+        "blocked": true
+      }
+    },
+    "git": {
+      "autoCommit": true,
+      "autoPush": true
+    }
+  }
 }

package/templates/project-identity/web-nextjs.json

@@ -20,5 +20,30 @@
     "lineLength": 100
   },
   "createdDate": "{{DATE}}",
-  "lastUpdated": "{{DATE}}"
+  "lastUpdated": "{{DATE}}",
+  "automation": {
+    "telegram": {
+      "enabled": true,
+      "chatId": "",
+      "topicId": "",
+      "triggers": {
+        "git_push": true,
+        "task_complete": false,
+        "deploy": true
+      }
+    },
+    "trello": {
+      "enabled": true,
+      "autoSync": true,
+      "triggers": {
+        "task_complete": true,
+        "milestone": true,
+        "blocked": true
+      }
+    },
+    "git": {
+      "autoCommit": true,
+      "autoPush": true
+    }
+  }
 }