@leejungkiin/awkit 1.5.6 → 1.6.1

package/README.md

@@ -1,6 +1,6 @@
-# AWKit — Antigravity Workflow Kit v1
+# AWKit — Antigravity Workflow Kit v12.5
 
-> **v1.5.0** · Single Source of Truth · Symphony-First · Ambient Memory
+> **v12.5.0** · 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.
 
@@ -18,6 +18,7 @@ AWKit (Antigravity v12+) thực thi 8 nguyên tắc lõi (Gstack-inspired) nhằ
 6. **Scope Freeze:** Khi debugging: KHÔNG sửa code không liên quan, KHÔNG refactor. Chỉ tập trung root cause.
 7. **Boil-the-Lake Checklist:** Checklist trước khi báo DONE: error handling, edge cases, logging, cleanup, input validation...
 8. **Safety Guardrails:** Chặn auto-run cho các lệnh nguy hiểm (`rm -rf`, `git push --force`, deploy production). Bắt buộc double-confirm.
+9. **Mindful Execution (v12.5+):** Chống AI "brain fry" bằng Iteration Counter (dừng sau 3 lần polish), Scope Guard, và Milestone Rest.
 
 ---
 
@@ -191,10 +192,10 @@ AWKit (từ bản cập nhật tích hợp mới) sử dụng **GitNexus** làm
 
 ```bash
 # 1. Quét toàn bộ project để tạo knowledge graph (chỉ cần chạy lần đầu hoặc khi cấu trúc code thay đổi lớn)
-npx @leejungkiin/gitnexus analyze
+npx @duytransipher/gitnexus analyze
 
 # 2. Setup MCP servers và skills tự động cho Antigravity và các editors khác:
-npx @leejungkiin/gitnexus setup
+npx @duytransipher/gitnexus setup
 ```
 
 AI agent của hệ thống cũng tự động gọi qua cổng GitNexus bằng MCP Tools để tự phân tích rủi ro trước khi commit!
@@ -219,6 +220,7 @@ awkit enable-pack creator-studio
 | 6.x | AWF v6 | main-awf, multiple sources |
 | **1.1.x** | **AWKit v1.1.9** | **Single source of truth, Native CLI, Telegram Integration** |
 | **1.5.x** | **AWKit v1.5.0** | **Unified Orchestration, Symphony 1.5.0, 7-Gate Intelligence** |
+| **12.5.x** | **Antigravity v12.5** | **Mindful Checkpoints (TP-ITER, TP-SCOPE, TP-REST), @duytransipher/gitnexus** |
 
 ---
 

package/bin/awk.js

@@ -38,6 +38,7 @@ const HOME = process.env.HOME || process.env.USERPROFILE;
 const { generateClineRules, generateClineWorkflows, generateClineSkills } = require('./cline-generators');
 const { generateCodexAgentsMd, generateCodexSkills, generateCodexAgents } = require('./codex-generators');
 const { generateClaudeRules, generateClaudeSkills } = require('./claude-generators');
+const { cmdGate } = require('../scripts/automation-gate');
 
 // ─── Platform Definitions ──────────────────────────────────────────────────
 
@@ -2050,6 +2051,18 @@ function cmdHelp() {
     log(`  ${C.gray}  --parse-mode <md|html>${C.reset}  Formatting mode`);
     log('');
 
+    // GitNexus
+    log(`${C.bold}🔍  GitNexus${C.reset}`);
+    log(line);
+    log(`  ${C.green}gitnexus list${C.reset}       List all indexed repositories`);
+    log(`  ${C.green}gitnexus status${C.reset}     Show current project index info`);
+    log(`  ${C.green}gitnexus clean${C.reset}      Interactive cleanup of old indexes`);
+    log(`  ${C.green}gitnexus clean${C.reset} ${C.gray}<name...>${C.reset}  Remove specific repo(s) by name`);
+    log(`  ${C.gray}  --stale${C.reset}            Auto-remove repos with missing paths`);
+    log(`  ${C.gray}  --all${C.reset}              Remove all except current project`);
+    log(`  ${C.gray}  Alias: gn${C.reset}`);
+    log('');
+
     // Available packs
     const packsDir = path.join(AWK_ROOT, 'skill-packs');
     if (fs.existsSync(packsDir)) {
@@ -2871,8 +2884,12 @@ function tgSend(args) {
                     dim('Telegram notifications are disabled for this project (.project-identity).');
                     return;
                 }
-                if (tgAuto.chatId) chatId = tgAuto.chatId;
-                if (tgAuto.topicId) topicId = tgAuto.topicId;
+                if (tgAuto.chatId) {
+                    chatId = tgAuto.chatId;
+                    // Reset topicId when chatId is overridden — global topicId belongs to global chatId
+                    topicId = null;
+                }
+                if (tgAuto.topicId && parseInt(tgAuto.topicId, 10) > 1) topicId = tgAuto.topicId;
             }
         } catch (e) { }
     }
@@ -3378,6 +3395,309 @@ function checkAutoUpdate() {
     }
 }
 
+// ─── GitNexus Management ──────────────────────────────────────────────────────
+
+const GITNEXUS_REGISTRY = path.join(HOME, '.gitnexus', 'registry.json');
+
+function readGitnexusRegistry() {
+    if (!fs.existsSync(GITNEXUS_REGISTRY)) return [];
+    try {
+        return JSON.parse(fs.readFileSync(GITNEXUS_REGISTRY, 'utf8'));
+    } catch (_) {
+        return [];
+    }
+}
+
+function writeGitnexusRegistry(registry) {
+    fs.mkdirSync(path.dirname(GITNEXUS_REGISTRY), { recursive: true });
+    fs.writeFileSync(GITNEXUS_REGISTRY, JSON.stringify(registry, null, 2) + '\n');
+}
+
+function cmdGitnexus(args) {
+    const sub = args[0] || 'list';
+
+    switch (sub) {
+        case 'list':
+        case 'ls': {
+            const registry = readGitnexusRegistry();
+            if (registry.length === 0) {
+                info('No GitNexus indexed repositories found.');
+                dim('Run `npx gitnexus analyze` in a project to index it.');
+                return;
+            }
+
+            log('');
+            log(`${C.cyan}${C.bold}🔍 GitNexus Indexed Repositories (${registry.length})${C.reset}`);
+            log(`${C.gray}${'─'.repeat(56)}${C.reset}`);
+
+            const cwd = process.cwd();
+            for (const repo of registry) {
+                const isCurrent = repo.path === cwd;
+                const marker = isCurrent ? `${C.green}◉` : `${C.gray}○`;
+                const nameColor = isCurrent ? C.green : C.reset;
+                const stats = repo.stats || {};
+                const indexDate = repo.indexedAt ? new Date(repo.indexedAt).toLocaleDateString() : 'unknown';
+                const pathExists = fs.existsSync(repo.path);
+                const pathStatus = pathExists ? '' : ` ${C.red}(path missing!)${C.reset}`;
+
+                log(`  ${marker} ${nameColor}${C.bold}${repo.name}${C.reset}${pathStatus}`);
+                dim(`    Path:    ${repo.path}`);
+                dim(`    Indexed: ${indexDate} | ${stats.nodes || 0} symbols, ${stats.edges || 0} edges, ${stats.processes || 0} flows`);
+            }
+            log('');
+            break;
+        }
+
+        case 'status': {
+            const cwd = process.cwd();
+            const registry = readGitnexusRegistry();
+            const match = registry.find(r => r.path === cwd);
+
+            if (!match) {
+                warn('Current directory is not indexed by GitNexus.');
+                dim('Run `npx gitnexus analyze` to index this project.');
+                return;
+            }
+
+            const stats = match.stats || {};
+            const indexDate = match.indexedAt ? new Date(match.indexedAt) : null;
+            const ageMs = indexDate ? Date.now() - indexDate.getTime() : 0;
+            const ageDays = Math.floor(ageMs / (1000 * 60 * 60 * 24));
+            const stale = ageDays > 7;
+
+            log('');
+            log(`${C.cyan}${C.bold}🔍 GitNexus: ${match.name}${C.reset}`);
+            log(`${C.gray}${'─'.repeat(56)}${C.reset}`);
+            dim(`Path:        ${match.path}`);
+            dim(`Storage:     ${match.storagePath}`);
+            dim(`Indexed:     ${indexDate ? indexDate.toLocaleString() : 'unknown'} (${ageDays}d ago)`);
+            dim(`Last Commit: ${match.lastCommit || 'n/a'}`);
+            dim(`Symbols:     ${stats.nodes || 0}`);
+            dim(`Relations:   ${stats.edges || 0}`);
+            dim(`Communities: ${stats.communities || 0}`);
+            dim(`Processes:   ${stats.processes || 0}`);
+            dim(`Embeddings:  ${stats.embeddings || 0}`);
+
+            if (stale) {
+                log('');
+                warn(`Index is ${ageDays} days old. Consider refreshing:`);
+                dim('  npx gitnexus analyze');
+            }
+
+            // Show projectId from .project-identity if available
+            const identityPath = path.join(cwd, '.project-identity');
+            const identity = readJsonFile(identityPath);
+            if (identity && identity.projectId) {
+                dim(`Project ID:  ${identity.projectId}`);
+            }
+            log('');
+            break;
+        }
+
+        case 'clean': {
+            const registry = readGitnexusRegistry();
+            if (registry.length === 0) {
+                info('No GitNexus indexed repositories to clean.');
+                return;
+            }
+
+            const cwd = process.cwd();
+            const isStaleMode = args.includes('--stale');
+            const isAllMode = args.includes('--all');
+
+            // Named repos: awkit gn clean <name1> <name2> ...
+            const namedArgs = args.slice(1).filter(a => !a.startsWith('--'));
+            if (namedArgs.length > 0 && !isStaleMode && !isAllMode) {
+                const nameLookup = new Map(registry.map(r => [r.name.toLowerCase(), r]));
+                const matched = [];
+                const notFound = [];
+
+                for (const name of namedArgs) {
+                    const entry = nameLookup.get(name.toLowerCase());
+                    if (entry) matched.push(entry);
+                    else notFound.push(name);
+                }
+
+                if (notFound.length > 0) {
+                    warn(`Not found in registry: ${notFound.join(', ')}`);
+                    dim('Available repos:');
+                    for (const r of registry) dim(`  • ${r.name}`);
+                }
+
+                if (matched.length === 0) {
+                    info('No matching repos to clean.');
+                    return;
+                }
+
+                log('');
+                log(`${C.yellow}${C.bold}🧹 Will remove ${matched.length} repo(s):${C.reset}`);
+                for (const r of matched) {
+                    log(`  ${C.red}✗${C.reset} ${r.name} — ${r.path}`);
+                }
+                log('');
+
+                if (!promptYN('Confirm?')) {
+                    info('Cancelled.');
+                    return;
+                }
+
+                const removeNames = new Set(matched.map(r => r.name));
+                for (const r of matched) {
+                    if (r.storagePath && fs.existsSync(r.storagePath)) {
+                        try {
+                            fs.rmSync(r.storagePath, { recursive: true, force: true });
+                            dim(`Deleted: ${r.storagePath}`);
+                        } catch (e) {
+                            warn(`Failed to delete ${r.storagePath}: ${e.message}`);
+                        }
+                    }
+                }
+
+                const remaining = registry.filter(r => !removeNames.has(r.name));
+                writeGitnexusRegistry(remaining);
+                ok(`Removed ${matched.length} repos. ${remaining.length} remaining.`);
+                return;
+            }
+
+            if (isStaleMode) {
+                // Auto-clean repos whose paths no longer exist
+                const stale = registry.filter(r => !fs.existsSync(r.path));
+                if (stale.length === 0) {
+                    ok('No stale repos found. All paths are valid.');
+                    return;
+                }
+
+                log('');
+                log(`${C.yellow}${C.bold}🧹 Found ${stale.length} stale repo(s):${C.reset}`);
+                for (const r of stale) {
+                    log(`  ${C.red}✗${C.reset} ${r.name} — ${r.path}`);
+                }
+                log('');
+
+                if (!promptYN('Remove these stale entries?')) {
+                    info('Cancelled.');
+                    return;
+                }
+
+                for (const r of stale) {
+                    // Remove .gitnexus storage if it exists
+                    if (r.storagePath && fs.existsSync(r.storagePath)) {
+                        try {
+                            fs.rmSync(r.storagePath, { recursive: true, force: true });
+                            dim(`Deleted: ${r.storagePath}`);
+                        } catch (e) {
+                            warn(`Failed to delete ${r.storagePath}: ${e.message}`);
+                        }
+                    }
+                }
+
+                const remaining = registry.filter(r => fs.existsSync(r.path));
+                writeGitnexusRegistry(remaining);
+                ok(`Removed ${stale.length} stale entries. ${remaining.length} repos remaining.`);
+                return;
+            }
+
+            if (isAllMode) {
+                const toRemove = registry.filter(r => r.path !== cwd);
+                if (toRemove.length === 0) {
+                    info('Only current project is indexed. Nothing to clean.');
+                    return;
+                }
+
+                log('');
+                log(`${C.yellow}${C.bold}🧹 Will remove ${toRemove.length} repo(s) (keeping current project):${C.reset}`);
+                for (const r of toRemove) {
+                    log(`  ${C.red}✗${C.reset} ${r.name} — ${r.path}`);
+                }
+                log('');
+
+                if (!promptYN('Proceed?')) {
+                    info('Cancelled.');
+                    return;
+                }
+
+                for (const r of toRemove) {
+                    if (r.storagePath && fs.existsSync(r.storagePath)) {
+                        try {
+                            fs.rmSync(r.storagePath, { recursive: true, force: true });
+                            dim(`Deleted: ${r.storagePath}`);
+                        } catch (e) {
+                            warn(`Failed to delete ${r.storagePath}: ${e.message}`);
+                        }
+                    }
+                }
+
+                const remaining = registry.filter(r => r.path === cwd);
+                writeGitnexusRegistry(remaining);
+                ok(`Removed ${toRemove.length} repos. Current project preserved.`);
+                return;
+            }
+
+            // Interactive mode: show numbered list, user selects
+            log('');
+            log(`${C.cyan}${C.bold}🔍 Select repos to remove:${C.reset}`);
+            log(`${C.gray}${'─'.repeat(56)}${C.reset}`);
+
+            for (let i = 0; i < registry.length; i++) {
+                const r = registry[i];
+                const isCurrent = r.path === cwd;
+                const pathExists = fs.existsSync(r.path);
+                const tag = isCurrent ? ` ${C.green}(current)${C.reset}` : !pathExists ? ` ${C.red}(missing)${C.reset}` : '';
+                log(`  ${C.yellow}${i + 1}${C.reset}. ${r.name}${tag}`);
+                dim(`     ${r.path}`);
+            }
+            log('');
+
+            const input = promptChoice('Enter numbers to remove (e.g. 2,3,5)', '').trim();
+            if (!input) {
+                info('No selection. Cancelled.');
+                return;
+            }
+
+            const indices = input.split(',').map(s => parseInt(s.trim(), 10) - 1).filter(i => i >= 0 && i < registry.length);
+            if (indices.length === 0) {
+                info('Invalid selection. Cancelled.');
+                return;
+            }
+
+            const selected = indices.map(i => registry[i]);
+            log('');
+            log(`${C.yellow}Will remove:${C.reset}`);
+            for (const r of selected) {
+                log(`  ${C.red}✗${C.reset} ${r.name}`);
+            }
+            log('');
+
+            if (!promptYN('Confirm?')) {
+                info('Cancelled.');
+                return;
+            }
+
+            const removeNames = new Set(selected.map(r => r.name));
+            for (const r of selected) {
+                if (r.storagePath && fs.existsSync(r.storagePath)) {
+                    try {
+                        fs.rmSync(r.storagePath, { recursive: true, force: true });
+                        dim(`Deleted: ${r.storagePath}`);
+                    } catch (e) {
+                        warn(`Failed to delete ${r.storagePath}: ${e.message}`);
+                    }
+                }
+            }
+
+            const remaining = registry.filter(r => !removeNames.has(r.name));
+            writeGitnexusRegistry(remaining);
+            ok(`Removed ${selected.length} repos. ${remaining.length} remaining.`);
+            break;
+        }
+
+        default:
+            err(`Unknown gitnexus sub-command: ${sub}`);
+            log(`  Available: list, status, clean`);
+            break;
+    }
+}
+
 // ─── Native HTTP Server ───────────────────────────────────────────────────────
 
 function cmdServe(args) {
@@ -3540,6 +3860,13 @@ const [, , command, ...args] = process.argv;
         case 'serve':
             cmdServe(args);
             break;
+        case 'gitnexus':
+        case 'gn':
+            cmdGitnexus(args);
+            break;
+        case 'gate':
+            cmdGate(args);
+            break;
         case 'admin':
             cmdAdmin();
             break;

package/core/GEMINI.md

@@ -49,15 +49,23 @@ Mỗi skill tự xử lý gate logic riêng — xem SKILL.md của từng skill.
 - AI models: Gemini 2.5+ only.
 - Firebase: Firebase AI Logic SDK.
 
-### Auto-Commit & Push (Per-Project Automation)
-- **ĐIỀU KIỆN:** Bắt buộc tuân thủ config `automation.git` trong `.project-identity` (nếu có).
-  - Nếu `autoCommit: false` → **KHÔNG** tự commit.
-  - Nếu `autoPush: false` → **KHÔNG** tự push.
-- Nếu được phép: Build thành công (0 errors) → **TỰ ĐỘNG** `git add` → `git commit` → `git push` (non-force, không chờ approval).
-- Commit message: conventional format (`fix:`, `feat:`, `refactor:`, `chore:`).
-- `git push` (non-force) được phép `SafeToAutoRun=true`. Nếu push fail → retry 1 lần với `git pull --rebase && git push`.
-- **Telegram Notification:** Sau khi push thành công → Đọc config `automation.telegram.triggers.git_push`. Nếu bật (hoặc default true) → tự động báo qua lệnh `awkit tg send`.
-- Cấm force push. Cấm push fail mà không báo cáo.
+### Automation Gate (BẮT BUỘC)
+- AI **PHẢI** dùng `awkit gate` thay vì gọi trực tiếp `git commit/push`, `awkit trello`, `awkit tg send`.
+- `awkit gate` tự đọc `.project-identity` → enforce `automation.*` config → execute hoặc block.
+- **Git:**
+  - `awkit gate git auto "message"` — commit + push + telegram notify (nếu enabled).
+  - `awkit gate git commit "message"` — chỉ commit.
+  - `awkit gate git push` — chỉ push.
+  - Commit message: conventional format (`fix:`, `feat:`, `refactor:`, `chore:`).
+  - Push fail → auto-retry 1 lần với `git pull --rebase`. Cấm force push.
+- **Trello:**
+  - `awkit gate trello complete "Task"` — gated trello complete.
+  - `awkit gate trello comment "Note"` — gated trello comment.
+  - `awkit gate trello block "Reason"` — gated trello block.
+- **Telegram:**
+  - `awkit gate telegram send "Message"` — gated telegram send.
+- **Dry-run:** `awkit gate check` — hiển thị trạng thái gate hiện tại (không execute).
+- ⛔ Gọi `git commit/push` hoặc `awkit trello/tg` trực tiếp (bypass gate) = **VI PHẠM**.
 
 ### 7-Gate Autonomous System (v12.3)
 - orchestrator PHẢI triage complexity (TRIVIAL/MODERATE/COMPLEX) trước mọi task.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@leejungkiin/awkit",
-  "version": "1.5.6",
-  "description": "Antigravity Workflow Kit. Unified AI agent orchestration system.",
+  "version": "1.6.1",
+  "description": "Antigravity Workflow Kit v12.5. Unified AI agent orchestration system with Mindful Checkpoints.",
   "main": "bin/awk.js",
   "bin": {
     "awkit": "bin/awk.js",
@@ -38,6 +38,6 @@
   ],
   "dependencies": {
     "@leejungkiin/awkit-symphony": "^1.5.0",
-    "@leejungkiin/gitnexus": "file:../gitnexus/gitnexus"
+    "@duytransipher/gitnexus": "latest"
   }
 }

