Skip to content

docs(skill): map agent runtimes onto board commands - #784

Merged
julianbenegas merged 2 commits into
mainfrom
agent-comms-references
Nov 20, 2026
Merged

julianbenegas merged 2 commits into
mainfrom
agent-comms-references

Conversation

@cramforce

@cramforce cramforce commented Nov 20, 2026 •

Copy link
Copy Markdown
Contributor

Adds a page per coding agent that ships its own spawn, send, wait, and monitor tools, mapping those tools onto the commands SKILL.md already documents.

  • Users: none
  • Protocol / backends: none
  • Performance / I/O: none
  • Tests: none in code. Every command named here is one SKILL.md or the CLI reference already documents.

Open

The signatures describe other projects (fx, Claude Code, Codex, eve), not this one, so they age on their own schedule; each page says what it was written against.

@vercel

vercel Bot commented Nov 20, 2026 •

Copy link
Copy Markdown
Contributor

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

Project Deployment Actions Updated
vboard-preview-publisher Ready Ready Preview Nov 20, 2026 10:33pm UTC

Comment thread skills/board/references/agent-comms.md Resolved
Comment thread skills/board/references/fx.md Resolved
Comment thread skills/board/references/fx.md Resolved
Comment thread skills/board/references/eve.md Resolved
@cramforce cramforce changed the title docs(skills): map agent messaging tools onto board commands docs(skill): map agent runtimes onto board commands Nov 20, 2026
One page per runtime (fx, Claude Code, Codex, eve) mapping that runtime's own spawn, send, wait, and monitor tools onto the commands SKILL.md already documents.
@cramforce
cramforce force-pushed the agent-comms-references branch from 7621444 to 973dbfb Compare November 20, 2026 22:24

@vercel vercel Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Checked every board command, flag, and error these pages name against packages/board/docs/04-reference/01-cli.md and src/server/tasks.ts. They all exist and behave as described: --label 'board.task=completed|blocked|failed' alternation (src/cli/main.ts:489), reopen only from failed and task_finished on completed or canceled (tasks.ts:763-767), wait <id> waiting in the thread, and tasks <prefix>/ reading the subtree. CI is green.

Two small nits:

  • fx.md, the task_not_owned note: owns() (tasks.ts:253-257) lets anyone with manage in the channel change the task, so a lead with manage can cancel a task the reviewer's profile created. The error only happens to a profile without manage, e.g. one narrowed by x-board-can. Maybe: "unless the lead has manage in the channel, a profile changes only the tasks it made…"
  • claude.md, tools table: TaskStop's signature is bare (id), but every other row starts with the tool's name (TaskStop(id)).

I didn't check the signatures of the other runtimes (fx, Claude Code, Codex, eve), since that code isn't in this repo. Each page saying which version it was written against covers that.

Co-authored-by: Malte Ubl <89679+cramforce@users.noreply.github.com>
@julianbenegas
julianbenegas marked this pull request as ready for review November 20, 2026 22:52
@julianbenegas
julianbenegas merged commit c2d3324 into main Nov 20, 2026
8 checks passed
@julianbenegas
julianbenegas deleted the agent-comms-references branch November 20, 2026 22:52
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.

2 participants