Tactic Remoteでチームワークフローを構築する

Tactic Remoteは個人開発者向けに設計されましたが、チームでの採用が増えています。このガイドでは、共有インフラ、アクセス管理、全員が生産性を維持しながら互いの作業を妨げないワークフロー規約など、開発チームのためのTactic Remoteセットアップ方法を解説します。

チームアーキテクチャ

個人開発者は自分のMacでTactic Remoteを実行します。チームにはより多くの選択肢があります：

オプションA：個人Mac、個別セットアップ

各開発者が自分のMacでTactic Remoteコンパニオンアプリを実行し、自分のiPhoneから接続します。最もシンプルなセットアップで、チームメンバー間の完全な分離を実現します。

最適： 小規模チーム（2〜5人）で、全員が高性能なMacを持ち、主にコードベースの異なる部分で作業する場合。

メリット： 共有インフラゼロ、完全なプライバシー、調整オーバーヘッドなし。 デメリット： セッションの共有可視性なし、各開発者が自身のセットアップを管理。

オプションB：共有開発サーバー

専用Mac（Mac Mini、Mac Studio、またはMac Pro）でTactic Remoteコンパニオンアプリを実行し、複数のユーザーアカウントを設定。各開発者は共有マシン上の自分のユーザーアカウントに接続します。

最適： 5〜15人のチームで、セッションを共有せずにインフラを集中管理したい場合。

セットアップ方法：

1. 共有Mac上に各開発者のmacOSユーザーアカウントを作成。
2. 各ユーザーアカウントにClaude Codeとtmuxをインストール。
3. ユーザーごとにTactic Remoteコンパニオンアプリを実行（各自に固有のポートを割り当て）。
4. Cloudflare Tunnelで開発者ごとのサブドメインルーティングを設定。

developer1.team.example.com → localhost:3001 (開発者1のコンパニオンアプリ)
developer2.team.example.com → localhost:3002 (開発者2のコンパニオンアプリ)
developer3.team.example.com → localhost:3003 (開発者3のコンパニオンアプリ)

各開発者はiPhoneから個人のサブドメインを使って接続します。セッションは開発者間で分離されますが、インフラは集中管理されます。

メリット： 集中管理、一貫した環境、開発者に高性能な個人Macが不要。 デメリット： 共有マシンのリソース競合、単一障害点。

オプションC：ハイブリッドセットアップ

シニア開発者とリードは共有サーバーを使用し（一貫性とチームの可視性のため）、個々のコントリビューターは個人Macを使用。柔軟性と調整のバランスを取ります。

チーム規約

技術セットアップは簡単な部分です。チーム規約こそが、AIコーディングツールの共同利用を実際に機能させるものです。

規約1：セッション命名規則

一貫したセッション命名形式を採用しましょう。推奨フォーマット：

{開発者イニシャル}-{プロジェクト}-{フォーカス}

例：

• jk-api-auth-module
• ms-frontend-dashboard-redesign
• tc-infra-ci-pipeline

これにより、各セッションの所有者と作業内容が一目瞭然になります。共有サーバーで複数の開発者のセッションが表示される場合、混乱を防ぎます。

規約2：セッションごとにブランチ

各Claude Codeセッションは専用のGitブランチで作業すべきです：

ai/{開発者}/{説明}

例：

• ai/jkim/add-user-auth
• ai/msmith/refactor-payment-flow

この規約の利点：

• 並行するAIセッション間のマージコンフリクトを防止
• コードレビューを明確化（AIセッションごとに1つのPR）
• Git履歴でAI生成の変更を明確に識別
• AIセッションの成果物が低品質な場合、簡単にロールバック可能

規約3：承認エスカレーション

すべての承認判断を個々の開発者が行うべきではありません。チームレベルの承認カテゴリーを定義しましょう：

自己承認（個人開発者）：

• セッションのプロジェクトスコープ内でのファイル読み書き
• テスト実行
• 開発依存関係のインストール
• フォーマットとリントの修正

ピア承認（チームメイトに通知）：

• データベーススキーマの変更
• APIコントラクトの変更（エンドポイントのシグネチャ、レスポンス形式）
• セキュリティに関わるコードの変更
• 共有設定ファイルの変更

リード承認（テックリードの承認が必要）：

• 本番環境デプロイコマンド
• インフラの変更
• 依存関係のメジャーバージョンアップグレード
• 認証・認可ロジックの変更

