arkaos 2.15.0 → 2.16.0

package/VERSION

@@ -1 +1 @@
-2.15.0
+2.16.0

package/arka/SKILL.md

@@ -138,3 +138,16 @@ All department output saved to the Obsidian vault:
 - Wikilinks for cross-references
 - Department-specific output paths
 - MOC (Map of Content) for organization
+
+## Model Selection
+
+When dispatching subagent work via the Task tool, include the `model` parameter from the target agent's YAML `model:` field:
+
+- Agent YAMLs at `departments/*/agents/*.yaml` have `model: opus | sonnet | haiku`
+- Quality Gate dispatch (Marta/Eduardo/Francisca) ALWAYS uses `model: opus` — NON-NEGOTIABLE
+- Default to `sonnet` if the agent YAML has no `model` field
+- Mechanical tasks (commit messages, routing, keyword extraction) use `model: haiku`
+
+Example Task tool call:
+
+    Task(description="...", subagent_type="general-purpose", model="sonnet", prompt="...")

package/arka/skills/comfyui/SKILL.md

@@ -0,0 +1,82 @@
+---
+name: arka-comfyui
+description: >
+  ComfyUI ecosystem orchestrator. Two specialized squads: ComfyUI Core (workflow engineering,
+  custom nodes research, model discovery, pipeline optimization, API automation) and
+  Hollywood Cinematographic Production (directing, cinematography, color grading, VFX,
+  sound design, editing, motion graphics). Manages 2 projects: purz-comfyui-workflows
+  (production-ready workflow collection) and lora_tester (LoRA batch testing toolkit).
+  Full AI video production pipeline from concept to final cut.
+  Use when user says "comfyui", "comfy", "workflow", "video production", "cinematography",
+  "generate video", "text to video", "image to video", or wants to work with ComfyUI.
+---
+
+# ComfyUI Ecosystem Orchestrator — ARKA OS
+
+Full-spectrum AI media production platform. From ComfyUI node engineering to Hollywood-grade cinematographic output.
+
+## Ecosystem Overview
+
+| Project | Type | Stack | Path |
+|---------|------|-------|------|
+| **purz-comfyui-workflows** | Workflow Collection | ComfyUI JSON (7 workflows, 110+ nodes) | `/Users/andreagroferreira/AIProjects/purz-comfyui-workflows` |
+| **lora_tester** | CLI Tool + Gallery | Python 3.8+ (stdlib) + Vanilla HTML/JS | `/Users/andreagroferreira/AIProjects/lora_tester` |
+
+## Squads (summary)
+
+| Squad | Purpose | Members |
+|-------|---------|---------|
+| **ComfyUI Core** | Technical engine: workflow JSON, custom nodes, models, VRAM, API automation | Viktor (Pipeline Architect), Kaito (Workflow Engineer), Iris (Node Researcher), Atlas (Model Specialist), Nexus (Automation Engineer), Pixel (QA Tester) |
+| **Cinematographic Production** | Hollywood pipeline: direction, DP, art, VFX, color, edit, sound, motion, production | Roman (Director), Lena (DP), Soren (Screenwriter), Mika (Art Director), Orion (VFX), Celeste (Colorist), Raven (Editor), Echo (Sound Designer), Flux (Motion Graphics), Sterling (Producer) |
+
+Full role definitions, agent types, and competencies: `references/squads.md`.
+
+## Commands
+
+### General
+
+| Command | Description |
+|---------|-------------|
+| `/comfyui <description>` | Describe what you need — orchestrator routes to correct squad |
+| `/comfyui status` | Status of all ComfyUI projects + server availability |
+| `/comfyui context` | Full ecosystem context (workflows, models, capabilities) |
+
+### ComfyUI Core
+
+| Command | Description |
+|---------|-------------|
+| `/comfyui workflow create\|edit\|list\|test` | Design, modify, list, or test workflows |
+| `/comfyui node research <topic>` | Research custom nodes |
+| `/comfyui model research\|list` | Research or query models (checkpoints, LoRAs, VAEs, ControlNets) |
+| `/comfyui lora test` | Delegate to /lora-tester |
+| `/comfyui optimize <workflow>` | VRAM/speed optimization |
+| `/comfyui api <task>` | API automation |
+| `/comfyui install <nodes>` | Guide custom node installation |
+
+### Cinematographic Production
+
+| Command | Description |
+|---------|-------------|
+| `/comfyui produce <concept>` | Full pipeline: concept → script → storyboard → generate → edit → deliver |
+| `/comfyui direct\|shoot\|grade\|edit\|vfx\|sound\|motion` | Single-stage production commands |
+| `/comfyui storyboard\|lookdev` | Pre-production: storyboard, visual style development |
+
+### Pipelines
+
+| Command | Description |
+|---------|-------------|
+| `/comfyui pipeline t2v\|i2v\|a2v` | Text/Image/Audio-to-Video (LTX-2 / SVD) |
+| `/comfyui pipeline upscale\|interpolate\|mask` | Upscale, frame interpolation, subject/bg replacement |
+
+## Orchestration Workflow
+
+Every `/comfyui` request follows a 6-phase flow: (1) context loading, (2) analysis & planning with squad routing, (3) plan presentation & approval gate, (4) execution with worktree isolation, (5) mandatory Quality Gate (Marta/Eduardo/Francisca), (6) documentation & report.
+
+Squad routing: technical → Core; creative production → Cinematographic; full production → both, coordinated by Producer Sterling; research → Iris or Atlas.
+
+**See `references/workflows.md`** for full phase templates (plan, report), workflows catalogue (LTX-2 T2V/I2V/Audio, SVD, AnimateDiff), model registry, cinematic prompt engineering guide, ComfyUI API reference, status command, `/comfyui produce` pipeline, custom node research protocol, and Obsidian output structure.
+
+## References
+
+- `references/squads.md` — Full Core and Cinematographic squad role tables, agent types, core competencies
+- `references/workflows.md` — Phase templates, workflow catalogue, model registry, API reference, prompt engineering guide, Obsidian output

