codymaster 4.6.0 → 4.8.0

package/skills/cm-frappe-agent/commands/frappe-test.md

@@ -1,356 +0,0 @@
----
-description: Run Frappe tests with various options including specific DocTypes, modules, apps, and coverage reporting
-allowed-tools: Bash, Read, Grep, Glob
-argument-hint: [app_name] [--doctype <name>] [--module <name>] [--coverage]
----
-
-# Run Frappe Tests
-
-Execute Frappe test suites with various filtering and reporting options.
-
-## Arguments
-
-Parse the user's input: $ARGUMENTS
-
-- **app_name**: (Optional) App to test
-- **--doctype**: Test specific DocType
-- **--module**: Test specific module
-- **--coverage**: Generate coverage report
-- **--parallel**: Run tests in parallel
-- **--failfast**: Stop on first failure
-
-## Process
-
-### Step 1: Detect Environment
-
-```bash
-# Find site
-cat sites/currentsite.txt 2>/dev/null || echo "No default site"
-
-# List available apps
-ls apps/
-```
-
-### Step 2: Determine Test Scope
-
-Based on arguments, determine what to test:
-- All tests (no arguments)
-- App tests (`--app erpnext`)
-- Module tests (`--module erpnext.accounts`)
-- DocType tests (`--doctype "Sales Invoice"`)
-
-### Step 3: Run Tests
-
-#### All Tests
-```bash
-bench --site <sitename> run-tests
-```
-
-#### App Tests
-```bash
-bench --site <sitename> run-tests --app my_app
-```
-
-#### Module Tests
-```bash
-bench --site <sitename> run-tests --module my_app.my_module.doctype.my_doctype
-```
-
-#### DocType Tests
-```bash
-bench --site <sitename> run-tests --doctype "My DocType"
-```
-
-#### With Coverage
-```bash
-bench --site <sitename> run-tests --app my_app --coverage
-```
-
-#### Parallel Tests
-```bash
-bench --site <sitename> run-tests --app my_app --parallel
-```
-
-#### Skip Test Data Setup
-```bash
-bench --site <sitename> run-tests --app my_app --skip-setup
-```
-
-### Step 4: Analyze Results
-
-Parse test output for:
-- Passed tests
-- Failed tests
-- Errors
-- Skipped tests
-- Coverage percentage (if enabled)
-
-## Test File Structure
-
-```
-my_app/
-└── my_module/
-    └── doctype/
-        └── my_doctype/
-            └── test_my_doctype.py
-```
-
-## Writing Tests
-
-### Basic Test
-```python
-# test_my_doctype.py
-import frappe
-from frappe.tests.utils import FrappeTestCase
-
-
-class TestMyDocType(FrappeTestCase):
-    def setUp(self):
-        """Run before each test"""
-        self.doc = make_test_doc()
-
-    def tearDown(self):
-        """Run after each test"""
-        frappe.db.rollback()
-
-    def test_create_document(self):
-        """Test document creation"""
-        doc = frappe.get_doc({
-            "doctype": "My DocType",
-            "field1": "value1"
-        })
-        doc.insert()
-
-        self.assertTrue(doc.name)
-        self.assertEqual(doc.field1, "value1")
-
-    def test_validate_required_field(self):
-        """Test that required field raises error"""
-        doc = frappe.get_doc({
-            "doctype": "My DocType"
-            # Missing required field
-        })
-
-        with self.assertRaises(frappe.MandatoryError):
-            doc.insert()
-
-    def test_calculation(self):
-        """Test amount calculation"""
-        doc = frappe.get_doc({
-            "doctype": "My DocType",
-            "qty": 10,
-            "rate": 100
-        })
-        doc.insert()
-
-        self.assertEqual(doc.amount, 1000)
-```
-
-### Test with Fixtures
-```python
-# test_records.json (in same directory)
-[
-    {
-        "doctype": "My DocType",
-        "name": "TEST-001",
-        "field1": "Test Value"
-    }
-]
-```
-
-```python
-# test_my_doctype.py
-class TestMyDocType(FrappeTestCase):
-    def test_with_fixture(self):
-        """Test using fixture data"""
-        doc = frappe.get_doc("My DocType", "TEST-001")
-        self.assertEqual(doc.field1, "Test Value")
-```
-
-### Test API Endpoints
-```python
-class TestMyAPI(FrappeTestCase):
-    def test_whitelisted_method(self):
-        """Test API endpoint"""
-        from my_app.api import get_data
-
-        result = get_data("param1")
-
-        self.assertIsNotNone(result)
-        self.assertIn("key", result)
-
-    def test_api_permissions(self):
-        """Test API requires login"""
-        frappe.set_user("Guest")
-
-        with self.assertRaises(frappe.PermissionError):
-            from my_app.api import protected_method
-            protected_method()
-
-        frappe.set_user("Administrator")
-```
-
-### Test Document Events
-```python
-class TestMyDocTypeEvents(FrappeTestCase):
-    def test_on_submit(self):
-        """Test submit creates linked document"""
-        doc = make_test_doc()
-        doc.insert()
-        doc.submit()
-
-        # Check linked document was created
-        linked = frappe.get_all("Linked DocType",
-            filters={"reference": doc.name})
-
-        self.assertEqual(len(linked), 1)
-
-    def test_on_cancel_reverses(self):
-        """Test cancel reverses changes"""
-        doc = make_test_doc()
-        doc.insert()
-        doc.submit()
-
-        original_value = get_related_value()
-
-        doc.cancel()
-
-        new_value = get_related_value()
-        self.assertNotEqual(original_value, new_value)
-```
-
-## Test Utilities
-
-### Create Test Records
-```python
-def make_test_doc(**kwargs):
-    """Helper to create test documents"""
-    doc = frappe.get_doc({
-        "doctype": "My DocType",
-        "field1": kwargs.get("field1", "Default"),
-        "field2": kwargs.get("field2", "Default")
-    })
-    return doc
-
-
-def make_test_customer():
-    """Create test customer"""
-    if not frappe.db.exists("Customer", "_Test Customer"):
-        doc = frappe.get_doc({
-            "doctype": "Customer",
-            "customer_name": "_Test Customer",
-            "customer_type": "Company"
-        })
-        doc.insert()
-    return frappe.get_doc("Customer", "_Test Customer")
-```
-
-### Assertions
-```python
-# Common assertions
-self.assertEqual(a, b)
-self.assertNotEqual(a, b)
-self.assertTrue(condition)
-self.assertFalse(condition)
-self.assertIsNone(value)
-self.assertIsNotNone(value)
-self.assertIn(item, container)
-self.assertNotIn(item, container)
-self.assertRaises(ExceptionType, callable, *args)
-self.assertAlmostEqual(a, b, places=2)
-```
-
-### Test Context Managers
-```python
-from frappe.tests.utils import change_settings
-
-class TestWithSettings(FrappeTestCase):
-    def test_with_changed_settings(self):
-        with change_settings("Selling Settings", {
-            "allow_negative_stock": 1
-        }):
-            # Test with changed settings
-            pass
-        # Settings restored after context
-```
-
-## Coverage Report
-
-```bash
-# Generate coverage
-bench --site <sitename> run-tests --app my_app --coverage
-
-# View coverage report
-# HTML report in htmlcov/index.html
-```
-
-## Debugging Tests
-
-### Run with Verbose Output
-```bash
-bench --site <sitename> run-tests --app my_app -v
-```
-
-### Run Single Test
-```bash
-bench --site <sitename> run-tests \
-    --module my_app.my_module.doctype.my_doctype.test_my_doctype \
-    --test test_create_document
-```
-
-### Debug in Console
-```bash
-bench --site <sitename> console
-```
-
-```python
-# In console
-from my_app.my_module.doctype.my_doctype.test_my_doctype import TestMyDocType
-
-test = TestMyDocType()
-test.setUp()
-test.test_create_document()  # Run specific test
-```
-
-## Common Test Patterns
-
-### Test Permissions
-```python
-def test_user_cannot_access(self):
-    frappe.set_user("test_user@example.com")
-
-    with self.assertRaises(frappe.PermissionError):
-        frappe.get_doc("Restricted DocType", "DOC-001")
-
-    frappe.set_user("Administrator")
-```
-
-### Test Validation
-```python
-def test_date_validation(self):
-    doc = make_test_doc()
-    doc.start_date = "2024-01-15"
-    doc.end_date = "2024-01-10"  # Before start
-
-    with self.assertRaises(frappe.ValidationError):
-        doc.insert()
-```
-
-### Test Background Jobs
-```python
-def test_enqueued_job(self):
-    from my_app.tasks import my_task
-
-    # Run synchronously for testing
-    result = my_task(param="value")
-
-    self.assertEqual(result, expected_value)
-```
-
-## Output
-
-After running tests, provide:
-1. Summary: passed/failed/errors
-2. Failed test details
-3. Coverage percentage (if requested)
-4. Suggestions for fixing failures

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

