flutter-pro-max-cli 1.0.0 → 1.0.1

package/assets/.agent/workflows/flutter-pro-max.md

@@ -1,23 +1,25 @@
 ---
-description: Flutter Pro Max - Chuyên gia Flutter với Clean Architecture và Performance
+name: flutter-pro-max
+description: Chuyên gia Flutter với kiến thức sâu về Clean Architecture, Performance và Modern Dart 3
 ---
 
-# flutter-pro-max
+# Flutter Pro Max - Flutter Design Intelligence
 
-Searchable database của Flutter widgets, packages, design patterns, architecture guidelines, colors, typography, và best practices.
+Searchable database của Flutter widgets, packages, design patterns, architecture guidelines, và best practices.
 
 ## Prerequisites
 
+Chỉ cần Python (không cần pip install):
+
 ```bash
-python3 --version
-pip install rank-bm25
+python3 --version || python --version
 ```
 
 ---
 
-## How to Use This Workflow
+## How to Use This Skill
 
-Khi user yêu cầu Flutter work, follow workflow này:
+Khi user yêu cầu Flutter work (design, build, create, implement, review, fix, improve), follow workflow này:
 
 ### Step 1: Analyze User Requirements
 
@@ -25,44 +27,35 @@ Trích xuất thông tin từ request:
 - **Architecture**: Clean Architecture, Feature-First, DDD
 - **State Management**: Riverpod (default), Bloc, Provider
 - **UI Components**: Widgets, Layouts, Animations
-- **Design**: Colors, Typography, Styles
 - **Package needs**: Networking, Database, Security, etc.
 
-### Step 2: Search Relevant Data (14 Sources)
+### Step 2: Search Relevant Data
+
+Sử dụng `search.py` để tìm kiếm (auto-detect domain):
 
 ```bash
 python3 .agent/workflows/scripts/search.py "<keyword>" --top 5
-python3 .agent/workflows/scripts/search.py "<keyword>" --stack riverpod --top 5
 ```
 
-**Available stacks:** `riverpod`, `bloc`, `provider`
-
-**Search Examples by Domain:**
+**Với domain cụ thể:**
 ```bash
-# Flutter Widgets
-python3 .agent/workflows/scripts/search.py "ListView pagination" --top 5
-
-# Design Patterns
-python3 .agent/workflows/scripts/search.py "authentication login" --top 5
-
-# Charts
-python3 .agent/workflows/scripts/search.py "chart bar comparison" --top 5
-
-# Typography
-python3 .agent/workflows/scripts/search.py "font modern SaaS" --top 5
+python3 .agent/workflows/scripts/search.py "<keyword>" --domain widget --top 5
+python3 .agent/workflows/scripts/search.py "<keyword>" --domain package --top 5
+```
 
-# Colors by Product
-python3 .agent/workflows/scripts/search.py "fintech crypto dark" --top 5
+**Với stack filter (loại bỏ conflicts):**
+```bash
+python3 .agent/workflows/scripts/search.py "<keyword>" --stack riverpod --top 5
+```
 
-# UX Guidelines
-python3 .agent/workflows/scripts/search.py "touch target accessibility" --top 5
+**Available domains:** `widget`, `package`, `pattern`, `architect`, `chart`, `color`, `typography`, `style`, `ux`, `icon`, `landing`, `naming`, `product`, `prompt`
 
-# UI Styles
-python3 .agent/workflows/scripts/search.py "glassmorphism neumorphism" --top 5
-```
+**Available stacks:** `riverpod`, `bloc`, `provider`
 
 ### Step 3: Apply Technical Standards
 
+Luôn tuân thủ các tiêu chuẩn:
+
 #### Dart 3 Modern Syntax
 ```dart
 // ✅ Records
