Files
2nd/10_Wiki/Topics/Domain_Design/Comfyui/위키 Workflow JSON - ComfyUI 2026-05-20.md
T
Antigravity Agent c24165b8bc refactor(topics): 멀티 에이전트용 지식 재편 — _Common(공통 기본기) + Domain_* 구조
에이전트 8종(대화형/프로그래머 C·S/디자이너/설계자/기획자/QA/PD/PM)에게
[공통 기본 능력 + 롤별 Specialty] 2층으로 지식을 주입하기 위한 재분류.
문서 내용·포맷은 무수정, 폴더 이동만 (6,372개 문서 수 보존 확인).

- Topic_Programming → Domain_Programming (내부 구조 보존)
- Topic_Graphic → Domain_Design
- Topic_Business → Domain_Product
- Topic_General → Domain_General
- _Common 신설: Math(구 Topic_Math_Specialty), Reasoning(구 General/From_Thinking & Reasoning),
  Reasoning_Creativity(구 General/From_창의성), Communication(Poetic_Blog_Writing + From_writing)
- 타 도메인의 From_* 폴더는 유지 (출처 표기일 뿐, 이미 도메인에 맞게 분류된 문서)
- 빈 폴더 정리 (memory/procedures)
- 에이전트→폴더 매핑은 workspace의 .astra/agent-knowledge-map.json (9개 에이전트)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-11 11:05:56 +09:00

4.9 KiB

id, title, category, status, verification_status, canonical_id, aliases, duplicate_of, source_trust_level, confidence_score, created_at, updated_at, review_reason, merge_history, tags, raw_sources, applied_in, github_commit
id title category status verification_status canonical_id aliases duplicate_of source_trust_level confidence_score created_at updated_at review_reason merge_history tags raw_sources applied_in github_commit
workflow-json---comfyui Workflow JSON - ComfyUI 10_Wiki/Topics draft conceptual
B 0.8 2026-05-20 2026-05-20
web
wikify
https://docs.comfy.org/specs/workflow_json

Workflow JSON - ComfyUI

🎯 한 줄 통찰 (One-line insight)

ComfyUI의 워크플로우를 정의하기 위해 JSON Schema를 사용하여 구조화된 데이터를 생성하고 관리하는 규격서입니다.

🧠 핵심 개념 (Core concepts)

  • JSON Schema 기반 정의: Workflow JSONJSON Schema를 사용하여 정의되며, 변경 사항은 rfcs repo에서 논의됩니다.
  • ComfyWorkflow v1.0 구조: 워크플로우의 핵심 요소로 version, state, nodes를 필수적으로 포함합니다.
  • 노드 및 연결 구조: nodes, links, reroutes 등 노드의 위치, 크기, 입력/출력 핀(pins) 및 연결 상태를 정의하는 복잡한 객체 모델을 가집니다.
  • 상태 관리 (State): 마지막으로 사용된 그룹 ID, 노드 ID, 링크 ID 등을 포함하여 워크플로우의 연속성을 유지합니다.

🧩 추출된 패턴 (Extracted patterns)

  • 계층적 데이터 구조: nodes 내부에 inputs, outputs, properties, widgets_values와 같은 하위 객체를 두어 노드의 동작을 세부적으로 정의하는 패턴을 보입니다.
  • 좌표 및 경계 정의: groupsbounding이나 nodespos, size를 수치 배열 또는 객체 형태로 정의하여 UI 상의 위치를 결정합니다.
  • 관계형 연결 (Linking): links 객체를 통해 origin_idtarget_id 사이의 관계를 명시적으로 정의합니다.

📖 세부 내용 (Details)

1. Workflow JSON v1.0 주요 구성 요소

2. Nodes (노드) 상세 규격

  • 필수 속성: id, type, pos, size, flags, order, mode, properties가 반드시 포함되어야 합니다.
  • 입력 및 출력: inputsoutputs는 각각 이름, 타입, 슬롯 인덱스 정보를 포함하며, 노드 간의 데이터 흐름을 제어합니다.
  • 기타 속성: widgets_values, color, bgcolor 등을 통해 시각적 요소와 사용자 입력값을 관리합니다.
  • Links: id, origin_id, target_id, type 등을 포함하며 노드 간의 연결을 정의합니다.
  • Reroutes: id, pos, linkIds를 통해 연결 경로를 재지정하는 역할을 합니다.

4. 기타 데이터 구조

⚖️ 모동 및 업데이트 (Contradictions & updates)

  • 최신 버전 정보: 현재 최신 버전은 Version 1.0 (Latest)로 명시되어 있습니다.
  • 이전 버전 존재: Older versions에 대한 언급이 있으나, 구체적인 하위 버전의 상세 스키마는 본문에서 확인되지 않음 (단, 0.4 버전 관련 언급 있음).

🛠️ 적용 사례 (Applied in summary)

  • JSON Schema 검증: ComfyUI 워크플로우 파일이 규격에 맞게 작성되었는지 검증하는 도구로 활용될 수 있습니다.
  • 워크플로우 저장 및 공유: 노드, 링크, 그룹 정보를 JSON 형태로 직렬화하여 다른 사용자에게 전달하거나 재사용할 수 있습니다.

검증 상태 및 신뢰도

  • 상태: draft
  • 검증 단계: conceptual
  • 출처 신뢰도: B (Primary Source — 웹사이트 본문 직접 추출)
  • 중복 검사 결과: 신규 생성 (New discovery)
  • JSON Schema: 워크플로우 데이터의 구조를 정의하고 검증하는 표준 규격입니다.
  • ComfyUI Server: 워크플로가 실행되는 백엔드 환경과 관련된 개념입니다.
  • Node Definitions: 워크플로우 내 개별 노드의 동작과 속성을 정의하는 기초 정보입니다.
  • [[rfcs repo]: 스키마 변경 사항이 논의되는 공식적인 저장소입니다.

📝 변경 이력 (Change history)