@@ -1,51 +0,0 @@
----
-title: "Frappe Dev Master — Tài liệu Toàn diện"
-description: "Trang chủ hệ thống tài liệu kỹ thuật, hướng dẫn sử dụng, và danh mục AI Agent của Frappe Dev Master — bộ công cụ AI phát triển Frappe/ERPNext toàn vòng đời."
-keywords: "frappe, erpnext, ai skill, vibe coding, documentation, cli, devtool"
-robots: "index, follow"
----
-
-# Frappe Dev Master — Tổng quan
-
-> **Bộ công cụ AI toàn diện cho phát triển Frappe/ERPNext** — từ cài đặt, thiết kế, lập trình, tới gỡ lỗi, tối ưu hiệu năng và vận hành từ xa. Hỗ trợ Vibe Coding qua CLI (`frappe-devtool`) và AI Skill (`frappe-dev-master`).
-
-## Thành phần Hệ thống
-
-| Thành phần | Mô tả | Files |
-|---|---|---|
-| **SKILL.md** | Bộ não trung tâm — điều phối tất cả agents và skills | 1 file |
-| **Agents** | AI Agents chuyên biệt cho từng giai đoạn lifecycle | 12 agents |
-| **Commands** | CLI commands cho tương tác nhanh | 15 commands |
-| **Resources** | Tài liệu tham khảo kiến trúc và patterns | 8 files |
-| **Sub-Skills** | Cú pháp chi tiết cho từng lĩnh vực kỹ thuật | 7 skills |
-
-## Vòng đời Phát triển (Development Lifecycle)
-
-```
-INSTALL → PLAN → BUILD → TEST → DEBUG → FIX → OPTIMIZE → DEPLOY → OPERATE
-```
-
-1. **INSTALL** — Cài đặt bench, site, apps → [frappe-installer](../agents/frappe-installer.md)
-2. **PLAN** — Thiết kế kiến trúc, DocType → [frappe-planner](../agents/frappe-planner.md)
-3. **BUILD** — Lập trình Backend/Frontend → [frappe-backend](../agents/frappe-backend.md), [frappe-frontend](../agents/frappe-frontend.md)
-4. **TEST** — Kiểm thử tự động → [commands/frappe-test](../commands/frappe-test.md)
-5. **DEBUG** — Phân tích lỗi → [frappe-debugger](../agents/frappe-debugger.md)
-6. **FIX** — Sửa lỗi có cấu trúc → [frappe-fixer](../agents/frappe-fixer.md)
-7. **OPTIMIZE** — Tối ưu hiệu năng → [frappe-performance](../agents/frappe-performance.md)
-8. **DEPLOY** — Triển khai production → [commands/frappe-bench](../commands/frappe-bench.md)
-9. **OPERATE** — Vận hành từ xa qua REST API → [frappe-remote-ops](../agents/frappe-remote-ops.md)
-
-## Nội dung Tài liệu
-
-| # | Tài liệu | Mô tả |
-|---|---|---|
-| 1 | [Kiến trúc Hệ thống](architecture.md) | 7-Layer Architecture, Data Flow, ADR |
-| 2 | [Danh mục AI Agents](agents-catalog.md) | 12 agents chuyên biệt với chức năng & workflow |
-| 3 | [Danh mục CLI Commands](commands-catalog.md) | 15 commands cho tương tác nhanh |
-| 4 | [Tài liệu Tham khảo](resources-catalog.md) | Resources và Sub-Skills kỹ thuật |
-| 5 | [Hướng dẫn Sử dụng (SOP)](sop/user-guide.md) | Step-by-step cho từng tác vụ |
-| 6 | [Hướng dẫn Vibe Coding](sop/vibe-coding-guide.md) | Tích hợp AI Agent (Cursor, OpenClaw, OpenFang) |
-| 7 | [Sitemap cho AI/LLM](sitemap.md) | Dành cho NotebookLM và Semantic Search |
-
----
-*Tài liệu tự động tạo bởi `cm-dockit` Workflow — 2026-03-25*

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

@@ -1,113 +0,0 @@
----
-title: "Danh mục AI Agents"
-description: "Catalogue chi tiết 12 AI Agents chuyên biệt trong Frappe Dev Master — chức năng, trigger conditions, và workflow."
-keywords: "frappe agents, ai agent, doctype architect, backend, frontend, debugger, fixer, performance"
-robots: "index, follow"
----
-
-# Danh mục AI Agents
-
-> **12 AI Agents** phân chia thành 2 nhóm: **Build** (phát triển) và **Operate** (vận hành). Mỗi agent có chuyên môn riêng, được SKILL.md điều phối tự động dựa trên ngữ cảnh yêu cầu.
-
----
-
-## Nhóm 1: Build Agents (Phát triển)
-
-### 1.1 DocType Architect
-- **File:** `agents/doctype-architect.md`
-- **Trigger:** "thiết kế DocType", "schema", "workflow states", "naming rule"
-- **Chức năng:** Thiết kế cấu trúc database (JSON schema), quan hệ DocType, workflow states, naming conventions
-- **Output:** DocType JSON files, Custom Field definitions, Property Setters
-
-### 1.2 Frappe Backend
-- **File:** `agents/frappe-backend.md`
-- **Trigger:** "viết API", "controller", "background job", "engine"
-- **Chức năng:** Lập trình Python server-side — Controllers, Engines (Layer 2), API endpoints
-- **Quy tắc:** Luôn tách business logic ra `engines/`, dùng idempotent upsert
-
-### 1.3 Frappe Frontend
-- **File:** `agents/frappe-frontend.md`
-- **Trigger:** "client script", "form script", "dialog", "list view"
-- **Chức năng:** JavaScript Frappe Forms, Dialogs, List View configurations
-- **Quy tắc:** Dùng `window.myapp` namespace, kiểm tra element tồn tại trước khi thao tác
-
-### 1.4 Custom Frontend
-- **File:** `agents/frappe-custom-frontend.md`
-- **Trigger:** "trang custom", "standalone page", "custom frontend"
-- **Chức năng:** Standalone frontend pages ngoài Desk UI chuẩn của Frappe
-
-### 1.5 ERPNext Customizer
-- **File:** `agents/erpnext-customizer.md`
-- **Trigger:** "mở rộng ERPNext", "custom field", "property setter"
-- **Chức năng:** Mở rộng an toàn các module core ERPNext qua Custom Fields/Property Setters
-- **Quy tắc:** KHÔNG BAO GIỜ sửa file core — luôn dùng hooks.py
-
----
-
-## Nhóm 2: Lifecycle Agents (Vận hành)
-
-### 2.1 Frappe Installer
-- **File:** `agents/frappe-installer.md`
-- **Trigger:** "cài đặt frappe", "install bench", "setup site", "production setup"
-- **Chức năng:** Cài đặt môi trường (Python, Node, MariaDB, Redis), bench init, site creation, production deployment (Nginx, Supervisor, SSL)
-- **Workflow:** Detect Environment → Install Prerequisites → Init Bench → Create Site → Install Apps
-- **Bảng lỗi thường gặp:** 8 common errors with quick fixes
-
-### 2.2 Frappe Planner
-- **File:** `agents/frappe-planner.md`
-- **Trigger:** "lên kế hoạch", "feature planning", "technical design"
-- **Chức năng:** Lập kế hoạch feature mới, thiết kế kỹ thuật, ADR
-
-### 2.3 Frappe Debugger
-- **File:** `agents/frappe-debugger.md`
-- **Trigger:** "phân tích lỗi", "debug", "check error", "log investigation"
-- **Chức năng:** Phân tích lỗi (chỉ read-only), log investigation, không sửa code
-- **Phân biệt:** Debugger chỉ **phân tích**, Fixer mới **sửa**
-
-### 2.4 Frappe Fixer ⭐
-- **File:** `agents/frappe-fixer.md`
-- **Trigger:** "sửa lỗi", "fix bug", "fix error", "solve frappe error"
-- **Chức năng:** Sửa lỗi theo vòng lặp bắt buộc 6 bước
-- **Fix Loop (MANDATORY):**
-  1. **REPRODUCE** — Xác nhận lỗi tồn tại
-  2. **DIAGNOSE** — Tìm nguyên nhân gốc (không chỉ triệu chứng)
-  3. **HYPOTHESIZE** — Đề xuất fix tối thiểu
-  4. **FIX** — Áp dụng thay đổi (theo 7-Layer)
-  5. **VERIFY** — Kiểm tra fix hoạt động, không regression
-  6. **DOCUMENT** — Ghi chép lại lỗi và cách sửa
-
-### 2.5 Frappe Performance ⭐
-- **File:** `agents/frappe-performance.md`
-- **Trigger:** "chậm", "slow query", "optimize", "performance", "caching"
-- **Chức năng:** Query optimization, profiling (cProfile, tracemalloc), caching strategy, N+1 detection
-- **Workflow:** Identify Bottleneck → Profile Code → Find Root Cause → Optimize
-- **Common Patterns:** N+1 queries, missing indexes, over-fetching, no caching
-
-### 2.6 Frappe Remote Ops
-- **File:** `agents/frappe-remote-ops.md`
-- **Trigger:** "remote API", "REST API", "frappe cloud", "curl frappe"
-- **Chức năng:** CRUD qua REST API, report execution, Web Form management, DocType discovery
-- **Security:** KHÔNG tiết lộ API keys, LUÔN xác nhận trước thao tác xóa
-
-### 2.7 GitHub Workflow
-- **File:** `agents/github-workflow.md`
-- **Trigger:** "git", "github", "ci/cd", "pull request"
-- **Chức năng:** Git operations, CI/CD configuration, GitHub Actions
-
----
-
-## Ma trận Phối hợp Agent
-
-Khi một agent cần hỗ trợ từ agent khác:
-
-| Tình huống | Agent gốc | Chuyển tới |
-|---|---|---|
-| Fix cần thay đổi schema | Fixer | → DocType Architect |
-| Fix cần API mới | Fixer | → Backend |
-| Fix trên remote site | Fixer | → Remote Ops |
-| Cần phân tích sâu hơn | Fixer | → Debugger |
-| Performance cần index mới | Performance | → DocType Architect |
-| Build xong cần test | Backend/Frontend | → Commands/test |
-
----
-[← Kiến trúc](architecture.md) · [Danh mục Commands →](commands-catalog.md)

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

