@leejungkiin/awkit 1.0.0

package/workflows/git/git-commit-workflow.md

@@ -0,0 +1,75 @@
+---
+description: 📤 Commit & push code an toàn
+---
+
+# /git-commit-workflow - Commit Message Standards
+
+## 🎯 Mục đích
+Tạo commit message chuẩn semantic và thực hiện git operations an toàn.
+
+## 📋 Prerequisite
+**BẮT BUỘC:** Phải chạy `/audit` trước khi commit.
+
+---
+
+## Phase 1: Stage Changes
+
+// turbo
+```bash
+# Check status
+git status
+
+# Stage files (avoid git add .)
+git add <specific-files>
+
+# Verify staged changes
+git diff --staged
+```
+
+---
+
+## Phase 2: Generate Commit Message
+
+**Format:** `<type>(<scope>): <description>`
+
+### Types:
+- `feat`: New feature
+- `fix`: Bug fix
+- `refactor`: Code restructuring (no behavior change)
+- `style`: Formatting, whitespace
+- `docs`: Documentation only
+- `test`: Add/update tests
+- `chore`: Maintenance, dependencies
+
+### Examples:
+```
+feat(auth): implement biometric login
+fix(payment): resolve subscription renewal issue
+refactor(analytics): extract tracking logic to service
+docs(readme): update installation instructions
+```
+
+---
+
+## Phase 3: Commit & Push
+
+// turbo
+```bash
+# Commit with semantic message
+git commit -m "<generated-message>"
+
+# Pull rebase if needed (shared branch)
+git pull --rebase origin <branch>
+
+# Push
+git push origin <branch>
+```
+
+---
+
+## 🤖 Agent Rules
+
+1. **NEVER commit broken code**
+2. **ALWAYS suggest commit message** and wait for user confirmation
+3. **IF `/audit` not run yet** → Run it first
+4. **Auto-generate semantic commit message** based on changed files

package/workflows/git/hotfix.md

@@ -0,0 +1,357 @@
+---
+description: 🚨 Sửa lỗi khẩn cấp Production
+---
+
+# WORKFLOW: /hotfix - Emergency Production Fix
+
+**⚠️ CHỈ SỬ DỤNG KHI:**
+- App đang crash trên production
+- Critical security vulnerability được phát hiện
+- Data loss đang xảy ra
+- Service outage ảnh hưởng users
+
+**KHÔNG dùng cho:**
+- Bug nhỏ có thể đợi được
+- Feature requests
+- Performance improvements (trừ khi critical)
+
+---
+
+## 🎯 Mục tiêu
+
+Sửa lỗi production **NHANH** và **AN TOÀN** nhất có thể, với documentation đầy đủ để tránh lặp lại.
+
+---
+
+## ⚡ FAST TRACK MODE (Bypass Spec-First)
+
+Workflow này được phép **bypass** requirement tạo spec trước, NHƯNG phải tuân thủ các safety checks:
+
+```yaml
+bypass_conditions:
+  - severity: CRITICAL (P0)
+  - user_impact: HIGH (>1000 users affected)
+  - time_sensitive: YES (must fix within hours)
+
+safety_requirements:
+  - Must document root cause
+  - Must have rollback plan
+  - Must write post-mortem after fix
+```
+
+---
+
+## Giai đoạn 1: Triage & Assessment (5-10 phút)
+
+### 1.1. Xác định mức độ nghiêm trọng
+
+```
+P0 - CRITICAL: App không dùng được, data loss, security breach
+P1 - HIGH: Tính năng chính bị lỗi, ảnh hưởng nhiều users
+P2 - MEDIUM: Tính năng phụ lỗi, workaround có thể
+P3 - LOW: UI glitch, minor bugs
+```
+
+**Chỉ P0 và P1 mới được dùng /hotfix!**
+
+### 1.2. Thu thập thông tin
+
+- [ ] Error logs/crash reports
+- [ ] Steps to reproduce
+- [ ] Affected versions (iOS/Android version, app version)
+- [ ] Number of affected users
+- [ ] When did it start?
+
+### 1.3. Rollback assessment
+
+"Có thể rollback về version trước không?"
+- **CÓ** → Rollback ngay, fix sau
+- **KHÔNG** → Tiếp tục hotfix
+
+---
+
+## Giai đoạn 2: Root Cause Analysis (10-15 phút)
+
+### 2.1. Reproduce locally
+
+1. Checkout production branch
+2. Reproduce lỗi trong dev environment
+3. Confirm root cause
+
+### 2.2. Identify the culprit
+
+- Recent commits? (`git log --since="2 days ago"`)
+- Recent deployments?
+- Third-party SDK updates?
+- Backend API changes?
+
+### 2.3. Document findings
+
+Tạo file `docs/ai/hotfix/YYYY-MM-DD-issue-name.md`:
+
+```markdown
+# Hotfix: [Issue Name]
+
+## Severity: P0/P1
+
+## Impact
+- Affected users: [number]
+- Affected platforms: iOS/Android/Both
+- Started: [timestamp]
+
+## Root Cause
+[Detailed explanation]
+
+## Proposed Fix
+[What you will change]
+
+## Risks
+[What could go wrong]
+
+## Rollback Plan
+[How to undo if fix fails]
+```
+
+---
+
+## Giai đoạn 3: Implement Fix (15-30 phút)
+
+### 3.1. Create hotfix branch
+
+```bash
+git checkout production
+git pull origin production
+git checkout -b hotfix/YYYY-MM-DD-issue-name
+```
+
+### 3.2. Minimal change principle
+
+**QUAN TRỌNG**: Chỉ sửa đúng cái bị lỗi, KHÔNG:
+- Refactor code
+- Add new features
+- "Improve" things khác
+- Change formatting
+
+### 3.3. Write targeted fix
+
+Focus vào:
+- Smallest possible change
+- Defensive coding (null checks, try-catch)
+- Backward compatibility
+
+### 3.4. Add safety guards
+
+```swift
+// iOS Example
+guard let data = fetchData() else {
+    // Fallback to safe default
+    logger.error("Hotfix: Data fetch failed, using fallback")
+    return defaultData
+}
+```
+
+```kotlin
+// Android Example
+try {
+    riskyOperation()
+} catch (e: Exception) {
+    // Log and gracefully degrade
+    FirebaseCrashlytics.getInstance().recordException(e)
+    showFallbackUI()
+}
+```
+
+---
+
+## Giai đoạn 4: Testing (10-20 phút)
+
+### 4.1. Test the fix
+
+- [ ] Verify fix works locally
+- [ ] Test on affected device/OS version
+- [ ] Test edge cases
+- [ ] Verify no regression
+
+### 4.2. Quick smoke test
+
+Test các tính năng chính:
+- [ ] App launches
+- [ ] Login works
+- [ ] Core features work
+- [ ] No new crashes
+
+### 4.3. Beta test (if possible)
+
+- Deploy to internal testers
+- Monitor for 15-30 minutes
+- Check crash reports
+
+---
+
+## Giai đoạn 5: Deploy (Platform-specific)
+
+### iOS (TestFlight → App Store)
+
+```bash
+# 1. Bump version
+# Edit Info.plist: CFBundleShortVersionString = "1.2.3"
+# CFBundleVersion = "123"
+
+# 2. Build & Archive
+xcodebuild archive -scheme YourApp -archivePath build/YourApp.xcarchive
+
+# 3. Upload to TestFlight
+xcodebuild -exportArchive -archivePath build/YourApp.xcarchive \
+  -exportPath build/ -exportOptionsPlist ExportOptions.plist
+
+# 4. Submit for expedited review
+# In App Store Connect: Request Expedited Review
+# Explain the critical bug and user impact
+```
+
+### Android (Internal Test → Production)
+
+```bash
+# 1. Bump version
+# Edit build.gradle.kts:
+# versionCode = 124
+# versionName = "1.2.4"
+
+# 2. Build release
+./gradlew bundleRelease
+
+# 3. Upload to Play Console
+# Internal testing → Production (phased rollout 10%)
+
+# 4. Monitor crash reports
+```
+
+### Expo (EAS Update)
+
+```bash
+# 1. Create hotfix update
+eas update --branch production --message "Hotfix: [issue]"
+
+# 2. Monitor rollout
+eas update:view
+
+# 3. If issues, rollback
+eas update:rollback
+```
+
+---
+
+## Giai đoạn 6: Monitor (2-4 giờ)
+
+### 6.1. Watch metrics
+
+- [ ] Crash rate (should decrease)
+- [ ] Error logs (should reduce)
+- [ ] User reports (should stop)
+- [ ] App Store/Play Store reviews
+
+### 6.2. Phased rollout (if possible)
+
+- Start with 10% users
+- If stable after 1 hour → 50%
+- If stable after 2 hours → 100%
+
+### 6.3. Rollback trigger
+
+Rollback immediately if:
+- Crash rate increases
+- New critical bugs appear
+- User complaints spike
+
+---
+
+## Giai đoạn 7: Post-Mortem (Sau khi stable)
+
+### 7.1. Write post-mortem
+
+Cập nhật `docs/ai/hotfix/YYYY-MM-DD-issue-name.md`:
+
+```markdown
+## Timeline
+- [HH:MM] Issue detected
+- [HH:MM] Hotfix started
+- [HH:MM] Fix deployed
+- [HH:MM] Verified stable
+
+## What Went Wrong
+[Detailed analysis]
+
+## What Went Right
+[What helped us fix quickly]
+
+## Action Items
+- [ ] Add test to prevent regression
+- [ ] Update monitoring/alerts
+- [ ] Improve deployment process
+- [ ] Document learnings
+```
+
+### 7.2. Merge back to main
+
+```bash
+# Merge hotfix to main branch
+git checkout main
+git merge hotfix/YYYY-MM-DD-issue-name
+git push origin main
+```
+
+### 7.3. Create regression test
+
+**BẮT BUỘC**: Thêm test để đảm bảo lỗi này không xảy ra lại.
+
+---
+
+## 🛡️ Safety Checklist
+
+Trước khi deploy, confirm:
+
+- [ ] Root cause đã được xác định rõ ràng
+- [ ] Fix đã được test kỹ
+- [ ] Rollback plan đã sẵn sàng
+- [ ] Monitoring đã được setup
+- [ ] Team đã được thông báo
+- [ ] Documentation đã được viết
+
+---
+
+## 📊 Success Criteria
+
+Hotfix được coi là thành công khi:
+
+- ✅ Crash rate giảm về baseline
+- ✅ Không có regression bugs
+- ✅ User complaints dừng lại
+- ✅ Post-mortem đã được viết
+- ✅ Regression test đã được thêm
+
+---
+
+## ⚠️ NEXT STEPS
+
+```
+1️⃣ Monitor metrics trong 24h tiếp theo
+2️⃣ Schedule post-mortem meeting với team
+3️⃣ Tạo tasks để prevent tương tự: /plan
+4️⃣ Update runbook/documentation
+```
+
+---
+
+## 🔴 Emergency Contacts (Template)
+
+```
+# Add your team's emergency contacts
+- On-call engineer: [Name/Phone]
+- Backend team lead: [Name/Phone]
+- DevOps: [Name/Phone]
+- Product manager: [Name/Phone]
+```
+
+---
+
+**Remember**: Hotfix là last resort. Nếu không thực sự khẩn cấp, hãy dùng quy trình normal với `/plan` → `/code` → `/test`.

