comic-sol

Comic Sol

Turn one natural-language request into a local, editable comic project. Reason about story and images, then delegate deterministic work to the bundled Python scripts.

Read progressively

• Read workflow for input detection, all ten stages, commands, state transitions, failures, resume, and completion.
• Read creative direction before authoring plans, character fingerprints, storyboards, references, or image prompts.
• Read capability detection before the first doctor call and again only if the exposed tools change.
• Read image provider setup before agent-managed external image tools; its ComfyUI route is reference/experimental and outside the deterministic engine.
• Read visual QA before accepting, retrying, overriding, composing, or exporting any generated panel.
• Read safety and IP before sending prompts externally and whenever people, minors, sensitive data, named styles, franchises, or refusals appear.
• Read schemas whenever writing or revising JSON artifacts.

Core orchestration

1. Detect resume/source-file/pasted-story/short-prompt mode in the normative order.
2. Ask only a materially required workflow question; otherwise apply defaults.
3. Inspect exposed tool metadata without invoking tools. Pass the best usable image tool as agent-image-generation with its declared features to doctor; pass unavailable for an inspectable inventory with no usable tool, and no flags if inspection is unavailable or fails. Never infer capability availability or features from provider, model, or tool names.
4. Run doctor, initialize or inspect the project, then validate and record every stage. Capability warnings allow deterministic planning. If neither a declared native tool nor a declared external adapter is available, prepare that handoff and then transition the project to BLOCKED until a destination declares a usable capability. Deterministic scripts never discover or call providers.
5. Generate canonical references and panels into attempt paths, including through an explicitly selected agent-managed external adapter; normal intake, retention, review, and promotion gates still apply. For prepared-handoff execution, run PYTHON scripts/comic_sol.py handoff inspect PROJECT (installed equivalent: comic-sol handoff inspect PROJECT), select only a reported job whose effective status is ready, and pass PROJECT/<jobs[].path> using the exact path returned for that job. After result intake, inspect again before retrying; the new inspection is authoritative for status and the next attempt. Never enumerate or execute retained generation/jobs/*.json files directly. See workflow for the full lifecycle. Require the image model to draw each exact generated-visual storyboard SFX and never a deterministic-lettering one. Inspect every result visually, record all seven QA checks, and repair only failures within budget. Route a bad effect to lettering with sfx_repair.py and follow its next_action: ink the model drew needs a regenerate review, not re-lettering alone.
6. Promote accepted attempts; deterministically letter dialogue, captions, and any deterministic-lettering SFX while validating and counting exact generated-visual storyboard SFX without drawing it in Pillow; compose pages, inspect every composed page and write its qa/pages/page-{NNN}.json record, export the PDF, render the QA report (which projects the terminal status), validate final integrity, then transition to it.
7. Return status, counts, warnings, and clickable project output paths.