gstack完全ガイド：Claude Codeを仮想エンジニアリングチームに変える方法
目次
- gstackとは？
- インストール方法
- コアワークフロー：Think → Plan → Build → Review → Test → Ship
- ブラウザ自動化：/browse
- セーフティガード
- 並列スプリント：Conductor連携
- ビルダー哲学（Ethos）
- 実践ワークフロー例
- プライバシーとテレメトリ
- トラブルシューティング
- まとめ
- 参照リンク
一人で1日1万行以上のプロダクションコードを書けるとしたらどうでしょう？Y Combinator代表のGarry Tanが公開したgstackは、Claude CodeをCEO、デザイナー、スタッフエンジニア、QAリード、セキュリティ責任者、リリースエンジニアで構成される仮想エンジニアリングチームに変換するオープンソースツールです。実際に60日間で60万行以上のプロダクションコードを出荷した実績がそれを裏付けています。
本ガイドでは、gstackのインストールから28のスキル活用法、コアワークフロー、そして実践的なヒントまで体系的に解説します。
gstackとは？
gstackはClaude Code上で動作するソフトウェアファクトリーです。単なるコーディングアシスタントではなく、各専門的な役割を果たす28のスキル（skill）を提供し、ソフトウェア開発の全プロセスを体系的に管理します。
| 主要指標 | 内容 |
|---|---|
| 出荷コード量 | 60日間で600,000行以上（35%がテストコード） |
| 日次生産性 | 10,000～20,000行/日（パートタイム作業） |
| スキル数 | 28の専門スキル |
| ライセンス | MIT（完全無料、プレミアムなし） |
インストール方法
前提条件
- Claude Code - AnthropicのCLIコーディングツール
- Git - バージョン管理
- Bun v1.0+ - JavaScriptランタイム（コンパイル済みバイナリ生成用）
- Node.js - Windows環境でのみ追加必要
Step 1：グローバルインストール（30秒）
git clone https://github.com/garrytan/gstack.git ~/.claude/skills/gstack
cd ~/.claude/skills/gstack && ./setupこのコマンドでgstackが~/.claude/skills/gstackにインストールされ、Claude Codeが自動的にすべてのスキルを認識します。
Step 2：プロジェクトに追加（任意）
チーム全体で同じ設定を使用する場合は、プロジェクトリポジトリにコピーします：
cp -Rf ~/.claude/skills/gstack .claude/skills/gstack
rm -rf .claude/skills/gstack/.git
cd .claude/skills/gstack && ./setupCodex/Gemini/Cursorユーザー
# リポジトリローカルインストール
git clone https://github.com/garrytan/gstack.git .agents/skills/gstack
cd .agents/skills/gstack && ./setup --host codex
# またはグローバルインストール
git clone https://github.com/garrytan/gstack.git ~/gstack
cd ~/gstack && ./setup --host codex
# 自動検出
./setup --host autoコアワークフロー：Think → Plan → Build → Review → Test → Ship
gstackの最大の強みは、ソフトウェア開発ライフサイクル全体を構造化されたステップに分割している点です。各ステップに専門的な役割が割り当てられています。
ステップ1：企画（Planning）
すべてのプロジェクトの出発点です。6つの核心的な質問でプロダクトを再定義し、2～3つの実装案を工数見積もりとともに生成します。
/office-hours2つのモードを提供します：
- Startupモード：プロダクトマーケットフィットに対する鋭い質問
- Builderモード：探索的で生成的なアプローチ
ユーザー視点で課題を再考し、「リクエストの中に隠れた10つ星プロダクト」を発掘します。4つのスコープモードをサポートします：
- Expansion：大きく夢を描く（機能拡張）
- Selective Expansion：機会を選別して拡張
- Hold Scope：現在のスコープで最高品質
- Reduction：最小実行可能バージョン
コーディング前にアーキテクチャを確定します。システム境界、データフロー、状態遷移、障害モード、エッジケースをダイアグラムで可視化します。生成されたテスト計画は/qaに自動的に引き継がれます。
7つのデザイン次元を0～10のスケールで評価します。空状態、エラー状態、モバイル動作、ローディング状態など見落としがちな部分を検出し、AIが生成した曖昧な記述（AI slop）を特定します。
/autoplanを実行すると、CEO → デザイン → エンジニアリングレビューを自動的に順次実行します。重要な判断（taste decision）のみユーザーに確認を求めます。ステップ2：デザイン（Design）
| スキル | 役割 | 主な機能 |
|---|---|---|
/design-consultation | デザインパートナー | 競合環境リサーチ、タイポグラフィ/カラー/スペーシングシステム設計、HTMLプレビュー生成、DESIGN.md出力 |
/design-review | コードが書けるデザイナー | 80項目のビジュアル監査、CSS限定の修正（安全）、最大30件の修正、before/afterスクリーンショット |
ステップ3：コードレビュー（Review）
| スキル | 役割 | 主な機能 |
|---|---|---|
/review | スタッフエンジニア | N+1クエリ、レースコンディション、インジェクションバグなどの本番障害パターン検出。明確な問題は自動修正 |
/investigate | デバッガー | 根本原因の追跡。データフローのトレース。3回修正失敗でアーキテクチャ再検討 |
/codex | セカンドオピニオン | OpenAI Codexによる独立レビュー。review/adversarial/consultationの3モード |
ステップ4：テストとセキュリティ（QA & Security）
| スキル | モード | 説明 |
|---|---|---|
/qa | Diff-aware | featureブランチで自動：git diffベースで影響ページのみテスト |
| Full | 総合テスト（5～15分）、5～10件の問題を文書化 | |
| Quick (--quick) | 30秒スモークテスト | |
| Regression | ベースラインとの比較テスト | |
/qa-only | レポート専用 | コード変更なしでバグレポートのみ生成 |
/cso | セキュリティ監査 | OWASP Top 10 + STRIDE脅威モデリング。信頼度8/10以上のゲート |
ステップ5：デプロイ（Ship & Deploy）
| スキル | 役割 | 主な機能 |
|---|---|---|
/ship | リリースエンジニア | main同期 → テスト → カバレッジ監査 → PR作成（ワンコマンドパイプライン） |
/land-and-deploy | リリースエンジニア | PRマージ → デプロイ → プロダクションヘルスチェック |
/canary | SRE | デプロイ後のモニタリング：コンソールエラー、リグレッション、ページ障害の監視 |
/benchmark | パフォーマンスエンジニア | ページロード、Core Web Vitals、リソースサイズの測定およびbefore/after比較 |
ブラウザ自動化：/browse
gstackには実際のChromiumベースのブラウザ自動化が内蔵されています。MCPプロトコルと比較してトークンオーバーヘッドがほぼなく（MCPはセッションあたり30,000～40,000トークンを消費）、コマンドあたり約100～200msのレスポンス速度を提供します。
主な特徴
- Persistent Daemon：長時間稼働するChromiumサーバーによりコールドスタートなし
- Refシステム：アクセシビリティツリーベースの要素参照（
@e1、@e2）。DOM変更なしで安全に動作 - Cookieインポート：Chrome、Arc、Brave、EdgeからCookieを取り込み可能
- Localhost専用バインディング：ネットワークアクセスをブロック、セッションごとのBearerトークン認証
よく使うブラウザコマンド
# ページ遷移
browse goto https://example.com
# スナップショット（要素参照付き）
browse snapshot -i
# 要素クリック
browse click @e5
# フォーム入力
browse fill @e12 "検索キーワード"
# スクリーンショット撮影
browse screenshot
# JavaScript実行
browse js "document.title"セーフティガード
gstackは誤操作による致命的なコマンド実行を防ぐセーフティガードを提供します：
| スキル | 機能 |
|---|---|
/careful | 破壊的コマンド（rm -rf、DROP TABLE、force-pushなど）実行前に警告 |
/freeze | 特定ディレクトリへの編集範囲制限（ロック） |
/guard | /careful + /freeze の組み合わせ（最大安全） |
/unfreeze | /freeze 解除 |
並列スプリント：Conductor連携
gstackはConductor（macOSアプリ）と連携して、複数のClaude Codeセッションを同時に実行できます。各セッションはgit worktreeで隔離されたワークスペースで独立して動作するため、衝突なしに並列開発が可能です。
ワークフローはシンプルです：
- リポジトリを登録
- 複数のエージェントを同時にデプロイ（各自が隔離されたワークスペースを持つ）
- リアルタイムで進捗をモニタリングし、コードレビュー後にマージ
ビルダー哲学（Ethos）
gstackは2つの核心原則に従っています：
Boil the Lake（湖を沸かせ）
完成コストがショートカットよりほんの数分多いだけなら、常に完成させるという原則です。AI支援時代では「2週間かかる」を「1時間で済む」と捉え直すべきです。90%のソリューションではなく100%の完成を追求します。
Search Before Building（作る前に探せ）
「誰かがすでに解決しているか？」を「ゼロから設計しよう」より先に問うべきです。3つの知識レイヤーを活用します：
- Layer 1（実証済み）：広く使われているバトルテスト済みパターン
- Layer 2（新しく人気のあるもの）：最新のベストプラクティス（批判的検証が必要）
- Layer 3（ファーストプリンシプル）：問題固有の独創的推論
実践ワークフロー例
新機能を企画からデプロイまで進める全体の流れです：
# 1. プロダクトアイデアの検証
/office-hours
→ 6つの核心的な質問でプロダクトを再定義
# 2. CEOレビューでスコープ決定
/plan-ceo-review
→ 4つのモードから選択して実装スコープを確定
# 3. エンジニアリングアーキテクチャの確定
/plan-eng-review
→ ダイアグラム、エッジケース、テスト計画を生成
# 4.（または自動化）全体企画パイプライン
/autoplan
→ CEO → デザイン → エンジニアリングレビューを自動順次実行
# 5. 実装完了後のコードレビュー
/review
→ 本番障害パターンの検出 + 自動修正
# 6. QAテスト
/qa
→ バグ発見 + 自動リグレッションテスト生成
# 7. セキュリティ監査
/cso
→ OWASP Top 10 + STRIDE脅威モデリング
# 8. デプロイ
/ship
→ テスト → カバレッジ → PR作成
# 9. デプロイ後のモニタリング
/canary
→ コンソールエラー、リグレッションの監視プライバシーとテレメトリ
- デフォルト：OFF - 明示的な同意なしにはデータは一切送信されません
- 収集項目（同意時）：スキル名、所要時間、成功/失敗、バージョン、OSのみ
- 絶対に収集しないもの：コード、ファイルパス、リポジトリ名、ブランチ名、プロンプト、ユーザー生成コンテンツ
- 即時無効化：
gstack-config set telemetry off - ローカル分析：
gstack-analyticsでいつでもローカルで確認可能
トラブルシューティング
| 症状 | 解決方法 |
|---|---|
| スキルが表示されない | cd ~/.claude/skills/gstack && ./setup |
| /browseが失敗する | cd ~/.claude/skills/gstack && bun install && bun run build |
| 古いインストール | /gstack-upgradeを実行、またはconfigでauto_upgrade: trueを設定 |
| Windowsの問題 | Git BashまたはWSLが必要。Node.jsもPATHに追加すること |
| Claudeがスキルを認識しない | プロジェクトのCLAUDE.mdにgstackスキル一覧を追加 |
まとめ
- gstackはClaude Codeを28の専門的な役割を持つ仮想チームに変換するオープンソースのソフトウェアファクトリー
- Think → Plan → Build → Review → Test → Ship → Reflect の全プロセスをカバー
/office-hoursで開始し/shipで完了する構造化されたワークフロー- 内蔵Chromiumブラウザで実際のUIテストとスクリーンショット自動化をサポート
/careful、/freeze、/guardで致命的なミスを防止- Conductor連携で並列スプリントが可能
- MITライセンス - 完全無料、プレミアムティアなし
- インストール30秒：
git clone+./setupの1行で完了
参照リンク
- garrytan/gstack - GitHubgstack公式リポジトリ（README、インストールガイド、ソースコード）
- gstack Skills Documentation28スキルの詳細説明、ワークフロー、Greptile連携
- gstack Builder Ethosビルダー哲学：Boil the Lake、Search Before Buildingの原則
- gstack Architectureシステム設計、デーモンアーキテクチャ、セキュリティモデル、Refシステム
- gstack Browser Reference/browseコマンド完全リファレンス、スナップショット、インタラクション
- gstack Contributing Guide開発環境セットアップ、テスト、コントリビューターモード
- Conductor並列AIコーディングエージェントオーケストレーションmacOSアプリ
コメント 0件
登録されたコメントがありません。