package/workflows/git/release-notes.md

@@ -0,0 +1,160 @@
+---
+description: 📝 Tạo Release Notes tự động
+---
+
+# WORKFLOW: /release-notes - Automated Changelog Generation
+
+Tự động tạo release notes từ git commits cho App Store và Play Store.
+
+---
+
+## Giai đoạn 1: Generate from Git
+
+### 1.1. Conventional Commits Format
+
+Commits nên theo format:
+```
+<type>(<scope>): <subject>
+
+<body>
+
+<footer>
+```
+
+Types:
+- `feat`: New feature
+- `fix`: Bug fix
+- `perf`: Performance improvement
+- `docs`: Documentation
+- `style`: UI/UX changes
+- `refactor`: Code refactoring
+- `test`: Tests
+- `chore`: Maintenance
+
+### 1.2. Extract Commits
+
+```bash
+# Get commits since last release
+git log v1.0.0..HEAD --pretty=format:"%s" --no-merges
+
+# Group by type
+git log v1.0.0..HEAD --pretty=format:"%s" --no-merges | grep "^feat:"
+git log v1.0.0..HEAD --pretty=format:"%s" --no-merges | grep "^fix:"
+```
+
+---
+
+## Giai đoạn 2: Format for Platforms
+
+### App Store (English)
+
+```markdown
+## What's New in Version 1.1.0
+
+### New Features
+• Added dark mode support
+• Introduced offline mode for core features
+• New onboarding experience
+
+### Improvements
+• Faster app startup time
+• Improved search performance
+• Better error messages
+
+### Bug Fixes
+• Fixed crash when uploading large images
+• Resolved sync issues with cloud storage
+• Fixed UI glitches on iPad
+
+---
+
+Thank you for using [App Name]! We're constantly improving your experience.
+```
+
+### Play Store (English)
+
+```markdown
+🎉 What's New
+
+✨ New Features
+• Dark mode is here!
+• Work offline with core features
+• Redesigned onboarding
+
+⚡ Improvements
+• 50% faster startup
+• Smoother search
+• Clearer error messages
+
+🐛 Bug Fixes
+• No more crashes when uploading
+• Cloud sync works perfectly
+• iPad UI is now pixel-perfect
+
+Love the app? Rate us! ⭐⭐⭐⭐⭐
+```
+
+---
+
+## Giai đoạn 3: Localization
+
+### Vietnamese
+
+```markdown
+## Có gì mới trong phiên bản 1.1.0
+
+### Tính năng mới
+• Hỗ trợ chế độ tối
+• Chế độ ngoại tuyến cho các tính năng chính
+• Trải nghiệm giới thiệu mới
+
+### Cải tiến
+• Khởi động ứng dụng nhanh hơn
+• Tìm kiếm mượt mà hơn
+• Thông báo lỗi rõ ràng hơn
+
+### Sửa lỗi
+• Sửa lỗi crash khi tải ảnh lớn
+• Khắc phục vấn đề đồng bộ
+• Sửa lỗi giao diện trên iPad
+```
+
+---
+
+## Automation Script
+
+```bash
+#!/bin/bash
+# generate-release-notes.sh
+
+LAST_TAG=$(git describe --tags --abbrev=0)
+CURRENT_VERSION="1.1.0"
+
+echo "## What's New in Version $CURRENT_VERSION"
+echo ""
+
+echo "### New Features"
+git log $LAST_TAG..HEAD --pretty=format:"• %s" --no-merges | grep "^• feat:" | sed 's/^• feat: /• /'
+echo ""
+
+echo "### Improvements"
+git log $LAST_TAG..HEAD --pretty=format:"• %s" --no-merges | grep "^• perf:\|^• refactor:" | sed 's/^• perf: /• /' | sed 's/^• refactor: /• /'
+echo ""
+
+echo "### Bug Fixes"
+git log $LAST_TAG..HEAD --pretty=format:"• %s" --no-merges | grep "^• fix:" | sed 's/^• fix: /• /'
+```
+
+---
+
+## Best Practices
+
+- Keep it user-focused (not technical)
+- Highlight top 3-5 changes
+- Use emojis for Play Store
+- Keep under 4000 characters
+- Test readability
+
+---
+
+**Next Steps**: Copy to App Store Connect / Play Console

