Bud

// architecture

A second, separate discord.js bot — its own token, locked to one Discord server — that watches a single collaborator and never replies to them. Their stream-of-consciousness messages go to Claude Sonnet, which decomposes them into discrete typed items. For each item, Bud pulls the target repo's file tree and searches/reads the relevant files through the GitHub API, then asks Claude whether it's already built, how hard it is, and where to touch — filing a GitHub issue and DMing me a report. Nothing proceeds without my ✅ on that item; the approval listener is global, so it survives restarts and works on uncached DMs.

// how it works

1. 1

   Watch one channel

   A dedicated bot (its own token, one server) watches a single collaborator's messages — nobody else — and never shows itself by replying.

2. 2

   Decompose

   Claude Sonnet breaks each message into discrete typed items — bug or feature, priority, whether it touches the DB schema — each with the original quote attached.

3. 3

   Probe the codebase

   For each item Bud pulls the target repo's file tree, runs a couple of code searches and reads the relevant files via the GitHub API, then asks Claude if it's already built, how hard it is, and where to touch.

4. 4

   File + gate

   It opens a labelled GitHub issue and DMs me a report with a ✅ / ❌ per item. The approval listener is global, so it works on uncached DMs and survives a bot restart.

5. 5

   Dispatch the build

   On ✅ it fires a workflow_dispatch to a GitHub Action wired to run Claude Code — which branches off main, implements the item and opens the PR. On ❌ the item is dropped. Schema-touching items are flagged, not auto-migrated.

// tool calls

• analyzeMessage()Claude Sonnet decomposes a message into typed items { type, title, priority, schema-change? }
• GET /git/trees/main?recursive=1pulls the target repo's full file tree (session-cached)
• GET /search/codecontent search to locate the relevant files per item
• GET /contents/{path}reads candidate files (truncated) to judge feasibility with Claude
• POST /issuesfiles a labelled GitHub issue (bug / enhancement)
• POST /actions/workflows/…/dispatchesthe ✅ action — workflow_dispatch that runs Claude Code → PR

// approval dm