Skip to content

docs: IWCL dispatch protocol β€” inter-wolt communication#260

Open
woltspace-jerpint[bot] wants to merge 2 commits into
mainfrom
uxw/iwcl-docs
Open

docs: IWCL dispatch protocol β€” inter-wolt communication#260
woltspace-jerpint[bot] wants to merge 2 commits into
mainfrom
uxw/iwcl-docs

Conversation

@woltspace-jerpint
Copy link
Copy Markdown
Contributor

Summary

  • New /woltspace-dispatch skill β€” step-by-step protocol for raccoon orchestrators to dispatch work to other wolts via IWCL (tmux send-keys)
  • New docs/iwcl.md β€” architecture overview, proven patterns, and future roadmap

The Skill Covers

  • Pre-flight checklist (credential verification, system load check)
  • 7-step dispatch flow (spawn β†’ boot β†’ send spec β†’ monitor β†’ review β†’ push β†’ PR)
  • Worker selection guide (raccoon/beaver/otter for different task types)
  • Dev workflow template for consistent dispatch messages
  • Troubleshooting (stale creds, pasted-but-not-submitted, OOM)

The Doc Covers

  • How IWCL works today (tmux send-keys transport)
  • Proven patterns from Session 31 (multi-wolt parallel build) and Session 27 (direct messaging)
  • Future roadmap: inbox model β†’ bidirectional status β†’ autonomous orchestration

Context

This documents the protocol used in Session 31's first multi-wolt orchestrated build, where uxwolt (raccoon/opus) dispatched:

Both features were built in parallel in ~20 minutes.

Test plan

  • Verify skill loads correctly: /woltspace-dispatch shows in skill list
  • Verify docs render correctly on GitHub

πŸ€– Generated with Claude Code

@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 4, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
woltspace Ready Ready Preview, Comment Apr 12, 2026 11:58pm

uxwolt and others added 2 commits April 12, 2026 23:56
Add /woltspace-dispatch skill with step-by-step protocol for raccoon
orchestrators to dispatch work to other wolts via tmux send-keys.

Includes pre-flight checklist, message format, monitoring commands,
worker selection guide, and troubleshooting. Also adds docs/iwcl.md
with architecture overview and future roadmap (inbox model, bidirectional
status, autonomous orchestration).

Based on learnings from Session 31 β€” first successful multi-wolt
parallel build (2 features, 2 workers, 2 PRs in ~20 minutes).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Replace all tmux send-keys references with set-buffer + paste-buffer
(atomic paste). Document the _tmux_paste() helper, shell vs Python
usage, and the authorization chain friction discovered during
Session 47 dispatch.

Co-Authored-By: Claude Opus 4.6 <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.

0 participants