package/workflows/git/rollback.md

@@ -0,0 +1,52 @@
+---
+description: ⏪ Quay lại phiên bản cũ
+---
+
+# WORKFLOW: /rollback - The Time Machine (Emergency Recovery)
+
+Bạn là **Antigravity Emergency Responder**. User vừa sửa code xong và app chết hoàn toàn, hoặc lỗi tràn lan khắp nơi. Họ muốn "Quay về quá khứ" (Rollback).
+
+## Nguyên tắc: "Calm & Calculated" (Bình tĩnh, không hoảng loạn)
+
+## Giai đoạn 1: Damage Assessment (Đánh giá thiệt hại)
+1.  Hỏi User (Ngôn ngữ đơn giản):
+    *   "Anh vừa sửa cái gì mà nó hỏng vậy? (VD: Sửa file X, thêm tính năng Y)"
+    *   "Nó hỏng kiểu gì? (Không mở được app, hay mở được nhưng lỗi chỗ khác?)"
+2.  Tự scan nhanh các file vừa thay đổi gần đây (nếu biết được từ context).
+
+## Giai đoạn 2: Recovery Options (Các lựa chọn phục hồi)
+Đưa ra các phương án cho User (dạng A/B/C):
+
+*   **A) Rollback File cụ thể:**
+    *   "Em sẽ khôi phục file X về phiên bản trước khi sửa."
+    *   (Dùng Git nếu có, hoặc restore từ bộ nhớ đệm nếu chưa commit).
+
+*   **B) Rollback toàn bộ Session:**
+    *   "Em sẽ hoàn tác tất cả thay đổi trong buổi hôm nay."
+    *   (Cần Git: `git stash` hoặc `git checkout .`).
+
+*   **C) Sửa thủ công (Nếu không muốn mất code mới):**
+    *   "Anh muốn giữ lại code mới và để em tìm cách sửa lỗi thay vì rollback?"
+    *   (Chuyển sang mode `/debug`).
+
+## Giai đoạn 3: Execution (Thực hiện Rollback)
+1.  Nếu User chọn A hoặc B:
+    *   Kiểm tra Git status.
+    *   Thực hiện lệnh rollback phù hợp.
+    *   Xác nhận file đã về trạng thái cũ.
+2.  Nếu User chọn C:
+    *   Chuyển sang Workflow `/debug`.
+
+## Giai đoạn 4: Post-Recovery
+1.  Báo User: "Đã quay xe thành công. App đã về trạng thái [thời điểm]."
+2.  Gợi ý: "Anh thử `/run` lại xem đã ổn chưa."
+3.  **Phòng ngừa tái phát:** "Lần sau trước khi sửa lớn, anh nhắc em commit một bản backup nhé."
+
+---
+
+## ⚠️ NEXT STEPS (Menu số):
+```
+1️⃣ Rollback xong? /run để test lại app
+2️⃣ Muốn sửa thay vì rollback? /debug
+3️⃣ OK rồi? /save-brain để lưu lại
+```