@leejungkiin/awkit 1.7.1 → 1.7.5

package/scripts/multi-model-pipeline.js

@@ -0,0 +1,386 @@
+/**
+ * Multi-Model Collaborative Pipeline Helper for AWKit
+ * Orchestrates tasks across Gemini Flash Medium, agy (Claude Opus), and Codex.
+ */
+
+const { execSync, spawnSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const AGY_PATH = path.join(os.homedir(), '.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}`);
+
+// Load configurations from .project-identity
+let config = {};
+try {
+    const configPath = path.join(__dirname, '..', '.project-identity');
+    if (fs.existsSync(configPath)) {
+        config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+    }
+} catch (_) {}
+
+function findAgy() {
+    if (fs.existsSync(AGY_PATH)) {
+        return AGY_PATH;
+    }
+    try {
+        return execSync('which agy', { encoding: 'utf8' }).trim();
+    } catch (_) {
+        return 'agy';
+    }
+}
+
+function findClaudePath() {
+    if (config.automation?.multiAgent?.runners?.claude) {
+        const p = config.automation.multiAgent.runners.claude;
+        if (fs.existsSync(p)) return p;
+    }
+    const homeClaude = path.join(os.homedir(), '.claude', 'local', 'claude');
+    if (fs.existsSync(homeClaude)) return homeClaude;
+
+    try {
+        const shell = process.env.SHELL || '/bin/zsh';
+        const shellCmd = shell.endsWith('zsh') ? 'zsh -lc "which claude"' : 'bash -lc "which claude"';
+        const detected = execSync(shellCmd, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+        if (detected && fs.existsSync(detected)) return detected;
+    } catch (_) {}
+
+    return 'claude';
+}
+
+function findCodexPath() {
+    if (config.automation?.multiAgent?.runners?.codex) {
+        const p = config.automation.multiAgent.runners.codex;
+        if (fs.existsSync(p)) return p;
+    }
+    try {
+        const shell = process.env.SHELL || '/bin/zsh';
+        const shellCmd = shell.endsWith('zsh') ? 'zsh -lc "which codex"' : 'bash -lc "which codex"';
+        const detected = execSync(shellCmd, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+        if (detected && fs.existsSync(detected)) return detected;
+    } catch (_) {}
+    return 'codex';
+}
+
+function findQwenPath() {
+    if (config.automation?.multiAgent?.runners?.qwen) {
+        const p = config.automation.multiAgent.runners.qwen;
+        if (fs.existsSync(p)) return p;
+    }
+    try {
+        const shell = process.env.SHELL || '/bin/zsh';
+        const shellCmd = shell.endsWith('zsh') ? 'zsh -lc "which qwen"' : 'bash -lc "which qwen"';
+        const detected = execSync(shellCmd, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+        if (detected && fs.existsSync(detected)) return detected;
+    } catch (_) {}
+    return 'qwen';
+}
+
+function readGlobalConfig() {
+    const defaultConf = {
+        audioAlerts: true,
+        runners: {
+            claude: true,
+            codex: true,
+            qwen: true
+        }
+    };
+    try {
+        const globalConfigPath = path.join(os.homedir(), '.awkit_config.json');
+        if (fs.existsSync(globalConfigPath)) {
+            const parsed = JSON.parse(fs.readFileSync(globalConfigPath, 'utf8'));
+            return {
+                ...defaultConf,
+                ...parsed,
+                runners: {
+                    ...defaultConf.runners,
+                    ...(parsed.runners || {})
+                }
+            };
+        }
+    } catch (_) {}
+    return defaultConf;
+}
+
+function isRunnerEnabled(runnerName) {
+    const localVal = config.automation?.multiAgent?.runnersEnabled?.[runnerName];
+    if (localVal !== undefined) return localVal;
+
+    const globalConfig = readGlobalConfig();
+    const globalVal = globalConfig.runners?.[runnerName];
+    if (globalVal !== undefined) return globalVal;
+
+    return true;
+}
+
+function isRunnerAvailable(runnerName) {
+    if (!isRunnerEnabled(runnerName)) return false;
+    let p;
+    if (runnerName === 'claude') p = findClaudePath();
+    else if (runnerName === 'codex') p = findCodexPath();
+    else if (runnerName === 'qwen') p = findQwenPath();
+    else return false;
+
+    if (fs.existsSync(p)) return true;
+    try {
+        execSync(`which ${p} || command -v ${p}`, { stdio: 'ignore' });
+        return true;
+    } catch (_) {
+        return false;
+    }
+}
+
+
+function playAudioAlert(message = "Quy trình đã hoàn thành") {
+    // 1. Read global configuration
+    let globalAudio = true;
+    try {
+        const globalConfigPath = path.join(os.homedir(), '.awkit_config.json');
+        if (fs.existsSync(globalConfigPath)) {
+            const globalConfig = JSON.parse(fs.readFileSync(globalConfigPath, 'utf8'));
+            if (globalConfig.audioAlerts !== undefined) {
+                globalAudio = globalConfig.audioAlerts;
+            }
+        }
+    } catch (_) {}
+
+    // 2. Read local project identity config
+    let localAudio = config.automation?.multiAgent?.audioAlerts;
+
+    // Local configuration takes priority. If not defined, fallback to global config.
+    const audioEnabled = localAudio !== undefined ? localAudio : globalAudio;
+
+    if (audioEnabled) {
+        try {
+            execSync(`afplay /System/Library/Sounds/Glass.aiff && say "${message}"`, { stdio: 'ignore' });
+        } catch (_) {}
+    }
+}
+
+function runPlanStep(featureName) {
+    info(`Khởi chạy Lập kế hoạch Kiến trúc...`);
+    
+    // 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.`;
+
+    let planSuccess = false;
+    
+    if (isRunnerAvailable('claude')) {
+        const claudePath = findClaudePath();
+        try {
+            info(`Calling Claude CLI (${claudePath}) for Architect Planning...`);
+            log(`$ ${claudePath} -p "..." --print --no-session-persistence --permission-mode bypassPermissions`);
+            const result = spawnSync(claudePath, [
+                '-p', prompt,
+                '--print',
+                '--no-session-persistence',
+                '--permission-mode', 'bypassPermissions'
+            ], { encoding: 'utf8', timeout: 30000 }); // 30s timeout for Claude
+
+            if (result.status === 0) {
+                log(result.stdout);
+                planSuccess = true;
+            } else {
+                warn(`Claude planning failed: ${result.stderr || result.stdout}`);
+            }
+        } catch (e) {
+            warn(`Claude planning failed or timed out: ${e.message}. Falling back to agy (Gemini)...`);
+        }
+    } else {
+        info(`Claude CLI is disabled or not available. Falling back directly to agy (Gemini)...`);
+    }
+
+    if (!planSuccess) {
+        const agyBin = findAgy();
+        try {
+            log(`$ ${agyBin} --model gemini-3.5-flash --print "..."`);
+            const result = spawnSync(agyBin, [
+                '--model', 'gemini-3.5-flash',
+                '--print', prompt
+            ], { encoding: 'utf8', timeout: 60000 });
+
+            if (result.status === 0) {
+                log(result.stdout);
+            } else {
+                err(`Lỗi lập kế hoạch: ${result.stderr || result.stdout}`);
+                process.exit(1);
+            }
+        } catch (e) {
+            err(`Lỗi lập kế hoạch: ${e.message}`);
+            process.exit(1);
+        }
+    }
+
+    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}`);
+    playAudioAlert("Kế hoạch kiến trúc đã hoàn thành");
+}
+
+function runUiStep(featureName) {
+    // 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.`;
+
+    if (isRunnerAvailable('codex')) {
+        info(`Khởi chạy Thiết kế Shell & GUI Assets (Codex CLI)...`);
+        const cmdPreview = `codex exec "${promptPreview.replace(/"/g, '\\"')}" -s read-only --skip-git-repo-check < /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, '\\"')}" -s read-only --skip-git-repo-check < /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);
+        }
+    } else {
+        info(`Codex CLI is disabled or not available. Falling back to agy (Gemini)...`);
+        const agyBin = findAgy();
+        try {
+            log(`$ ${agyBin} --model gemini-3.5-flash --print "..."`);
+            const outPreview = spawnSync(agyBin, [
+                '--model', 'gemini-3.5-flash',
+                '--print', promptPreview
+            ], { encoding: 'utf8', timeout: 60000 });
+
+            if (outPreview.status === 0) {
+                let code = outPreview.stdout;
+                const match = code.match(/```html\s*([\s\S]*?)```/i) || code.match(/```xml\s*([\s\S]*?)```/i);
+                if (match) {
+                    code = match[1];
+                }
+                fs.writeFileSync(path.join(process.cwd(), 'assets', 'ui', 'demo_preview.html'), code, 'utf8');
+                ok(`Đã sinh UI Demo Preview tại assets/ui/demo_preview.html`);
+            } else {
+                err(`Gemini UI Design failed: ${outPreview.stderr || outPreview.stdout}`);
+                process.exit(1);
+            }
+        } catch (e) {
+            err(`Lỗi sinh UI Demo Preview qua Gemini: ${e.message}`);
+            process.exit(1);
+        }
+    }
+    
+    playAudioAlert("Thiết kế giao diện đã hoàn thành");
+}
+
+function runCodeStep(featureName) {
+    const isCostOptimized = config.automation?.multiAgent?.routingMode === 'cost-optimized';
+
+    if (isCostOptimized && isRunnerAvailable('qwen')) {
+        info(`Khởi chạy Thực thi Viết Code (Qwen Coder 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.`;
+        
+        try {
+            const qwenScript = path.join(__dirname, 'qwen-exec.js');
+            log(`$ node ${qwenScript} --prompt "..."`);
+            const result = spawnSync('node', [
+                qwenScript,
+                '--prompt', promptCode
+            ], { encoding: 'utf8', timeout: 180000 });
+
+            if (result.status === 0) {
+                log(result.stdout);
+                ok(`Đã viết code và hoàn tất quá trình review từ critic subagent.`);
+            } else {
+                err(`Lỗi thực thi viết code Qwen: ${result.stderr || result.stdout}`);
+                process.exit(1);
+            }
+        } catch (e) {
+            err(`Lỗi thực thi viết code Qwen: ${e.message}`);
+            process.exit(1);
+        }
+    } else {
+        const agyBin = findAgy();
+        if (isCostOptimized && !isRunnerAvailable('qwen')) {
+            info(`Qwen Coder CLI is disabled or not available. Falling back to agy (Gemini)...`);
+        }
+        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.`;
+
+        try {
+            log(`$ ${agyBin} --model gemini-3.5-flash --print "..."`);
+            const result = spawnSync(agyBin, [
+                '--model', 'gemini-3.5-flash',
+                '--print', promptCode
+            ], { encoding: 'utf8', timeout: 180000 });
+
+            if (result.status === 0) {
+                log(result.stdout);
+                ok(`Đã viết code và hoàn tất quá trình review từ critic subagent.`);
+            } else {
+                err(`Lỗi thực thi viết code: ${result.stderr || result.stdout}`);
+                process.exit(1);
+            }
+        } catch (e) {
+            err(`Lỗi thực thi viết code: ${e.message}`);
+            process.exit(1);
+        }
+    }
+    
+    playAudioAlert("Viết mã nguồn đã hoàn thành");
+}
+
+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/scripts/qwen-exec.js

@@ -0,0 +1,147 @@
+#!/usr/bin/env node
+
+/**
+ * Wrapper script to run Qwen CLI non-interactively within AWKit.
+ * Handles temporary files, sandbox options, and fallback protocols.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { execSync } = require('child_process');
+
+const args = process.argv.slice(2);
+let prompt = '';
+let promptFile = '';
+let outputFile = '';
+let sandbox = 'read-only';
+
+for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--prompt' && args[i + 1]) {
+        prompt = args[i + 1];
+        i++;
+    } else if (args[i] === '--prompt-file' && args[i + 1]) {
+        promptFile = args[i + 1];
+        i++;
+    } else if (args[i] === '--output' && args[i + 1]) {
+        outputFile = args[i + 1];
+        i++;
+    } else if (args[i] === '--sandbox' && args[i + 1]) {
+        sandbox = args[i + 1];
+        i++;
+    }
+}
+
+// Read prompt from file if specified
+if (promptFile && fs.existsSync(promptFile)) {
+    prompt = fs.readFileSync(promptFile, 'utf8');
+}
+
+if (!prompt) {
+    console.error('Error: Prompt is required. Use --prompt or --prompt-file');
+    process.exit(1);
+}
+
+// Load configurations from .project-identity
+let routingMode = 'cost-optimized';
+let config = {};
+
+try {
+    const identityPath = path.join(__dirname, '..', '.project-identity');
+    if (fs.existsSync(identityPath)) {
+        config = JSON.parse(fs.readFileSync(identityPath, 'utf8'));
+        if (config.automation?.multiAgent?.routingMode) {
+            routingMode = config.automation.multiAgent.routingMode;
+        }
+    }
+} catch (e) {
+    console.warn('⚠️ Could not load config from .project-identity, using defaults.');
+}
+
+// Dynamic Qwen CLI Path Detection
+function findQwenPath() {
+    // 1. Check config path
+    if (config.automation?.multiAgent?.runners?.qwen) {
+        const p = config.automation.multiAgent.runners.qwen;
+        if (fs.existsSync(p)) return p;
+    }
+    // 2. Try interactive shell which (resolves aliases/nvm)
+    try {
+        const shell = process.env.SHELL || '/bin/zsh';
+        const shellCmd = shell.endsWith('zsh') ? 'zsh -lc "which qwen"' : 'bash -lc "which qwen"';
+        const detected = execSync(shellCmd, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+        if (detected && fs.existsSync(detected)) return detected;
+    } catch (_) {}
+    // 3. Basic command check
+    try {
+        const detected = execSync('which qwen || command -v qwen', { encoding: 'utf8' }).trim();
+        if (detected) return detected;
+    } catch (_) {}
+
+    return 'qwen';
+}
+
+const qwenPath = findQwenPath();
+
+// Verify Qwen CLI existence
+let qwenAvailable = false;
+try {
+    execSync(`[ -f "${qwenPath}" ] || command -v qwen`, { stdio: 'ignore' });
+    qwenAvailable = true;
+} catch (e) {
+    console.warn(`⚠️ Qwen CLI not found at ${qwenPath}`);
+}
+
+// Temporary file to pipe inputs securely
+const tempInputFile = path.join(__dirname, `temp_qwen_input_${Date.now()}.txt`);
+fs.writeFileSync(tempInputFile, prompt, 'utf8');
+
+let success = false;
+let finalOutput = '';
+
+if (qwenAvailable) {
+    console.log('🤖 Running code generation via Qwen CLI...');
+    try {
+        const cmd = `"${qwenPath}" --max-session-turns 1 -s ${sandbox} < "${tempInputFile}"`;
+        finalOutput = execSync(cmd, { encoding: 'utf8', timeout: 120000 });
+        success = true;
+    } catch (e) {
+        console.warn('⚠️ Qwen execution failed. Fallback triggered.');
+        console.error(e.message);
+    }
+}
+
+// Fallback to Gemini CLI (agy) if Qwen failed or unavailable
+if (!success) {
+    console.log('📡 Falling back to Gemini CLI (agy)...');
+    try {
+        const agyBin = 'agy';
+        const cmd = `"${agyBin}" --model gemini-3.5-flash --print "${prompt.replace(/"/g, '\\"')}" < /dev/null`;
+        finalOutput = execSync(cmd, { encoding: 'utf8', timeout: 60000 });
+        success = true;
+    } catch (e) {
+        console.error('❌ Fallback to Gemini CLI also failed:', e.message);
+    }
+}
+
+// Clean up temporary file
+try {
+    if (fs.existsSync(tempInputFile)) {
+        fs.unlinkSync(tempInputFile);
+    }
+} catch (_) {}
+
+// Output results
+if (success) {
+    if (outputFile) {
+        fs.mkdirSync(path.dirname(outputFile), { recursive: true });
+        fs.writeFileSync(outputFile, finalOutput, 'utf8');
+        console.log(`✅ Output written to ${outputFile}`);
+    } else {
+        process.stdout.write(finalOutput);
+    }
+    process.exit(0);
+} else {
+    console.error('❌ Failed to execute code step with both Qwen and fallback Gemini.');
+    process.exit(1);
+}

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