この実施にはツールではなく規律が必要です（Tactic Remoteはまだチーム承認ポリシーを強制できません）が、早期に規約を確立することでコストの高いミスを防げます。

規約4：デイリーAIスタンドアップ

デイリースタンドアップにAIに関する簡潔なセグメントを追加しましょう：

• 夜間や午前中に完了したAIタスクは？
• 現在実行中のAIタスクは？
• チームで議論が必要な承認リクエストはあるか？
• AI生成のコードで大幅な手動修正が必要だったものはあるか？

これによりチームはAI活動を把握し、品質問題を早期に発見できます。また、どの種類のタスクがAIに適しているか、どれがまだ人間の実装を必要とするかをチームが学ぶのにも役立ちます。

共有プロンプトライブラリ

リポジトリにチームレベルのプロンプトライブラリを作成しましょう：

.claude-prompts/
├── code-review.md       # 標準コードレビュープロンプト
├── test-coverage.md     # テストカバレッジ分析プロンプト
├── security-audit.md    # セキュリティレビュープロンプト
├── pre-deploy.md        # デプロイ前チェックリスト
├── dependency-update.md # 依存関係更新手順
└── new-feature.md       # 機能実装テンプレート

各ファイルには、チームが実際の使用を通じて磨き上げた実績あるプロンプトが含まれます。code-review.mdの例：

Review the diff for this branch against main. Evaluate:
 
1. Correctness: Does the code do what it claims?
2. Edge cases: What inputs or conditions could cause failure?
3. Security: Are there injection, auth, or data exposure risks?
4. Performance: Any O(n²) patterns, missing indexes, or memory leaks?
5. Maintainability: Would a new team member understand this code?
 
For each issue found, provide:
 
- Severity (critical / warning / suggestion)
- File and line reference
- Explanation of the problem
- Suggested fix
 
If the code looks good, say so — don't invent issues.

チームメンバーはTactic Remoteからこれらのプロンプトを参照します：

Follow the code-review prompt in .claude-prompts/code-review.md
for the current branch.

これにより、どの開発者がAIを指示しても、一貫した品質基準が維持されます。

チーム活動の監視

共有サーバーでは、Macコンパニオンアプリのステータスパネルに全開発者のアクティブセッションが表示されます。テックリードは以下を監視できます：

• 同時実行中のAIセッション数
• 各セッションのリソース使用状況（CPU、メモリ）
• セッションの所要時間と活動パターン
• 承認の応答時間

この可視性により、共有サーバーのアップグレードが必要な時期、開発者が助けを必要としている可能性（承認待ちのまま数時間経過したセッション）、チーム規約が守られているかを特定できます。

チームセキュリティ

チームでの利用はセキュリティの考慮事項を増幅させます：

APIキー管理： 各開発者は固有のAPIキーを持つべきです。共有キーでは「誰が何をしたか」の監査が不可能になります。チームのAPIキーはアクセス制御付きのパスワードマネージャーに保存しましょう。

セッション分離： 共有サーバーで、開発者が互いのtmuxセッションにアクセスできないことを検証しましょう。macOSユーザーアカウントの分離がこれを提供しますが、テストで確認が必要です。

コードアクセス範囲： 各開発者のClaude Codeセッションが、権限のあるリポジトリのみにアクセスできることを確認しましょう。macOSファイルパーミッションとGit SSHキーの分離を使用して実現します。

オフボーディング： 開発者がチームを離れる際は、APIキーの失効、セッションの終了、共有サーバーからのユーザーアカウント削除を行います。この手順をオフボーディングチェックリストに記録しましょう。

チーム導入の開始

段階的なアプローチを推奨します：

1. 第1週： 2人の開発者がそれぞれTactic Remoteインスタンスをセットアップし、1スプリントで使用。
2. 第2週： 学びを共有し、命名規約とプロンプトライブラリを策定。
3. 第3週： ドキュメント化された規約のもとでチーム全体に展開。
4. 第4週： 評価——何がうまくいき、何を調整すべきか？

小さく始めて、素早く学び、慎重にスケールしましょう。Tactic Remoteは強力なチームツールですが、その効果は技術自体と同様に、それを取り巻く規約に依存します。

個人セットアップについてははじめにを、接続オプションについてはローカルネットワークとCloudflare Tunnelをご覧ください。