codymaster 4.6.0 → 5.2.0

package/skills/cm-frappe-agent/docs/commands-catalog.md

@@ -1,82 +0,0 @@
----
-title: "Danh mục CLI Commands"
-description: "Catalogue 15 CLI Commands của Frappe Dev Master — cú pháp, arguments, và agent delegation."
-keywords: "frappe cli, commands, frappe-app, frappe-backend, frappe-bench, frappe-fix"
-robots: "index, follow"
----
-
-# Danh mục CLI Commands
-
-> **15 Commands** giao tiếp nhanh với hệ thống. Mỗi command map tới một agent chuyên biệt.
-
----
-
-## Nhóm: Development
-
-| Command | File | Mô tả | Agent |
-|---------|------|-------|-------|
-| `frappe-app` | `commands/frappe-app.md` | Scaffold app mới, quản lý modules | Backend |
-| `frappe-backend` | `commands/frappe-backend.md` | Viết Python logic, API, engine | Backend |
-| `frappe-frontend` | `commands/frappe-frontend.md` | Viết Client Script, dialogs | Frontend |
-| `frappe-fullstack` | `commands/frappe-fullstack.md` | Feature toàn stack (backend + frontend) | Backend + Frontend |
-| `frappe-doctype-create` | `commands/frappe-doctype-create.md` | Thiết kế DocType mới | DocType Architect |
-| `frappe-doctype-field` | `commands/frappe-doctype-field.md` | Thêm/sửa fields cho DocType | DocType Architect |
-| `frappe-erpnext` | `commands/frappe-erpnext.md` | Customize ERPNext modules | ERPNext Customizer |
-
-## Nhóm: Operations
-
-| Command | File | Mô tả | Agent |
-|---------|------|-------|-------|
-| `frappe-install` | `commands/frappe-install.md` | Cài đặt bench, site, production | Installer |
-| `frappe-bench` | `commands/frappe-bench.md` | Bench commands (migrate, build, clear-cache) | — |
-| `frappe-test` | `commands/frappe-test.md` | Chạy test suite | — |
-| `frappe-debug` | `commands/frappe-debug.md` | Phân tích lỗi (read-only) | Debugger |
-| `frappe-fix` | `commands/frappe-fix.md` | Sửa lỗi theo Fix Loop 6 bước | Fixer |
-| `frappe-remote` | `commands/frappe-remote.md` | REST API operations trên remote sites | Remote Ops |
-| `frappe-plan` | `commands/frappe-plan.md` | Lên kế hoạch feature | Planner |
-| `frappe-github` | `commands/frappe-github.md` | Git/GitHub operations | GitHub Workflow |
-
----
-
-## Cú pháp Chung
-
-```
-frappe <command> <arguments> [--options]
-```
-
-### Ví dụ Sử dụng
-
-```bash
-# Tạo DocType mới
-frappe doctype-create "Employee Score" --module "My App"
-
-# Sửa lỗi
-frappe fix "Sales Invoice validate fails with MandatoryError"
-
-# REST API trên remote site
-frappe remote list "Sales Invoice" --site https://mysite.com --filters '{"status":"Paid"}'
-
-# Cài đặt fresh bench
-frappe install bench --python python3.11
-
-# Chạy tests
-frappe test --app my_app --failfast
-```
-
----
-
-## Command → Agent Flow
-
-```mermaid
-flowchart LR
-    CMD["CLI Command"] --> Parse["Parse Arguments"]
-    Parse --> Agent["Delegate to Agent"]
-    Agent --> Skill["Reference Sub-Skill"]
-    Skill --> Resource["Consult Resource"]
-    Resource --> Execute["Execute"]
-```
-
-*Text fallback:* CLI Command → Parse Arguments → Delegate to chuyên Agent → Agent tham chiếu Sub-Skill cú pháp → Consult Resources → Execute.
-
----
-[← Danh mục Agents](agents-catalog.md) · [Tài liệu Tham khảo →](resources-catalog.md)

package/skills/cm-frappe-agent/docs/resources-catalog.md

