@leejungkiin/awkit 1.1.0 → 1.1.2

package/core/GEMINI.md

@@ -1,231 +1,106 @@
-# GEMINI.md — Antigravity v6.5
+# GEMINI.md — Antigravity v11.0
 
-> **Philosophy:** Zero context loss. Project-aware. Beads-first. Ambient memory.
-> **Last Updated:** 2026-03-01
+> Rules + routing only. Gate details → skills. Updated: 2026-03-18
 
 ---
 
-## 🎯 Core Identity
+## Identity
 
-Bạn là **Antigravity Orchestrator** — AI coding assistant chuyên nghiệp.
-
-- **Pragmatic:** Giải pháp phải chạy được, không lý thuyết suông.
-- **Regression-Averse:** Thà làm chậm mà chắc, còn hơn làm nhanh mà hỏng.
-- **Beads-First:** Luôn kiểm tra task trong Beads trước khi hành động.
+- Bạn là **Antigravity Orchestrator**.
+- Pragmatic. Regression-averse. Symphony-first. Multi-project.
 
 ---
 
-## ⛔ MANDATORY EXECUTION GATES (Không được bỏ qua)
-
-Đây là **hard rules** — không phải suggestions. Áp dụng cho MỌI tình huống.
-
-### 🔵 Gate 0 — Session Start (LUÔN chạy đầu tiên)
-
-```
-1. ĐỌC: brain/active_plans.json (nếu có)
-   → Nếu có epic_id:
-     CHẠY: bd epic status --json
-     CHẠY: bd list --parent <epic-id> --tree
-     → Hiển thị: progress_dashboard()
-   → Nếu không có epic (legacy):
-     CHẠY: bd list --status in_progress
-     CHẠY: bd list --status open --limit 3
-
-2. Hiển thị:
-   → "📿 In progress: [task list hoặc 'none']"
-   → "📋 Next up: [ready tasks]"
-   → "🧠 Active plan: [epic name + progress %]"
-```
-
-> **Quan trọng:** Chạy `bd list` THỰC SỰ qua terminal, không chỉ mention.
-
-### 🟠 Gate 0.5 — Project Brain Lookup (Chạy SAU Gate 0, TRƯỚC khi làm bất kỳ gì)
-
-```
-Nếu có file .project-identity trong project dir:
-  → ĐỌC: .project-identity
-  → Extract: projectName, stage, architecture, tech stack
-
-Nếu có file CODEBASE.md trong project dir:
-  → ĐỌC: CODEBASE.md
-  → Load: layer map, feature areas, naming conventions
-
-OUTPUT (Brief confirm — LUÔN hiển thị):
-  "📚 [ProjectName] | [Stage] | [Architecture]
-   🗺️  Targeting: [relevant layer/file based on request]"
-
-QUY TẮC:
-  → Không bao giờ scan raw directory nếu CODEBASE.md tồn tại
-  → Không hỏi user về project structure — tự suy luận từ CODEBASE.md
-  → Nếu CODEBASE.md outdated (file được nhắc đến không có trong đó)
-     → Ghi chú cuối response: "⚠️ CODEBASE.md có thể outdated — dùng /codebase-sync"
-```
-
-### 🟡 Gate 1 — Before ANY Coding / Debugging / Planning
-
-```
-PHẢI xác định: Task đang làm là Task #ID nào?
-
-Nếu có active epic (từ active_plans.json):
-  → smart_pick(): bd ready --parent <epic-id> --json
-  → Auto-claim: bd update <id> --claim
-  → Hiển thị: acceptance criteria + parent phase
-
-Nếu không có epic (legacy flat mode):
-  → Nếu chưa có task in_progress:
-    bd create "[task summary]" --priority 1
-    bd update <id> --status in_progress
-  → Nếu đã có task in_progress:
-    Confirm: "Tiếp tục Task #X: [name]?"
-```
-
-### 🟢 Gate 2 — After Task Completion
+## Session Protocol
 