package/skills/CATALOG.md

@@ -1,7 +1,7 @@
 # 📋 AWF Skill Catalog
 
-> Classification of core runtime skills and optional packs.
-> Updated: 2026-04-02
+> Classification of all skills by type, trigger, and priority.
+> Updated: 2026-03-06
 
 ---
 
@@ -9,65 +9,60 @@
 
 | Type | Description | Example |
 |------|-------------|---------|
-| `auto` | Always active, runs silently without user command | `orchestrator`, `nm-memory-sync` |
+| `auto` | Always active, runs silently without user command | `orchestrator`, `memory-sync` |
 | `manual` | User must explicitly invoke via `/command` or keyword | `brainstorm-agent`, `ios-engineer` |
 
 ---
 
-## Default Runtime Profile (`awkit install`)
+## Active Skills
+
+| # | Skill | Type | Trigger | Priority | Version | Status |
+|---|-------|------|---------|----------|---------|--------|
+| 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 | `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 |
+| 8 | `ios-engineer` | `manual` | iOS tasks | — | — | ✅ Active |
+| 9 | `smali-to-kotlin` | `manual` | `/reverse-android` | 8 | — | ✅ Active |
+| 10 | `smali-to-swift` | `manual` | `/reverse-ios` | 9 | — | ✅ Active |
+| 11 | `awf-context-help` | `auto` | `/help`, stuck | — | — | ✅ Active |
+| 12 | `auto-save` | `auto` | Session end | — | — | ✅ Background |
+| 13 | `awf-version-tracker` | `auto` | Skill changes | — | — | ✅ Background |
+| 14 | `module-spec-writer` | `auto` | Gate 1.5 check fail | 1.5 | 1.0.0 | ✅ Active |
+| 15 | `spec-gate` | `auto` | Gate 2 check fail | 2 | 1.0.0 | ✅ Active |
+| 16 | `visual-design-gate` | `auto` | Gate 2.5 check fail | 2.5 | 1.0.0 | ✅ Active |
+| 17 | `trello-sync` | `auto` | Always | 2 | 3.0.0 | ✅ Active |
 
-`awkit install` now installs a lean runtime profile instead of the full source skill library.
-
-### Core Lifecycle & Coordination
-
-- `orchestrator`
-- `symphony-orchestrator`
-- `awf-session-restore`
-- `nm-memory-sync`
-- `symphony-enforcer`
-- `trello-sync`
-
-### Planning & Execution
-
-- `brainstorm-agent`
-- `module-spec-writer`
-- `spec-gate`
-- `visual-design-gate`
-- `single-flow-task-execution`
+---
 
-### Quality & Debugging
+## Quality & Discipline Skills (Superpowers-Inspired)
 
-- `systematic-debugging`
-- `verification-gate`
-- `code-review`
-- `gitnexus-intelligence`
+> Skills ported and adapted from [obra/superpowers](https://github.com/obra/superpowers) framework.
+> Integrated into AWKit with NeuralMemory + Symphony extensions.
 
-### Meta / Self-Evolution
+| # | Skill | Type | Trigger | Priority | Status |
+|---|-------|------|---------|----------|--------|
+| 14 | `verification-gate` | `auto` | Task completion, commit, deploy | 1 | ✅ Active |
+| 15 | `systematic-debugging` | `auto` | `/debug`, error detected, test failures | 2 | ✅ Active |
+| 16 | `code-review` | `auto` | Task completion, before merge | 3 | ✅ Active |
+| 17 | `writing-skills` | `manual` | Creating/modifying skills | — | ✅ Active |
 
-- `writing-skills`
-- `skill-creator`
-- `awf-version-tracker`
-- `auto-save`
-- `awf-adaptive-language`
-- `awf-context-help`
-- `awf-error-translator`
-- `gemini-conductor`
-- `codex-conductor`
-- `telegram-notify`
-- `ship-to-code`
 
 ---
 
-## Optional Packs
+## NeuralMemory Skill Pack (Optional Upgrade)
+
+When NeuralMemory is installed, these skills provide enhanced capabilities:
 
-| Pack | Purpose |
-|------|---------|
-| `mobile-ios` | iOS, SwiftUI, Xcode, reverse engineering |
-| `mobile-android` | Android, Kotlin, Compose, AdMob, APK analysis |
-| `marketing` | ASO, App Store marketing, analytics, growth |
-| `creator-studio` | Sprites, LucyLab TTS, short-form video workflows |
-| `neural-memory` | Memory audit, intake, evolution, extra workflows |
-| `superpowers` | Additional execution/TDD/reference skills ported from Superpowers |
+| # | Skill | Type | Replaces | Trigger |
+|---|-------|------|----------|---------|
+| 1 | `nm-memory-sync` | `auto` | `memory-sync` | Session start, debug, errors |
+| 2 | `nm-memory-intake` | `manual` | — | `/memory-intake` |
+| 3 | `nm-memory-audit` | `manual` | — | `/memory-audit` |
+| 4 | `nm-memory-evolution` | `manual` | — | `/memory-evolution` |
 
 ---
 
@@ -76,7 +71,7 @@
 Skills marked with self-evolution have a `## Learnings` section that accumulates insights:
 
 - ✅ `orchestrator` — routing improvements