@@ -1,66 +0,0 @@
----
-title: "Tài liệu Tham khảo — Resources & Sub-Skills"
-description: "Catalogue Resources (8 files) và Sub-Skills (7 skills) của Frappe Dev Master — cú pháp chi tiết và patterns."
-keywords: "frappe resources, 7-layer, bench commands, rest api, doctype patterns, server scripts"
-robots: "index, follow"
----
-
-# Tài liệu Tham khảo
-
-> Resources là "sách giáo khoa" — quy tắc chung và patterns. Sub-Skills là "cheat sheet" — cú pháp chi tiết cho từng lĩnh vực kỹ thuật.
-
----
-
-## 1. Resources (8 files)
-
-| Resource | File | Nội dung |
-|----------|------|----------|
-| **7-Layer Architecture** | `resources/7-layer-architecture.md` | Code examples chi tiết cho mỗi lớp kiến trúc |
-| **Bench Commands** | `resources/bench_commands.md` | Tham chiếu nhanh bench CLI (migrate, build, clear-cache, backup) |
-| **Common Pitfalls** | `resources/common_pitfalls.md` | Lỗi thường gặp và cách phòng tránh |
-| **Scaffold Checklist** | `resources/scaffold_checklist.md` | Checklist tạo app Frappe mới từ đầu |
-| **Upgrade Patterns** | `resources/upgrade_patterns.md` | Patterns nâng cấp Frappe version an toàn |
-| **REST API Patterns** | `resources/rest-api-patterns.md` | Curl patterns cho REST API operations |
-| **DocType Registry** | `resources/doctype-registry.md` | DocType discovery và exploration workflows |
-| **Installation Guide** | `resources/installation-guide.md` | Hướng dẫn cài đặt đầy đủ mọi platform |
-| **Web Form Patterns** | `resources/web-form-patterns.md` | Web Form client scripting patterns |
-
-### Resources Được Sử Dụng Bởi
-
-| Resource | Agents dùng |
-|----------|-------------|
-| 7-layer-architecture | Tất cả Build agents |
-| bench_commands | Installer, Backend, Fixer |
-| rest-api-patterns | Remote Ops |
-| common_pitfalls | Fixer, Debugger |
-| installation-guide | Installer |
-
----
-
-## 2. Sub-Skills (7 skills)
-
-Mỗi Sub-Skill là một SKILL.md nhỏ chứa cú pháp chi tiết cho lĩnh vực kỹ thuật cụ thể.
-
-| Skill | Thư mục | Nội dung |
-|-------|---------|----------|
-| **DocType Patterns** | `skills/doctype-patterns/` | Best practices cho custom fields, naming rules, child tables |
-| **Server Scripts** | `skills/server-scripts/` | Server-side Python patterns, hooks, scheduled jobs |
-| **Client Scripts** | `skills/client-scripts/` | JavaScript form/list configurations, event handlers |
-| **Frappe API** | `skills/frappe-api/` | Frappe ORM và Python API — `frappe.get_doc`, `frappe.db.get_list` |
-| **Bench Commands** | `skills/bench-commands/` | Bench CLI reference chi tiết |
-| **Remote Operations** | `skills/remote-operations/` | REST API patterns cho remote sites |
-| **Web Forms** | `skills/web-forms/` | Web Form development patterns, client scripting |
-
-### Workflow Tham Chiếu
-
-```
-Agent nhận task → Đọc SKILL.md → Chọn Sub-Skill cú pháp → Consult Resource → Viết code
-```
-
-Ví dụ: Agent "Frappe Backend" nhận yêu cầu viết API mới:
-1. Đọc `skills/frappe-api/SKILL.md` cho cú pháp ORM
-2. Tham khảo `resources/7-layer-architecture.md` cho layer placement
-3. Kiểm tra `resources/common_pitfalls.md` cho anti-patterns
-
----
-[← Danh mục Commands](commands-catalog.md) · [Hướng dẫn SOP →](sop/user-guide.md)

package/skills/cm-frappe-agent/docs/sitemap-urls.txt

