ComfyUI_ComfyAssistant

Install ComfyUI Assistant as a ComfyUI custom node. Use when performing or troubleshooting installation (clone, Python deps, frontend build, restart).

For complex user requests — evaluate, investigate, ask questions, propose a plan, accept modifications, then execute. Use when the request is multi-step, ambiguous, or high-impact.

Workflow execution and complete workflow generation tools (executeWorkflow, applyWorkflowJson). Use when the user wants to run a workflow or build a complete workflow from a description.

Python backend modules, chat request lifecycle, SSE format, and API endpoints

System prompt assembly from system_context, user_context, and environment sources

Generate a Product Requirements Document (PRD) for a new feature. Use when planning a feature, starting a new project, or when asked to create a PRD. Triggers on: create a prd, write prd for, plan this feature, requirements for, spec out.

When the user asks to create or design a skill, follow a clear process: clarify intent, draft name/description/instructions, then call createSkill. Optionally offer to create a skill when you automate a procedure they might want to reuse.

When the user asks to organize a workflow, read frontend JSON, reorganize for readability, apply in a new tab, and always validate with getWorkflowInfo. Run automatically without asking.

Guidelines for using graph tools (before adding nodes, connecting, setting widgets, error handling, multi-step operations).

How tools are declared on backend and frontend, and how to keep them in sync

Base graph tools (addNode, removeNode, connectNodes, getWorkflowInfo, setNodeWidgetValue, fillPromptNode). Use when modifying workflows or when the user asks about the canvas.

Project-specific guide for the chat UI -- components, terminal theme, message rendering, runtime setup

When and how to update project documentation. Use whenever you change architecture, patterns, features, or user-facing behavior; or when implementing a development phase.

Quick-reference summary of project conventions for fast agent consumption

Decision order and safety checks for user workflow requests to prevent hallucinated or invalid workflows.

Unified workflow template library (official and community). Use this as the primary starting point for any complex model request (Wan, Flux, SDXL, etc.).

High-level system map of ComfyUI Assistant -- read first to understand the project

Agentic tools system for ComfyUI interaction. Use when implementing tools, function calling, or enabling LLM-driven actions in ComfyUI workflows.

How the React extension wires into ComfyUI -- entry point, bottom panel, window.app access

Common ComfyUI node types and workflow patterns. Use when suggesting nodes or explaining workflows.

Web search, content extraction, and ComfyUI Registry lookup tools. Use when built-in knowledge is insufficient or the user needs external resources.

Use ComfyUI_examples as the first source of truth for complete workflows. Prefer extracting workflows from example images and validating nodes/models before applying.

Rules for choosing Load Diffusion Model vs CheckpointLoader based on where the model is installed (diffusion_models/unet vs checkpoints).

Environment scanning, caching, and model discovery for installed nodes, packages, and models

Guidance for environment awareness, search, and skill creation tools