diff --git a/.agent/workflows/add-node.md b/.agent/workflows/add-node.md
new file mode 100644
index 0000000..372ce38
--- /dev/null
+++ b/.agent/workflows/add-node.md
@@ -0,0 +1,30 @@
+---
+description: how to add or update nodes in ComfyUI custom node
+---
+
+Follow these steps to add a new node or update existing ones in this repository.
+
+### 1. Implementation Principles
+- **Asynchronous I/O**: Use `ThreadPoolExecutor` for disk-heavy operations (saving/loading).
+- **PyTorch Optimization**: Perform tensor normalization (`.float().div_(255.0)`) directly in PyTorch rather than NumPy to avoid memory overhead.
+- **Visual Feedback**: Always include `comfy.utils.ProgressBar`.
+- **Detailed Descriptions**: Include a `DESCRIPTION` class attribute for ComfyUI tooltips.
+
+### 2. Adding a New Node
+1. **Create Python File**: Create a new `.py` file for your node (e.g., `new_node_feature.py`).
+2. **Implement Node Class**:
+   - Ensure `CATEGORY = "CUSTOM_NODE_NAME"`.
+   - Implement `DESCRIPTION`.
+3. **Register in `__init__.py`**:
+   - Import `NODE_CLASS_MAPPINGS` and `NODE_DISPLAY_NAME_MAPPINGS` from the new file.
+   - Update the global mappings in `__init__.py`.
+4. **Update Documentation**:
+   - Add the new node details to `README.md` under the appropriate section.
+5. **Security Check**:
+   - For saving nodes, use `os.path.commonpath` to ensure the target directory is within the ComfyUI `output` folder.
+
+### 3. Update Checklist
+- [ ] Add `DESCRIPTION` to class.
+- [ ] Use `ThreadPoolExecutor` if I/O bound.
+- [ ] Update `README.md`.
+- [ ] Register in `__init__.py`.
\ No newline at end of file
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..7a60b85
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,2 @@
+__pycache__/
+*.pyc
diff --git a/resolution_matrix.py b/resolution_matrix.py
index e6996cf..546063d 100644
--- a/resolution_matrix.py
+++ b/resolution_matrix.py
@@ -1,4 +1,8 @@
+import comfy.utils
+
 class PixelForge:
+    DESCRIPTION = "A ComfyUI node for selecting mathematically valid image resolutions filtered by aspect ratio, orientation, and megapixel limit."
+
     """
     PixelForge Resolution Matrix
     A ComfyUI node for selecting mathematically valid resolutions
@@ -110,6 +114,9 @@ class PixelForge:
 
         total_mp = (width * height) / self.MP_BASE
 
+        pbar = comfy.utils.ProgressBar(1)
+        pbar.update(1)
+
         return (
             width,
             height,