Skip to content

docs: openrouter-byok-visual-review known-pattern (cross-town contribution from midgard)#447

Open
the-data-viking wants to merge 1 commit into
mainfrom
docs/openrouter-byok-visual-review
Open

docs: openrouter-byok-visual-review known-pattern (cross-town contribution from midgard)#447
the-data-viking wants to merge 1 commit into
mainfrom
docs/openrouter-byok-visual-review

Conversation

@the-data-viking
Copy link
Copy Markdown
Collaborator

Summary

Documents the working pattern for visual review of HTML/UI content via OpenRouter (BYOK) until the multimodal-via-OpenRouter transport-layer fix lands (`hq-m333`).

The pattern bypasses both broken attachment paths:

  • Image attachments via OpenRouter/Anthropic routes: ~100% drop per midgard mayor's deterministic repro (2026-05-10, N=15, all refused with "NO IMAGE RECEIVED"). Tracked as `hq-m333`.
  • html attachment type via OpenRouter: ~50% drop per same repro session. Tracked as `hq-aaca`.

Working pattern: inline HTML source into question text via `--vars-file` template-variable substitution, run with `--no-synthesis`, do a manual synthesis call. 0/210 refusals in midgard's reference 30-persona × 7-question boardroom run.

Adds:

  • `docs/known-patterns/openrouter-byok-visual-review.md` — full pattern doc with rationale, when-to-use-other-paths, step-by-step, empirical anchor, and "what this does NOT cover"
  • `docs/known-patterns/example-files/instrument-vars.example.yaml` — instrument with `{ack_html}` / `{list_html}` placeholders
  • `docs/known-patterns/example-files/vars.example.yaml` — vars-file scaffold with literal-block scalars
  • `docs/known-patterns/example-files/synthesize.example.py` — manual synthesis call (since the bundled synthesis prompt is tuned for survey data, not free-text design feedback)

Empirical anchor

$4 total cost for a complete actionable UI review (Sonnet 4.5 BYOK, 30 personas × 7 questions + 1 synthesis call), zero refusals across 210 responses.

Authorship

Pattern + working example files contributed by midgard mayor (`openclaw@dataviking.tech`, GitHub: @openclaw-dv) from cross-town consult. PR opened from jotunheim per standing coord protocol (synthpanel pushes go through jotunheim's CI environment). Tagging midgard for review on the PR thread.

Test plan

  • Markdown renders cleanly on synthpanel.dev (or relevant docs surface) when committed
  • Example files copy-paste cleanly (validated locally — synthesize.example.py runs through ruff format clean; YAML files parse)
  • Doc cross-links to `hq-m333`, `hq-aaca`, `hq-0pnq` are valid bead IDs (they are — filed today)

🤖 Generated with Claude Code

…files

Documents the working pattern for visual review of HTML/UI content via
OpenRouter (BYOK) until the multimodal-via-OpenRouter transport-layer fix
lands (hq-m333). Inlines HTML source into question text via template-
variable substitution; bypasses both the image-attachment path (~100%
drop on OR/Anthropic per midgard's deterministic repro 2026-05-10) and
the html-attachment path (~50% drop, hq-aaca).

Empirical anchor: 30 personas × 7 questions × Sonnet 4.5 BYOK boardroom
review producing actionable executive summary at ~$4 total cost
(midgard, 2026-05-10).

Pattern + example files contributed by midgard mayor; PR opened from
jotunheim per the standing cross-town coord protocol that synthpanel
pushes go through jotunheim.

Co-Authored-By: midgard mayor <openclaw@dataviking.tech>
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant