@leejungkiin/awkit 1.0.0

package/skills/memory-sync/memory-templates.md

@@ -0,0 +1,201 @@
+# Brain Entry Templates
+
+> Các template chuẩn để lưu vào brain/ — dùng cho cả auto-save và manual /save-brain.
+
+---
+
+## Template 1: Decision (brain/decisions/)
+
+**Filename:** `brain/decisions/YYYY-MM-DD-[slug].md`
+
+```markdown
+---
+date: 2026-02-22
+type: decision
+topic: [brief topic, e.g., "Database choice for neural-brain"]
+feature: [which feature/project this belongs to]
+tags: [tech, architecture, database, ...]
+salience: 0.90
+---
+
+# Decision: [Topic]
+
+## What was decided
+[Clear statement of the decision]
+
+## Why this approach
+[Rationale — key reasons]
+
+## Alternatives considered
+- **[Option A]**: [Why rejected]
+- **[Option B]**: [Why rejected]
+
+## Trade-offs
+- ✅ [Pro 1]
+- ✅ [Pro 2]
+- ⚠️ [Con/caveat]
+
+## Context
+[Additional context: task ID, feature, constraints]
+```
+
+---
+
+## Template 2: Solution (brain/solutions/)
+
+**Filename:** `brain/solutions/YYYY-MM-DD-[slug].md`
+
+```markdown
+---
+date: 2026-02-22
+type: solution
+error_pattern: [e.g., "TypeError: Cannot read property of undefined"]
+files_affected: [e.g., "activation.js, store.js"]
+tags: [javascript, sqlite, null-check, ...]
+salience: 0.85
+---
+
+# Solution: [Error Pattern]
+
+## The Error
+```
+[Paste exact error or describe the bug]
+```
+
+## Root Cause
+[Why this happened — 1-2 sentences]
+
+## The Fix
+[Step-by-step or code snippet showing the solution]
+
+```js
+// Before (broken)
+code here
+
+// After (fixed)
+code here
+```
+
+## How to Prevent
+[Rule or pattern to avoid this in future]
+
+## Context
+[What feature/task was being worked on when this occurred]
+```
+
+---
+
+## Template 3: Architecture (brain/decisions/)
+
+**Filename:** `brain/decisions/arch-[feature]-[date].md`
+
+```markdown
+---
+date: 2026-02-22
+type: architecture
+feature: [feature name, e.g., "neural-brain"]
+tags: [architecture, design, ...]
+salience: 0.95
+---
+
+# Architecture: [Feature Name]
+
+## Overview
+[Brief description of what was designed]
+
+## Structure
+```
+[directory tree or component diagram]
+```
+
+## Key Decisions
+1. [Decision 1 + rationale]
+2. [Decision 2 + rationale]
+3. [Decision 3 + rationale]
+
+## Tech Choices
+| Component | Choice | Reason |
+|-----------|--------|--------|
+| [Layer]   | [Tech] | [Why]  |
+
+## Data Flow
+[How data flows through the system]
+
+## Open Questions
+- [ ] [Question to resolve later]
+```
+
+---
+
+## Template 4: Session (brain/session.json)
+
+**Auto-updated by ambient-brain skill.**
+
+```json
+{
+  "last_updated": "2026-02-22T16:56:00+07:00",
+  "working_on": {
+    "project": "main-awf",
+    "feature": "neural-brain + ambient-brain skill",
+    "phase": "implementation",
+    "current_task_id": null,
+    "current_files": ["skills/ambient-brain/SKILL.md"]
+  },
+  "recent_decisions": [
+    {
+      "ref": "decisions/2026-02-22-use-better-sqlite3.md",
+      "summary": "Use better-sqlite3 for neural brain storage"
+    }
+  ],
+  "recent_solutions": [],
+  "active_context": {
+    "neural_brain_port": "Planning phase - studying Python source",
+    "ambient_brain": "Implementing skill files"
+  },
+  "completed_milestones": [],
+  "context_checkpoints": []
+}
+```
+
+---
+
+## Template 5: Active Plans (brain/active_plans.json)
+
+```json
+{
+  "plans": [
+    {
+      "id": "neural-brain-nodejs-port",
+      "title": "Port neural-memory to Node.js for main-awf",
+      "status": "planning",
+      "phases": [
+        { "id": "p1", "name": "Study Python source", "status": "done" },
+        { "id": "p2", "name": "Build SQLite schema", "status": "next" },
+        { "id": "p3", "name": "Core data structures", "status": "pending" },
+        { "id": "p4", "name": "Spreading activation engine", "status": "pending" },
+        { "id": "p5", "name": "Public API integration", "status": "pending" }
+      ],
+      "created": "2026-02-22",
+      "last_updated": "2026-02-22"
+    },
+    {
+      "id": "ambient-brain-skill",
+      "title": "Ambient Brain Sync skill for AWF",
+      "status": "implementing",
+      "phases": [
+        { "id": "p1", "name": "Design & brainstorm", "status": "done" },
+        { "id": "p2", "name": "Create skill files", "status": "in_progress" },
+        { "id": "p3", "name": "Update GEMINI.md", "status": "next" },
+        { "id": "p4", "name": "Deploy to antigravity", "status": "pending" },
+        { "id": "p5", "name": "Test with real workflow", "status": "pending" }
+      ],
+      "created": "2026-02-22",
+      "last_updated": "2026-02-22"
+    }
+  ]
+}
+```
+
+---
+
+*brain-templates v1.0.0 — Standard formats for consistent brain storage*