package/arka/skills/comfyui/references/squads.md

@@ -0,0 +1,80 @@
+# arka-comfyui — squads
+
+Referenced from SKILL.md. Read only when needed.
+
+## Architecture
+
+```
+                        ARKA OS /comfyui Orchestrator
+                                    |
+                    +---------------+---------------+
+                    |                               |
+            ComfyUI Core Squad              Cinematographic Squad
+            (Technical Engine)              (Creative Production)
+                    |                               |
+        +-----------+-----------+           +-------+-------+
+        |           |           |           |       |       |
+   Workflows    Research    Automation   Pre-Prod  Prod  Post-Prod
+        |           |           |           |       |       |
+   purz-comfyui  Custom     lora_tester  Script  Shoot   Edit
+   -workflows    Nodes      (batch test) Board   Direct  Grade
+        |           |           |         Story   Light   VFX
+        v           v           v         Art     Comp    Sound
+   ComfyUI Server (localhost:8188)                Motion
+        |
+        +-- POST /prompt (queue)
+        +-- GET /history (poll)
+        +-- GET /view (download)
+        +-- GET /object_info (discover)
+```
+
+## SQUAD 1 — ComfyUI Core (Technical Engine)
+
+The engineering backbone. These specialists know every node, every model, every optimization trick.
+
+| Role | Agent Type | Name | Specialty |
+|------|-----------|------|-----------|
+| **Pipeline Architect** | `architect` | Viktor | Workflow design, node graph architecture, data flow optimization, multi-pass pipelines |
+| **Workflow Engineer** | `backend-dev` | Kaito | JSON workflow construction, API-format conversion, conditional node logic, batch orchestration |
+| **Node Researcher** | `research-analyst` | Iris | Custom node discovery (ComfyUI Manager, GitHub), new model evaluation, capability mapping |
+| **Model Specialist** | `research-analyst` | Atlas | Checkpoint/LoRA/VAE/ControlNet selection, quantization (FP8/FP4), VRAM optimization |
+| **Automation Engineer** | `backend-dev` | Nexus | Python scripting, ComfyUI API automation, batch generation, queue management, manifest tracking |
+| **QA Tester** | `qa-eng` | Pixel | Output quality validation, A/B comparison, artifact detection, performance benchmarking |
+
+**Core Competencies:**
+- Workflow JSON engineering (API format, node IDs, connections)
+- Custom node ecosystem (ComfyUI Manager, 2000+ community nodes)
+- Model landscape (Stability AI, Lightricks LTX, Runway, Black Forest Labs)
+- Memory optimization (chunked inference, tiled decoding, model offloading)
+- Multi-pass pipelines (low-res draft -> upscale -> high-res refine)
+- LoRA training evaluation and strength testing
+- ControlNet/IP-Adapter/SAM integration
+- Video frame interpolation (FILM, GMFSS, RIFE)
+
+## SQUAD 2 — Cinematographic Production (Hollywood Level)
+
+Full film production pipeline — from concept to final deliverable. Every role mirrors a real Hollywood department.
+
+| Role | Agent Type | Name | Specialty |
+|------|-----------|------|-----------|
+| **Director** | `brand-director` | Roman | Creative vision, shot composition, narrative flow, pacing, emotional arc, final cut authority |
+| **Cinematographer (DP)** | `visual-designer` | Lena | Camera movement (dolly, crane, steadicam), lighting design, depth of field, aspect ratios, lens selection |
+| **Screenwriter** | `content-marketer` | Soren | Prompt engineering as screenwriting, scene descriptions, dialogue, narrative structure, beat sheets |
+| **Art Director** | `visual-designer` | Mika | Visual style, color palette, production design, set dressing, period accuracy, world-building |
+| **VFX Supervisor** | `frontend-dev` | Orion | Compositing, masking, subject/background replacement, particle effects, environment extension |
+| **Colorist** | `visual-designer` | Celeste | Color grading, LUT design, mood through color, scene-to-scene continuity, final look |
+| **Editor** | `visual-designer` | Raven | Pacing, rhythm, cut timing, montage, transitions, assembly to final cut, export settings |
+| **Sound Designer** | `content-marketer` | Echo | Audio-to-video sync, soundscape design, music selection, audio separation, ambient design |
+| **Motion Graphics Artist** | `visual-designer` | Flux | Title sequences, lower thirds, kinetic typography, logo animation, UI/HUD overlays |
+| **Producer** | `tech-lead` | Sterling | Budget (compute/VRAM), scheduling, resource allocation, pipeline coordination, delivery |
+
+**Core Competencies:**
+- Cinematic prompt engineering (lens, lighting, movement vocabulary)
+- Shot type vocabulary (ECU, CU, MS, WS, EWS, OTS, POV, bird's eye, Dutch angle)
+- Camera movement lexicon (dolly in/out, truck, pan, tilt, crane, Steadicam, handheld, zoom)
+- Lighting design (three-point, Rembrandt, butterfly, split, rim, practical, motivated)
+- Color theory and grading (warm/cool, complementary, analogous, monochromatic, teal-orange)
+- Aspect ratios and their emotional impact (2.39:1 anamorphic, 1.85:1, 16:9, 4:3, 1:1)
+- Frame rate and motion (24fps cinematic, 30fps broadcast, 60fps smooth, 120fps slo-mo)
+- Audio-visual synchronization and rhythm
+- Export codecs and delivery specs (H.264, H.265, ProRes, DNxHR, CRF values)

package/arka/skills/comfyui/references/workflows.md

@@ -0,0 +1,435 @@
+# arka-comfyui — workflows
+
+Referenced from SKILL.md. Read only when needed.
+
+## Orchestration Workflow
+
+For EVERY `/comfyui` request, follow this workflow:
+
+### Phase 1 — Context Loading
+1. Read ComfyUI skill reference: `/Users/andreagroferreira/AIProjects/lora_tester/.claude/skills/comfy_local/skill.md`
+2. Check available workflows: `ls /Users/andreagroferreira/AIProjects/purz-comfyui-workflows/`
+3. Check ComfyUI server: `curl -s http://localhost:8188/system_stats 2>/dev/null`
+4. Load project context for affected repos
+5. Identify which squad(s) the request needs
+
+### Phase 2 — Analysis & Planning
+
+**Before planning, verify context:**
+- Restate the request to confirm understanding
+- Ask at least 1 clarifying question about scope or intent
+- Challenge at least 1 assumption (devil's advocate)
+- Check memory/knowledge base for prior related work
+
+**Squad routing logic:**
+- Technical workflow requests -> ComfyUI Core Squad
+- Creative production requests -> Cinematographic Squad (with Core support)
+- Full production pipeline -> Both squads coordinated by Producer (Sterling)
+- Research requests -> Node Researcher (Iris) or Model Specialist (Atlas)
+
+1. Analyze the request and route to correct squad(s)
+2. Determine which roles are needed
+3. Create execution plan with:
+   - **Squad(s) involved** (Core, Cinematographic, or both)
+   - **Roles assigned** (which agents)
+   - **Pipeline stages** (pre-prod, production, post-prod)
+   - **Technical requirements** (models, nodes, VRAM, resolution)
+   - **Deliverables** (files, formats, specs)
+
+### Phase 3 — Plan Presentation & Approval
+
+```
+--- COMFYUI — Production Plan ---
+
+REQUEST: [summary]
+
+SQUAD ASSIGNMENT:
+  Core: [roles involved]
+  Cinematographic: [roles involved]
+
+PIPELINE:
+  1. [stage] — [role] — [deliverable]
+  2. [stage] — [role] — [deliverable]
+  ...
+
+TECHNICAL REQUIREMENTS:
+  - Models: [list]
+  - Nodes: [custom nodes needed]
+  - Resolution: [WxH]
+  - Frames: [count]
+  - VRAM estimate: [GB]
+
+DELIVERABLES:
+  - [format, resolution, codec, duration]
+
+CONSIDERATIONS:
+  - [risk/note]
+
+---------------------------------
+```
+
+Ask for user approval: "Approve plan and proceed?"
+
+### Phase 4 — Execution
+1. Only proceed after approval
+2. Use worktree isolation for code changes (NON-NEGOTIABLE)
+3. Squad roles execute in their domain
+4. Producer (Sterling) coordinates cross-squad handoffs
+
+### Phase 5: Quality Gate (NON-NEGOTIABLE)
+
+Before any output reaches the user:
+- **Marta** (CQO) orchestrates the review
+- **Eduardo** (Copy Director) reviews all text output
+- **Francisca** (Tech/UX Director) reviews all code and technical output
+
+**Verdict:** APPROVED or REJECTED. No exceptions.
+
+### Phase 6 — Documentation & Report
+
+```
+--- COMFYUI — Production Report ---
+
+COMPLETED:
+  - [deliverables produced]
+
+TECHNICAL:
+  - Workflow: [name]
+  - Models used: [list]
+  - Resolution: [WxH] | Frames: [N] | FPS: [N]
+  - Generation time: [estimate]
+
+FILES:
+  - [outputs and locations]
+
+-----------------------------------
+```
+
+## Available Workflows Reference
+
+### LTX-2 Text-to-Video (ltx2-t2v-lora)
+| Property | Value |
+|----------|-------|
+| Resolution | 1280x720 |
+| Frames | 48 (configurable, must be divisible by 8+1) |
+| Model | ltx-2-19b-dev-fp8 |
+| Text Encoder | Gemma 3 12B (FP4/FP8/Full) |
+| LoRA Support | Yes (camera control, style) |
+| Key Nodes | LTX2_NAG, LTXVConditioning, KSampler |
+| Output | H.264 MP4, CRF 13, 24fps |
+
+### LTX-2 Image-to-Video (ltx2-i2v-lora)
+| Property | Value |
+|----------|-------|
+| Resolution | Input image resolution |
+| Frames | 48 |
+| Model | ltx-2-19b-dev-fp8 |
+| Key Feature | First-frame conditioning |
+| Key Nodes | LTXVImgToVideoInplaceKJ, LTX2_NAG |
+| Output | H.264 MP4 |
+
+### LTX-2 Audio-to-Video (ltx2-audio_to_video_extension_5x)
+| Property | Value |
+|----------|-------|
+| Feature | Separate audio + video VAE encoding |
+| Upscaling | 5x spatial upscaler |
+| Chunked Inference | 4 chunks, 4096 tokens |
+| Audio Processing | FL_Audio_Separation, audio crop, vocoder |
+| Key Nodes | LTXVAudioVAEEncode/Decode, LTXVSeparateAVLatent |
+| Output | H.264 MP4 with audio |
+
+### SVD Simple (svd-simple)
+| Property | Value |
+|----------|-------|
+| Resolution | 576x1024 |
+| Frames | 14 + 2x interpolation = 27 |
+| Model | svd.safetensors |
+| Key Feature | Simple image-to-video |
+| Interpolation | FILM VFI |
+| Output | H.264 MP4 |
+
+### SVD CLIP Extension 8x (svd-clip-extension-8x)
+| Property | Value |
+|----------|-------|
+| Resolution | 576x1024 |
+| Frames | 14 base + 8x interpolation |
+| Model | svd.safetensors + CLIP Vision |
+| Interpolation | GMFSS Fortuna (8x) |
+| Output | H.264 MP4, high frame count |
+
+### AnimateDiff Subject Replacement
+| Property | Value |
+|----------|-------|
+| Model | deliberate_v3 (SD 1.5) |
+| Segmentation | SAM + YOLOv8 person detection |
+| Control | ControlNet inpaint + openpose |
+| IP-Adapter | ip-adapter-plus_sd15 |
+| Use Case | Replace subject in video while preserving motion |
+
+### AnimateDiff Background Replacement
+| Property | Value |
+|----------|-------|
+| Model | deliberate_v3 (SD 1.5) |
+| Segmentation | SAM + YOLOv8 |
+| Control | ControlNet inpaint |
+| Use Case | Replace background while preserving subject |
+
+## Model Registry
+
+### Checkpoints
+| Model | Type | Size | Use Case |
+|-------|------|------|----------|
+| ltx-2-19b-dev-fp8 | LTX-2 | ~10GB | Primary T2V/I2V |
+| ltx-2-19b-distilled-fp8 | LTX-2 Distilled | ~10GB | Faster generation |
+| deliberate_v3 | SD 1.5 | ~2GB | AnimateDiff base |
+| svd | SVD | ~4GB | Image-to-video |
+
+### Text Encoders
+| Model | Precision | VRAM |
+|-------|-----------|------|
+| gemma_3_12B_it | Full | ~24GB |
+| gemma_3_12B_it_fp8_scaled | FP8 | ~12GB |
+| gemma_3_12B_it_fp4_mixed | FP4 | ~6GB |
+
+### LoRAs
+| LoRA | Purpose |
+|------|---------|
+| ltx-2-19b-distilled-lora-384 | Quality boost for distilled model |
+| ltx-2-19b-lora-camera-control-dolly-left | Camera dolly movement |
+| DoubleDolly_lora_weights | Double dolly camera effect |
+| ltx2-cakeify-v2 | Style transfer (cakeify) |
+| lcm-sd15-lora | LCM acceleration for SD 1.5 |
+| temporaldiff-v1-animatediff | Temporal consistency |
+
+### Interpolation Models
+| Model | Multiplier | Quality |
+|-------|-----------|---------|
+| FILM VFI (film_net_fp32) | 2x | High |
+| GMFSS Fortuna | 2x-8x | Very high |
+
+## Cinematic Prompt Engineering Guide
+
+The Screenwriter (Soren) and Director (Roman) use structured prompt engineering:
+
+### Shot Type Vocabulary
+```
+ECU  — Extreme Close-Up (eyes, details)
+CU   — Close-Up (face fills frame)
+MCU  — Medium Close-Up (head + shoulders)
+MS   — Medium Shot (waist up)
+MWS  — Medium Wide Shot (knees up)
+WS   — Wide Shot (full body + environment)
+EWS  — Extreme Wide Shot (landscape dominates)
+OTS  — Over-the-Shoulder
+POV  — Point of View
+```
+
+### Camera Movement Vocabulary
+```
+dolly in/out    — Camera moves toward/away from subject
+truck L/R       — Camera moves laterally
+pan L/R         — Camera pivots horizontally (stationary)
+tilt up/down    — Camera pivots vertically (stationary)
+crane up/down   — Camera rises/lowers vertically
+Steadicam       — Smooth handheld tracking
+handheld        — Organic, documentary feel
+zoom in/out     — Lens zoom (not camera movement)
+rack focus      — Shift focus between planes
+push in         — Slow dolly in for emphasis
+```
+
+### Lighting Vocabulary
+```
+three-point         — Key + fill + back (standard)
+Rembrandt           — Triangle shadow on cheek
+butterfly/Paramount — Shadow under nose
+split               — Half face lit, half shadow
+rim/edge            — Backlight outlining subject
+practical           — Visible light sources in scene
+motivated           — Light justified by scene elements
+golden hour         — Warm, low-angle natural light
+blue hour           — Cool, pre-dawn/post-sunset
+chiaroscuro         — Extreme contrast (Caravaggio)
+```
+
+### Prompt Structure for Cinematic Output
+```
+[Shot type], [camera movement], [subject description],
+[lighting], [color palette], [mood/atmosphere],
+[lens/focal length], [aspect ratio reference],
+[film stock/look reference], [time of day]
+```
+
+**Example:**
+```
+Medium wide shot, slow dolly in, a lone figure walking through
+rain-soaked neon streets, Rembrandt lighting with cyan and magenta
+neon reflections, melancholic noir atmosphere, 35mm anamorphic lens,
+Kodak Vision3 500T film grain, late night
+```
+
+## ComfyUI API Reference
+
+### Core Endpoints
+| Endpoint | Method | Purpose |
+|----------|--------|---------|
+| `/prompt` | POST | Queue workflow: `{"prompt": {...}, "client_id": "..."}` |
+| `/history/{prompt_id}` | GET | Poll job status and results |
+| `/queue` | GET | Queue status (pending + running) |
+| `/view?filename=X&type=output` | GET | Download generated media |
+| `/object_info` | GET | All available nodes and their schemas |
+| `/object_info/{NodeType}` | GET | Specific node schema + available models |
+| `/system_stats` | GET | GPU memory, VRAM, compute stats |
+| `/upload/image` | POST | Upload input image (multipart) |
+| `/upload/mask` | POST | Upload mask image (multipart) |
+
+### Workflow JSON Format (API)
+```json
+{
+  "1": {
+    "class_type": "NodeType",
+    "inputs": {
+      "param": "value",
+      "connection": ["source_node_id", output_index]
+    }
+  }
+}
+```
+
+### Batch Generation Pattern
+```python
+# 1. Submit all jobs upfront (queue them)
+for job in jobs:
+    response = post("/prompt", {"prompt": workflow})
+    prompt_ids.append(response["prompt_id"])
+
+# 2. Single polling loop
+while pending:
+    for pid in pending:
+        history = get(f"/history/{pid}")
+        if pid in history:
+            download_outputs(history[pid])
+            pending.remove(pid)
+    time.sleep(3)
+```
+
+## /comfyui status
+
+```bash
+# Server status
+curl -s http://localhost:8188/system_stats 2>/dev/null
+
+# Project status
+cd /Users/andreagroferreira/AIProjects/purz-comfyui-workflows && git log --oneline -5
+cd /Users/andreagroferreira/AIProjects/lora_tester && git log --oneline -5
+```
+
+Present as:
+
+```
+--- COMFYUI ECOSYSTEM — Status ---
+
+SERVER: [online/offline] (localhost:8188)
+  GPU: [name] | VRAM: [total/used/free]
+
+PURZ-COMFYUI-WORKFLOWS
+  Branch: [branch]
+  Last commit: [hash] — [message]
+  Workflows: 7 (3 LTX-2, 2 SVD, 2 AnimateDiff)
+
+LORA_TESTER
+  Branch: [branch]
+  Last commit: [hash] — [message]
+  Components: CLI (252 lines) + Gallery (900 lines)
+
+SQUADS READY:
+  Core: Viktor, Kaito, Iris, Atlas, Nexus, Pixel (6)
+  Cinematographic: Roman, Lena, Soren, Mika, Orion,
+                   Celeste, Raven, Echo, Flux, Sterling (10)
+
+----------------------------------
+```
+
+## /comfyui produce — Full Production Pipeline
+
+The flagship command. Runs the complete Hollywood pipeline:
+
+```
+Phase 1: DEVELOPMENT (Screenwriter Soren + Director Roman)
+  - Concept analysis and creative brief
+  - Scene breakdown and beat sheet
+  - Prompt script (structured cinematic prompts)
+  - Shot list with camera/lighting specs
+
+Phase 2: PRE-PRODUCTION (Art Director Mika + Cinematographer Lena)
+  - Visual style development (lookdev)
+  - Color palette and mood board
+  - Storyboard (generated reference images)
+  - Technical specs (resolution, fps, codec)
+
+Phase 3: PRODUCTION (Pipeline Architect Viktor + Workflow Engineer Kaito)
+  - Workflow selection or creation
+  - Model and LoRA selection (Model Specialist Atlas)
+  - Generation execution via ComfyUI API
+  - Quality monitoring (QA Tester Pixel)
+
+Phase 4: POST-PRODUCTION
+  - VFX compositing (VFX Supervisor Orion)
+  - Color grading (Colorist Celeste)
+  - Sound design (Sound Designer Echo)
+  - Motion graphics (Motion Graphics Flux)
+  - Final edit and pacing (Editor Raven)
+
+Phase 5: DELIVERY (Producer Sterling)
+  - Export in requested format/codec
+  - Quality Gate review
+  - Documentation and handoff
+```
+
+## Custom Node Research Protocol
+
+When Iris (Node Researcher) investigates custom nodes:
+
+1. **ComfyUI Manager Registry** — Primary source for vetted nodes
+2. **GitHub search** — `comfyui custom node [capability]`
+3. **ComfyUI community** — Reddit r/comfyui, Discord, forums
+4. **Evaluation criteria:**
+   - Active maintenance (commits in last 3 months)
+   - Star count and community adoption
+   - Compatibility with current ComfyUI version
+   - VRAM requirements
+   - License compatibility
+   - Node conflicts with existing installation
+
+## Obsidian Output
+
+All documentation: `/Users/andreagroferreira/Documents/Personal/Projects/WizardingCode Internal/ComfyUI/`
+
+```
+WizardingCode Internal/ComfyUI/
+├── Home.md                    <- Ecosystem overview
+├── Workflows/
+│   ├── LTX-2 T2V.md
+│   ├── LTX-2 I2V.md
+│   ├── LTX-2 Audio.md
+│   ├── SVD Simple.md
+│   ├── SVD CLIP 8x.md
+│   ├── AnimateDiff Subject.md
+│   ├── AnimateDiff Background.md
+│   └── Custom/               <- User-created workflows
+├── Models/
+│   ├── Checkpoints.md
+│   ├── LoRAs.md
+│   ├── VAEs.md
+│   └── ControlNets.md
+├── Production/
+│   ├── Cinematic Prompt Guide.md
+│   ├── Shot Types.md
+│   ├── Camera Movement.md
+│   ├── Lighting Design.md
+│   └── Color Grading.md
+├── Research/
+│   ├── Custom Nodes.md
+│   └── New Models.md
+└── Projects/                  <- Production project logs
+```