-- ✅ `nm-memory-sync` — trigger pattern refinements
+- ✅ `memory-sync` — trigger pattern refinements
 - ✅ `symphony-orchestrator` — task management optimizations
 
 ---

package/skills/TRIGGER_INDEX.md

@@ -0,0 +1,30 @@
+# Skill Trigger Index
+
+> ⚠️ TRƯỚC mọi side-effect, scan bảng này → load skill tương ứng TRƯỚC khi act.
+> Check THEN act — never act THEN check.
+
+| Skill | Trigger | Path | Pri |
+|:---|:---|:---|:---|
+| orchestrator | Mọi request (routing) | orchestrator/SKILL.md | 🔴 |
+| symphony-enforcer | Task create/update/complete, progress report | symphony-enforcer/SKILL.md | 🔴 |
+| symphony-orchestrator | Session start, server check | symphony-orchestrator/SKILL.md | 🔴 |
+| awf-session-restore | Session start, init chain | awf-session-restore/SKILL.md | 🔴 |
+| nm-memory-sync | Session start/end, debug, errors | nm-memory-sync/SKILL.md | 🟡 |
+| verification-gate | Task completion, commit, deploy, success claims | verification-gate/SKILL.md | 🟡 |
+| code-review | Task completion, before merge | code-review/SKILL.md | 🟡 |
+| spec-gate | Gate 2 architecture design | spec-gate/SKILL.md | 🟡 |
+| brainstorm-agent | `/brainstorm`, ý tưởng, ideation | brainstorm-agent/SKILL.md | 🟢 |
+| skill-creator | `/create-agent-skill`, tạo/sửa skill | skill-creator/SKILL.md | 🟢 |
+| gitnexus-intelligence | Refactoring, impact analysis, pre-commit | gitnexus-intelligence/SKILL.md | 🟢 |
+| ship-to-code | Code porting, migration, language translation | ship-to-code/SKILL.md | 🟢 |
+| visual-design-gate | Gate 2.5 UI/UX design sync | visual-design-gate/SKILL.md | 🟢 |
+| module-spec-writer | Gate 1.5 COMPLEX + >3 modules | module-spec-writer/SKILL.md | 🟢 |
+
+## File Guards
+
+| File pattern | PHẢI đọc lại | Lý do |
+|:---|:---|:---|
+| `symphony/**/*.json` | `symphony-enforcer/SKILL.md` | Task integrity |
+| `.project-identity` | `orchestrator/SKILL.md` | Project config |
+| `**/SKILL.md` | `skill-creator/SKILL.md` | Skill format |
+| `GEMINI.md` | N/A (self-referencing) | Core rules |

package/skills/awf-session-restore/SKILL.md

@@ -15,7 +15,9 @@ invocation-type: auto
 priority: 2
 ---
 
-# AWF Session Restore (v7.0 — Symphony Native)
+<!-- ⚠️ INIT CHAIN CRITICAL — File này quyết định thứ tự context loading. Sai = rò rỉ cross-project memory. -->
+
+# AWF Session Restore (v7.2 — Symphony Native + Trigger Index)
 
 > **Purpose:** Silently gather unstructured context (Git, Plans, Memory) at session start.
 > **Key Change v7.0:** Symphony-native. Strict brain scoping.
@@ -63,7 +65,8 @@ cat .project-identity 2>/dev/null || echo "NO_PROJECT"
 ```
 
 **Nếu tìm thấy:** Extract `projectId` và `projectName` từ JSON.
-**Nếu không:** Ghi nhận `raw mode` — các bước sau vẫn chạy nhưng không scope theo project.
+**Cache Mindful Config:** Extract `mindfulCheckpoint` và `mindfulCheckpointConfig` (defaults: enabled=true, threshold=3, scopeGuard=true, milestoneRest=true).
+**Nếu không:** Ghi nhận `raw mode` — các bước sau vẫn chạy nhưng không scope theo project. Mindful defaults vẫn ON.
 
 ### Step 2: Switch NeuralMemory Brain (CHẠY THỨ HAI)
 
@@ -119,6 +122,14 @@ Hoặc dùng MCP tool (sau khi brain đã switch):
 symphony_available_tasks(filter="my")
 ```
 