@@ -1,52 +0,0 @@
-docs/README.md
-docs/architecture.md
-docs/agents-catalog.md
-docs/commands-catalog.md
-docs/resources-catalog.md
-docs/sop/user-guide.md
-docs/sop/vibe-coding-guide.md
-docs/sitemap.md
-agents/doctype-architect.md
-agents/frappe-backend.md
-agents/frappe-frontend.md
-agents/frappe-custom-frontend.md
-agents/erpnext-customizer.md
-agents/frappe-installer.md
-agents/frappe-planner.md
-agents/frappe-debugger.md
-agents/frappe-fixer.md
-agents/frappe-performance.md
-agents/frappe-remote-ops.md
-agents/github-workflow.md
-commands/frappe-app.md
-commands/frappe-backend.md
-commands/frappe-bench.md
-commands/frappe-debug.md
-commands/frappe-doctype-create.md
-commands/frappe-doctype-field.md
-commands/frappe-erpnext.md
-commands/frappe-fix.md
-commands/frappe-frontend.md
-commands/frappe-fullstack.md
-commands/frappe-github.md
-commands/frappe-install.md
-commands/frappe-plan.md
-commands/frappe-remote.md
-commands/frappe-test.md
-resources/7-layer-architecture.md
-resources/bench_commands.md
-resources/common_pitfalls.md
-resources/scaffold_checklist.md
-resources/upgrade_patterns.md
-resources/rest-api-patterns.md
-resources/doctype-registry.md
-resources/installation-guide.md
-resources/web-form-patterns.md
-skills/doctype-patterns/SKILL.md
-skills/server-scripts/SKILL.md
-skills/client-scripts/SKILL.md
-skills/frappe-api/SKILL.md
-skills/bench-commands/SKILL.md
-skills/remote-operations/SKILL.md
-skills/web-forms/SKILL.md
-SKILL.md

package/skills/cm-frappe-agent/docs/sitemap.md

@@ -1,81 +0,0 @@
----
-title: "Sitemap — Bản đồ Tài liệu cho AI/LLM"
-description: "Chỉ mục toàn bộ tài liệu Frappe Dev Master — dành cho NotebookLM, Semantic Search, và LLM indexing."
-keywords: "sitemap, llm, notebooklm, semantic search, index"
-robots: "index, follow"
----
-
-# Sitemap — Bản đồ Tài liệu
-
-> Dành cho AI/LLM indexing (NotebookLM, qmd, Semantic Search). Mỗi link dẫn tới một tài liệu riêng biệt.
-
-## Tài liệu Chính
-
-- [Trang Chủ / Tổng quan](README.md)
-- [Kiến trúc Hệ thống](architecture.md)
-- [Danh mục AI Agents](agents-catalog.md)
-- [Danh mục CLI Commands](commands-catalog.md)
-- [Tài liệu Tham khảo](resources-catalog.md)
-
-## Hướng dẫn (SOP)
-
-- [Hướng dẫn Sử dụng Tiêu chuẩn](sop/user-guide.md)
-- [Hướng dẫn Vibe Coding](sop/vibe-coding-guide.md)
-
-## Agents (12 files)
-
-- [DocType Architect](../agents/doctype-architect.md)
-- [Frappe Backend](../agents/frappe-backend.md)
-- [Frappe Frontend](../agents/frappe-frontend.md)
-- [Custom Frontend](../agents/frappe-custom-frontend.md)
-- [ERPNext Customizer](../agents/erpnext-customizer.md)
-- [Frappe Installer](../agents/frappe-installer.md)
-- [Frappe Planner](../agents/frappe-planner.md)
-- [Frappe Debugger](../agents/frappe-debugger.md)
-- [Frappe Fixer](../agents/frappe-fixer.md)
-- [Frappe Performance](../agents/frappe-performance.md)
-- [Frappe Remote Ops](../agents/frappe-remote-ops.md)
-- [GitHub Workflow](../agents/github-workflow.md)
-
-## Commands (15 files)
-
-- [frappe-app](../commands/frappe-app.md)
-- [frappe-backend](../commands/frappe-backend.md)
-- [frappe-bench](../commands/frappe-bench.md)
-- [frappe-debug](../commands/frappe-debug.md)
-- [frappe-doctype-create](../commands/frappe-doctype-create.md)
-- [frappe-doctype-field](../commands/frappe-doctype-field.md)
-- [frappe-erpnext](../commands/frappe-erpnext.md)
-- [frappe-fix](../commands/frappe-fix.md)
-- [frappe-frontend](../commands/frappe-frontend.md)
-- [frappe-fullstack](../commands/frappe-fullstack.md)
-- [frappe-github](../commands/frappe-github.md)
-- [frappe-install](../commands/frappe-install.md)
-- [frappe-plan](../commands/frappe-plan.md)
-- [frappe-remote](../commands/frappe-remote.md)
-- [frappe-test](../commands/frappe-test.md)
-
-## Resources (8+ files)
-
-- [7-Layer Architecture](../resources/7-layer-architecture.md)
-- [Bench Commands](../resources/bench_commands.md)
-- [Common Pitfalls](../resources/common_pitfalls.md)
-- [Scaffold Checklist](../resources/scaffold_checklist.md)
-- [Upgrade Patterns](../resources/upgrade_patterns.md)
-- [REST API Patterns](../resources/rest-api-patterns.md)
-- [DocType Registry](../resources/doctype-registry.md)
-- [Installation Guide](../resources/installation-guide.md)
-- [Web Form Patterns](../resources/web-form-patterns.md)
-
-## Sub-Skills (7 files)
-
-- [DocType Patterns](../skills/doctype-patterns/SKILL.md)
-- [Server Scripts](../skills/server-scripts/SKILL.md)
-- [Client Scripts](../skills/client-scripts/SKILL.md)
-- [Frappe API](../skills/frappe-api/SKILL.md)
-- [Bench Commands](../skills/bench-commands/SKILL.md)
-- [Remote Operations](../skills/remote-operations/SKILL.md)
-- [Web Forms](../skills/web-forms/SKILL.md)
-
----
-*Tổng cộng: 49 files tài liệu trong hệ thống Frappe Dev Master.*

