From a02190f6a8d3e158092e7338639062b3b244d100 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sat, 10 Jan 2026 17:18:01 +0000
Subject: [PATCH] Update plugin README with npm-style package structure
 documentation

Co-authored-by: johndoe6345789 <224850594+johndoe6345789@users.noreply.github.com>
---
 .../workflow/plugins/README.md                | 30 ++++++++++++++++---
 1 file changed, 26 insertions(+), 4 deletions(-)

diff --git a/backend/autometabuilder/workflow/plugins/README.md b/backend/autometabuilder/workflow/plugins/README.md
index bf1b29a..6bca435 100644
--- a/backend/autometabuilder/workflow/plugins/README.md
+++ b/backend/autometabuilder/workflow/plugins/README.md
@@ -4,8 +4,15 @@ This document describes all available workflow plugins for building declarative
 
 ## Directory Structure
 
-Plugins are now organized into subdirectories by category:
-- **backend/** - Backend infrastructure and initialization plugins (14 plugins)
+Plugins are organized using an npm-style package structure. Each category folder contains:
+- A `package.json` with category metadata
+- Individual plugin folders, each containing:
+  - The plugin Python file (`plugin_name.py`)
+  - A `package.json` with plugin metadata
+
+### Categories
+
+- **backend/** - Backend infrastructure and initialization plugins (15 plugins)
 - **core/** - Core workflow orchestration plugins (7 plugins)
 - **tools/** - Tool execution and development plugins (7 plugins)
 - **notifications/** - External notification integrations (3 plugins)
@@ -19,9 +26,24 @@ Plugins are now organized into subdirectories by category:
 - **var/** - Variable management (4 plugins)
 - **test/** - Unit testing and assertions (5 plugins)
 - **utils/** - Utility functions (7 plugins)
-- **web/** - Web UI and Flask operations (26 plugins)
+- **web/** - Web UI and Flask operations (24 plugins)
 
-**Total: 95 plugins**
+**Total: 120 plugins in 15 categories**
+
+### Example Structure
+
+```
+backend/workflow/plugins/
+  math/
+    package.json              # Category metadata
+    math_add/
+      package.json            # Plugin metadata
+      math_add.py             # Plugin implementation
+    math_divide/
+      package.json
+      math_divide.py
+    ...
+```
 
 ## Categories