+#### 3e. Skill Trigger Index (v7.2 — Two-Tier Loading)
+```
+Read: ~/.gemini/antigravity/skills/TRIGGER_INDEX.md
+→ Memorize trigger table (~150 tokens)
+→ Load specific SKILL.md files ON DEMAND khi action matches trigger
+→ KHÔNG load toàn bộ SKILL.md files upfront
+```
+
 ### Step 4: Compose Silent Context
 
 **KHÔNG in ra console.** Tổng hợp thành context object ngầm cho AI sử dụng nội bộ:
@@ -141,6 +152,12 @@ symphony_available_tasks(filter="my")
   "brain": {
     "switched_to": "<projectId>",
     "active_plan": "plans/260316-auth/implementation_plan.md"
+  },
+  "mindful": {
+    "enabled": true,
+    "iteration_threshold": 3,
+    "scope_guard": true,
+    "milestone_rest": true
   }
 }
 ```

package/skills/brainstorm-agent/SKILL.md

@@ -17,6 +17,8 @@ activation_keywords:
 priority: medium
 ---
 
+<!-- ⚠️ GATE 1 — Brainstorm ONLY. Không code trong phase này. Output = BRIEF.md. -->
+
 # 💡 Brainstorm Agent — Router
 
 > **Purpose:** Biến ý tưởng mơ hồ thành bản thiết kế rõ ràng qua phiên brainstorm có cấu trúc.

package/skills/code-review/SKILL.md

@@ -3,6 +3,8 @@ name: code-review
 description: Use when completing tasks, implementing features, or before merging. Dispatch structured code review with severity classification. Auto-triggers after task completion in subagent-driven or single-flow execution.
 ---
 
+<!-- ⚠️ REVIEW GATE — Spec compliance FIRST, then code quality. No merge without review. -->
+
 # Code Review
 
 ## Overview

package/skills/code-review-system-principles/SKILL.md

@@ -0,0 +1,154 @@
+---
+name: code-review-system-principles
+description: "Nguyên tắc cốt lõi, tiêu chí đánh giá và output schema cho hệ thống tự động Code Review. Sử dụng khi AI đóng vai trò người kiểm duyệt (reviewer) tìm bugs trong một bản vá (patch/diff)."
+version: 1.0.0
+trigger: conditional
+activation_keywords:
+  - "code review principles"
+  - "review principles"
+  - "nguyên tắc review"
+  - "code review rules"
+---
+
+<!-- ⚠️ DUAL-SYNCED: Thực thi đồng bộ chéo giữa ~/.gemini/antigravity và main-awf. -->
+
+# Code Review System Principles
+
+This document summarizes the active review prompt rules used when evaluating a patch.
+It is a human-readable restatement, not a verbatim raw prompt dump.
+
+## 1. Reviewer role
+
+- Act as a reviewer for a proposed code change made by another engineer.
+- Focus on discrete, actionable bugs introduced by the patch.
+- Prefer no findings over weak or speculative findings.
+
+## 2. What counts as a bug worth flagging
+
+A finding should generally satisfy all of the following:
+
+1. It meaningfully impacts correctness, performance, security, or maintainability.
+2. It is discrete and actionable.
+3. Fixing it matches the rigor level already present in the codebase.
+4. It was introduced by the current patch, not pre-existing.
+5. The original author would likely want to fix it if informed.
+6. It does not depend on unstated assumptions about intent.
+7. It identifies provably affected code or scenarios, not vague downstream risk.
+8. It is not merely an intentional product or behavior change.
+
+## 3. What to ignore
+
+- Trivial style issues, unless they obscure meaning or violate a documented standard.
+- General codebase quality complaints.
+- Speculative regressions without a concrete affected path.
+- Pre-existing problems not introduced by the patch.
+- Non-actionable feedback.
+
+## 4. Finding coverage rules
+
+- Return **all** findings the author would likely fix.
+- Do **not** stop at the first valid issue.
+- If there is no clearly valuable issue, return an empty findings list.
+
+## 5. Comment-writing rules
+
+Each finding comment should:
+
+- Clearly explain why the issue is a bug.
+- Accurately communicate severity.
+- Stay brief: at most one paragraph.
+- Avoid unnecessary praise or blame.
+- State the conditions, environments, or inputs required for the issue to occur.
+- Be understandable without close reading.
+- Avoid large code blocks; any included code should be very small.
+- Use matter-of-fact, assistant-like tone.
+- Use an imperative finding title with a priority prefix.
+- Keep the title short (no more than 80 characters).
+
+## 6. Location rules
+
+- Use one comment per distinct issue.
+- Keep the line range as short as possible.
+- Prefer the smallest diff-overlapping range that pinpoints the issue.
+- Avoid large ranges when a smaller subrange can explain the bug.
+
+## 7. Suggestion block rules
+
+- Use `suggestion` blocks **only** for concrete replacement code.
+- Keep them minimal.
+- Preserve exact leading whitespace.
+- Do not change outer indentation unless the fix truly requires it.
+
+## 8. Priority rules
+
+Every finding title must begin with a priority tag:
+
+- `[P0]` Blocking / universal / drop-everything issue
+- `[P1]` Urgent, should be fixed next cycle
+- `[P2]` Normal bug, fix eventually
+- `[P3]` Low priority, nice to have
+
+Also include numeric priority in JSON:
+
+- `0` for P0
+- `1` for P1
+- `2` for P2
+- `3` for P3
+
+## 9. Output schema rules
+
+The output must be valid JSON with exactly this top-level shape:
+
+- `findings`: array
+- `overall_correctness`: `"patch is correct"` or `"patch is incorrect"`
+- `overall_explanation`: short justification
+- `overall_confidence_score`: float
+
+Each finding must include:
+
+- `title`
+- `body`
+- `confidence_score`
+- `priority` (when determinable)
+- `code_location.absolute_file_path`
+- `code_location.line_range.start`
+- `code_location.line_range.end`
+
+Additional formatting constraints:
+
+- Output raw JSON only; no markdown fences or extra prose.
+- `code_location` is required for every finding.
+- The location should overlap the diff.
+- Do not generate a PR fix in the final review output.
+
+## 10. Correctness verdict rules
+
+Use `patch is correct` only when:
+
+- Existing code and tests should not break, and
+- The patch is free of blocking bugs.
+
+Ignore non-blocking nits such as:
+
+- style
+- formatting
+- typos
+- documentation polish
+
+## 11. Practical review heuristic
+
+A good finding usually answers all of these quickly:
+
+- **Where is the problem?**
+- **When does it break?**
+- **Why is it a real bug?**
+- **How severe is it?**
+- **Is it definitely introduced by this patch?**
+
+## 12. Review philosophy summary
+
+- Precision over volume
+- Evidence over speculation
+- Patch-introduced regressions over legacy issues
+- Author-useful feedback over theoretical concerns
+- Concise comments over long essays

package/skills/codex-conductor/SKILL.md

@@ -15,6 +15,8 @@ invocation-type: auto
 priority: 5
 ---
 
+<!-- ⚠️ INSPECT ONLY — Codex TUYỆT ĐỐI KHÔNG sửa code. Output = .md reports. approval-mode suggest. -->
+
 # 🔍 Codex Conductor — Router
 
 > **Purpose:** Gọi Codex CLI qua terminal khi cần rà soát logic, debug, review code chuyên sâu.
@@ -38,7 +40,7 @@ Codex CLI         = Inspector — debug, review, verify, test
 
 ```bash
 which codex || command -v codex