package/skills/orchestrator/SKILL.md

@@ -0,0 +1,193 @@
+---
+name: orchestrator
+description: >-
+  Intelligent dispatcher — analyzes context, injects project brain, then
+  delegates to the right skill or workflow. Always runs first.
+version: 2.0.0
+trigger: always
+priority: 1
+---
+
+# Orchestrator Skill v2.0 — Project-Aware
+
+> **Role:** First-layer processor. Chạy trước MỌI skill khác.
+> **New in v2.0:** Project Brain Lookup — inject project context trước khi route.
+
+---
+
+## Execution Order (MANDATORY)
+
+```
+Step 1: Project Brain Lookup    ← MỚI — chạy đầu tiên
+Step 2: Intent Detection
+Step 3: Route to skill/workflow
+```
+
+---
+
+## Step 1: Project Brain Lookup (LUÔN CHẠY)
+
+Trước khi làm bất cứ điều gì, orchestrator phải load project context:
+
+### 1.1 — Đọc `.project-identity`
+
+```yaml
+check: Có file .project-identity trong project dir không?
+
+IF EXISTS:
+  read: .project-identity
+  extract:
+    - projectName
+    - stage (stage3_development, etc.)
+    - architecture (clean_architecture, mvvm)
+    - tech stack (swift, react, node, etc.)
+    - currentWork / nextMilestones
+
+SET: project_context = { name, stage, arch, stack }
+```
+
+### 1.2 — Đọc `CODEBASE.md`
+
+```yaml
+check: Có file CODEBASE.md trong project dir không?
+
+IF EXISTS:
+  read: CODEBASE.md
+  extract:
+    - layer_map: { layer_name → files[] }
+    - feature_areas: { feature → directory }
+    - naming_conventions
+    - data_flow_diagrams
+
+SET: codebase_map = { layers, features, conventions }
+
+RULES:
+  → KHÔNG scan raw directory nếu CODEBASE.md tồn tại
+  → KHÔNG hỏi user về file location — tự suy luận từ codebase_map
+```
+
+### 1.3 — Resolve Target từ Request
+
+```yaml
+# Khi user đề cập feature/bug/area:
+resolve_target(user_request, codebase_map):
+  keywords = extract_keywords(user_request)
+  
+  # Match theo thứ tự ưu tiên:
+  1. Layer match: "crash khi login" → AuthenticationViewModel, AuthUseCases
+  2. Feature match: "water tracking" → Features/Water/
+  3. Service match: "camera chậm" → CameraViewModel + Core/Services/
+  4. Fallback: "không rõ" → list top 3 candidates từ CODEBASE.md
+```
+
+### 1.4 — Brief Confirm Output (LUÔN HIỂN THỊ)
+
+```
+Format:
+  "📚 [ProjectName] | [Stage] | [Architecture]
+   🗺️  Targeting: [resolved file/layer]"
+
+Example:
+  "📚 FitBite Witness | Stage 3 Development | Clean Architecture + MVVM
+   🗺️  Targeting: AuthenticationViewModel → SignInUseCase"
+
+Nếu CODEBASE.md không có:
+  "📚 [ProjectName] — CODEBASE.md chưa có, đang scan cấu trúc..."
+
+Nếu file được nhắc đến KHÔNG có trong CODEBASE.md:
+  → Thực hiện xong, thêm footer: "⚠️ CODEBASE.md có thể outdated — dùng /codebase-sync"
+```
+
+---
+
+## Step 2: Intent Detection
+
+Sau khi có project context, detect intent từ request:
+
+```yaml
+debug_intent:
+  keywords: ["error", "bug", "crash", "fix", "lỗi", "sửa", "fail", "không chạy"]
+  + image: [screenshot of error/crash]
+  action: Execute debug flow với target đã resolve từ Step 1
+
+code_intent:
+  keywords: ["implement", "build", "create", "add", "code", "viết", "tạo", "thêm"]
+  action: Execute code flow tại target layer/file đã biết
+
+plan_intent:
+  keywords: ["plan", "design", "architect", "how to", "strategy", "thiết kế"]
+  action: Route to /plan với project context injected
+
+context_intent:
+  keywords: ["remember", "save", "continue", "where was I", "nhớ", "tiếp", "recap"]
+  action: Route to /recap hoặc /save-brain
+
+ads_intent:
+  keywords: ["ads", "campaign", "CPI", "ROAS", "quảng cáo"]
+  action: Route to /ads-audit hoặc /adsExpert
+
+image_intent:
+  trigger: User gửi ảnh chụp màn hình
+  + debug keywords: Route to visual-debug với CODEBASE context
+  + design keywords: Route to design-to-ui
+  + error screenshot: Route to debug flow
+```
+
+---
+
+## Step 3: Routing
+
+### With Project Context (khi đã có CODEBASE.md)
+
+```
+→ Không suggest workflow, THỰC HIỆN LUÔN
+→ Đi thẳng đến file/layer đã resolve
+→ Không hỏi "file này ở đâu?" — đã biết từ CODEBASE.md
+```
+
+### Without Project Context
+
+```
+→ Route bình thường theo intent
+→ Suggest workflow phù hợp
+→ Có thể hỏi clarifying question (max 2 lần)
+```
+
+### Slash Command Detection
+
+```yaml
+# User gõ /command → Load workflow file trực tiếp
+/plan        → global_workflows/plan.md
+/planExpert  → global_workflows/planExpert.md
+/code        → global_workflows/code.md
+/codeExpert  → global_workflows/codeExpert.md
+/debug       → global_workflows/debug.md
+/debugExpert → global_workflows/debugExpert.md
+/codebase-sync → global_workflows/codebase-sync.md  # MỚI
+# ...etc (see GEMINI.md)
+```
+
+### Fallback
+
+```
+No intent match → Ask clarifying question (max 2 lần)
+Still unclear   → Suggest /help
+```
+
+---
+
+## Integration
+
+```yaml
+runs_before: awf-session-restore, memory-sync, all workflows
+provides_to: [project_context, resolved_target, intent]
+receives_from: user_request, active_document
+
+# Khi có CODEBASE.md → memory-sync R2 chỉ cần query với resolved_target
+# thay vì query toàn bộ brain/
+```
+
+---
+
+*orchestrator v2.0 — Project-Aware Dispatcher*
+*Created by Kien AI*

