@leejungkiin/awkit 1.6.1 → 1.6.2

package/README.md

@@ -1,8 +1,9 @@
 # AWKit — Antigravity Workflow Kit v12.5
 
-> **v12.5.0** · Single Source of Truth · Symphony-First · Mindful Execution
+> **v12.5** · Single Source of Truth · Symphony-First · Mindful Execution
 
 AWKit là framework điều phối AI agent chuyên nghiệp. Đây là **nơi duy nhất** chứa toàn bộ workflows, skills, GEMINI.md và cấu hình — không còn phân tán giữa nhiều repo.
+AWKit giúp tối ưu context khi làm việc, có khả năng quản lý task, đồng bộ Trello và báo cáo lên Telegram, ngoài ra Awkit còn sử dụng cơ chế checkpoint để dev dừng đúng lúc tránh tâm lý tối ưu hóa quá mức (over-optimization) một vấn đề phổ biến khi làm việc với AI.
 
 ---
 
@@ -224,4 +225,4 @@ awkit enable-pack creator-studio
 
 ---
 
-*AWKit v1.5.x — Antigravity Workflow Kit · Created by Kien AI*
+*AWKit Antigravity Workflow Kit · Created by leejungkiin*

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leejungkiin/awkit",
-  "version": "1.6.1",
+  "version": "1.6.2",
   "description": "Antigravity Workflow Kit v12.5. Unified AI agent orchestration system with Mindful Checkpoints.",
   "main": "bin/awk.js",
   "bin": {

package/skills/gitnexus-intelligence/SKILL.md

@@ -72,7 +72,7 @@ FALLBACK (nếu không match path):
 |---------|--------|
 | Trước khi edit bất kỳ function/class/method | `gitnexus_impact` → check blast radius |
 | Debug error / trace bug | `gitnexus_query` + `gitnexus_context` |
-| Explore unfamiliar code | `gitnexus_query` → execution flows |
+| Explore unfamiliar code | `CODEBASE.md` + `grep_search` → Tìm Anchor Class → `gitnexus_context` |
 | Rename symbol | `gitnexus_rename` (dry_run trước) |
 | Trước commit | `gitnexus_detect_changes` |
 | Refactor / extract / split | `gitnexus_context` + `gitnexus_impact` |
@@ -149,14 +149,14 @@ FALLBACK (nếu không match path):
 
 ---
 
-## 📋 Workflow: Exploring Code
+## 📋 Workflow: Exploring Code (Zero-Shotgun Protocol)
 
 ```
-1. READ gitnexus://repo/{name}/context      → Overview + staleness
-2. READ gitnexus://repo/{name}/clusters     → Functional areas
-3. gitnexus_query({query: "<concept>"})     → Execution flows
-4. gitnexus_context({name: "<symbol>"})     → Deep dive
-5. READ gitnexus://repo/{name}/process/{name} → Full trace
+1. Đọc CODEBASE.md để xác định cấu trúc module / Clean Architecture layers.
+2. Dùng list_dir hoặc grep_search vào đúng thư mục dự đoán để tìm 1 "Anchor Class" (VD: ProfileViewModel).
+3. KHÔNG dùng gitnexus_query rải rác trừ khi các bước 1-2 hoàn toàn thất bại.
+4. Dùng gitnexus_context({name: "<AnchorClass>"}) để lấy 360° view các luồng dữ liệu xung quanh điểm neo này.
+5. READ gitnexus://repo/{name}/process/{name} → Full trace luồng thực thi liên quan.
 ```
 
 ---
@@ -201,10 +201,11 @@ always_do:
   - PHẢI chạy gitnexus_impact TRƯỚC khi edit bất kỳ symbol nào
   - PHẢI chạy gitnexus_detect_changes TRƯỚC khi commit
   - PHẢI cảnh báo user khi risk = HIGH hoặc CRITICAL
-  - Ưu tiên gitnexus_query thay vì grep khi explore code
+  - PHẢI dùng GitNexus context sau khi xác định được "Anchor Class" qua heuristic search
   - PHẢI dùng gitnexus_rename (dry_run trước) khi rename
 
 never_do:
+  - KHÔNG gọi gitnexus_query (>1 lần) với các khái niệm bao quát ("appwrite feedback", "push notification") gây lãng phí token.
   - KHÔNG edit function/class mà chưa check impact
   - KHÔNG ignore HIGH/CRITICAL risk warnings
   - KHÔNG rename bằng find-and-replace → dùng gitnexus_rename

package/skills/module-spec-writer/SKILL.md

@@ -84,7 +84,7 @@ OPTIONAL:
 ### Phase 2: Per-Module Spec Generation
 - Gather context (BRIEF, source code, KI, NeuralMemory)
 - Generate spec theo template → `templates/module-spec-template.md`
-- Self-review checklist: screens đủ? flows rõ? edge cases?
+- Self-review checklist: screens đủ? flows rõ? edge cases? **transitions & micro-interactions defined?**
 
 ### Phase 3: Cross-Module Consistency Check
 - Dependency graph (circular? missing cross-refs?)

package/skills/module-spec-writer/templates/module-spec-template.md

@@ -85,10 +85,31 @@
 
 ---
 
+## Transitions & Micro-interactions (Mobile)
+
+| Screen/Element | Animation Type | Details |
+|----------------|---------------|---------|
+| [List/Grid screen] | Staggered fade+slide | Items appear sequentially (50ms delay) |
+| [Stats/Dashboard] | Number counter | Values roll/count up from 0 |
+| [Navigation A→B] | Hero / Shared element | [which element animates across] |
+| [Modal/Sheet] | Spring damping | Spring-based open/close |
+| [Buttons/Cards] | Scale on press | Scale 0.95 + haptic impact(light) |
+| [Success state] | Checkmark draw | Animated stroke white→green |
+| [Error state] | Shake | Horizontal oscillation on invalid field |
+| [Toggle/Switch] | Spring bounce | Spring physics + optional haptic |
+| [Like/Favorite] | Pulse/Particle | Scale pulse or burst effect |
+
+> Fill only relevant rows. Delete unused ones. Add custom animations as needed.
+
+---
+
 ## Acceptance Criteria
 - [ ] [measurable criterion 1]
 - [ ] [measurable criterion 2]
 - [ ] [measurable criterion 3]
+- [ ] All loading states use skeleton→content morph transitions (no instant pop-in)
+- [ ] All tappable elements have scale-on-press feedback
+- [ ] Haptic feedback integrated for key interactions
 ```
 
 ---

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

@@ -98,9 +98,13 @@ File patterns:
    - Đưa hướng dẫn test cụ thể
    - Gọi notify_user(BlockedOnUser=true) — DỪNG và CHỜ user response
 
-=== TRƯỜNG HỢP 2: autoVerification = true (Auto Maestro) ===
-   - Chạy Auto Build
-   - Chạy mcp_maestro_launch_app, mcp_maestro_take_screenshot
-   - NẾU Build/Run Lỗi: BlockedOnUser=true
-   - NẾU Pass: BlockedOnUser=false. Lập tức đi tiếp!
+=== TRƯỜNG HỢP 2: autoVerification = true (Autonomous UI Visual Verification) ===
+   AI tự động thực hiện chu trình 5 bước để kiểm tra hiển thị:
+   1. [ISOLATION]: Tạm thời chỉnh sửa Entry File (ContentView/MainActivity/App) để boot trực tiếp vào màn hình mục tiêu. Inject mock-data.
+   2. [BOOT]: Chạy Auto Build và Launch app lên Simulator/Emulator (hoặc dùng mcp_maestro_launch_app).
+   3. [VERIFY]: Call CLI / Maestro take_screenshot. AI gọi `view_file` lên ảnh để đối chiếu vs Thiết kế (Padding, Colors, Text, State).
+   4. [MANDATORY REVERT]: BẤT KỂ kết quả ra sao (hay build lỗi), PHẢI gỡ bỏ code Isolation, trả Entry File về phiên bản gốc (dùng Git stash hoặc revert tay).
+   5. [FEEDBACK LOOP]:
+      - Nếu PASS: BlockedOnUser=false. Lập tức đi tiếp!
+      - Nếu FAIL: AI tự log ra file kết quả chẩn đoán lỗi hiển thị -> Tự vòng lại sửa Code -> Start Bước 1. (Tối đa 3 vòng lặp mindful_pause).
 ```