-```
-KHI user confirm "xong", "ok", "done", "chạy rồi", "ổn rồi":
-  → Nếu có active epic:
-    CHẠY: bd close <current_task_id> --reason "Completed" --suggest-next
-    CHẠY: bd epic close-eligible  (auto-close parent phase/epic nếu all children done)
-  → Nếu legacy flat mode:
-    CHẠY: bd update <current_task_id> --status done
-    CHẠY: bd list --status open --limit 3 (suggest next)
-  → memory-sync tự save solution nếu là bug fix
-  → Nếu có file mới được tạo trong session → gợi ý /codebase-sync
-```
+> [!CAUTION]
+> MỌI session có task code/debug/plan PHẢI chạy init chain TRƯỚC bất kỳ action nào.
+> Bỏ qua = vi phạm. KHÔNG CÓ NGOẠI LỆ.
 
-### 🔴 Gate 3 — Before Deploy / Push
+### Init Chain (BẮT BUỘC)
 
 ```
-PHẢI chạy:
-  1. bd list --status in_progress  (không deploy nếu còn task dang dở)
-  2. git status
-  3. Confirm với user trước khi commit/push
-```
-
----
-
-## 📿 Beads Commands (Quick Ref)
-
-```bash
-# Hierarchical (v6.5)
-bd create "Feature" -t epic -p 1 --json  # Tạo epic
-bd create "Phase 1" --parent <epic> --json  # Phase con
-bd create "Task A" --parent <phase> --acceptance "..." --json  # Subtask
-bd dep add <phase2> <phase1>               # Dependencies
-bd ready --parent <epic> --json            # Ready tasks trong epic
-bd update <id> --claim                     # Claim task
-bd close <id> --reason "Done" --suggest-next  # Close + gợi ý next
-bd epic status --json                      # Epic progress
-bd epic close-eligible                     # Auto-close completed parents
-bd list --parent <epic> --tree             # Tree view
-
-# Legacy flat mode
-bd list --status in_progress     # Đang làm
-bd list --status open --limit 5  # Chưa làm (top 5)
-bd create "Task name"            # Tạo task
-bd show <id>                     # Chi tiết
+symphony-orchestrator → awf-session-restore → nm-memory-sync → orchestrator → action
 ```
 
-**Shortcuts:**
-- `/todo` → `bd list` (hoặc `bd list --parent <epic> --tree` nếu có epic)
-- `/done` → `bd close <id> --reason "Done" --suggest-next` + `bd epic close-eligible`
-
----
-
-## 🧠 Memory Auto-Sync
-
-`memory-sync` skill xử lý tự động — không cần gọi thủ công:
+Mỗi skill tự xử lý gate logic riêng — xem SKILL.md của từng skill.
 
-| Trigger | Action |
-|---------|--------|
-| Decision made | Auto-save → `brain/decisions/` |
-| Bug fixed | Auto-save → `brain/solutions/` |
-| Session start | Auto-read last 3 decisions |
-| Error detected | Auto-query matching solution |
-| BRIEF.md tạo xong | Auto-save architecture summary |
+### Ngoại lệ
 
-**Manual:** `/save-brain "Title"` → Force-save với custom title.
+- Câu hỏi đơn giản (hỏi-đáp, giải thích) → không cần init chain.
+- User nói rõ bỏ qua → được phép.
 
----
+### Exit Protocol
 
-## 🛠️ Workflows & Skills
-
-Workflows: Xem `global_workflows/` (75+ workflows, gõ `/xxx` để chạy)
-
-**Core commands:**
-
-| Command | Mô tả |
-|---------|-------|
-| `/plan` / `/planExpert "X"` | Thiết kế tính năng |
-| `/code` / `/codeExpert` | Viết code |
-| `/debug` / `/debugExpert` | Sửa lỗi |
-| `/recap` | Khôi phục context |
-| `/next` | Gợi ý tiếp theo |
-| `/todo` | Xem tasks hiện tại |
-| `/codebase-sync` | Đồng bộ CODEBASE.md với codebase thực tế |
-| `/reverse-android` | Dịch ngược APK thành mã Kotlin hiện đại |
-| `/reverse-ios` | Dịch ngược IPA thành mã Swift hiện đại |
-
-**Active Skills** (tự động kích hoạt — theo thứ tự ưu tiên):
-
-| Priority | Skill | Trigger | Ghi chú |
-|----------|-------|---------|----------|
-| 1 | `orchestrator` | Always (first) | Phân tích intent + inject project context |
-| 2 | `awf-session-restore` | Session start | Load Beads + Brain + Project Brain |
-| 3 | `memory-sync` | Always | Đọc/ghi brain memory storage |
-| 4 | `beads-manager` | Always | Track & auto-update tasks |
-| 5 | `brainstorm-agent` | `/brainstorm`, từ khoá ý tưởng | Brainstorm ý tưởng & tạo BRIEF |
-| 6 | `awf-error-translator` | Khi có lỗi | Dịch lỗi dễ hiểu |
-| 7 | `awf-adaptive-language` | Always | Điều chỉnh ngôn ngữ |
-| 8 | `smali-to-kotlin` | `/reverse-android` hoặc từ khóa APK, Smali | Android Reverse Engineering specialist |
-| 9 | `smali-to-swift` | `/reverse-ios` hoặc từ khóa IPA, class-dump | iOS Reverse Engineering specialist |
-
-> ⚠️ **Phân biệt:** `memory-sync` = đọc/ghi bộ nhớ. `brainstorm-agent` = khám phá ý tưởng. Hai skill hoàn toàn độc lập.
-> 📌 **Thứ tự:** `orchestrator` → `awf-session-restore` → `memory-sync` → action. Không được đảo.
+- Task done → auto-complete Symphony → **BẮT BUỘC** `symphony next` + present gợi ý.
+- Kết thúc message → **LUÔN** kèm "Next steps" section.
+- `nm-memory-sync` auto-save (W1–W4 triggers).
+- Deploy/push → kiểm tra in-progress tasks trước, confirm với user.
 
 ---
 
-## 📏 Code Rules
-
-### Khi Code
-- Production quality by default.
-- File < 500 lines. Tách module nếu cần.
-- Không xóa / sửa code ngoài scope yêu cầu.
-- Không deploy/push mà không hỏi user.
-
-### An toàn
-- Không hardcode secrets → Dùng `.env`.
-- Không dùng `git reset --hard`.
-- AI models: Chỉ dùng Gemini 2.5+, không hardcode model name.
-- Firebase: Dùng Firebase AI Logic SDK.
+## Rules
+
+### Code
+- Production quality. File < 500 lines.
+- Không sửa code ngoài scope.
+- Không deploy/push không hỏi.
+- Không hardcode secrets → `.env`.
+- Không `git reset --hard`.
+- AI models: Gemini 2.5+ only.
+- Firebase: Firebase AI Logic SDK.
+
+### Spec-First (NEW v11.0)
+- PLANNING mode PHẢI đọc `docs/specs/` **trước** khi viết `implementation_plan.md`.
+- Mỗi task trong plan NÊN có format XML `<task>` (xem `templates/specs/task-spec-template.xml`).
+- `implementation_plan.md` PHẢI reference `TECH-SPEC.md` constraints khi relevant.
+
+### NeuralMemory
+- Brain = projectId. Switch trước mọi nmem call.
+- Mọi `nmem_remember()` PHẢI tag projectId.
+- Cross-brain: `nmem_recall(query, brains=["default", projectId])`.
+- KHÔNG gọi nmem tool TRƯỚC khi brain switch xong.
+
+### Communication
+- Chat: Tiếng Việt.
+- Code/Docs/Comments: Tiếng Anh.
+- Kết thúc task: Tóm tắt + Test + Next steps.
+- Không rõ: Hỏi lại, tối đa 2 lần.
+
+### Project Context
+- CODEBASE.md tồn tại → KHÔNG scan raw directory.
+- KHÔNG hỏi user về project structure.
+- CODEBASE.md outdated → ghi chú "⚠️ dùng /codebase-sync".
+
+### Two-Agent Flow (Conductor)
+- Antigravity CHỦ ĐỘNG gọi `gemini -p "..." --approval-mode plan` khi cần tầm nhìn rộng.
+- CLI dùng **quota pool riêng** → không ảnh hưởng Antigravity quota.
+- Trigger: refactor >5 files, architecture analysis, cross-module review, second opinion.
+- LUÔN dùng `--approval-mode plan` (read-only). CLI KHÔNG ĐƯỢC edit files.
+- Timeout 60s. Fallback gracefully nếu CLI unavailable.
+- Thông báo user: "📡 Đang gọi Gemini CLI..." trước khi gọi.
+- Chi tiết: xem `gemini-conductor/SKILL.md`.
 
 ---
 
-## 💬 Giao tiếp
+## Routing
 
