From e9efbc461634504b83d4142237e7e738461655de Mon Sep 17 00:00:00 2001
From: Morpheus <morpheus@git.dumas.ddns.net>
Date: Sat, 8 Aug 2026 21:30:07 +0000
Subject: [PATCH] Add optimized workflow section

---
 README.md                               | 31 +++++++++++++++++
 optimized/README.md                     | 44 +++++++++++++++++++++++++
 optimized/image-edit/README.md          |  3 ++
 optimized/image-to-video/README.md      |  3 ++
 optimized/text-to-image/README.md       |  3 ++
 optimized/text-to-video/README.md       |  3 ++
 optimized/upscale-restoration/README.md |  3 ++
 7 files changed, 90 insertions(+)
 create mode 100644 optimized/README.md
 create mode 100644 optimized/image-edit/README.md
 create mode 100644 optimized/image-to-video/README.md
 create mode 100644 optimized/text-to-image/README.md
 create mode 100644 optimized/text-to-video/README.md
 create mode 100644 optimized/upscale-restoration/README.md

diff --git a/README.md b/README.md
index a040546..5386f2d 100644
--- a/README.md
+++ b/README.md
@@ -8,6 +8,7 @@ Model-organized workflow library for local ComfyUI use.
 - `models/ltx/` - LTX workflows and notes
 - `models/flux2klein/` - FLUX.2-klein workflows and notes
 - `models/minimax/` - MiniMax workflows and notes
+- `optimized/` - maintained category masters built from collected workflows
 - `models/_incoming/` - temporary holding area when a workflow is still being classified
 - `templates/workflow-template/` - starter folder for new workflow imports
 
@@ -27,6 +28,10 @@ Example:
 
 `models/ltx/first-frame-character-lock/`
 
+Optimized workflows live under:
+
+`optimized/<category>/<family>-master/`
+
 ## Conventions
 
 - Organize primarily by model family.
@@ -43,3 +48,29 @@ Example:
 - `minimax`
 
 More model families can be added later as needed.
+
+## Optimized layer
+
+The `optimized/` section is the maintained layer for cleaned-up "best current" workflows by category.
+
+These are not raw imports. They are intended to become:
+
+- better organized
+- better documented
+- stripped of junk or dead branches
+- updated when stronger ideas appear in newly collected workflows
+
+Expected categories:
+
+- `text-to-image`
+- `image-edit`
+- `image-to-video`
+- `text-to-video`
+- `upscale-restoration`
+
+Each optimized workflow should explain:
+
+- what source workflows informed it
+- what changes were made
+- why those changes were chosen
+- what still needs real-world testing
diff --git a/optimized/README.md b/optimized/README.md
new file mode 100644
index 0000000..2209a60
--- /dev/null
+++ b/optimized/README.md
@@ -0,0 +1,44 @@
+# Optimized Workflows
+
+This section is the maintained layer for "best current" master workflows.
+
+The `models/` tree stores collected originals and community finds.
+
+The `optimized/` tree stores the cleaned-up workflows built from analyzing what we have collected.
+
+## Purpose
+
+These workflows are intended to become the practical default choices for each category after comparing:
+
+- official workflows
+- community workflows
+- custom-node variants
+- model-specific optimizations
+- quality vs speed tradeoffs
+
+## Categories
+
+- `text-to-image/`
+- `image-edit/`
+- `image-to-video/`
+- `text-to-video/`
+- `upscale-restoration/`
+
+## Workflow format
+
+Each optimized workflow should have its own folder and usually include:
+
+- `workflow.json` or another portable Comfy workflow asset
+- `README.md`
+- optional notes, screenshots, or benchmark artifacts
+
+## Update policy
+
+This section is reviewed on a Sunday-evening cadence.
+
+The weekly review should:
+
+- inspect newly collected workflows
+- decide whether a category master should be created or updated
+- document what changed and why
+- commit and push changes before reporting back
diff --git a/optimized/image-edit/README.md b/optimized/image-edit/README.md
new file mode 100644
index 0000000..5b84311
--- /dev/null
+++ b/optimized/image-edit/README.md
@@ -0,0 +1,3 @@
+# Image Edit Masters
+
+Home for maintained category masters focused on image editing, inpainting, outpainting, and reference-driven edits.
diff --git a/optimized/image-to-video/README.md b/optimized/image-to-video/README.md
new file mode 100644
index 0000000..f2f6bca
--- /dev/null
+++ b/optimized/image-to-video/README.md
@@ -0,0 +1,3 @@
+# Image-to-Video Masters
+
+Home for maintained category masters focused on image-to-video generation.
diff --git a/optimized/text-to-image/README.md b/optimized/text-to-image/README.md
new file mode 100644
index 0000000..885ba64
--- /dev/null
+++ b/optimized/text-to-image/README.md
@@ -0,0 +1,3 @@
+# Text-to-Image Masters
+
+Home for maintained category masters focused on text-to-image generation.
diff --git a/optimized/text-to-video/README.md b/optimized/text-to-video/README.md
new file mode 100644
index 0000000..74f1d6b
--- /dev/null
+++ b/optimized/text-to-video/README.md
@@ -0,0 +1,3 @@
+# Text-to-Video Masters
+
+Home for maintained category masters focused on text-to-video generation.
diff --git a/optimized/upscale-restoration/README.md b/optimized/upscale-restoration/README.md
new file mode 100644
index 0000000..1bc9edf
--- /dev/null
+++ b/optimized/upscale-restoration/README.md
@@ -0,0 +1,3 @@
+# Upscale and Restoration Masters
+
+Home for maintained category masters focused on upscaling, restoration, relighting, and detail recovery.