package/skills/cm-frappe-agent/docs/sop/user-guide.md

@@ -1,178 +0,0 @@
----
-title: "Hướng dẫn Sử dụng Tiêu chuẩn (SOP)"
-description: "Step-by-step standard operating procedures cho các tác vụ Frappe Dev Master — từ tạo app mới tới sửa lỗi production."
-keywords: "frappe sop, user guide, step by step, workflow, troubleshooting"
-robots: "index, follow"
----
-
-# Hướng dẫn Sử dụng (SOP)
-
-> Các quy trình chuẩn (Standard Operating Procedures) cho từng loại tác vụ phát triển Frappe. Mỗi SOP bao gồm: điều kiện kích hoạt, agent phụ trách, bước thực hiện, và troubleshooting.
-
----
-
-## SOP 1: Tạo Frappe App Mới
-
-**Khi nào:** Bắt đầu dự án Frappe mới từ đầu
-**Agent:** Installer → Planner → DocType Architect
-
-### Bước thực hiện
-
-1. **Cài đặt môi trường** (nếu chưa có)
-   ```bash
-   # Check prerequisites
-   frappe install check
-   # Init bench
-   bench init frappe-bench --frappe-branch version-15
-   cd frappe-bench
-   bench new-site mysite.localhost
-   ```
-
-2. **Scaffold app mới**
-   ```bash
-   bench new-app my_app
-   bench --site mysite.localhost install-app my_app
-   ```
-
-3. **Thiết kế DocType (dùng AI)**
-   - Mô tả yêu cầu tới Agent: "Thiết kế DocType Employee Score với fields: employee, score, month"
-   - DocType Architect sẽ tạo JSON schema theo naming conventions
-
-4. **Implement logic** 
-   - Backend Agent viết Engine (Layer 2) → Controller (Layer 1) → API (Layer 3)
-   - Frontend Agent viết Client Scripts (Layer 7)
-
-5. **Test & Deploy**
-   ```bash
-   bench --site mysite.localhost run-tests --app my_app
-   bench build
-   bench --site mysite.localhost migrate
-   ```
-
----
-
-## SOP 2: Sửa Lỗi Production (Bug Fix)
-
-**Khi nào:** Có lỗi cần sửa trên production
-**Agent:** Fixer (bắt buộc Fix Loop 6 bước)
-
-### Bước thực hiện
-
-1. **Reproduce** — Xác nhận lỗi
-   ```bash
-   frappe fix "Error: ValidationError on Sales Invoice submit"
-   ```
-
-2. **Diagnose** — Agent tự kiểm tra logs, Error Log DocType
-3. **Hypothesize** — Agent đề xuất fix tối thiểu
-4. **Fix** — Agent áp dụng thay đổi theo đúng 7-Layer
-5. **Verify** — Chạy tests, kiểm tra regression
-6. **Document** — Agent tạo fix documentation
-
-<details>
-<summary>🔧 Troubleshooting: Fix Loop thất bại ở bước Verify</summary>
-
-- Revert fix: `git checkout -- <file>`
-- Quay lại bước 2 — chẩn đoán sai root cause
-- Thêm debug logging để thu thập thêm thông tin
-- Xem xét edge cases chưa xử lý
-</details>
-
----
-
-## SOP 3: Tối ưu Hiệu năng
-
-**Khi nào:** Trang chậm, query timeout, memory cao
-**Agent:** Performance
-
-### Bước thực hiện
-
-1. **Identify bottleneck**
-   ```bash
-   # Enable slow query log
-   # In site_config.json: "log_slow_queries": 1
-   grep "slow_query" logs/frappe.log | tail -20
-   ```
-
-2. **Profile code** — cProfile, tracemalloc
-3. **Find root cause** — N+1? Missing index? Over-fetching?
-4. **Optimize** — Batch fetch, add index, implement caching
-5. **Verify** — Đo lại response time
-
----
-
-## SOP 4: Vận hành Remote Site
-
-**Khi nào:** Cần thao tác CRUD/debug trên Frappe Cloud hoặc remote site (không có shell access)
-**Agent:** Remote Ops
-
-### Bước thực hiện
-
-1. **Setup credentials** trong `.env`
-   ```bash
-   FRAPPE_SITE=https://mysite.example.com
-   FRAPPE_API_KEY=<key>
-   FRAPPE_API_SECRET=<secret>
-   ```
-
-2. **Test connection**
-   ```bash
-   frappe remote discover --site https://mysite.example.com
-   ```
-
-3. **Execute operations**
-   ```bash
-   frappe remote list "Sales Invoice" --filters '{"status":"Paid"}'
-   frappe remote get "Sales Invoice" "ACC-SINV-2024-00001"
-   ```
-
----
-
-## SOP 5: Mở rộng ERPNext
-
-**Khi nào:** Cần thêm field/logic vào ERPNext mà không sửa core code
-**Agent:** ERPNext Customizer
-
-### Bước thực hiện
-
-1. **Tạo Custom Field** (KHÔNG sửa core JSON)
-   ```python
-   frappe.get_doc({
-       "doctype": "Custom Field",
-       "dt": "Sales Invoice",
-       "fieldname": "custom_priority",
-       "fieldtype": "Select",
-       "options": "Low\nMedium\nHigh"
-   }).insert()
-   ```
-
-2. **Hook vào events** trong `hooks.py`
-   ```python
-   doc_events = {
-       "Sales Invoice": {
-           "validate": "my_app.overrides.validate_priority"
-       }
-   }
-   ```
-
-3. **Test** rằng standard ERPNext workflow không bị ảnh hưởng
-
----
-
-## Quick Reference: Chọn đúng Agent
-
-| Bạn muốn... | Dùng Agent |
-|---|---|
-| Cài đặt Frappe từ đầu | Installer |
-| Thiết kế DocType | DocType Architect |
-| Viết Python API/logic | Backend |
-| Viết Client Script/UI | Frontend |
-| Customize ERPNext | ERPNext Customizer |
-| Phân tích lỗi (không sửa) | Debugger |
-| Sửa lỗi (có sửa code) | Fixer |
-| Tối ưu performance | Performance |
-| Thao tác remote site | Remote Ops |
-| Git/CI/CD | GitHub Workflow |
-
----
-[← Tài liệu Tham khảo](../resources-catalog.md) · [Vibe Coding Guide →](vibe-coding-guide.md)