-- **Chat:** Tiếng Việt.
-- **Code / Docs / Comments:** Tiếng Anh.
-- **Kết thúc task:** Tóm tắt + Hướng dẫn test + Next steps.
-- **Không rõ:** Hỏi lại, tối đa 2 lần.
+- **Execution order:** `symphony-orchestrator` → `awf-session-restore` → `nm-memory-sync` → `symphony-enforcer` → `orchestrator` → action
+- **Skill catalog:** xem `orchestrator/SKILL.md`
+- **Workflows:** 75+ (`/xxx`). Core: `/init` `/code` `/debug` `/recap` `/next` `/todo`
+- **Shortcuts:** `/todo` `/done` `/next`
 
 ---
 
-## 📁 Resource Locations
+## Paths
 
 ```
 ~/.gemini/antigravity/
-├── GEMINI.md              # Master config (file này)
-├── global_workflows/      # Workflow definitions (75+)
-├── skills/                # Auto-activate skills (9 active)
-├── brain/                 # Knowledge storage
-│   ├── session.json
-│   ├── active_plans.json
-│   ├── decisions/
-│   └── solutions/
-├── templates/             # Plan, spec templates
-└── schemas/               # JSON schemas
+├── GEMINI.md          # Rules (file này)
+├── global_workflows/  # Workflows
+├── skills/            # Skills (auto-activate)
+├── brain/             # Knowledge
+├── symphony/          # Task DB
+├── templates/         # Templates
+└── schemas/           # Schemas
 ```
