npm - @leejungkiin/awkit - Versions diffs - 1.0.0 - Mend

@leejungkiin/awkit 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (139) hide show

package/CHANGELOG.md +27 -0
package/README.md +146 -0
package/VERSION +1 -0
package/bin/awf.js +549 -0
package/bin/awk.js +1759 -0
package/core/AGENTS.md +39 -0
package/core/GEMINI.md +202 -0
package/core/GEMINI.md.bak +244 -0
package/core/orchestrator.md +58 -0
package/package.json +46 -0
package/schemas/brain.schema.json +342 -0
package/schemas/preferences.schema.json +95 -0
package/schemas/session.schema.json +112 -0
package/skill-packs/neural-memory/README.md +111 -0
package/skill-packs/neural-memory/pack.json +35 -0
package/skill-packs/neural-memory/schemas/brain-snapshot.json +167 -0
package/skill-packs/neural-memory/skills/nm-memory-audit/SKILL.md +157 -0
package/skill-packs/neural-memory/skills/nm-memory-evolution/SKILL.md +202 -0
package/skill-packs/neural-memory/skills/nm-memory-intake/SKILL.md +135 -0
package/skill-packs/neural-memory/skills/nm-memory-sync/SKILL.md +184 -0
package/skill-packs/neural-memory/workflows/nm-import.md +73 -0
package/skill-packs/neural-memory/workflows/nm-recall.md +67 -0
package/skill-packs/neural-memory/workflows/nm-snapshot.md +69 -0
package/skills/adaptive-language/SKILL.md +189 -0
package/skills/ambient-brain/SKILL.md +314 -0
package/skills/ambient-brain/brain-router.md +185 -0
package/skills/ambient-brain/brain-templates.md +201 -0
package/skills/auto-save/SKILL.md +223 -0
package/skills/awf-adaptive-language/SKILL.md +189 -0
package/skills/awf-context-help/SKILL.md +180 -0
package/skills/awf-error-translator/SKILL.md +153 -0
package/skills/awf-session-restore/SKILL.md +270 -0
package/skills/awf-version-tracker/SKILL.md +32 -0
package/skills/awf-version-tracker/scripts/snapshot.sh +22 -0
package/skills/beads-manager/SKILL.md +323 -0
package/skills/brainstorm-agent/SKILL.md +295 -0
package/skills/context-help/SKILL.md +180 -0
package/skills/error-translator/SKILL.md +153 -0
package/skills/ios-engineer/SKILL.md +101 -0
package/skills/memory-sync/SKILL.md +378 -0
package/skills/memory-sync/memory-router.md +185 -0
package/skills/memory-sync/memory-templates.md +201 -0
package/skills/orchestrator/SKILL.md +193 -0
package/skills/session-restore/SKILL.md +240 -0
package/templates/CODEBASE.md +80 -0
package/templates/brain.example.json +321 -0
package/templates/preferences.example.json +21 -0
package/templates/project-identity/android.json +28 -0
package/templates/project-identity/backend-nestjs.json +24 -0
package/templates/project-identity/expo.json +27 -0
package/templates/project-identity/ios.json +27 -0
package/templates/project-identity/web-nextjs.json +24 -0
package/templates/session.example.json +53 -0
package/templates/specs/design-template.md +166 -0
package/templates/specs/requirements-template.md +65 -0
package/templates/specs/tasks-template.md +132 -0
package/templates/structures/android.txt +10 -0
package/templates/structures/backend-nestjs.txt +6 -0
package/templates/structures/expo.txt +9 -0
package/templates/structures/ios.txt +9 -0
package/templates/structures/web-nextjs.txt +6 -0
package/templates/workflow_dual_mode_template.md +87 -0
package/workflows/_uncategorized/README.md +339 -0
package/workflows/_uncategorized/ads-creative.md +357 -0
package/workflows/_uncategorized/ads-full-optimization.md +308 -0
package/workflows/_uncategorized/ads-plan.md +247 -0
package/workflows/_uncategorized/ads-user-analysis.md +337 -0
package/workflows/_uncategorized/skill-health.md +35 -0
package/workflows/_uncategorized/skill-rollback.md +35 -0
package/workflows/ads/admob.md +62 -0
package/workflows/ads/ads-analyst.md +201 -0
package/workflows/ads/ads-audit.md +106 -0
package/workflows/ads/ads-optimize.md +97 -0
package/workflows/ads/ads-targeting.md +241 -0
package/workflows/ads/adsExpert.md +160 -0
package/workflows/ads/smali-ads-config.md +400 -0
package/workflows/ads/smali-ads-flow.md +331 -0
package/workflows/ads/smali-ads-interstitial.md +377 -0
package/workflows/ads/smali-ads-native.md +382 -0
package/workflows/context/auto-execution-workflow.md +291 -0
package/workflows/context/auto-implement.md +211 -0
package/workflows/context/codebase-sync.md +163 -0
package/workflows/context/logic-reasoning-workflow.md +260 -0
package/workflows/context/next.md +195 -0
package/workflows/context/recap.md +212 -0
package/workflows/context/save-brain.md +285 -0
package/workflows/context/user-intent-analysis-workflow.md +206 -0
package/workflows/expert/codeExpert.md +126 -0
package/workflows/expert/debugExpert.md +136 -0
package/workflows/expert/planExpert.md +112 -0
package/workflows/git/cloudflare-tunnel.md +135 -0
package/workflows/git/git-commit-workflow.md +75 -0
package/workflows/git/hotfix.md +357 -0
package/workflows/git/release-notes.md +160 -0
package/workflows/git/rollback.md +52 -0
package/workflows/git/smart-git-ops.md +103 -0
package/workflows/lifecycle/brainstorm.md +377 -0
package/workflows/lifecycle/code.md +663 -0
package/workflows/lifecycle/debug.md +116 -0
package/workflows/lifecycle/deploy.md +95 -0
package/workflows/lifecycle/init.md +152 -0
package/workflows/lifecycle/master-code-workflow.md +300 -0
package/workflows/lifecycle/migration.md +196 -0
package/workflows/lifecycle/plan.md +91 -0
package/workflows/lifecycle/refactor.md +165 -0
package/workflows/lifecycle/run.md +52 -0
package/workflows/lifecycle/test.md +91 -0
package/workflows/meta/customize.md +346 -0
package/workflows/meta/file-protection-rules.md +129 -0
package/workflows/meta/help.html +350 -0
package/workflows/meta/project-identity-enforcement.md +180 -0
package/workflows/mobile/app-analysis.md +64 -0
package/workflows/mobile/maestro-qa-workflow.md +470 -0
package/workflows/mobile/maestro-test-workflow.md +84 -0
package/workflows/mobile/structure-clean-architect.md +271 -0
package/workflows/mobile/turbo-mobile-build.md +190 -0
package/workflows/quality/accessibility-audit.md +311 -0
package/workflows/quality/audit.md +217 -0
package/workflows/quality/bug-hunter.md +243 -0
package/workflows/quality/code-janitor.md +209 -0
package/workflows/quality/code-quality-rules.md +132 -0
package/workflows/quality/performance-audit.md +343 -0
package/workflows/quality/project-audit.md +61 -0
package/workflows/quality/self-healing-test.md +192 -0
package/workflows/quality/ui-review.md +130 -0
package/workflows/quality/ux-audit.md +213 -0
package/workflows/quality/visual-debug.md +34 -0
package/workflows/roles/oracle.md +267 -0
package/workflows/roles/product-manager-workflow.md +52 -0
package/workflows/roles/qa-engineer-workflow.md +41 -0
package/workflows/roles/tech-lead-workflow.md +45 -0
package/workflows/roles/ui-ux-designer-workflow.md +42 -0
package/workflows/roles/vibe-coding-master-workflow.md +52 -0
package/workflows/ui/app-screen-analyzer.md +152 -0
package/workflows/ui/create-feature.md +332 -0
package/workflows/ui/create-spec-architect.md +184 -0
package/workflows/ui/design-to-ui.md +308 -0
package/workflows/ui/ui-first-methodology.md +279 -0
package/workflows/ui/visualize.md +298 -0

