@leejungkiin/awkit 1.7.1 → 1.7.4

package/scripts/i18n-helper.js

@@ -0,0 +1,381 @@
+const fs = require('fs');
+const path = require('path');
+
+const C = {
+    cyan: '\x1b[36m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    red: '\x1b[31m',
+    gray: '\x1b[90m',
+    bold: '\x1b[1m',
+    reset: '\x1b[0m'
+};
+
+function log(msg) { console.log(msg); }
+function ok(msg) { log(`${C.green}✓ ${msg}${C.reset}`); }
+function warn(msg) { log(`${C.yellow}⚠ ${msg}${C.reset}`); }
+function err(msg) { log(`${C.red}✗ ${msg}${C.reset}`); }
+function dim(msg) { log(`${C.gray}${msg}${C.reset}`); }
+
+// Helper to set nested property in object (like lodash.set)
+function setNested(obj, pathStr, value) {
+    const parts = pathStr.split('.');
+    let current = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const part = parts[i];
+        if (current[part] === undefined || typeof current[part] !== 'object') {
+            current[part] = {};
+        }
+        current = current[part];
+    }
+    current[parts[parts.length - 1]] = value;
+}
+
+// Helper to get nested property in object
+function getNested(obj, pathStr) {
+    const parts = pathStr.split('.');
+    let current = obj;
+    for (const part of parts) {
+        if (current === null || current === undefined) return undefined;
+        current = current[part];
+    }
+    return current;
+}
+
+// Recursively find all nested keys and values in an object
+function flattenObject(obj, prefix = '') {
+    let results = {};
+    for (const k in obj) {
+        if (Object.prototype.hasOwnProperty.call(obj, k)) {
+            const keyName = prefix ? `${prefix}.${k}` : k;
+            if (obj[k] !== null && typeof obj[k] === 'object' && !Array.isArray(obj[k])) {
+                Object.assign(results, flattenObject(obj[k], keyName));
+            } else {
+                results[keyName] = obj[k];
+            }
+        }
+    }
+    return results;
+}
+
+// Format Javascript object as clean JS/TS string with sorted keys
+function formatJsObject(obj, indent = 2) {
+    const spaces = ' '.repeat(indent);
+    if (Array.isArray(obj)) {
+        return '[\n' + obj.map(item => spaces + formatJsObject(item, indent + 2)).join(',\n') + '\n' + ' '.repeat(indent - 2) + ']';
+    } else if (obj !== null && typeof obj === 'object') {
+        const keys = Object.keys(obj).sort();
+        const lines = keys.map(k => {
+            const keyStr = /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(k) ? k : JSON.stringify(k);
+            return `${spaces}${keyStr}: ${formatJsObject(obj[k], indent + 2)}`;
+        });
+        return '{\n' + lines.join(',\n') + '\n' + ' '.repeat(indent - 2) + '}';
+    } else {
+        return JSON.stringify(obj);
+    }
+}
+
+// Find translation files in target directories, avoiding heavy system folders
+function findTranslationFiles(dir) {
+    const filesList = [];
+    const ignoreList = ['node_modules', '.git', '.gitnexus', 'dist', 'build', '.expo', 'ios', 'android', 'web-build'];
+
+    function traverse(currentDir) {
+        let list;
+        try {
+            list = fs.readdirSync(currentDir);
+        } catch (_) {
+            return;
+        }
+
+        for (const file of list) {
+            const absPath = path.join(currentDir, file);
+            let stat;
+            try {
+                stat = fs.statSync(absPath);
+            } catch (_) {
+                continue;
+            }
+
+            if (stat.isDirectory()) {
+                if (ignoreList.includes(file)) continue;
+                traverse(absPath);
+            } else if (stat.isFile()) {
+                const ext = path.extname(file).toLowerCase();
+                const nameLower = file.toLowerCase();
+
+                // Look for translations.* or locale files like en.json, vi.json
+                const isTranslationFile = 
+                    (nameLower.includes('translation') && (ext === '.json' || ext === '.ts' || ext === '.js')) ||
+                    (ext === '.json' && (nameLower === 'en.json' || nameLower === 'vi.json' || nameLower === 'ja.json'));
+
+                if (isTranslationFile) {
+                    filesList.push(absPath);
+                }
+            }
+        }
+    }
+
+    traverse(dir);
+    return filesList;
+}
+
+// Read and parse translation file safely
+function readTranslationFile(filePath) {
+    const content = fs.readFileSync(filePath, 'utf8');
+    const ext = path.extname(filePath).toLowerCase();
+
+    if (ext === '.json') {
+        try {
+            return { type: 'json', data: JSON.parse(content), raw: content };
+        } catch (e) {
+            throw new Error(`Failed to parse JSON file ${filePath}: ${e.message}`);
+        }
+    } else if (ext === '.ts' || ext === '.js') {
+        // Find the outer curly braces block
+        const braceStart = content.indexOf('{');
+        const braceEnd = content.lastIndexOf('}');
+        if (braceStart === -1 || braceEnd === -1 || braceEnd < braceStart) {
+            throw new Error(`Could not locate object braces in JS/TS file: ${filePath}`);
+        }
+
+        const objectStr = content.substring(braceStart, braceEnd + 1);
+        try {
+            // Safe evaluation of object content
+            const data = new Function(`return (${objectStr})`)();
+            return {
+                type: 'js',
+                data,
+                prefix: content.substring(0, braceStart),
+                suffix: content.substring(braceEnd + 1),
+                raw: content
+            };
+        } catch (e) {
+            throw new Error(`Failed to parse JS/TS object in ${filePath}: ${e.message}`);
+        }
+    }
+
+    throw new Error(`Unsupported translation file type: ${ext}`);
+}
+
+// Write translation file safely
+function writeTranslationFile(filePath, fileInfo) {
+    if (fileInfo.type === 'json') {
+        // Sort keys recursively
+        const sorted = sortObjectKeys(fileInfo.data);
+        fs.writeFileSync(filePath, JSON.stringify(sorted, null, 2) + '\n', 'utf8');
+    } else if (fileInfo.type === 'js') {
+        const sorted = sortObjectKeys(fileInfo.data);
+        const formatted = formatJsObject(sorted);
+        fs.writeFileSync(filePath, `${fileInfo.prefix}${formatted}${fileInfo.suffix}`, 'utf8');
+    }
+}
+
+// Sort object keys recursively
+function sortObjectKeys(obj) {
+    if (Array.isArray(obj)) {
+        return obj.map(sortObjectKeys);
+    } else if (obj !== null && typeof obj === 'object') {
+        const sorted = {};
+        Object.keys(obj).sort().forEach(key => {
+            sorted[key] = sortObjectKeys(obj[key]);
+        });
+        return sorted;
+    }
+    return obj;
+}
+
+// CLI implementation
+async function cmdI18n(args) {
+    const subCmd = args[0] || 'help';
+
+    if (subCmd === 'help' || subCmd === '--help' || subCmd === '-h') {
+        log('');
+        log(`${C.cyan}${C.bold}🌐 awkit i18n — Language & Translation Workflow Helper${C.reset}`);
+        log(`${C.gray}${'─'.repeat(56)}${C.reset}`);
+        log(`Manage your localization and translation files cleanly.`);
+        log('');
+        log(`${C.bold}Commands:${C.reset}`);
+        log(`  ${C.green}add${C.reset} --key <key> [--en <val>] [--vi <val>] ...`);
+        log(`      Add a translation key with values across files.`);
+        log(`  ${C.green}search${C.reset} <query>  (or find)`);
+        log(`      Search for translation keys or values containing query.`);
+        log(`  ${C.green}sync${C.reset}`);
+        log(`      Alphabetically sort and synchronize keys across all translation files.`);
+        log(`  ${C.green}list${C.reset}`);
+        log(`      List all translations mapped in the project.`);
+        log('');
+        log(`${C.bold}Examples:${C.reset}`);
+        log(`  awkit i18n add --key "auth.login.title" --en "Log In" --vi "Đăng nhập"`);
+        log(`  awkit i18n search "Welcome"`);
+        log('');
+        return;
+    }
+
+    const cwd = process.cwd();
+    
+    // Read files configured in .project-identity or auto-detect
+    let configFiles = [];
+    const identityPath = path.join(cwd, '.project-identity');
+    if (fs.existsSync(identityPath)) {
+        try {
+            const identity = JSON.parse(fs.readFileSync(identityPath, 'utf8'));
+            if (identity.i18n && Array.isArray(identity.i18n.files)) {
+                configFiles = identity.i18n.files.map(f => path.resolve(cwd, f));
+            }
+        } catch (_) {}
+    }
+
+    const files = configFiles.length > 0 ? configFiles : findTranslationFiles(cwd);
+
+    if (files.length === 0) {
+        err('No translation files found in this repository.');
+        dim('Either configure "i18n.files" in .project-identity or place translation files matching *translation*.{json,ts,js} or en.json/vi.json.');
+        return;
+    }
+
+    switch (subCmd) {
+        case 'add': {
+            // Parse arguments
+            let key = '';
+            const translations = {};
+            
+            for (let i = 1; i < args.length; i++) {
+                if (args[i] === '--key') {
+                    key = args[++i];
+                } else if (args[i].startsWith('--')) {
+                    const lang = args[i].substring(2);
+                    translations[lang] = args[++i];
+                } else if (args[i].includes(':')) {
+                    // Alternative syntax: en:Hello
+                    const parts = args[i].split(':');
+                    const lang = parts[0];
+                    const val = parts.slice(1).join(':');
+                    translations[lang] = val;
+                }
+            }
+
+            if (!key) {
+                err('Missing translation key. Specify using --key <key_name>');
+                return;
+            }
+
+            if (Object.keys(translations).length === 0) {
+                err('No translations specified. E.g. --en "Hello" --vi "Xin chào"');
+                return;
+            }
+
+            info(`Adding key "${key}" to translation files...`);
+            
+            for (const file of files) {
+                const basename = path.basename(file);
+                const fileLang = basename.split('.')[0].toLowerCase(); // e.g. en, vi, translations
+                
+                try {
+                    const fileInfo = readTranslationFile(file);
+                    
+                    // Match translation value. If file name is specific like en.json or vi.json, inject specific lang.
+                    // If it is translations.ts, inject nested object languages.
+                    if (fileLang === 'en' || fileLang === 'vi') {
+                        const val = translations[fileLang] || translations['en'] || Object.values(translations)[0];
+                        setNested(fileInfo.data, key, val);
+                    } else {
+                        // Mixed translation file (e.g. translations.ts), set language key paths
+                        for (const lang in translations) {
+                            if (fileInfo.data[lang] !== undefined) {
+                                setNested(fileInfo.data[lang], key, translations[lang]);
+                            } else {
+                                // Fallback directly on root
+                                setNested(fileInfo.data, `${lang}.${key}`, translations[lang]);
+                            }
+                        }
+                    }
+                    
+                    writeTranslationFile(file, fileInfo);
+                    ok(`Updated ${basename}`);
+                } catch (e) {
+                    err(`Failed updating ${basename}: ${e.message}`);
+                }
+            }
+            break;
+        }
+
+        case 'search':
+        case 'find': {
+            const query = args.slice(1).join(' ').toLowerCase();
+            if (!query) {
+                err('Please specify a query to search.');
+                return;
+            }
+
+            log(`\n🔍 Searching for "${query}" in translations...`);
+            log(`${C.gray}${'─'.repeat(56)}${C.reset}`);
+
+            let matchesFound = 0;
+            for (const file of files) {
+                try {
+                    const fileInfo = readTranslationFile(file);
+                    const flattened = flattenObject(fileInfo.data);
+                    
+                    for (const key in flattened) {
+                        const val = String(flattened[key]);
+                        if (key.toLowerCase().includes(query) || val.toLowerCase().includes(query)) {
+                            log(`  [${C.cyan}${path.basename(file)}${C.reset}] ${C.green}${key}${C.reset}: "${val}"`);
+                            matchesFound++;
+                        }
+                    }
+                } catch (e) {
+                    err(`Error scanning ${path.basename(file)}: ${e.message}`);
+                }
+            }
+            if (matchesFound === 0) {
+                warn('No matches found.');
+            } else {
+                log(`\nFound ${matchesFound} matches.`);
+            }
+            break;
+        }
+
+        case 'sync': {
+            info('Synchronizing and formatting all translation files...');
+            for (const file of files) {
+                try {
+                    const fileInfo = readTranslationFile(file);
+                    writeTranslationFile(file, fileInfo);
+                    ok(`Synced & Sorted ${path.basename(file)}`);
+                } catch (e) {
+                    err(`Failed to sync ${path.basename(file)}: ${e.message}`);
+                }
+            }
+            break;
+        }
+
+        case 'list': {
+            log(`\n📋 Listing all translation entries:`);
+            log(`${C.gray}${'─'.repeat(56)}${C.reset}`);
+            for (const file of files) {
+                try {
+                    const fileInfo = readTranslationFile(file);
+                    const flattened = flattenObject(fileInfo.data);
+                    log(`\n${C.cyan}${path.basename(file)}${C.reset}:`);
+                    for (const key in flattened) {
+                        log(`  ${C.green}${key}${C.reset}: "${flattened[key]}"`);
+                    }
+                } catch (e) {
+                    err(`Error reading ${path.basename(file)}: ${e.message}`);
+                }
+            }
+            break;
+        }
+
+        default:
+            err(`Unknown command: ${subCmd}`);
+            break;
+    }
+}
+
+function info(msg) { log(`${C.cyan}ℹ ${msg}${C.reset}`); }
+
+module.exports = {
+    cmdI18n
+};

