From f344e5cdc2a1d954528c4d35f9dcdef4028e6b04 Mon Sep 17 00:00:00 2001 From: mrsaifullah52 Date: Sat, 22 Nov 2025 12:24:58 +0500 Subject: [PATCH] feat(autominator): update agent menu and documentation --- src/modules/autominator/README.md | 58 +++++++++++++++---- .../autominator/agents/autominator.agent.yaml | 4 ++ .../workflows/create-workflow/workflow.yaml | 27 ++++++--- 3 files changed, 71 insertions(+), 18 deletions(-) diff --git a/src/modules/autominator/README.md b/src/modules/autominator/README.md index 7f009c17..499367d0 100644 --- a/src/modules/autominator/README.md +++ b/src/modules/autominator/README.md @@ -20,9 +20,25 @@ Autominator is an independent BMAD module that specializes in n8n workflow autom ## Workflows -### 1. Create Workflow +### 1. Gather Requirements -Build new n8n workflows from scratch based on your requirements. +Gather and document workflow requirements before creating n8n workflows. + +**Triggers:** + +- `*gather-requirements` + +**Features:** + +- Interactive requirement gathering +- Documents problem statement, triggers, integrations +- Creates requirement file for workflow creation +- Saves to `docs/workflow-requirements/` +- Required before creating workflows + +### 2. Create Workflow + +Build new n8n workflows from scratch based on requirements. **Triggers:** @@ -38,7 +54,7 @@ Build new n8n workflows from scratch based on your requirements. - Web search integration for latest n8n docs - Automatic JSON validation -### 2. Modify Workflow +### 3. Modify Workflow Edit or update existing n8n workflows with backup and safety checks. @@ -55,7 +71,7 @@ Edit or update existing n8n workflows with backup and safety checks. - Change validation - Rollback capability -### 3. Migrate Workflow +### 4. Migrate Workflow Migrate automation workflows from other platforms to n8n. @@ -81,7 +97,7 @@ Migrate automation workflows from other platforms to n8n. - Migration notes and documentation - Post-migration testing guidance -### 4. Optimize Workflow +### 5. Optimize Workflow Analyze and improve existing n8n workflows for performance and best practices. @@ -113,18 +129,38 @@ agent autominator/autominator *autominator ``` +### Gather Requirements (Recommended First Step) + +```bash +# Start the requirements gathering process +*gather-requirements + +# Follow the interactive prompts to: +# 1. Describe the problem you're solving +# 2. Define trigger type +# 3. Specify data requirements +# 4. Define desired outcome +# 5. List integrations +# 6. Define conditional logic +# 7. Set criticality level +# 8. Name the workflow + +# Requirements are saved to: docs/workflow-requirements/req-{name}.md +``` + ### Create a Workflow ```bash # Start the create workflow process *create-workflow -# Follow the interactive prompts to: -# 1. Describe your workflow type -# 2. Select integrations -# 3. Define complexity level -# 4. Configure error handling -# 5. Review and confirm +# Arnold will: +# 1. Check for requirements file (or prompt to create one) +# 2. Load requirements automatically +# 3. Research n8n documentation +# 4. Design workflow structure +# 5. Build and validate workflow JSON +# 6. Save to docs/workflows/{name}.json ``` ### Migrate from Another Platform diff --git a/src/modules/autominator/agents/autominator.agent.yaml b/src/modules/autominator/agents/autominator.agent.yaml index 6c8d3641..27072362 100644 --- a/src/modules/autominator/agents/autominator.agent.yaml +++ b/src/modules/autominator/agents/autominator.agent.yaml @@ -23,6 +23,10 @@ agent: - Structured Approach - Follow task-specific workflows for different automation scenarios. menu: + - trigger: gather-requirements + workflow: "{project-root}/{bmad_folder}/autominator/workflows/gather-requirements/workflow.yaml" + description: Gather and document workflow requirements (run this first before creating workflows) + - trigger: create-workflow workflow: "{project-root}/{bmad_folder}/autominator/workflows/create-workflow/workflow.yaml" description: Create new n8n workflow from scratch based on requirements diff --git a/src/modules/autominator/workflows/create-workflow/workflow.yaml b/src/modules/autominator/workflows/create-workflow/workflow.yaml index 4bc06600..6c0c95c5 100644 --- a/src/modules/autominator/workflows/create-workflow/workflow.yaml +++ b/src/modules/autominator/workflows/create-workflow/workflow.yaml @@ -2,6 +2,15 @@ name: create-workflow description: "Create new n8n workflow from scratch based on requirements" author: "Saif" +# Critical variables from config +config_source: "{project-root}/{bmad_folder}/autominator/config.yaml" +output_folder: "{config_source}:output_folder" +user_name: "{config_source}:user_name" +communication_language: "{config_source}:communication_language" +workflows_folder: "{config_source}:workflows_folder" +requirements_folder: "{config_source}:requirements_folder" +date: system-generated + # Workflow components installed_path: "{project-root}/{bmad_folder}/autominator/workflows/create-workflow" shared_path: "{project-root}/{bmad_folder}/autominator/workflows/_shared" @@ -15,16 +24,20 @@ platform_mappings: "{shared_path}/platform-mappings.yaml" # Variables variables: - workflow_type: "" # Will be elicited - trigger_type: "" # Will be elicited - integrations: [] # Will be elicited + requirements_file: "" # Will be discovered or elicited + workflow_type: "" # Will be loaded from requirements or elicited + trigger_type: "" # Will be loaded from requirements or elicited + integrations: [] # Will be loaded from requirements or elicited complexity: "" # Will be elicited error_handling: "" # Will be elicited - save_location: "" # Will be elicited - workflow_name: "" # Will be elicited - additional_requirements: "" # Will be elicited + workflow_name: "" # Will be loaded from requirements or elicited + problem_description: "" # Will be loaded from requirements + data_requirements: "" # Will be loaded from requirements + desired_outcome: "" # Will be loaded from requirements + conditional_logic: "" # Will be loaded from requirements + criticality: "" # Will be loaded from requirements -default_output_file: "{project-root}/workflows/workflow-{timestamp}.json" +default_output_file: "{workflows_folder}/{workflow_name}.json" standalone: true web_bundle: false