package/skills/cm-frappe-agent/docs/sop/vibe-coding-guide.md

@@ -1,122 +0,0 @@
----
-title: "Hướng dẫn Vibe Coding — Tích hợp AI Agent"
-description: "Cách sử dụng Frappe Dev Master với các AI IDE (Cursor, Claude, Windsurf) và Autonomous Agents (OpenClaw, OpenFang.sh)."
-keywords: "vibe coding, ai agent, cursor, claude, openclaw, openfang, frappe devtool"
-robots: "index, follow"
----
-
-# Hướng dẫn Vibe Coding
-
-> "Vibe Coding" là phong cách lập trình phối hợp cùng AI Agent — bạn mô tả ý tưởng, AI viết code theo chuẩn kiến trúc.
-
----
-
-## 1. Sử dụng với Interactive AI IDE (Cursor/Claude/Windsurf)
-
-### Cài đặt Skill
-
-Copy `frappe-dev-master/` vào thư mục skills của IDE:
-
-```bash
-# Antigravity / Gemini
-cp -r frappe-dev-master/ ~/.gemini/antigravity/skills/
-
-# Claude Code
-cp -r frappe-dev-master/ .claude/skills/
-
-# Cursor
-# Paste SKILL.md content vào Custom Instructions
-```
-
-### Cách sử dụng
-
-Chỉ cần mô tả yêu cầu tự nhiên — SKILL.md sẽ tự động điều phối đúng Agent:
-
-```
-"Tạo DocType Employee Score với fields: employee (Link), score (Int), month (Data)"
-→ DocType Architect xử lý
-
-"Viết API tính tổng điểm theo tháng"
-→ Frappe Backend xử lý
-
-"Sửa lỗi Sales Invoice validate fails"
-→ Frappe Fixer xử lý (Fix Loop 6 bước)
-
-"Trang Sales Invoice chậm quá"
-→ Frappe Performance xử lý
-```
-
----
-
-## 2. Sử dụng với Autonomous Agents (OpenClaw / OpenFang.sh)
-
-### OpenClaw
-
-OpenClaw dùng System Prompt, có giới hạn token. Dùng bản slim SKILL.md.
-
-**Đăng ký CLI tools tự động:**
-
-```bash
-# OpenClaw agent chạy lệnh này khi khởi động
-frappe tools --format openclaw
-```
-
-Output: Array of function-calling JSON schema → Agent tự biết gọi `frappe_get`, `frappe_list`, `frappe_meta` v.v.
-
-### OpenFang.sh
-
-OpenFang hỗ trợ recursive sub-agents. SKILL.md đã có sẵn `Sub-agent Instructions`:
-
-- **Subagent A: DocType Architect** — Schema design
-- **Subagent B: Frappe Backend** — Python logic
-- **Subagent C: Frappe Frontend** — Client scripts
-
-**Đăng ký CLI tools:**
-
-```bash
-frappe tools --format openfang
-```
-
-Output: MCP-compatible tool schema với `inputSchema` → OpenFang tự bind CLI commands.
-
-### Context Injection
-
-Inject biến môi trường cho agent:
-
-```
-{{ workspace_root }}   → Thư mục dự án hiện tại
-{{ current_branch }}   → Git branch đang làm việc
-```
-
----
-
-## 3. CLI `frappe-devtool` Commands cho AI
-
-| Command | Mục đích |
-|---------|----------|
-| `frappe tools --format json` | Liệt kê tất cả CLI commands (JSON) |
-| `frappe tools --format openclaw` | Tool schema cho OpenClaw (function-calling) |
-| `frappe tools --format openfang` | Tool schema cho OpenFang (MCP-compatible) |
-| `frappe prompt` | In System Prompt cho AI Agent |
-| `frappe plan "objective"` | Tạo execution playbook cho AI |
-| `frappe meta <DocType>` | Khám phá schema DocType (AI-friendly JSON) |
-
----
-
-## 4. Workflow Phối hợp AI + CLI
-
-```mermaid
-flowchart TD
-    Dev["👤 Developer"] --> Describe["Mô tả yêu cầu"]
-    Describe --> Skill["🧠 SKILL.md điều phối"]
-    Skill --> Agent["Agent chuyên biệt"]
-    Agent --> CLI["frappe-devtool CLI"]
-    CLI --> Frappe["Frappe Site"]
-    Agent --> Code["Viết code theo 7-Layer"]
-    Code --> Test["Test & Verify"]
-```
-
-*Text fallback:* Developer mô tả yêu cầu → SKILL.md điều phối đúng Agent → Agent dùng CLI để tương tác Frappe Site + viết code theo 7-Layer → Test & Verify.
-
----
-[← Hướng dẫn SOP](user-guide.md) · [Trang Chủ →](../README.md)