Skip to content

docs: dispatch-symmetry anti-pattern (architecture, cross-town contribution from midgard)#451

Merged
the-data-viking merged 1 commit into
mainfrom
docs/dispatch-symmetry-anti-pattern
May 10, 2026
Merged

docs: dispatch-symmetry anti-pattern (architecture, cross-town contribution from midgard)#451
the-data-viking merged 1 commit into
mainfrom
docs/dispatch-symmetry-anti-pattern

Conversation

@the-data-viking
Copy link
Copy Markdown
Collaborator

Summary

Codifies the architectural smell that produced 7 cross-town incidents between v1.0.4 → v1.0.6: a feature added at one dispatch entrypoint that doesn't cascade to all paths that should expose the same behavior. Manifests as silent degradation rather than loud error.

Instances cataloged

  1. boardroom Worker route asymmetry — catalyst.css set Cache-Control, /sessions HTML didn't (bo-sq2)
  2. Cross-product cache audit — most DV repos lacked Cache-Control entirely; different surfaces, identical root cause (dvi-25f)
  3. synthpanel image content blocks dropped in OpenRouter→Anthropic route, native Anthropic worked (hq-m333)
  4. synthpanel html attachments inconsistent through two-text-block shape (hq-aaca)
  5. v1 single-round path skipped attachment resolver, v3 multi-round didn't (hq-ilke)
  6. MCP v3 multi-round terminated after round 1, CLI v3 multi-round didn't (hq-fjdx)
  7. yggdrasil's fetch_mode: screenshot silent degradation when playwright not present (hq-gjh7)

Common shape

Feature added at one entrypoint → doesn't cascade to all dispatch paths that should expose the same behavior → manifests as silent degradation (attachments dropped, rounds skipped, headers missing) rather than loud error → catch is manual probing → fix is "wire it everywhere + add a CI test that audits dispatch-path symmetry."

Doc structure

  • Title-cased 'anti-pattern' framing — emphasis on the smell, not the cure
  • 7 instances chronological/severity-ordered with concrete cite for each
  • 'Detection: at design time' section — lowest-cost intervention, surfaced before CI test discussion
  • 'Why this is not just write more tests' — pre-empts the most common reaction
  • 'See also' linking 4 artifacts: sibling-cascade memory, cache-control-policy.md, openrouter-byok-visual-review.md, hq-83ye reference implementation

Authorship

Pattern + draft contributed by midgard mayor (`openclaw@dataviking.tech`). PR opened from jotunheim per standing cross-town coord protocol. Third cross-town docs PR this cycle (after PR #447 openrouter-byok-visual-review and PR #449 release-dogfood-protocol).

Test plan

  • Markdown renders cleanly (pure prose, no template-engine refs)
  • Cross-references valid (cites bead IDs hq-m333, hq-aaca, hq-ilke, hq-fjdx, hq-83ye, hq-gjh7 — all filed and tracked)
  • No markdown linter warnings if synthpanel has one wired

🤖 Generated with Claude Code

Codifies the architectural smell that produced 7 cross-town incidents
between v1.0.4 → v1.0.6: a feature added at one dispatch entrypoint that
doesn't cascade to all paths that should expose the same behavior.
Manifests as silent degradation rather than loud error — caller sees a
successful-looking run that has executed less than expected.

Instances cataloged: boardroom Worker route asymmetry (bo-sq2),
cross-product cache audit (dvi-25f), hq-m333 (OR→Anthropic image drop),
hq-aaca (html attachment two-text-block shape), hq-ilke (v1 single-round
bank-ref bypass), hq-fjdx (MCP v3 multi-round termination), hq-gjh7
(screenshot/playwright soft-dep silent degradation).

Cross-town contribution from midgard mayor; PR opened from jotunheim
per the standing cross-town coord protocol. Third such PR this cycle
(after openrouter-byok-visual-review.md and release-dogfood-protocol.md).

Co-Authored-By: midgard mayor <openclaw@dataviking.tech>
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@cloudflare-workers-and-pages
Copy link
Copy Markdown

Deploying synthpanel with  Cloudflare Pages  Cloudflare Pages

Latest commit: 1d1493d
Status: ✅  Deploy successful!
Preview URL: https://f427cb99.synthpanel.pages.dev
Branch Preview URL: https://docs-dispatch-symmetry-anti.synthpanel.pages.dev

View logs

@the-data-viking the-data-viking merged commit 264988d into main May 10, 2026
15 checks passed
@the-data-viking the-data-viking deleted the docs/dispatch-symmetry-anti-pattern branch May 10, 2026 21:55
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