From 4bd1d314d6d23c3b6eccc5e87dd3122e8d650d09 Mon Sep 17 00:00:00 2001
From: kflame99 <261674183+kflame99@users.noreply.github.com>
Date: Sun, 15 Feb 2026 09:21:52 +0000
Subject: [PATCH] Add project operating workflow and continuity docs

---
 DECISIONS.md | 19 +++++++++++++++++++
 TODO.md      | 20 ++++++++++++++++++++
 WORKFLOW.md  | 41 +++++++++++++++++++++++++++++++++++++++++
 WORKLOG.md   | 24 ++++++++++++++++++++++++
 4 files changed, 104 insertions(+)
 create mode 100644 DECISIONS.md
 create mode 100644 TODO.md
 create mode 100644 WORKFLOW.md
 create mode 100644 WORKLOG.md

diff --git a/DECISIONS.md b/DECISIONS.md
new file mode 100644
index 0000000..3ab3a8e
--- /dev/null
+++ b/DECISIONS.md
@@ -0,0 +1,19 @@
+# DECISIONS
+
+## 2026-02-15 — Profile-first RunPod build flow
+- We use profile files as inputs and generate lock files as build/runtime truth.
+- Profile inputs:
+  - `Runpod_Comfy/profiles/runpod.<id>.yaml`
+  - `Runpod_Comfy/profiles/nodes.<id>.yaml`
+  - `Runpod_Comfy/profiles/models.<id>.yaml`
+  - Optional `Runpod_Comfy/profiles/urls.<id>.txt`
+- Compiler output:
+  - `Runpod_Comfy/config/comfyui.lock`
+  - `Runpod_Comfy/config/custom_nodes.lock.json`
+  - `Runpod_Comfy/config/models.json`
+- Docker base image is taken from generated `comfyui.lock` (`BASE_IMAGE` build arg).
+
+## 2026-02-15 — Work continuity model
+- Planning/serious execution in OpenClaw web dashboard.
+- Telegram for quick pings.
+- Repo files (`TODO/WORKLOG/DECISIONS/WORKFLOW`) are continuity anchor across devices.
diff --git a/TODO.md b/TODO.md
new file mode 100644
index 0000000..bf26396
--- /dev/null
+++ b/TODO.md
@@ -0,0 +1,20 @@
+# TODO
+
+## NOW
+- [ ] Fill real values for RunPod profile files (`Runpod_Comfy/profiles/*.example.yaml` copies)
+- [ ] Compile selected profile and verify generated lock files
+- [ ] Build and push first RunPod image
+
+## NEXT
+- [ ] Deploy image on RunPod and run smoke test workflow
+- [ ] Add helper script: `Runpod_Comfy/tools/build_from_lock.sh`
+- [ ] Add profile validation checks (schema-lite)
+
+## BLOCKED
+- [ ] Final production model URLs and checksums (waiting on selection)
+
+## DONE
+- [x] Add profile compiler scaffold (`compile_profile.sh`)
+- [x] Add example profile files (runpod/nodes/models + urls format)
+- [x] Wire Dockerfile to configurable base image via build-arg
+- [x] Generate lock files from sample profile and sanity-check JSON
diff --git a/WORKFLOW.md b/WORKFLOW.md
new file mode 100644
index 0000000..5be3f6b
--- /dev/null
+++ b/WORKFLOW.md
@@ -0,0 +1,41 @@
+# Workflow (Cristian + kflame)
+
+This is the operating flow for this repo.
+
+## 1) Where planning happens
+- Primary workspace: OpenClaw web dashboard session.
+- Telegram: quick pings only.
+
+## 2) Source of truth
+- Tasks: `TODO.md`
+- Progress/handoff: `WORKLOG.md`
+- Decisions: `DECISIONS.md`
+- Code/config truth: repo files + commits
+
+## 3) Start of each work block
+1. Read `TODO.md`
+2. Read latest entry in `WORKLOG.md`
+3. Read `DECISIONS.md`
+4. Pick one task and execute
+
+## 4) End of each work block
+1. Update `WORKLOG.md` (done/next/blockers)
+2. Update `TODO.md` statuses
+3. If a meaningful choice was made, update `DECISIONS.md`
+4. Commit changes with clear message
+
+## 5) Task status model
+- `NOW`: actively working
+- `NEXT`: queued next
+- `BLOCKED`: waiting on external dependency
+- `DONE`: complete
+
+## 6) Resume from any device
+Use this order:
+1. `WORKLOG.md` latest entry
+2. `TODO.md` NOW/NEXT items
+3. `DECISIONS.md`
+4. Git history (`git log --oneline -n 10`)
+
+## 7) Rule of thumb
+If it matters later, write it to file now.
diff --git a/WORKLOG.md b/WORKLOG.md
new file mode 100644
index 0000000..ddcfb35
--- /dev/null
+++ b/WORKLOG.md
@@ -0,0 +1,24 @@
+# WORKLOG
+
+## 2026-02-15
+### Done
+- Implemented profile-driven scaffold for RunPod Comfy builds.
+- Added:
+  - `Runpod_Comfy/profiles/runpod.example.yaml`
+  - `Runpod_Comfy/profiles/nodes.example.yaml`
+  - `Runpod_Comfy/profiles/models.example.yaml`
+  - `Runpod_Comfy/profiles/urls.txt`
+  - `Runpod_Comfy/tools/compile_profile.sh`
+- Updated `Runpod_Comfy/docker/Dockerfile` to use `ARG BASE_IMAGE` + `FROM ${BASE_IMAGE}`.
+- Updated `Runpod_Comfy/README.md` with compile/build flow.
+- Ran sample compile: `Runpod_Comfy/tools/compile_profile.sh example`.
+- Validated generated JSON structure via Python loader.
+- Commit: `af028bf`.
+
+### Next (top 3)
+1. Create real profile files for Cristian's RunPod target.
+2. Compile and inspect generated lock files.
+3. Build + push image, deploy pod, smoke test.
+
+### Blockers
+- Real model URLs/checksums not finalized.