For an agent

This pack is two ComfyUI nodes. SG Publish sends a generation to Flow Production Tracking as a Version with the model, prompt, seed, sampler and workflow that produced it. SG Load reads a Version's media back into a graph. Nothing here makes images.

Run this first

<comfy-python> tools/doctor.py            # the interpreter, the paths, the profile
<comfy-python> tools/doctor.py --site     # also the connection, the fields, the storage, the links

It prints one line per thing a publish needs, with the fix appended where it fails. It exits non-zero on anything that would stop a publish.

Which install this is

file	the Registry pack	the repo checkout
`__init__.py`, `src/`, `web/`, `example_workflows/`	yes	yes
`README.md`, `INSTALL.md`, `DESIGN.md`, `CLAUDE.md`, `AGENTS.md`	yes	yes
`.claude/commands/`, `tools/doctor.py`	yes	yes
`tests/`, the rest of `tools/`, `site/`, `RELEASE.md`	no	yes

Manager updates the pack. git pull updates the checkout. Changing the code needs the checkout.

Documents

job	read
What the nodes do, and a first run	`README.md`
A local file, an interpreter, a command, a profile key, a fix	`INSTALL.md`
Changing this code	`CLAUDE.md`, then `DESIGN.md`

Procedures

.claude/commands/ has four procedures. They are plain markdown with no Claude Code in them. Follow the file whether or not your harness has slash commands.

file	does	also needs
`setup.md`	a first run, from the connection to the example workflow	nothing
`inspect-site.md`	measure one project and write `profile.local.json`	the `sg-groundtruth` checkout
`track-workflow.md`	put the nodes into a graph the operator already uses	nothing
`task.md`	do a job against the API, grounded in the corpus	the `sg-groundtruth` checkout

The profile says where to clone sg-groundtruth.

Command lines

command	needs
`<comfy-python> tools/doctor.py [--site]`	nothing without `--site`
`<comfy-python> src/comfyui_sg/instrument.py <wf.json>`	no site, no profile, no torch
`PYTHONPATH=src <comfy-python> -m comfyui_sg.fields`	`.env.local`
`PYTHONPATH=src <comfy-python> -m comfyui_sg.seed <file> ...`	`.env.local`, `profile.local.json`

PYTHONPATH=src is required for every -m comfyui_sg.*. The package is under src/ and nothing installs it.
instrument.py and doctor.py are run as files. -m would import the package __init__ and therefore torch.
None of these reads Settings. They read .env.local in the pack directory, or the same three keys in the environment.

Positional order

widgets_values is positional. Append a widget, never insert or remove one. The order is declared once, in widgets.py.
Outputs are positional. The order in RETURN_NAMES is frozen from the first release. Append only.

The source is on GitHub.