package/workflows/meta/help.html ADDED Viewed

@@ -0,0 +1,350 @@
+<!DOCTYPE html>
+<html lang="vi">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Quy Trình Phát Triển Antigravity High-End</title>
+    <style>
+        :root {
+            --bg-color: #0f172a;
+            --text-color: #e2e8f0;
+            --heading-color: #f8fafc;
+            --accent-color: #38bdf8;
+            --secondary-accent: #f472b6;
+            --card-bg: rgba(30, 41, 59, 0.7);
+            --border-color: rgba(148, 163, 184, 0.1);
+            --code-bg: #1e293b;
+            --success-color: #4ade80;
+            --accent-glow: rgba(56, 189, 248, 0.3);
+        }
+        * {
+            box-sizing: border-box;
+            margin: 0;
+            padding: 0;
+        }
+        body {
+            font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+            background-color: var(--bg-color);
+            color: var(--text-color);
+            line-height: 1.6;
+            padding: 2rem;
+            background-image:
+                radial-gradient(circle at 10% 20%, rgba(56, 189, 248, 0.1) 0%, transparent 20%),
+                radial-gradient(circle at 90% 80%, rgba(244, 114, 182, 0.1) 0%, transparent 20%);
+        }
+        .container {
+            max-width: 960px;
+            margin: 0 auto;
+        }
+        header {
+            text-align: center;
+            margin-bottom: 4rem;
+            padding: 2rem;
+            position: relative;
+        }
+        h1 {
+            font-size: 2.8rem;
+            color: var(--heading-color);
+            margin-bottom: 0.5rem;
+            letter-spacing: -0.025em;
+        }
+        .subtitle {
+            font-size: 1.25rem;
+            color: var(--accent-color);
+            font-weight: 500;
+        }
+        section {
+            margin-bottom: 3rem;
+            animation: fadeIn 0.5s ease-out forwards;
+            opacity: 0;
+        }
+        @keyframes fadeIn {
+            from {
+                opacity: 0;
+                transform: translateY(10px);
+            }
+            to {
+                opacity: 1;
+                transform: translateY(0);
+            }
+        }
+        section:nth-child(2) {
+            animation-delay: 0.1s;
+        }
+        section:nth-child(3) {
+            animation-delay: 0.2s;
+        }
+        section:nth-child(4) {
+            animation-delay: 0.3s;
+        }
+        .card {
+            background: var(--card-bg);
+            border: 1px solid var(--border-color);
+            border-radius: 1rem;
+            padding: 1.5rem;
+            backdrop-filter: blur(10px);
+            margin-bottom: 1.5rem;
+        }
+        .workflow-grid {
+            display: grid;
+            grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
+            gap: 1.5rem;
+        }
+        .workflow-item {
+            background: rgba(255, 255, 255, 0.03);
+            padding: 1.5rem;
+            border-radius: 0.75rem;
+            border-left: 4px solid var(--accent-color);
+        }
+        .workflow-item.master {
+            border-left-color: var(--secondary-accent);
+        }
+        h2 {
+            font-size: 1.8rem;
+            margin-bottom: 1.5rem;
+            display: flex;
+            align-items: center;
+            gap: 0.5rem;
+        }
+        h3 {
+            font-family: monospace;
+            color: var(--accent-color);
+            margin-bottom: 0.5rem;
+            font-size: 1.1rem;
+        }
+        code {
+            font-family: monospace;
+            color: var(--secondary-accent);
+            background: rgba(244, 114, 182, 0.1);
+            padding: 0.2rem 0.4rem;
+            border-radius: 0.25rem;
+        }
+        .step-container {
+            padding-left: 2rem;
+            border-left: 2px solid var(--border-color);
+        }
+        .step {
+            position: relative;
+            margin-bottom: 2.5rem;
+        }
+        .step-number {
+            position: absolute;
+            left: -2.9rem;
+            top: 0;
+            width: 1.8rem;
+            height: 1.8rem;
+            background: var(--bg-color);
+            border: 2px solid var(--accent-color);
+            border-radius: 50%;
+            color: var(--accent-color);
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            font-weight: bold;
+        }
+        .download-btn {
+            display: inline-flex;
+            align-items: center;
+            gap: 0.5rem;
+            margin-top: 2rem;
+            padding: 0.8rem 1.5rem;
+            background: linear-gradient(90deg, var(--accent-color), #a855f7);
+            color: white;
+            text-decoration: none;
+            border-radius: 9999px;
+            font-weight: 600;
+            transition: transform 0.2s, box-shadow 0.2s;
+            box-shadow: 0 4px 15px var(--accent-glow);
+        }
+        .download-btn:hover {
+            transform: translateY(-2px);
+            box-shadow: 0 8px 25px var(--accent-glow);
+        }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <header>
+            <h1>Antigravity Development</h1>
+            <div class="subtitle">AI-First Spec-Driven Workflow System</div>
+            <a href="workflow.zip" download class="download-btn">📥 Tải về Workflow.zip</a>
+        </header>
+        <section>
+            <h2>🌟 Các Quy Trình Cốt Lõi (Core Workflows)</h2>
+            <div class="workflow-grid">
+                <div class="workflow-item master">
+                    <h3>/master-code-workflow</h3>
+                    <p><strong>Master Workflow.</strong> Quy trình toàn diện từ A-Z để thiết kế và hiện thực hóa tính
+                        năng chuẩn Clean Architecture & Kiro-style specs.</p>
+                </div>
+                <div class="workflow-item">
+                    <h3>/app-screen-analyzer</h3>
+                    <p><strong>"God Mode" Planning.</strong> Phân tích ý tưởng/ảnh chụp màn hình và tự động tạo toàn bộ
+                        specs (Requirements/Design/Tasks) cho TẤT CẢ màn hình.</p>
+                </div>
+                <div class="workflow-item">
+                    <h3>/create-spec-architect</h3>
+                    <p><strong>Single Feature Design.</strong> Tạo specs chi tiết cho một tính năng lẻ cụ thể (VD: chỉ
+                        làm tính năng Chat).</p>
+                </div>
+                <div class="workflow-item">
+                    <h3>/auto-implement</h3>
+                    <p><strong>The Builder.</strong> Tự động code và test dựa trên các file specs đã có (đọc file
+                        tasks.md).</p>
+                </div>
+            </div>
+        </section>
+        <section>
+            <h2>🎨 UI & Implementation</h2>
+            <div class="workflow-grid">
+                <div class="workflow-item">
+                    <h3>/design-to-ui</h3>
+                    <p>Chuyển đổi trực tiếp từ ý tưởng/ảnh thiết kế sang code UI Swift/SwiftUI/Kotlin.</p>
+                </div>
+                <div class="workflow-item">
+                    <h3>/ui-first-methodology</h3>
+                    <p>Phương pháp phát triển ưu tiên giao diện trước, logic sau. Đảm bảo UX mượt mà.</p>
+                </div>
+                <div class="workflow-item">
+                    <h3>/create-feature</h3>
+                    <p>Xây dựng tính năng hoàn chỉnh với logic chặt chẽ và trải nghiệm Premium.</p>
+                </div>
+                <div class="workflow-item">
+                    <h3>/init & /structure</h3>
+                    <p><code>/init</code>: Khởi tạo dự án Mobile chuẩn.<br>
+                    <code>/structure-clean-architect</code>: Tạo cấu trúc Clean Architecture.</p>
+                </div>
+            </div>
+        </section>
+        <section>
+            <h2>🕵️ Quality Assurance & Debugging</h2>
+            <div class="workflow-grid">
+                <div class="workflow-item">
+                    <h3>/bug-hunter</h3>
+                    <p>Quy trình tìm, tái hiện và sửa lỗi dựa trên log hoặc báo cáo chi tiết.</p>
+                </div>
+                <div class="workflow-item">
+                    <h3>/visual-debug</h3>
+                    <p>Phân tích ảnh chụp màn hình để phát hiện lỗi giao diện, lệch layout.</p>
+                </div>
+                <div class="workflow-item">
+                    <h3>/maestro-test-workflow</h3>
+                    <p>Tạo và chạy bài kiểm tra giao diện tự động (E2E) với Maestro.</p>
+                </div>
+                <div class="workflow-item">
+                    <h3>/code-review-workflow</h3>
+                    <p>Review code chuyên sâu: Bảo mật, hiệu năng, Clean Code.</p>
+                </div>
+            </div>
+        </section>
+        <section>
+            <h2>🛠️ Operations & Maintenance</h2>
+            <div class="workflow-grid">
+                <div class="workflow-item">
+                    <h3>DevOps & Git</h3>
+                    <p><code>/deploy</code>: Đẩy app lên TestFlight/Play Store.<br>
+                    <code>/smart-git-ops</code>: Quản lý flows git và commit chuẩn.</p>
+                </div>
+                <div class="workflow-item">
+                    <h3>Maintenance</h3>
+                    <p><code>/refactor</code>: Tối ưu cấu trúc code an toàn.<br>
+                    <code>/code-janitor</code>: Dọn dẹp code rác & chuẩn hóa.</p>
+                </div>
+                <div class="workflow-item">
+                    <h3>Knowledge</h3>
+                    <p><code>/save-brain</code>: Lưu kiến thức dự án.<br>
+                    <code>/recap</code>: Khôi phục ngữ cảnh làm việc.</p>
+                </div>
+                <div class="workflow-item">
+                    <h3>Roles</h3>
+                    <p><code>/product-manager-workflow</code><br>
+                    <code>/tech-lead-workflow</code><br>
+                    <code>/ui-ux-designer-workflow</code></p>
+                </div>
+            </div>
+        </section>
+        <section>
+            <h2>🚀 Hướng Dẫn Kịch Bản Sử Dụng</h2>
+            <div class="card">
+                <h3>Kịch bản 1: Bắt đầu dự án mới (Khuyên dùng)</h3>
+                <br>
+                <div class="step-container">
+                    <div class="step">
+                        <div class="step-number">1</div>
+                        <h3>Thiết lập cấu trúc & Định hướng</h3>
+                        <p>Chạy <code>/master-code-workflow</code> để thiết lập nền móng chuẩn chỉnh hoặc <code>/init</code> để tạo dự án mới.</p>
+                    </div>
+                    <div class="step">
+                        <div class="step-number">2</div>
+                        <h3>Phân tích toàn bộ ứng dụng</h3>
+                        <p>Ra lệnh: <em>"Analyze app: [Mô tả ý tưởng app]"</em>. Hệ thống sẽ kích hoạt
+                            <code>/app-screen-analyzer</code> để tạo hàng loạt specs cho 20+ màn hình.
+                        </p>
+                    </div>
+                    <div class="step">
+                        <div class="step-number">3</div>
+                        <h3>Hiện thực hóa từng phần</h3>
+                        <p>Dùng <code>/auto-implement docs/specs/auth</code>, sau đó đến
+                            <code>/auto-implement docs/specs/home</code>... theo lộ trình trong
+                            <code>_overview.md</code>.
+                        </p>
+                    </div>
+                </div>
+            </div>
+            <div class="card">
+                <h3>Kịch bản 2: Làm tính năng lẻ (Feature nhỏ)</h3>
+                <br>
+                <div class="step-container">
+                    <div class="step">
+                        <div class="step-number">1</div>
+                        <h3>Thiết kế Specs</h3>
+                        <p>Chạy <code>/create-spec-architect</code> để tạo bộ hồ sơ cho tính năng mới.</p>
+                    </div>
+                    <div class="step">
+                        <div class="step-number">2</div>
+                        <h3>Thực thi</h3>
+                        <p>Chạy <code>/auto-implement [tên-feature]</code> để AI tự động code.</p>
+                    </div>
+                </div>
+            </div>
+        </section>
+        <footer>
+            <p>Antigravity System © 2026 - Spec-Driven Development</p>
+        </footer>
+    </div>
+</body>
+</html>

package/workflows/meta/project-identity-enforcement.md ADDED Viewed

@@ -0,0 +1,180 @@
+---
+description: Tuân thủ định dạng và tiêu chuẩn dự án theo .project-identity.
+---
+# Project Identity Enforcement Workflow
+## Overview
+Workflow này đảm bảo rằng AI assistant luôn kiểm tra và tuân thủ thông tin trong `.project-identity` trước khi thực hiện bất kỳ nhiệm vụ nào.
+## 🔴 MANDATORY RULES
+### Pre-Task Identity Check
+**BẮT BUỘC thực hiện trước mọi nhiệm vụ:**
+1. **Read .project-identity file**
+2. **Analyze project context**
+3. **Load appropriate workflow rules**
+4. **Apply project-specific constraints**
+### Identity Check Protocol
+#### Step 1: File Validation
+```
+IF .project-identity exists:
+  → Proceed to Step 2
+ELSE:
+  → Create .project-identity template
+  → Request user to fill required information
+  → STOP until completed
+```
+#### Step 2: Context Analysis
+**Extract and understand:**
+- `projectType`: Determines platform-specific rules
+- `projectStage`: Defines current workflow phase
+- `mainLanguages`: Programming languages in use
+- `mainFrameworks`: Technology stack
+- `keyFeatures`: Core functionality
+- `projectLifecycle`: Current stage requirements
+#### Step 3: Workflow Rules Loading
+**Load rules in this order:**
+1. `coreRules.always_applied` (mandatory for all tasks)
+2. `platformSpecificRules` based on `projectType`
+3. Stage-specific rules from `projectLifecycle`
+4. Integration rules if features are enabled
+## Workflow Rules Mapping
+### By Project Type
+**Android Projects:**
+```
+Required Rules:
+- .cursor/rules/android-workflow.mdc
+- .cursor/rules/android-code-deduplication.mdc
+- .cursor/rules/tdd-mobile-workflow.mdc
+- .cursor/rules/mobile-utility-workflow.mdc
+```
+**iOS Projects:**
+```
+Required Rules:
+- .cursor/rules/ios-workflow.mdc
+- .cursor/rules/tdd-mobile-workflow.mdc
+- .cursor/rules/mobile-utility-workflow.mdc
+```
+**Web Projects:**
+```
+Required Rules:
+- .cursor/rules/frontend-rules.mdc
+- .cursor/rules/backend-rules-optimized.mdc
+- .cursor/rules/api-integration-rules.mdc
+```
+**Flutter Projects:**
+```
+Required Rules:
+- .cursor/rules/mobile-utility-workflow.mdc
+- .cursor/rules/tdd-mobile-workflow.mdc
+```
+### By Project Stage
+**Stage 1 - Brainstorm:**
+```
+Required Rules:
+- .cursor/rules/brainstorm-workflow.mdc
+- .cursor/rules/brainstorm-detailed-workflow.mdc
+Blocking: Cannot proceed to development without brainstorm completion
+```
+**Stage 2 - Setup:**
+```
+Required Rules:
+- .cursor/rules/project-creation-workflow.mdc
+- .cursor/rules/planning-workflow.mdc
+- .cursor/rules/tech-stack-selection.mdc
+```
+**Stage 3 - Development:**
+```
+Required Rules:
+- Platform-specific development rules
+- .cursor/rules/development-rules.mdc
+- .cursor/rules/tdd-guidelines.mdc
+```
+## Context7 Integration (Enhanced)
+### Memory Check Requirements
+**Before starting any task:**
+1. **BẮT BUỘC**: Kích hoạt Context7 Auto-Check Workflow
+2. **BẮT BUỘC**: Search Context7 for project-related memories
+3. **BẮT BUỘC**: Resolve library IDs cho các tech stack components
+4. **BẮT BUỘC**: Thu thập documentation và best practices
+5. **BẮT BUỘC**: Apply lessons learned from similar projects
+6. **BẮT BUỘC**: Check for existing solutions or patterns
+7. **BẮT BUỘC**: Validate architecture choices với industry standards
+8. **BẮT BUỘC**: Update memory with new insights
+9. **MỚI**: Implement error handling cho Context7 failures
+10. **MỚI**: Cache Context7 results để improve performance
+## Enforcement Actions
+### Blocking Conditions
+**STOP execution if:**
+- `.project-identity` is missing or incomplete
+- Project stage requirements not met
+- Required workflow rules not loaded
+- Stage progression rules violated
+### Warning Conditions
+**Warn user if:**
+- Project type doesn't match detected technology
+- Stage seems inconsistent with project state
+- Missing recommended integrations
+- Outdated project information
+### Auto-Update Triggers
+**Automatically update `.project-identity` when:**
+- New technologies are detected
+- Project stage naturally progresses
+- New features are implemented
+- Integration status changes
+## Error Handling
+### Missing .project-identity
+```
+Action: Create template file
+Message: "🚫 Project identity file missing. Creating template..."
+Next: Request user to complete required fields
+```
+### Incomplete Information
+```
+Action: Identify missing fields
+Message: "⚠️ Project identity incomplete. Missing: [fields]"
+Next: Request specific information
+```
+### Stage Violation
+```
+Action: Block execution
+Message: "🚫 Cannot skip project stages. Current: [stage], Required: [required]"
+Next: Guide user to complete current stage
+```
+## Success Criteria
+**Task can proceed when:**
+- ✅ `.project-identity` exists and is complete
+- ✅ All required workflow rules are loaded
+- ✅ Project context is understood
+- ✅ Stage requirements are validated
+- ✅ No blocking conditions exist

package/workflows/mobile/app-analysis.md ADDED Viewed

@@ -0,0 +1,64 @@
+---
+description: 📊 Phân tích ứng dụng chuyên sâu
+---
+you are a.i named kien, hãy bắt đầu bằng câu: báo cáo sếp, em đã phân tích xong [nhiệm vụ] đây là những cái anh cần ạ, responsible for analyzing applications and giving work instructions, :
+# analytic google play data
+- if you receive 1 link from the application
+- action as if you are an aso expert, analysis of application, analysis of the keywords of the application
+# analytic by country
+- if you receive the csv with the containing structure: language,users,new users,engaged sessions,engagement rate,engaged sessions per user,average engagement time,event count,conversions,total revenue
+- please analyze all data and evaluate use by country, assess the potential of countries
+# analytics csv data:
+## step 1: ask users to provide data about firebase analytics
+  - csv data from firebase analytics.
+  - after having the data of firebase analytics moved to the next step
+  - tips: the data of firebase analytics will have the structure starting with: report csv export
+## step 2: data analysis from firebase analytics
+ - action as if you are a developer, evaluate detailed applications based on this analytics data.
+ - review users by 7 days and 30 days.
+ - give suggestions on applications based on this data
+## step 3: collect google play console data:
+- analyze as if you are an application marketing expert, aso expert
+ - csv data from google play console
+ ### get: store listing conversion analysis
+ * get: keyword analytics:
+	instruct users to download from:
+	- "listing conversion analysis" select "view by: search term": this is the data of the search keywords.
+	 term (keyword search) data starting from csv starts with: "search term, store listing visitors". analysis of 20 keywords.
+	you can be on this keyword to suggest other keywords similar. list 20 other keywords. here i want to use this data to search for potential keywords (currently with low search numbers based on data, but have search data on bg search engines).
+	- continue instruct users to download from: "view by: country / region": application display ratio on play store by country.
+	 effective statistics according to csv country starting with: country / region, store listing visitors
+### analytics:
+based on search term and country / region evaluating and analyzing the conversion ratio of the application
+### revenue:
+if the data contains data on revenue, offer the fluctuations in revenue, the highest revenue days (specify the revenue), compare with the installation.
+### evaluate data:
+ - effective evaluation based on data on the same type of applications, giving assessments on the competitive rate.
+ - create a list of keywords that evaluate effectively by keywords and add search data on search engines from that keyword.
+ - create a list of countries with good conversion rates
+- suggest similar keywords and keywords according to countries with good conversion rates
+# overview : provide assessment and actionable insights
+- give a comprehensive performance report of the app, highlighting strengths and weaknesses based on analyzed data.
+- identify key and potential markets by listing countries with the highest user engagement and potential growth markets based on current trends and available data.
+- compare with similar applications to evaluate the app's market position.
+- suggest specific strategies for app optimization and marketing, and outline tasks for user growth and development.
+each step is to be initiated only after the complete and verified information from the previous step has been obtained. this ensures a systematic and efficient analysis process.
+# rule:
+- response in vietnamese language
+- do not describe too much details of whose mission
+- you need to focus on application analysis as if you are a marketing expert, an application developer
+- no yapping, limit prose, no fluff