-# NOTE: If not installed, IMMEDIATELY fallback to IDE context. DO NOT ask user to install.
+# If not installed: npm i -g @openai/codex
 ```
 
 ## 🎯 Trigger Conditions
@@ -88,9 +90,9 @@ cd <PROJECT_ROOT> && timeout 180 codex exec \
 | Event | Action |
 |-------|--------|
 | Success | Parse → save report → summarize → suggest fixes |
-| Timeout | "⏳ Timed out (>120s)" → fallback Antigravity-only smoothly |
-| Error | Fallback Antigravity-only smoothly. Do NOT ask user to install |
-| Not installed | Fallback Antigravity-only smoothly. Do NOT ask user to install |
+| Timeout | "⏳ Timed out (>120s)" → fallback Antigravity-only |
+| Error | Check `codex --version` → suggest install |
+| Not installed | Ask user to install |
 
 ## 📁 Report Structure
 

package/skills/gemini-conductor/SKILL.md

@@ -15,6 +15,8 @@ invocation-type: auto
 priority: 5
 ---
 
+<!-- ⚠️ READ-ONLY CLI — Gemini CLI KHÔNG ĐƯỢC sửa code. Chỉ .md files. Timeout 60s. -->
+
 # 🎼 Gemini Conductor Skill
 
 > **Purpose:** Antigravity tự gọi Gemini CLI qua terminal khi cần tầm nhìn rộng hơn scope IDE.
@@ -194,9 +196,8 @@ on_timeout:
   - Fall back to Antigravity-only analysis
 
 on_error:
-  - Log: "⚠️ CLI invocation failed or not set up, continuing without conductor"
-  - IMMEDIATELY fallback to Antigravity-only mode
-  - Do NOT ask the user to install or authenticate the CLI. It is strictly optional
+  - Log: "⚠️ CLI invocation failed, continuing without conductor"
+  - Do NOT block the workflow — CLI is enhancement, not dependency
 ```
 
 ---