package/skills/session-restore/SKILL.md

@@ -0,0 +1,240 @@
+---
+name: awf-session-restore
+description: Auto-restore context from Beads + Brain on session start
+trigger: session_start
+---
+
+# AWF Session Restore (v5.0 - Beads + Brain)
+
+> **Purpose:** Tự động khôi phục context khi user quay lại sau khi nghỉ.
+
+---
+
+## Trigger
+
+Skill này tự động chạy khi:
+- User mở session mới
+- User gõ `/recap`
+- AI detect context loss (conversation reset)
+
+---
+
+## Execution Flow
+
+### 1. Multi-Source Context Check
+
+**Priority 1: Beads (Task State)**
+```bash
+bd list --status in_progress
+```
+
+**Output:**
+- Tasks đang làm dở
+- Tasks blocked
+- Tasks ready to start
+
+**Priority 2: Brain (Knowledge & Plans)**
+```bash
+# Check active plans
+cat brain/active_plans.json
+
+# Check recent memories
+ls -lt brain/ | head -5
+```
+
+**Output:**
+- Plan đang active
+- Phase hiện tại
+- Recent decisions/knowledge
+
+**Priority 3: Git (Code State)**
+```bash
+git status
+git log -1
+```
+
+**Output:**
+- Files đang thay đổi
+- Commit gần nhất
+
+---
+
+### 2. Context Synthesis
+
+Kết hợp 3 nguồn để tạo summary:
+
+```markdown
+🧠 **SESSION RESTORED**
+
+📿 **Beads Context:**
+- In Progress: Task #123 "Implement Login API" (started 2h ago)
+- Blocked: Task #125 (waiting for #120)
+- Ready: 3 tasks
+
+🧠 **Brain Context:**
+- Active Plan: plans/260130-1025-shopping-cart/
+- Current Phase: Phase 02 - Backend (50% complete)
+- Last Save: 30 minutes ago
+
+📂 **Git Context:**
+- Changed Files: 3 files (src/api/auth/*.ts)
+- Last Commit: "feat: add user model" (1 hour ago)
+
+➡️ **SUGGESTED NEXT STEP:**
+Continue task #123? `/codeExpert` or `/code`
+```
+
+---
+
+### 3. Smart Suggestions
+
+Based on context, suggest appropriate action:
+
+**Case 1: Task In-Progress**
+```
+➡️ Tiếp tục task #123? 
+   `/codeExpert` (Fast) or `/code` (Guided)
+```
+
+**Case 2: Task Blocked**
+```
+⚠️ Task #125 bị block bởi #120
+
+➡️ Làm task #120 trước?
+   `/codeExpert` or switch to another task
+```
+
+**Case 3: No Active Task**
+```
+📋 Có 3 tasks ready to start
+
+➡️ Bắt đầu task mới?
+   `/next` để xem gợi ý
+```
+
+**Case 4: Fresh Start**
+```
+🆕 Chưa có context
+
+➡️ Bắt đầu dự án mới?
+   `/planExpert "Feature"` or `/brainstorm`
+```
+
+---
+
+### 4. Memory Persistence
+
+Update session state:
+
+```json
+// brain/session.json
+{
+  "last_session": "2026-01-30T10:00:00Z",
+  "working_on": {
+    "feature": "Shopping Cart",
+    "plan_path": "plans/260130-1025-shopping-cart/",
+    "current_phase": "phase-02",
+    "current_task": {
+      "id": 123,
+      "name": "Implement Login API",
+      "status": "in_progress"
+    }
+  },
+  "context_sources": {
+    "beads": true,
+    "brain": true,
+    "git": true
+  }
+}
+```
+
+---
+
+## Error Handling
+
+### Beads Unavailable
+```
+⚠️ Beads không khả dụng
+
+Fallback: Dùng Brain + Git context
+```
+
+### Brain Empty
+```
+⚠️ Brain chưa có context
+
+Gợi ý: `/plan` để tạo context mới
+```
+
+### All Sources Fail
+```
+❌ Không thể khôi phục context
+
+➡️ Bắt đầu lại:
+1. `/recap` để quét dự án
+2. `/plan` để tạo plan mới
+3. Kể cho em biết đang làm gì
+```
+
+---
+
+## Integration with Workflows
+
+### Auto-Trigger in Workflows
+
+Các workflows tự động gọi session restore:
+
+```markdown
+# In /code workflow
+1. Check session.json
+2. If no context → Trigger awf-session-restore
+3. Resume from restored context
+```
+
+### Manual Trigger
+
+User có thể gọi thủ công:
+
+```bash
+/recap    # Alias for session restore
+```
+
+---
+
+## Performance
+
+- **Execution Time:** < 1 second
+- **Sources Checked:** 3 (Beads, Brain, Git)
+- **Output:** Concise summary (< 10 lines)
+
+---
+
+## Example Output
+
+```
+🧠 **WELCOME BACK!**
+
+📿 **Beads:** Task #123 "Login API" (in_progress, 2h ago)
+🧠 **Brain:** Plan "Shopping Cart" - Phase 02 (50%)
+📂 **Git:** 3 files changed
+
+➡️ **NEXT:** Continue coding? `/codeExpert`
+
+💡 **TIP:** Gõ `/next` để xem chi tiết hơn
+```
+
+---
+
+## Configuration
+
+User có thể customize trong `brain/preferences.json`:
+
+```json
+{
+  "session_restore": {
+    "auto_trigger": true,
+    "verbosity": "concise",  // concise | detailed
+    "sources": ["beads", "brain", "git"]
+  }
+}
+```