@@ -1,149 +0,0 @@
----
-title: "Kiến trúc Hệ thống Frappe Dev Master"
-description: "Tài liệu kỹ thuật mô tả Kiến trúc 7 Lớp, Hệ thống AI Agent, và Luồng Dữ liệu của Frappe Dev Master Skill."
-keywords: "frappe, 7-layer architecture, ai agent, data flow, adr"
-robots: "index, follow"
----
-
-# Kiến trúc Hệ thống
-
-> **Tham chiếu Nhanh:** `frappe-dev-master` xây dựng trên 2 trụ cột: **Kiến trúc App 7-Layer** (tách logic khỏi ORM) và **Hệ thống Điều phối AI Agent** (phân chia công việc rành mạch theo vòng đời).
-
-## 1. Kiến trúc 7 Lớp (7-Layer Architecture)
-
-Mô hình phân lớp nghiêm ngặt đảm bảo code testable, maintainable và scalable.
-
-| Lớp | Tên | Vai trò | Ví dụ |
-|-----|-----|---------|-------|
-| 1 | **DocType Controllers** | Schema JSON + lifecycle hooks (`validate`, `on_submit`) | `my_app/my_module/doctype/my_dt/my_dt.py` |
-| 2 | **Engines** | Pure Python logic — side-effect-free, testable 100% | `my_app/engines/scoring_engine.py` |
-| 3 | **APIs** | `@frappe.whitelist` endpoints, idempotent upsert | `my_app/api/permissions.py` |
-| 4 | **Tasks** | Scheduler events (daily/weekly) wrapper quanh Engines | `hooks.py` → `scheduler_events` |
-| 5 | **Setup Hooks** | Idempotent install/migrate hooks | `after_install`, `after_migrate` |
-| 6 | **Tests** | Unit tests pure logic, không cần Frappe Server | `tests/test_scoring_engine.py` |
-| 7 | **Client JS** | Shared utility namespaces, form/list scripts | `my_app/public/js/my_app.js` |
-
-### Luồng Dữ liệu (Data Flow)
-
-```mermaid
-flowchart TD
-    Client["Client UI / Browser"] --> API["Lớp 3: API Endpoint"]
-    Webhook["External Webhook"] --> API
-    Task["Lớp 4: Scheduler Tasks"] --> Engine["Lớp 2: Business Logic Engine"]
-    API --> Engine
-    Engine --> ORM["Lớp 1: DocType Controllers"]
-    ORM --> DB[("MariaDB")]
-```
-
-*Text fallback:* Request từ Client/Webhook → API Endpoint → Engine (Pure Python) → DocType Controller → Database. Scheduler Tasks cũng gọi trực tiếp Engine.
-
-### Quy tắc Vàng
-
-1. **KHÔNG** đặt business logic nặng trong DocType controller
-2. **LUÔN** tách thuật toán phức tạp ra `engines/` để test độc lập
-3. **LUÔN** dùng `@frappe.whitelist` cho API, KHÔNG trả về raw HTML
-4. **LUÔN** dùng `frappe.log_error()`, KHÔNG dùng `frappe.logger`
-
----
-
-## 2. Hệ thống AI Agent
-
-```mermaid
-flowchart LR
-    User["👤 Developer"] --> Orchestrator["🧠 SKILL.md\nĐiều phối"]
-    Orchestrator --> Build["🔨 Build Agents"]
-    Orchestrator --> Operate["⚙️ Lifecycle Agents"]
-    Build --> DA["DocType Architect"]
-    Build --> BE["Frappe Backend"]
-    Build --> FE["Frappe Frontend"]
-    Build --> CFE["Custom Frontend"]
-    Build --> ERP["ERPNext Customizer"]
-    Operate --> INS["Installer"]
-    Operate --> PLN["Planner"]
-    Operate --> DBG["Debugger"]
-    Operate --> FIX["Fixer"]
-    Operate --> PERF["Performance"]
-    Operate --> RMT["Remote Ops"]
-    Operate --> GH["GitHub Workflow"]
-```
-
-*Text fallback:* SKILL.md là Orchestrator trung tâm. Nó điều phối 2 nhóm: Build Agents (5 agents cho phát triển) và Lifecycle Agents (7 agents cho vận hành).
-
-### Nhóm Build Agents (Phát triển)
-
-| Agent | File | Chức năng |
-|-------|------|-----------|
-| DocType Architect | `agents/doctype-architect.md` | Thiết kế schema, relations, workflow states |
-| Frappe Backend | `agents/frappe-backend.md` | Python APIs, controllers, background jobs |
-| Frappe Frontend | `agents/frappe-frontend.md` | Client scripts, dialogs, custom formatters |
-| Custom Frontend | `agents/frappe-custom-frontend.md` | Standalone frontend pages |
-| ERPNext Customizer | `agents/erpnext-customizer.md` | Mở rộng ERPNext core an toàn |
-
-### Nhóm Lifecycle Agents (Vận hành)
-
-| Agent | File | Chức năng |
-|-------|------|-----------|
-| Installer | `agents/frappe-installer.md` | Cài đặt bench, site, production |
-| Planner | `agents/frappe-planner.md` | Lập kế hoạch feature, ADR |
-| Debugger | `agents/frappe-debugger.md` | Phân tích lỗi, log investigation |
-| Fixer | `agents/frappe-fixer.md` | Sửa lỗi có cấu trúc 6-bước |
-| Performance | `agents/frappe-performance.md` | Query optimization, profiling, caching |
-| Remote Ops | `agents/frappe-remote-ops.md` | REST API operations cho remote sites |
-| GitHub Workflow | `agents/github-workflow.md` | Git operations, CI/CD |
-
----
-
-## 3. Quyết Định Kiến Trúc (ADR)
-
-| Quyết định | Lý do |
-|------------|-------|
-| **Tách Engine ra khỏi Controller** | DocType controller đòi HTTP Context + DB. Engine thuần Python → test nhanh, CI tự động |
-| **Không dùng Raw SQL mặc định** | Bypass cơ chế Role Permission → rủi ro SQL Injection. Ưu tiên `frappe.get_doc`, `frappe.db.get_list` |
-| **Luôn dùng `frappe.log_error()`** | `frappe.logger` không ghi vào Error Log DocType → mất trace |
-| **Idempotent Upsert cho API** | Tránh duplicate entries khi retry, đảm bảo safe CI/CD |
-
----
-
-## 4. Cấu trúc Thư mục
-
-```
-frappe-dev-master/
-├── SKILL.md                  # Bộ não điều phối trung tâm
-├── agents/                   # 12 AI Agents chuyên biệt
-│   ├── doctype-architect.md
-│   ├── frappe-backend.md
-│   ├── frappe-frontend.md
-│   ├── frappe-installer.md
-│   ├── frappe-fixer.md
-│   ├── frappe-debugger.md
-│   ├── frappe-performance.md
-│   ├── frappe-remote-ops.md
-│   └── ...
-├── commands/                 # 15 CLI Commands
-│   ├── frappe-app.md
-│   ├── frappe-backend.md
-│   ├── frappe-bench.md
-│   ├── frappe-install.md
-│   ├── frappe-fix.md
-│   ├── frappe-remote.md
-│   └── ...
-├── resources/                # 8+ Tài liệu tham khảo
-│   ├── 7-layer-architecture.md
-│   ├── bench_commands.md
-│   ├── common_pitfalls.md
-│   ├── rest-api-patterns.md
-│   ├── installation-guide.md
-│   └── ...
-├── skills/                   # 7 Sub-Skills
-│   ├── doctype-patterns/
-│   ├── server-scripts/
-│   ├── client-scripts/
-│   ├── frappe-api/
-│   ├── bench-commands/
-│   ├── remote-operations/
-│   └── web-forms/
-└── docs/                     # Tài liệu này
-```
-
----
-[← Trang Chủ](README.md) · [Danh mục Agents →](agents-catalog.md)