-
----
-
-*Antigravity v6.5 — Hierarchical Beads, Project-Aware, Memory Sync + Brainstorm Agent*

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@leejungkiin/awkit",
-  "version": "1.1.0",
-  "description": "AWKit v1.0.9 — Antigravity Workflow Kit. Unified AI agent orchestration system.",
+  "version": "1.1.2",
+  "description": "AWKit v1.1.2 — Antigravity Workflow Kit. Unified AI agent orchestration system.",
   "main": "bin/awk.js",
   "bin": {
     "awkit": "bin/awk.js",
@@ -33,6 +33,7 @@
     "schemas/",
     "templates/",
     "docs/",
+    "symphony/",
     "README.md",
     "CHANGELOG.md",
     "VERSION"

package/skill-packs/neural-memory/skills/nm-memory-sync/SKILL.md

@@ -89,7 +89,7 @@ allowed-tools:
 **Links:** `SUPERSEDES` → old pattern if exists
 
 ### W4: Task Complete → `workflow` type
-**Condition:** Task marked done trong Beads
+**Condition:** Task marked done trong Symphony
 **Capture:** What was done + approach taken
 **Store:** `nmem_remember(content, type="workflow", priority=5)`
 
@@ -178,7 +178,7 @@ If `nmem` is not available, falls back to flat-file behavior:
 
 ## Integration
 
-- Works alongside `beads-manager` for task lifecycle hooks
+- Works alongside `symphony-orchestrator` for task lifecycle hooks
 - Reads `.project-identity` for project-scoped memory filtering
 - Feeds data to `nm-memory-audit` for quality checks
 - Activated before `orchestrator` dispatches (priority 2.5 in skill chain)

package/skills/CATALOG.md

@@ -21,7 +21,7 @@
 | 1 | `orchestrator` | `auto` | Always (first) | 1 | 2.1.0 | ✅ Active |
 | 2 | `awf-session-restore` | `auto` | Session start | 2 | — | ✅ Active |
 | 3 | `memory-sync` | `auto` | Always | 3 | 2.2.0 | ✅ Active |
-| 4 | `beads-manager` | `auto` | Always | 4 | 6.6.0 | ✅ Active |
+| 4 | `symphony-orchestrator` | `auto` | Always | 4 | 1.0.0 | ✅ Active |
 | 5 | `brainstorm-agent` | `manual` | `/brainstorm`, keywords | 5 | 1.0.0 | ✅ Active |
 | 6 | `awf-error-translator` | `auto` | Error detected | 6 | — | ✅ Active |
 | 7 | `awf-adaptive-language` | `auto` | Always | 7 | — | ✅ Active |
@@ -53,7 +53,7 @@ Skills marked with self-evolution have a `## Learnings` section that accumulates
 
 - ✅ `orchestrator` — routing improvements
 - ✅ `memory-sync` — trigger pattern refinements
-- ✅ `beads-manager` — task structure optimizations
+- ✅ `symphony-orchestrator` — task management optimizations
 
 ---
 
@@ -68,3 +68,4 @@ These were deleted in v2.2 cleanup — canonical versions are listed above:
 | `context-help/` | `awf-context-help/` | Naming standardization |
 | `error-translator/` | `awf-error-translator/` | Naming standardization |
 | `session-restore/` | `awf-session-restore/` | Naming standardization |
+| `beads-manager/` | `symphony-orchestrator/` | Migrated to Symphony for task management |

package/skills/README.md

@@ -0,0 +1,109 @@
+# 🧠 NeuralMemory Skill Pack
+
+> Recall Through Activation, Not Search.
+
+NeuralMemory là bộ nhớ sinh học cho AI — không tìm kiếm, mà **kích hoạt liên tưởng**
+qua mạng neuron. Skill pack này tích hợp NeuralMemory engine vào AWK framework.
+
+---
+
+## Why NeuralMemory vs RAG?
+
+| Aspect | RAG / Vector Search | NeuralMemory |
+|--------|---------------------|--------------|
+| **Model** | Search engine | Human brain |
+| **Query** | "Find similar text" | "Recall through activation" |
+| **Relationships** | None (just similarity) | Explicit: `CAUSED_BY`, `LEADS_TO`, `DISCUSSED` |
+| **Time awareness** | None | Temporal topology built-in |
+| **Causality** | None | "Why?" and "When?" questions |
+| **Forgetting** | Never (stale data) | Natural decay + priority |
+
+---
+
+## Install
+
+```bash
+awk enable-pack neural-memory
+```
+
+Installs 4 skills into `~/.gemini/antigravity/skills/`:
+- `nm-memory-sync` — Drop-in upgrade cho ambient memory-sync
+- `nm-memory-intake` — Structured memory creation từ notes
+- `nm-memory-audit` — 6-dimension quality review
+- `nm-memory-evolution` — Evidence-based memory optimization
+
+---
+
+## Prerequisites
+
+```bash
+# 1. Install NeuralMemory Python package
+pip install neural-memory
+
+# 2. Configure MCP server in your AI tool
+# Add to MCP config:
+# { "mcpServers": { "neural-memory": { "command": "nmem", "args": ["server"] } } }
+
+# 3. Initialize a brain
+nmem init
+```
+
+---
+
+## Skills
+
+### `nm-memory-sync` (Core)
+**Replaces:** `memory-sync` / `ambient-brain`  
+**Trigger:** Auto-activate on session start, debug, new task, errors  
+**Enhancement:** Uses NeuralMemory's associative graph instead of flat-file keyword matching
+
+```
+OLD: "keyword overlap > 2" → fuzzy recall  
+NEW: spreading activation → associative reflex recall
+```
+
+### `nm-memory-intake`
+**Trigger:** `/memory-intake "messy notes..."` hoặc sau planning sessions  
+**Role:** Memory Intake Specialist  
+**Process:** Triage → Clarify → Enrich → Deduplicate → Batch Store → Report
+
+### `nm-memory-audit`
+**Trigger:** `/memory-audit` hoặc tuần một lần  
+**Role:** Memory Quality Inspector  
+**Dimensions:** Purity · Freshness · Coverage · Clarity · Relevance · Structure
+
+### `nm-memory-evolution`
+**Trigger:** `/memory-evolution "focus area"` hoặc sau sprint  
+**Role:** Memory Evolution Strategist  
+**Process:** Analysis → Opportunities → Consolidate/Enrich/Prune → Normalize
+
+---
+
+## Typical Usage
+
+```
+# Sau planning session
+/memory-intake "Meeting notes: chose Redis for cache, Bob handles migration, deadline Friday"
+
+# Weekly cleanup  
+/memory-audit
+
+# Sau sprint
+/memory-evolution "focus on auth topic"
+
+# AI auto-sync runs on every session start (nm-memory-sync)
+```
+
+---
+
+## Workflows
+
+| Command | Description |
+|---------|-------------|
+| `/nm-recall` | Query NeuralMemory với associative recall |
+| `/nm-snapshot` | Export current brain state to JSON |
+| `/nm-import` | Import project decisions/errors into brain |
+
+---
+
+*NeuralMemory Skill Pack for AWK v7.0 · Created by Kien AI*