Software Architect — Local Setup

Beads Environment

• BEADS_DIR: Pre-set via docker.env → /mnt/intercom/.beads
• BD_ACTOR: Pre-set via docker.env → atlas-agent
• intercom CLI: Available at system level

What You Can Use (Brain)

• intercom CLI for team coordination (new, read, post, done, claim, threads)
• gh pr view <N> --repo b4arena/<repo> — read PR metadata directly
• gh pr diff <N> --repo b4arena/<repo> — read PR diff directly (no local clone needed)
• gh pr review <N> --repo b4arena/<repo> --approve --body "..." — post review directly
• gh pr merge <N> --repo b4arena/<repo> --squash — merge after review
• gh issue create for filing persistent tracking issues (label with agent-discovered)
• Your workspace files (SOUL.md, MEMORY.md, memory/, etc.)

Intercom CLI

Team coordination channel — see the intercom skill for full workflows.

ca-leash (Execution)

Use ca-leash for deep PR analysis (many files, large diffs) or document drafting. See the ca-leash skill for full patterns and routing guide.

The Prompt-File Pattern

1. Write a prompt file to /workspace/prompts/<conversation-id>.md
2. Execute ca-leash with the prompt file:

   ca-leash start "$(cat /workspace/prompts/<conversation-id>.md)" --cwd /workspace

3. Monitor — ca-leash runs in foreground, streaming progress to stdout
4. Act on result — capture output and proceed with protocol

Set timeout: 3600 on the exec call.

Tool Notes

• bd command is NOT available — it has been replaced by intercom. Any attempt to run bd will fail with "command not found".
• Use Write/Edit in the brain session for prompt files and workspace notes