package/skills/gitnexus-intelligence/SKILL.md

@@ -14,6 +14,8 @@ invocation-type: auto
 priority: 5
 ---
 
+<!-- ⚠️ IMPACT-FIRST — PHẢI chạy gitnexus_impact TRƯỚC khi edit symbol. Chưa index → KHÔNG dùng tools. -->
+
 # GitNexus Intelligence v1.0 — Code-Aware Agent Skill
 
 > **Purpose:** Cung cấp architectural awareness cho AI agent thông qua knowledge graph.
@@ -39,6 +41,31 @@ INDEX STALE (tool trả warning):
 
 ---
 
+## 🔑 Auto-Repo Detection Protocol (BẮT BUỘC)
+
+```
+TRƯỚC KHI gọi bất kỳ GitNexus MCP tool nào:
+
+1. Gọi gitnexus_list_repos() → lấy danh sách repos đã index
+2. Match project directory (từ .project-identity hoặc cwd) với repo paths
+3. Dùng matched repo name làm `repo` param cho MỌI tool call
+
+VÍ DỤ:
+  gitnexus_list_repos() trả về repo path "/Users/.../FitWitnessSimple"
+  → project đang mở = FitWitnessSimple
+  → gitnexus_query({query: "weather", repo: "FitWitnessSimple"})
+
+FALLBACK (nếu không match path):
+  1. So sánh projectId (từ .project-identity) với repo names
+  2. Nếu vẫn không match → hỏi user chọn repo
+
+⚠️ KHÔNG BAO GIỜ gọi GitNexus tool mà THIẾU `repo` param khi có >1 repo indexed.
+```
+
+> **Quản lý repos:** `awkit gitnexus list` để xem, `awkit gitnexus clean` để dọn repos cũ.
+
+---
+
 ## 🎯 When to Activate
 
 | Trigger | Action |

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

@@ -23,6 +23,8 @@ activation_keywords:
   - "product spec"
 ---
 
+<!-- ⚠️ GATE 1.5 — User PHẢI approve module specs. COMPLEX + >3 modules = MANDATORY. -->
+
 # Module Spec Writer v1.2 — Gate 1.5: Product Specification (Router)
 
 > **Purpose:** Tạo tài liệu product-level cho từng module (screens, flows, rules)

package/skills/skill-creator/SKILL.md

@@ -11,6 +11,8 @@ activation_keywords:
   - "bổ sung skill"
 ---
 
+<!-- ⚠️ DUAL-SYNC BẮT BUỘC — Mọi thay đổi PHẢI sync sang main-awf. Không được bỏ qua Bước 3. -->
+
 # 🛠️ Skill Creator (with Auto-Sync to main-awf)
 
 **Purpose**: Hỗ trợ người dùng thiết kế, lập trình và tinh chỉnh các Antigravity Skills theo chuẩn. 

package/skills/spec-gate/SKILL.md

@@ -21,6 +21,8 @@ activation_keywords:
   - "API design"
 ---
 
+<!-- ⚠️ GATE 2 — User PHẢI approve design. AI KHÔNG được tự approve. Đọc GEMINI.md § 7-Gate trước khi sửa. -->
+
 # Spec Gate v1.2 — Architecture & Data Design Gate (Router)
 
 > **Purpose:** Chốt thiết kế kỹ thuật (DB Schema, API Contract, State Machine)

package/skills/symphony-enforcer/SKILL.md

@@ -17,6 +17,8 @@ invocation-type: auto
 priority: 1
 ---
 
+<!-- ⚠️ TASK INTEGRITY — Sửa file này PHẢI đọc lại GEMINI.md § Symphony rules. Không sửa format Sync Block. -->
+
 # Symphony Enforcer v3.7 — Router
 
 > **Purpose:** Đảm bảo AI KHÔNG BAO GIỜ quên cập nhật Symphony.
@@ -31,6 +33,12 @@ KHÔNG CÓ NGOẠI LỆ:
 - AI tự detect completion và auto-complete task
 - Task done → PHẢI atomic git commit trước khi suggest next
 - BỎ QUA BẤT KỲ STEP NÀO = VI PHẠM
+
+GATE 3 VIOLATION (NẶNG):
+- Tạo implementation plan mà KHÔNG tạo Symphony tickets = VI PHẠM NẶNG
+- Dùng artifact task.md thay cho Symphony = VI PHẠM
+  (task.md = IDE-level tracking, KHÔNG thay thế Symphony)
+- Severity tương đương: code logic khi chưa confirm UI
 ```
 
 ## 📋 Topic Index — Load file theo nhu cầu
@@ -41,6 +49,7 @@ KHÔNG CÓ NGOẠI LỆ:
 | Three-Phase Execution | Gate 4 với COMPLEX + UI tasks | `examples/three-phase.md` |
 | Trigger Points (TP1, TP1.5, TP1.7) | Milestone, schema changes, checkpoints | `examples/trigger-points.md` |
 | Task Completion (TP2-TP4) | Khi task sắp done | `examples/task-completion.md` |
+| Mindful Stop (TP-ITER, TP-SCOPE, TP-REST) | Iteration counter, scope guard, milestone rest | `examples/mindful-stop.md` |
 
 ## Auto-Lifecycle: task_boundary ↔ Symphony
 

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/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)