From 719140cde3a3d5028b33d9f2ae4e0f5a656c3581 Mon Sep 17 00:00:00 2001 From: Morpheus Date: Sun, 9 Aug 2026 08:48:30 +0000 Subject: [PATCH] Document ComfyUI workflow run records --- README.md | 4 +++- optimized/README.md | 3 ++- optimized/image-edit/README.md | 22 +++++++++++++++++++ .../flux2klein-9b-fp8-edit-master/README.md | 22 +++++++++++++++++++ .../zimage-turbo-3070-inpaint-start/README.md | 22 +++++++++++++++++++ optimized/notes/process.md | 1 + templates/workflow-template/README.md | 21 ++++++++++++++++++ 7 files changed, 93 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 5386f2d..db2f9e3 100644 --- a/README.md +++ b/README.md @@ -17,7 +17,7 @@ Model-organized workflow library for local ComfyUI use. Each workflow gets its own folder so it can carry: - `workflow.json` - the actual ComfyUI workflow file -- `README.md` - what it does, source link, model/version notes, required custom nodes, and any setup quirks +- `README.md` - what it does, source link, model/version notes, required custom nodes, setup quirks, and a record of meaningful workflow parameters and changes - optional supporting files such as screenshots, example prompts, or helper notes Suggested path pattern: @@ -39,6 +39,7 @@ Optimized workflows live under: - Keep source links in each workflow README. - Note whether the workflow is `tested`, `imported-only`, or `needs-fixes`. - Record required custom nodes so the workflow is easier to revive later. +- Record the important generation and edit settings whenever a workflow is tuned or promoted: positive prompt, negative prompt, CFG, steps, sampler, scheduler, seed, denoise, resolution, model, VAE, LoRAs, ControlNets, and node-level changes that materially affect output. ## Initial model families @@ -74,3 +75,4 @@ Each optimized workflow should explain: - what changes were made - why those changes were chosen - what still needs real-world testing +- what run settings or node parameters define the current behavior diff --git a/optimized/README.md b/optimized/README.md index 3ebd700..51697da 100644 --- a/optimized/README.md +++ b/optimized/README.md @@ -39,7 +39,7 @@ These workflows are intended to become the practical default choices for each ca Each optimized workflow should have its own folder and usually include: - `workflow.json` or another portable Comfy workflow asset -- `README.md` +- `README.md` with a compact record of the parameters and graph changes that define the current master - optional notes, screenshots, or benchmark artifacts ## Notes layer @@ -62,4 +62,5 @@ The weekly review should: - inspect newly collected workflows - decide whether a category master should be created or updated - document what changed and why +- document the workflow settings that actually changed, especially prompt, negative prompt, CFG, steps, sampler, scheduler, seed, denoise, resolution, model swaps, LoRA weights, ControlNet wiring, and any node removals or additions - commit and push changes before reporting back diff --git a/optimized/image-edit/README.md b/optimized/image-edit/README.md index 1553311..0fe397e 100644 --- a/optimized/image-edit/README.md +++ b/optimized/image-edit/README.md @@ -6,3 +6,25 @@ Home for maintained category masters focused on image editing, inpainting, outpa - `zimage-turbo-3070-inpaint-start` - `flux2klein-9b-fp8-edit-master` + +## README rule + +Every image-edit master README should carry a compact run record for meaningful tuning changes. + +Minimum fields to record: + +- positive prompt +- negative prompt +- CFG +- steps +- sampler +- scheduler +- seed +- denoise +- resolution +- checkpoint / model +- VAE +- LoRAs +- ControlNets or other guidance nodes +- mask or inpaint settings +- node-level graph changes diff --git a/optimized/image-edit/flux2klein-9b-fp8-edit-master/README.md b/optimized/image-edit/flux2klein-9b-fp8-edit-master/README.md index 8b85f93..821a436 100644 --- a/optimized/image-edit/flux2klein-9b-fp8-edit-master/README.md +++ b/optimized/image-edit/flux2klein-9b-fp8-edit-master/README.md @@ -39,6 +39,28 @@ This is built from the official `9B distilled` template because it matches your - extra custom-node edits with unclear payoff - a fake outpainting claim before we prove it on your machine +## Change Record + +Fill this out whenever the master is materially updated so we can see exactly what changed, not just that something changed. + +- Positive prompt: not recorded yet +- Negative prompt: not recorded yet +- CFG: not recorded yet +- Steps: not recorded yet +- Sampler: not recorded yet +- Scheduler: not recorded yet +- Seed: not recorded yet +- Denoise: not recorded yet +- Resolution: not recorded yet +- Checkpoint / model: `models/diffusion_models/flux-2-klein-9b-fp8.safetensors` +- VAE: `models/vae/flux2-vae.safetensors` +- Text encoder(s): `models/text_encoders/qwen_3_8b_fp8mixed.safetensors` +- LoRAs: none recorded yet +- ControlNets / guidance nodes: none recorded yet +- Masks / inpaint settings: not recorded yet +- Node-level graph changes: stayed on the official `9B distilled` template route; no extra community graph surgery recorded yet +- Why this change was made: keep the master aligned with your `9B fp8` preference while staying more practical than the heavier base route + ## Required models - `models/diffusion_models/flux-2-klein-9b-fp8.safetensors` diff --git a/optimized/image-edit/zimage-turbo-3070-inpaint-start/README.md b/optimized/image-edit/zimage-turbo-3070-inpaint-start/README.md index 3ff248d..f07d231 100644 --- a/optimized/image-edit/zimage-turbo-3070-inpaint-start/README.md +++ b/optimized/image-edit/zimage-turbo-3070-inpaint-start/README.md @@ -37,6 +37,28 @@ This master is a curated hold of the community inpainting workflow because it gi - any manual sampler surgery before real testing - any claim that this is better than `FLUX.2-klein` for edits +## Change Record + +Fill this out whenever the master is materially updated so we can see exactly what changed, not just that something changed. + +- Positive prompt: not recorded yet +- Negative prompt: not recorded yet +- CFG: not recorded yet +- Steps: not recorded yet +- Sampler: community inpaint sampler path retained; exact values not recorded yet +- Scheduler: not recorded yet +- Seed: not recorded yet +- Denoise: not recorded yet +- Resolution: not recorded yet +- Checkpoint / model: `models/diffusion_models/z_image_turbo_bf16.safetensors` +- VAE: `models/vae/ae.safetensors` +- Text encoder(s): `models/text_encoders/qwen_3_4b.safetensors` +- LoRAs: none recorded yet +- ControlNets / guidance nodes: `ZImageFunControlnet` +- Masks / inpaint settings: inpainting-focused graph retained; exact mask settings not recorded yet +- Node-level graph changes: held the community inpainting graph shape with `LanPaint_KSampler` and `ZImageFunControlnet`; no manual sampler surgery recorded yet +- Why this change was made: keep a plausible real edit path on a `3070` without prematurely bloating the graph + ## Required models - `models/text_encoders/qwen_3_4b.safetensors` diff --git a/optimized/notes/process.md b/optimized/notes/process.md index 5fc21cb..6f8f583 100644 --- a/optimized/notes/process.md +++ b/optimized/notes/process.md @@ -33,3 +33,4 @@ - What was removed - What was kept - What still needs Monday testing +- The parameter-level change record for any promoted workflow: positive prompt, negative prompt, CFG, steps, sampler, scheduler, seed, denoise, resolution, checkpoint/model path, VAE, LoRAs, ControlNets, and any meaningful node rewiring diff --git a/templates/workflow-template/README.md b/templates/workflow-template/README.md index dbe949b..73f0ec6 100644 --- a/templates/workflow-template/README.md +++ b/templates/workflow-template/README.md @@ -33,3 +33,24 @@ Short plain-English description of what the workflow does. - known issues - prompt tips - model / LoRA versions used + +## Run Record + +Use this section whenever the workflow is tuned, promoted, or meaningfully changed so we keep a real audit trail instead of vague prose. + +- Positive prompt: +- Negative prompt: +- CFG: +- Steps: +- Sampler: +- Scheduler: +- Seed: +- Denoise: +- Resolution: +- Checkpoint / model: +- VAE: +- LoRAs: +- ControlNets / guidance nodes: +- Masks / inpaint settings: +- Node-level graph changes: +- Why this change was made: