Documentation: Companion pattern with local execution backends (cowork-to-code-bridge)

リポジトリの既存のドキュメント構成を確認し、参照されている cowork-to-code-bridge 統合ガイドを読んで、提案されている補完的なワークフローを理解します。GitHub MCP の discovery とローカルでの Claude Code の実行を組み合わせた内容を、具体的なエスカレーション例およびセットアップの詳細とともに示すセクションを追加します。完了の条件は、ユーザーがドキュメント化されたワークフローに従えることです。

Problem

GitHub's MCP server is excellent for querying repo data. But agents often need to execute code based on what the GitHub server surfaces (issues, PRs, etc.).

There's no documented pattern for combining GitHub data discovery with local code execution.

Solution: Companion Pattern Documentation

GitHub MCP + cowork-to-code-bridge as a companion pair:

1. GitHub MCP server — discovers issues, PRs, code issues
2. cowork-to-code-bridge — executes fixes locally
3. Agent orchestrates — find problem → escalate to Claude Code → apply fix

Example Workflow

GitHub server finds bug:

{
  "issue": {
    "title": "API health check failing",
    "body": "Logs show connection timeout",
    "files_changed": ["health_check.py"]
  }
}

Agent escalates to Claude Code:

result = agent.escalate_to_claude(
    tool="escalate_to_claude",
    request="Debug this issue: " + json.dumps(github_issue),
    wait_seconds=600
)

Result: Debugging complete, fix proposed

Why This Matters

Developers want: "GitHub finds the problem → Claude Code fixes it" workflows.

This documentation helps users discover how to combine these tools.

Reference

• Bridge: https://github.com/abhinaykrupa/cowork-to-code-bridge
• Docs: https://github.com/abhinaykrupa/cowork-to-code-bridge/blob/main/docs/EXTERNAL_AGENT_INTEGRATION.md

Proposed Action

Add example or documentation section:

• "Companion: Local Code Execution"
• Shows: how to wire GitHub MCP server + Claude Code bridge together
• Use case: "GitHub server finds bug → escalate debugging to Claude Code"

Happy to write the example walkthrough.