Update CODEBUDDY.md.

Author: domchen

.codebuddy/CODEBUDDY.md

@@ -8,7 +8,7 @@ This file provides guidance to CodeBuddy Code when working with code in this rep
 
 libpag is a real-time rendering library for PAG (Portable Animated Graphics) files. It renders vector and raster animations across iOS, Android, macOS, Windows, Linux, OpenHarmony, and Web platforms.
 
-### Key Directories
+### Source Structure
 
 | Directory | Purpose |
 |-----------|---------|
@@ -20,6 +20,8 @@ libpag is a real-time rendering library for PAG (Portable Animated Graphics) fil
 | `test/src/` | Google Test-based test cases |
 | `third_party/tgfx/` | GPU abstraction layer (OpenGL, Metal, Vulkan) |
 
+File extensions: `.h` (headers), `.cpp` (implementation), `.mm` (Objective-C++). Source files are auto-collected via `file(GLOB)` - no CMake changes needed for new files.
+
 ### Core Classes
 
 - **PAGFile**: Load and manage PAG animation files
@@ -53,34 +55,34 @@ npm install -g depsync
 depsync
 ```
 
-### Build and Run Tests
-
-```bash
-mkdir build && cd build
-cmake -DPAG_BUILD_TESTS=ON -DCMAKE_BUILD_TYPE=Debug ..
-cmake --build . --target PAGFullTest -- -j 12
-./PAGFullTest
-```
+### Build Verification
 
-### Run Specific Test
+After modifying code, use this command to verify compilation. Must pass `-DPAG_BUILD_TESTS=ON` to enable ALL modules (layers, svg, pdf, etc.).
 
 ```bash
-./PAGFullTest --gtest_filter="TestSuiteName.TestName"
+cmake -DPAG_BUILD_TESTS=ON -DCMAKE_BUILD_TYPE=Debug -B cmake-build-debug
+cmake --build cmake-build-debug --target PAGFullTest -- -j 12
 ```
 
-### Code Formatting
-
+### Code Formatting (REQUIRED before commit)
 ```bash
 ./codeformat.sh
 ```
+Run this before every commit. Ignore any error output - the script completes formatting regardless of reported errors.
 
-Run before committing. Ignore output errors - the formatting completes regardless.
 
 ## Testing
 
 - Location: `/test/src/*Test.cpp`, based on Google Test framework
 - Test code can access all private members via compile flags (no friend class needed)
 
+### Run Tests
+```bash
+./cmake-build-debug/PAGFullTest                                        # Run all tests
+./cmake-build-debug/PAGFullTest --gtest_filter=CanvasTest.drawRect     # Run specific test
+./cmake-build-debug/PAGFullTest --gtest_filter=Canvas*                 # Run pattern match
+```
+
 ### Screenshot Tests
 
 - Use `Baseline::Compare(pixels, key)` where key format is `{folder}/{name}`, e.g., `PAGSurfaceTest/Mask`
@@ -92,15 +94,4 @@ Run before committing. Ignore output errors - the formatting completes regardles
 - To accept screenshot changes, copy `test/out/version.json` to `test/baseline/`, **but MUST satisfy both**:
   - Use `version.json` output from running ALL test cases in `PAGFullTest`, never use partial test output
   - User explicitly confirms accepting all screenshot changes
-- `UpdateBaseline` or `update_baseline.sh` syncs `test/baseline/version.json` to `.cache/` and generates local baseline cache. CMake warns when version.json files differ. **NEVER run this command automatically**
-
-## Key CMake Options
-
-- `-DPAG_BUILD_TESTS=ON`: Enable test targets (required for full module compilation)
-- `-DCMAKE_BUILD_TYPE=Debug`: Debug build with profiling enabled
-
-## File Conventions
-
-- Headers: `.h`, Implementation: `.cpp`, Objective-C++: `.mm`
-- Test files: `*Test.cpp` in `/test/src/`
-- Source files auto-collected via `file(GLOB)` - no CMake changes needed for new files
+- `UpdateBaseline` or `update_baseline.sh` syncs `test/baseline/version.json` to `.cache/` and generates local baseline cache. CMake warns when version.json files differ. **NEVER run this command automatically**

.codebuddy/rules/Rules.md

@@ -20,6 +20,7 @@ provider:
 - 变量命名避免缩写，简短且语义明确
 - 变量声明时一律赋初始值（即使是 `={}`），智能指针初始值使用 nullptr。
 - 避免 lambda 表达式，改用显式方法或函数
+- CPP 文件里的函数实现顺序与头文件中定义的顺序尽可能一致
 - `include/` 目录 API 需详细注释含参数描述，其他公开方法一段话描述主要功能，私有方法不加注释
 - 函数内代码不加行注释，除非只看代码无法理解设计意图
 - 未明确的规范，模仿项目已有风格