package/scripts/multi-model-pipeline.js

@@ -0,0 +1,144 @@
+/**
+ * Multi-Model Collaborative Pipeline Helper for AWKit
+ * Orchestrates tasks across Gemini Flash Medium, agy (Claude Opus), and Codex.
+ */
+
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const AGY_PATH = '/Users/trungkientn/.local/bin/agy';
+
+const C = {
+    reset: '\x1b[0m',
+    red: '\x1b[31m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    cyan: '\x1b[36m',
+    gray: '\x1b[90m',
+    bold: '\x1b[1m',
+};
+
+const log = (msg) => console.log(msg);
+const ok = (msg) => log(`${C.green}✔${C.reset} ${msg}`);
+const warn = (msg) => log(`${C.yellow}⚠${C.reset} ${msg}`);
+const err = (msg) => log(`${C.red}✖${C.reset} ${msg}`);
+const info = (msg) => log(`${C.cyan}ℹ${C.reset} ${msg}`);
+
+function findAgy() {
+    if (fs.existsSync(AGY_PATH)) {
+        return AGY_PATH;
+    }
+    try {
+        return execSync('which agy', { encoding: 'utf8' }).trim();
+    } catch (_) {
+        return 'agy';
+    }
+}
+
+function runPlanStep(featureName) {
+    const agyBin = findAgy();
+    info(`Khởi chạy Lập kế hoạch Kiến trúc (Opus 4.6 via agy CLI)...`);
+    
+    // Ensure docs and docs/specs directories exist
+    fs.mkdirSync(path.join(process.cwd(), 'docs', 'specs'), { recursive: true });
+
+    const specFile = `docs/specs/${featureName.toLowerCase().replace(/\s+/g, '_')}_spec.md`;
+    const prompt = `Thực hiện lập kế hoạch chi tiết cho tính năng '${featureName}'. Tạo PRD tại docs/PRD.md và Spec chi tiết tại ${specFile}. Hãy vẽ kèm sơ đồ Mermaid thể hiện luồng xử lý. Hãy phản hồi ngắn gọn bằng JSON tóm tắt các files đã tạo và mô tả kế hoạch.`;
+
+    const cmd = `"${agyBin}" --model claude-opus --print "${prompt.replace(/"/g, '\\"')}" < /dev/null`;
+    
+    try {
+        log(`${C.gray}$ ${cmd}${C.reset}`);
+        const output = execSync(cmd, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'inherit'] });
+        log(output);
+        ok(`Hoàn thành lập kế hoạch kiến trúc.`);
+        ok(`PRD đã lưu tại docs/PRD.md`);
+        ok(`Spec đã lưu tại ${specFile}`);
+    } catch (e) {
+        err(`Lỗi lập kế hoạch: ${e.message}`);
+        process.exit(1);
+    }
+}
+
+function runUiStep(featureName) {
+    info(`Khởi chạy Thiết kế Shell & GUI Assets (Codex CLI)...`);
+    
+    // Ensure assets/ui directory exists
+    fs.mkdirSync(path.join(process.cwd(), 'assets', 'ui'), { recursive: true });
+
+    // Step A: Prompt to generate layout demo preview HTML/CSS or mockup code
+    const promptPreview = `Tạo UI Demo Preview dưới dạng HTML/CSS tĩnh hoặc SwiftUI shell cho tính năng '${featureName}' dựa trên tài liệu docs/PRD.md và spec hiện có. Lưu tệp demo vào assets/ui/demo_preview.html.`;
+    const cmdPreview = `codex exec "${promptPreview.replace(/"/g, '\\"')}" --sandbox read-only < /dev/null`;
+
+    try {
+        log(`${C.gray}$ ${cmdPreview}${C.reset}`);
+        const outPreview = execSync(cmdPreview, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'inherit'] });
+        log(outPreview);
+        ok(`Đã sinh UI Demo Preview tại assets/ui/demo_preview.html`);
+    } catch (e) {
+        err(`Lỗi sinh UI Demo Preview: ${e.message}`);
+        process.exit(1);
+    }
+
+    // Step B: Prompt to generate spritesheet/image assets
+    const promptAssets = `Tạo GUI assets (nút bấm, icons, pet companion, egg) dưới dạng spritesheet hoặc dạng assets lẻ dựa trên thiết kế của UI Demo Preview. Lưu tệp assets vào thư mục assets/ui/.`;
+    const cmdAssets = `codex exec "${promptAssets.replace(/"/g, '\\"')}" --sandbox read-only < /dev/null`;
+
+    try {
+        log(`${C.gray}$ ${cmdAssets}${C.reset}`);
+        const outAssets = execSync(cmdAssets, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'inherit'] });
+        log(outAssets);
+        ok(`Đã sinh GUI assets thành công vào assets/ui/`);
+    } catch (e) {
+        err(`Lỗi sinh GUI assets: ${e.message}`);
+        process.exit(1);
+    }
+}
+
+function runCodeStep(featureName) {
+    const agyBin = findAgy();
+    info(`Khởi chạy Thực thi Viết Code (Gemini via agy CLI)...`);
+
+    const promptCode = `Hãy thực hiện viết code cho tính năng '${featureName}' tuân thủ kế hoạch chi tiết trong implementation_plan.md và các spec giao diện trong docs/specs/. Sau đó tự động gọi critic subagent để review code.`;
+    const cmdCode = `"${agyBin}" --model gemini-2.5-flash --print "${promptCode.replace(/"/g, '\\"')}" < /dev/null`;
+
+    try {
+        log(`${C.gray}$ ${cmdCode}${C.reset}`);
+        const output = execSync(cmdCode, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'inherit'] });
+        log(output);
+        ok(`Đã viết code và hoàn tất quá trình review từ critic subagent.`);
+    } catch (e) {
+        err(`Lỗi thực thi viết code: ${e.message}`);
+        process.exit(1);
+    }
+}
+
+function cmdPipeline(args) {
+    const step = args[0];
+    const featureName = args[1] || 'NewFeature';
+
+    if (!step) {
+        console.error('Usage: awkit pipeline <plan|ui|code> [FeatureName]');
+        process.exit(1);
+    }
+
+    switch (step.toLowerCase()) {
+        case 'plan':
+            runPlanStep(featureName);
+            break;
+        case 'ui':
+            runUiStep(featureName);
+            break;
+        case 'code':
+            runCodeStep(featureName);
+            break;
+        default:
+            console.error(`Unknown step: ${step}`);
+            process.exit(1);
+    }
+}
+
+module.exports = {
+    cmdPipeline,
+};

package/skill-packs/mobile-ios/pack.json

@@ -1,9 +1,10 @@
 {
     "name": "mobile-ios",
     "auto_install": false,
-    "description": "iOS development skills: Xcode, Swift, SwiftUI, reverse engineering, build optimization, and SPM analysis",
+    "description": "iOS development skills: Xcode, Swift, SwiftUI, reverse engineering, build optimization, visual QA, and SPM analysis",
     "skills": [
         "ios-engineer",
+        "ios-visual-qa-strategist",
         "smali-to-swift",
         "swiftui-pro",
         "xcode-build-benchmark",
@@ -11,6 +12,7 @@
         "xcode-build-orchestrator",
         "xcode-compilation-analyzer",
         "xcode-project-analyzer",
-        "spm-build-analysis"
+        "spm-build-analysis",
+        "ios-simulator-skill"
     ]
 }

package/skill-packs/reverse-engineering/pack.json

@@ -1,6 +1,7 @@
 {
     "name": "reverse-engineering",
     "auto_install": false,
+    "hidden": true,
     "description": "Android & iOS remote engineering, decompilation, code porting, and smali modding capabilities",
     "skills": [
         "smali-to-kotlin",

package/skills/CATALOG.md

@@ -36,6 +36,26 @@
 | 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 |
+| 18 | `animal-island-ui-style` | `manual` | keywords (动物森友会, 可爱圆润 UI) | — | 1.0.0 | ✅ Active |
+| 19 | `ios-visual-qa-strategist` | `manual` | iOS visual QA, simulator screenshots, minimal capture testing | — | 1.0.0 | ✅ Active |
+| 20 | `ios-simulator-skill` | `manual` | iOS app building, testing, and simulator control | — | 1.5.0 | ✅ Active |
+| 21 | `unity-game-development` | `manual` | Unity C# coding, ScriptableObjects, and profiling | — | 1.0.0 | ✅ Active |
+| 22 | `godot-game-development` | `manual` | Godot 4 GDScript, composition and signal design | — | 1.0.0 | ✅ Active |
+| 23 | `expo-game-development` | `manual` | Expo/React Native Skia/GL game loop optimization | — | 1.0.0 | ✅ Active |
+| 24 | `ai-music` | `manual` | generate music, make a song, AI music, soundtrack, jingle, compose, inpaint music | — | 1.0.0 | ✅ Active |
+| 25 | `game-developer` | `manual` | Unity, Unreal Engine, ECS architecture, game physics, multiplayer networking, shader programming, game AI | — | 1.1.0 | ✅ Active |
+
+---
+
+## Ponytail (Code Minimalism)
+
+> Adapted from [DietrichGebert/ponytail](https://github.com/DietrichGebert/ponytail) (MIT).
+> Enforces lazy senior dev coding: YAGNI, stdlib/native first, no unrequested abstractions.
+
+| # | Skill | Type | Trigger | Priority | Version | Status |
+|---|-------|------|---------|----------|---------|--------|
+| 26 | `awf-ponytail` | `auto` | `.project-identity` check (default ON) | 7.6 | 1.0.0 | ✅ Active |
+| 27 | `awf-ponytail-review` | `manual` | `/ponytail-review`, "what can we delete", Gate 5 | — | 1.0.0 | ✅ Active |
 
 ---
 

package/skills/GEMINI.md

@@ -78,6 +78,14 @@ Mỗi skill tự xử lý gate logic riêng — xem SKILL.md của từng skill.
 - 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.
+- Tài liệu thảo luận & brainstorm (Brief, Requirements, Brainstorm) PHẢI dùng tiếng Việt (hoặc ngôn ngữ giao tiếp của User), chỉ Code/Architecture mới bắt buộc dùng tiếng Anh.
+
+### Brainstorm & Plan Integrity (BPIP)
+- CẤM ghi đè (overwrite) toàn bộ BRIEF.md hoặc plan.md khi tinh chỉnh ý tưởng.
+- PHẢI sử dụng công cụ sửa code (replace_file_content) để cập nhật từng phần.
+- PHẢI duy trì bảng Revision History ở đầu mỗi file design/planning.
+- PHẢI lưu bản sao dự phòng vào `docs/history/` trước khi sửa đổi lớn (định dạng `[filename].v[N].md`, ví dụ: `implementation_plan.v1.md`).
+- CẤM dồn tất cả các phiên/tính năng vào một file `implementation_plan.md` duy nhất. PHẢI tách thành các kế hoạch phân mảnh (ví dụ: `implementation_plan.v2.md` hoặc `implementation_plan_feature.md`) và duy trì liên kết ngữ cảnh (Chain of Plans) đến phiên trước kèm tóm tắt ngắn ở đầu file mới.
 
 ### Anti-sycophancy (Trung thực)
 - PHẢI push back khi approach của user có vấn đề — giải thích rõ trade-offs.
@@ -119,7 +127,7 @@ Khi AI cần tự quyết định mà không hỏi user:
 - Risk HIGH/CRITICAL → PHẢI cảnh báo user trước khi sửa.
 - Explore code lạ → ưu tiên `gitnexus_query` thay vì grep thủ công.
 - Rename symbol → PHẢI dùng `gitnexus_rename` (dry_run trước).
-- Index stale → cảnh báo "⚠️ chạy `npx gitnexus analyze`".
+- Index stale → cảnh báo "⚠️ chạy `pnpm dlx gitnexus analyze` (hoặc `npx gitnexus analyze`)".
 - Chi tiết: xem `gitnexus-intelligence/SKILL.md`.
 
 ### Two-Agent Flow (Conductor)

package/skills/TRIGGER_INDEX.md

@@ -19,6 +19,16 @@
 | 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 | 🟢 |
+| animal-island-ui-style | Animal Crossing (动物森友会) style, animal-island-ui, 可爱圆润风格 UI | animal-island-ui-style/SKILL.md | 🟢 |
+| i18n-orchestrator | Translation, localization, i18n, translations, file ngôn ngữ | i18n-orchestrator/SKILL.md | 🟢 |
+| ios-visual-qa-strategist | iOS visual QA, SwiftUI/UIKit app testing, simulator screenshots, minimal screenshot capture | ios-visual-qa-strategist/SKILL.md | 🟢 |
+| ios-simulator-skill | iOS app testing, building, simulator control, accessibility mapping, and simulator automation | ios-simulator-skill/SKILL.md | 🟢 |
+| unity-game-development | Unity, C#, MonoBehaviour, ScriptableObject, FixedUpdate, object pool | unity-game-development/SKILL.md | 🟢 |
+| godot-game-development | Godot, GDScript, CharacterBody2D, CharacterBody3D, autoload, signal.connect | godot-game-development/SKILL.md | 🟢 |
+| expo-game-development | Expo game, React Native Skia, expo-gl, requestAnimationFrame, expo-av, GestureHandler | expo-game-development/SKILL.md | 🟢 |
+| ai-music | generate music, make a song, AI music, background music, soundtrack, jingle, theme music, royalty-free music, compose, music with lyrics, extend music, fix this song, inpaint music, runcomfy music | ai-music/SKILL.md | 🟢 |
+| game-developer | Unity, Unreal Engine, game development, ECS architecture, game physics, multiplayer networking, game optimization, shader programming, game AI, object pooling, state machine, LOD | game-developer/SKILL.md | 🟢 |
+
 
 ## File Guards