@@ -89,24 +82,40 @@ String getMessage(UIState state) => switch (state) {
 
 ## Search Reference
 
-### Available Data Sources (14 files)
+### Available Data
 
-| Type | File | Content |
-|------|------|---------|
-| Widget | `widget.csv` | 65+ Flutter widgets với pro-tips |
-| Package | `package.csv` | 100+ packages với best practices |
-| Pattern | `patterns.csv` | 100+ design patterns với code snippets |
+| Domain | File | Content |
+|--------|------|---------|
+| Widgets | `widget.csv` | 65+ Flutter widgets với pro-tips |
+| Packages | `package.csv` | 100+ packages với best practices |
+| Patterns | `patterns.csv` | 100+ design patterns với code snippets |
 | Architecture | `architect.csv` | Clean Architecture layer paths |
-| Chart | `charts.csv` | Chart type recommendations by data |
-| Color | `colors.csv` | Color palettes by product type |
-| Typography | `typography.csv` | Font pairings với Google Fonts |
-| Style | `styles.csv` | UI style guidelines (Glass, Neubrutalism...) |
-| UX Guideline | `ux-guidelines.csv` | UX best practices (Do/Don't) |
-| Icon | `icons.csv` | Icon recommendations |
-| Landing | `landing.csv` | Landing page section patterns |
-| Naming | `name_convention.csv` | Dart/Flutter naming conventions |
-| Product | `products.csv` | Product type styling recommendations |
-| Prompt | `prompts.csv` | AI prompt templates |
+| Charts | `charts.csv` | Chart type recommendations |
+| Colors | `colors.csv` | Color palettes by product type |
+| Typography | `typography.csv` | Font pairings |
+| Styles | `styles.csv` | UI style guidelines |
+| UX Guidelines | `ux-guidelines.csv` | UX best practices |
+| Icons | `icons.csv` | Icon recommendations |
+| Landing | `landing.csv` | Landing page patterns |
+| Naming | `name_convention.csv` | Naming conventions |
+| Products | `products.csv` | Product type styling |
+| Prompts | `prompts.csv` | AI prompt templates |
+
+### Search Examples
+
+```bash
+# Auto-detect domain
+python3 .agent/workflows/scripts/search.py "ListView" --top 5
+
+# Specific domain
+python3 .agent/workflows/scripts/search.py "network http" --domain package --top 5
+
+# Stack filter
+python3 .agent/workflows/scripts/search.py "state" --stack riverpod --top 5
+
+# JSON output
+python3 .agent/workflows/scripts/search.py "login" --json --top 3
+```
 
 ---
 
@@ -116,25 +125,20 @@ String getMessage(UIState state) => switch (state) {
 
 1. **Search widgets:**
    ```bash
-   python3 .agent/workflows/scripts/search.py "form input text field" --top 5
+   python3 .agent/workflows/scripts/search.py "form input" --domain widget --top 5
    ```
 
 2. **Search patterns:**
    ```bash
-   python3 .agent/workflows/scripts/search.py "authentication login" --top 5
+   python3 .agent/workflows/scripts/search.py "authentication login" --domain pattern --top 5
    ```
 
 3. **Search packages:**
    ```bash
-   python3 .agent/workflows/scripts/search.py "validation form" --stack riverpod --top 5
-   ```
-
-4. **Search colors:**
-   ```bash
-   python3 .agent/workflows/scripts/search.py "saas professional" --top 3
+   python3 .agent/workflows/scripts/search.py "validation" --domain package --stack riverpod --top 5
    ```
 
-5. **Apply results** to generate code với Riverpod state management
+4. **Apply results** to generate code với Riverpod state management
 
 ---
 
@@ -159,9 +163,3 @@ String getMessage(UIState state) => switch (state) {
 - [ ] Riverpod providers được tổ chức hợp lý
 - [ ] Không leak state giữa các features
 - [ ] Error handling với AsyncValue
-
-### UX/UI
-- [ ] Touch targets tối thiểu 44x44px
-- [ ] Colors đúng với product type
-- [ ] Typography phù hợp với brand
-- [ ] WCAG contrast requirements

package/assets/.agent/workflows/scripts/core.py

@@ -20,6 +20,10 @@ def _get_data_dir():
         script_dir.parent / ".shared" / "data",
         # When running from .shared/flutter-pro-max/scripts/
         script_dir.parent.parent / "data",
+        # When running from .agent/workflows/scripts/ (nested 3 levels deep)
+        script_dir.parent.parent.parent / ".shared" / "data",
+        # When running from .claude/skills/flutter-pro-max/scripts/ (nested 4 levels deep)
+        script_dir.parent.parent.parent.parent / ".shared" / "data",
         # Fallback: cwd
         Path.cwd() / ".shared" / "data",
     ]

package/assets/.claude/skills/flutter-pro-max/SKILL.md

@@ -9,18 +9,12 @@ Searchable database của Flutter widgets, packages, design patterns, architectu
 
 ## Prerequisites
 
-Kiểm tra Python đã cài đặt:
+Chỉ cần Python (không cần pip install):
 
 ```bash
 python3 --version || python --version
 ```
 
-Cài đặt dependency:
-
-```bash
-pip install rank-bm25
-```
-
 ---
 
 ## How to Use This Skill
@@ -33,47 +27,30 @@ Trích xuất thông tin từ request:
 - **Architecture**: Clean Architecture, Feature-First, DDD
 - **State Management**: Riverpod (default), Bloc, Provider
 - **UI Components**: Widgets, Layouts, Animations
-- **Design**: Colors, Typography, Styles
 - **Package needs**: Networking, Database, Security, etc.
 
 ### Step 2: Search Relevant Data
 
-Sử dụng `search.py` để tìm kiếm trong **14 data sources**:
+Sử dụng `search.py` để tìm kiếm (auto-detect domain):
 
 ```bash
 python3 .claude/skills/flutter-pro-max/scripts/search.py "<keyword>" --top 5
 ```
 
-**Với stack filter (loại bỏ conflicts):**
+**Với domain cụ thể:**
 ```bash
-python3 .claude/skills/flutter-pro-max/scripts/search.py "<keyword>" --stack riverpod --top 5
+python3 .claude/skills/flutter-pro-max/scripts/search.py "<keyword>" --domain widget --top 5
+python3 .claude/skills/flutter-pro-max/scripts/search.py "<keyword>" --domain package --top 5
 ```
 
-**Available stacks:** `riverpod`, `bloc`, `provider`
-
-**Search Examples by Domain:**
+**Với stack filter (loại bỏ conflicts):**
 ```bash
-# Flutter Widgets
-python3 scripts/search.py "ListView pagination" --top 5
-
-# Design Patterns
-python3 scripts/search.py "authentication login" --top 5
-
-# Charts
-python3 scripts/search.py "chart bar comparison" --top 5
-
-# Typography
-python3 scripts/search.py "font modern SaaS" --top 5
-
-# Colors by Product
-python3 scripts/search.py "fintech crypto dark" --top 5
+python3 .claude/skills/flutter-pro-max/scripts/search.py "<keyword>" --stack riverpod --top 5
+```
 
-# UX Guidelines
-python3 scripts/search.py "touch target accessibility" --top 5
+**Available domains:** `widget`, `package`, `pattern`, `architect`, `chart`, `color`, `typography`, `style`, `ux`, `icon`, `landing`, `naming`, `product`, `prompt`
 
-# UI Styles
-python3 scripts/search.py "glassmorphism neumorphism" --top 5
-```
+**Available stacks:** `riverpod`, `bloc`, `provider`
 
 ### Step 3: Apply Technical Standards
 
@@ -105,24 +82,40 @@ String getMessage(UIState state) => switch (state) {
 
 ## Search Reference
 
-### Available Data Sources (14 files)
+### Available Data
 
-| Type | File | Content |
-|------|------|---------|
-| Widget | `widget.csv` | 65+ Flutter widgets với pro-tips |
-| Package | `package.csv` | 100+ packages với best practices |
-| Pattern | `patterns.csv` | 100+ design patterns với code snippets |
+| Domain | File | Content |
+|--------|------|---------|
+| Widgets | `widget.csv` | 65+ Flutter widgets với pro-tips |
+| Packages | `package.csv` | 100+ packages với best practices |
+| Patterns | `patterns.csv` | 100+ design patterns với code snippets |
 | Architecture | `architect.csv` | Clean Architecture layer paths |
-| Chart | `charts.csv` | Chart type recommendations by data |
-| Color | `colors.csv` | Color palettes by product type |
-| Typography | `typography.csv` | Font pairings với Google Fonts |
-| Style | `styles.csv` | UI style guidelines (Glass, Neubrutalism...) |
-| UX Guideline | `ux-guidelines.csv` | UX best practices (Do/Don't) |
-| Icon | `icons.csv` | Icon recommendations |
-| Landing | `landing.csv` | Landing page section patterns |
-| Naming | `name_convention.csv` | Dart/Flutter naming conventions |
-| Product | `products.csv` | Product type styling recommendations |
-| Prompt | `prompts.csv` | AI prompt templates |
+| Charts | `charts.csv` | Chart type recommendations |
+| Colors | `colors.csv` | Color palettes by product type |
+| Typography | `typography.csv` | Font pairings |
+| Styles | `styles.csv` | UI style guidelines |
+| UX Guidelines | `ux-guidelines.csv` | UX best practices |
+| Icons | `icons.csv` | Icon recommendations |
+| Landing | `landing.csv` | Landing page patterns |
+| Naming | `name_convention.csv` | Naming conventions |
+| Products | `products.csv` | Product type styling |
+| Prompts | `prompts.csv` | AI prompt templates |
+
+### Search Examples
+
+```bash
+# Auto-detect domain
+python3 .claude/skills/flutter-pro-max/scripts/search.py "ListView" --top 5
+
+# Specific domain
+python3 .claude/skills/flutter-pro-max/scripts/search.py "network http" --domain package --top 5
+
+# Stack filter
+python3 .claude/skills/flutter-pro-max/scripts/search.py "state" --stack riverpod --top 5
+
+# JSON output
+python3 .claude/skills/flutter-pro-max/scripts/search.py "login" --json --top 3
+```
 
 ---
 
@@ -132,25 +125,20 @@ String getMessage(UIState state) => switch (state) {
 
 1. **Search widgets:**
    ```bash
-   python3 scripts/search.py "form input text field" --top 5
+   python3 .claude/skills/flutter-pro-max/scripts/search.py "form input" --domain widget --top 5
    ```
 
 2. **Search patterns:**
    ```bash
-   python3 scripts/search.py "authentication login" --top 5
+   python3 .claude/skills/flutter-pro-max/scripts/search.py "authentication login" --domain pattern --top 5
    ```
 
 3. **Search packages:**
    ```bash
-   python3 scripts/search.py "validation form" --stack riverpod --top 5
-   ```
-
-4. **Search colors:**
-   ```bash
-   python3 scripts/search.py "saas professional" --top 3
+   python3 .claude/skills/flutter-pro-max/scripts/search.py "validation" --domain package --stack riverpod --top 5
    ```
 
-5. **Apply results** to generate code với Riverpod state management
+4. **Apply results** to generate code với Riverpod state management
 
 ---
 
@@ -175,8 +163,3 @@ String getMessage(UIState state) => switch (state) {
 - [ ] Riverpod providers được tổ chức hợp lý
 - [ ] Không leak state giữa các features
 - [ ] Error handling với AsyncValue
-
-### UX/UI
-- [ ] Touch targets tối thiểu 44x44px
-- [ ] Colors đúng với product type
-- [ ] Typography phù hợp với brand

package/assets/.claude/skills/flutter-pro-max/scripts/core.py

@@ -20,6 +20,10 @@ def _get_data_dir():
         script_dir.parent / ".shared" / "data",
         # When running from .shared/flutter-pro-max/scripts/
         script_dir.parent.parent / "data",
+        # When running from .agent/workflows/scripts/ (nested 3 levels deep)
+        script_dir.parent.parent.parent / ".shared" / "data",
+        # When running from .claude/skills/flutter-pro-max/scripts/ (nested 4 levels deep)
+        script_dir.parent.parent.parent.parent / ".shared" / "data",
         # Fallback: cwd
         Path.cwd() / ".shared" / "data",
     ]

package/assets/.codebuddy/commands/flutter-pro-max.md

@@ -1,58 +1,165 @@
 ---
-description: Flutter Pro Max - Chuyên gia Flutter với Clean Architecture và Performance
+name: flutter-pro-max
+description: Chuyên gia Flutter với kiến thức sâu về Clean Architecture, Performance và Modern Dart 3
 ---
 
-# flutter-pro-max
+# Flutter Pro Max - Flutter Design Intelligence
 
-Searchable database: widgets, packages, patterns, colors, typography (14 files).
+Searchable database của Flutter widgets, packages, design patterns, architecture guidelines, và best practices.
 
 ## Prerequisites
 
+Chỉ cần Python (không cần pip install):
+
 ```bash
-pip install rank-bm25
+python3 --version || python --version
 ```
 
-## Search (14 Sources)
+---
+
+## How to Use This Skill
+
+Khi user yêu cầu Flutter work (design, build, create, implement, review, fix, improve), follow workflow này:
+
+### Step 1: Analyze User Requirements
+
+Trích xuất thông tin từ request:
+- **Architecture**: Clean Architecture, Feature-First, DDD
+- **State Management**: Riverpod (default), Bloc, Provider
+- **UI Components**: Widgets, Layouts, Animations
+- **Package needs**: Networking, Database, Security, etc.
+
+### Step 2: Search Relevant Data
+
+Sử dụng `search.py` để tìm kiếm (auto-detect domain):
 
 ```bash
 python3 .codebuddy/commands/scripts/search.py "<keyword>" --top 5
+```
+
+**Với domain cụ thể:**
+```bash
+python3 .codebuddy/commands/scripts/search.py "<keyword>" --domain widget --top 5
+python3 .codebuddy/commands/scripts/search.py "<keyword>" --domain package --top 5
+```
+
+**Với stack filter (loại bỏ conflicts):**
+```bash
 python3 .codebuddy/commands/scripts/search.py "<keyword>" --stack riverpod --top 5
 ```
 
-**Examples:**
+**Available domains:** `widget`, `package`, `pattern`, `architect`, `chart`, `color`, `typography`, `style`, `ux`, `icon`, `landing`, `naming`, `product`, `prompt`
+
+**Available stacks:** `riverpod`, `bloc`, `provider`
+
+### Step 3: Apply Technical Standards
+
+Luôn tuân thủ các tiêu chuẩn:
+
+#### Dart 3 Modern Syntax
+```dart
+// ✅ Records
+(String name, int age) getUserInfo() => ('John', 25);
+
+// ✅ Pattern Matching
+String getMessage(UIState state) => switch (state) {
+  LoadingState() => 'Loading...',
+  DataState(data: var d) => 'Data: $d',
+  ErrorState(message: var m) => 'Error: $m',
+};
+```
+
+#### Performance Rules
+- Luôn dùng `const` constructor khi có thể
+- Ưu tiên `SizedBox` hơn `Container` cho spacing
+- Dùng `ListView.builder` thay vì `ListView` + `children`
+
+#### State Management
+- **Default**: Riverpod với `riverpod_generator`
+- **Alternative**: Bloc (khi user yêu cầu)
+
+---
+
+## Search Reference
+
+### Available Data
+
+| Domain | File | Content |
+|--------|------|---------|
+| Widgets | `widget.csv` | 65+ Flutter widgets với pro-tips |
+| Packages | `package.csv` | 100+ packages với best practices |
+| Patterns | `patterns.csv` | 100+ design patterns với code snippets |
+| Architecture | `architect.csv` | Clean Architecture layer paths |
+| Charts | `charts.csv` | Chart type recommendations |
+| Colors | `colors.csv` | Color palettes by product type |
+| Typography | `typography.csv` | Font pairings |
+| Styles | `styles.csv` | UI style guidelines |
+| UX Guidelines | `ux-guidelines.csv` | UX best practices |
+| Icons | `icons.csv` | Icon recommendations |
+| Landing | `landing.csv` | Landing page patterns |
+| Naming | `name_convention.csv` | Naming conventions |
+| Products | `products.csv` | Product type styling |
+| Prompts | `prompts.csv` | AI prompt templates |
+
+### Search Examples
+
 ```bash
-# Widgets
+# Auto-detect domain
 python3 .codebuddy/commands/scripts/search.py "ListView" --top 5
 
-# Charts
-python3 .codebuddy/commands/scripts/search.py "chart bar" --top 5
+# Specific domain
+python3 .codebuddy/commands/scripts/search.py "network http" --domain package --top 5
 
-# Typography
-python3 .codebuddy/commands/scripts/search.py "font modern" --top 5
+# Stack filter
+python3 .codebuddy/commands/scripts/search.py "state" --stack riverpod --top 5
 
-# UX
-python3 .codebuddy/commands/scripts/search.py "touch accessibility" --top 5
+# JSON output
+python3 .codebuddy/commands/scripts/search.py "login" --json --top 3
 ```
 
-## Data Sources (14 files)
-
-| Type | File |
-|------|------|
-| Widget | `widget.csv` |
-| Package | `package.csv` |
-| Pattern | `patterns.csv` |
-| Architecture | `architect.csv` |
-| Chart | `charts.csv` |
-| Color | `colors.csv` |
-| Typography | `typography.csv` |
-| Style | `styles.csv` |
-| UX Guideline | `ux-guidelines.csv` |
-| Icon | `icons.csv` |
-| Landing | `landing.csv` |
-| Naming | `name_convention.csv` |
-| Product | `products.csv` |
-| Prompt | `prompts.csv` |
-
-## Standards
-- Dart 3, Performance, Riverpod (default)
-- UX: Touch targets 44x44px
+---
+
+## Example Workflow
+
+**User Request:** "Tạo màn hình đăng nhập với Riverpod"
+
+1. **Search widgets:**
+   ```bash
+   python3 .codebuddy/commands/scripts/search.py "form input" --domain widget --top 5
+   ```
+
+2. **Search patterns:**
+   ```bash
+   python3 .codebuddy/commands/scripts/search.py "authentication login" --domain pattern --top 5
+   ```
+
+3. **Search packages:**
+   ```bash
+   python3 .codebuddy/commands/scripts/search.py "validation" --domain package --stack riverpod --top 5
+   ```
+
+4. **Apply results** to generate code với Riverpod state management
+
+---
+
+## Pre-Delivery Checklist
+
+### Code Quality
+- [ ] Sử dụng `const` constructors
+- [ ] Sound Null Safety (không dùng `!` bừa bãi)
+- [ ] Dart 3 syntax (Records, Pattern Matching)
+
+### Performance
+- [ ] `ListView.builder` cho lists dài
+- [ ] `SizedBox` thay vì `Container` cho spacing
+- [ ] `const` widgets được đánh dấu
+
+### Architecture
+- [ ] Tuân thủ Clean Architecture layers
+- [ ] Dependency Injection đúng cách
+- [ ] Repository pattern cho data access
+
+### State Management
+- [ ] Riverpod providers được tổ chức hợp lý
+- [ ] Không leak state giữa các features
+- [ ] Error handling với AsyncValue

package/assets/.codebuddy/commands/scripts/core.py

@@ -20,6 +20,10 @@ def _get_data_dir():
         script_dir.parent / ".shared" / "data",
         # When running from .shared/flutter-pro-max/scripts/
         script_dir.parent.parent / "data",
+        # When running from .agent/workflows/scripts/ (nested 3 levels deep)
+        script_dir.parent.parent.parent / ".shared" / "data",
+        # When running from .claude/skills/flutter-pro-max/scripts/ (nested 4 levels deep)
+        script_dir.parent.parent.parent.parent / ".shared" / "data",
         # Fallback: cwd
         Path.cwd() / ".shared" / "data",
     ]