package/templates/CODEBASE.md

@@ -0,0 +1,80 @@
+# {{PROJECT_NAME}} — Codebase Map
+
+> **Project Type:** {{PROJECT_TYPE}} | **Stage:** {{PROJECT_STAGE}}
+> **Tech Stack:** {{TECH_STACK_SUMMARY}}
+> **Last Synced:** {{DATE}}
+
+---
+
+## 🗺️ Layer Map
+
+> _AI: Dùng bản đồ này để định vị file trước khi scan directory_
+
+```
+{{DIR_STRUCTURE}}
+```
+
+---
+
+## 📁 Feature Areas
+
+| Area | Location | Description |
+|------|----------|-------------|
+| _(example)_ Features | `{{FEATURES_DIR}}` | Main feature modules |
+| _(example)_ Shared UI | `{{SHARED_UI_DIR}}` | Reusable UI components |
+| _(example)_ Services | `{{SERVICES_DIR}}` | Business logic & data layer |
+| _(example)_ Models | `{{MODELS_DIR}}` | Data models & DTOs |
+
+> ⚠️ Update this table after adding new feature areas.
+
+---
+
+## 🔥 Firebase Integration
+
+| Feature | Status | Notes |
+|---------|--------|-------|
+| Analytics | ✅ | Event tracking |
+| Crashlytics | ✅ | Crash reporting |
+| Remote Config | ✅ | Feature flags |
+| Auth | ✅ | Sign in methods |
+| Firestore | ⬜ | — |
+| Storage | ⬜ | — |
+
+---
+
+## 🏗️ Architecture
+
+- **Pattern:** {{ARCHITECTURE}}
+- **State Management:** {{STATE_MANAGEMENT}}
+- **Networking:** {{NETWORKING}}
+- **Storage:** {{STORAGE}}
+
+---
+
+## 📏 Naming Conventions
+
+- **Files:** `PascalCase` (Swift/Kotlin) or `kebab-case` (JS/TS)
+- **Functions/Methods:** `camelCase`
+- **Constants:** `UPPER_SNAKE_CASE`
+- **Variables:** `camelCase`
+
+---
+
+## 🔑 Key Files
+
+| File | Purpose |
+|------|---------|
+| `.project-identity` | AI project context |
+| `CODEBASE.md` | This file — codebase map for AI |
+
+> Add important files here as the project grows.
+
+---
+
+## 📝 Notes
+
+_Add architecture decisions, gotchas, and important context here._
+
+---
+
+*Auto-generated by `awkit init` — keep this file updated with `/codebase-sync`*