maxritter/pilot-shell

How real engineers run Claude Code and Codex: spec-driven planning, enforced TDD, persistent memory, and quality enforcement on all levels. Make your agents production-ready.

Pilot Shell – Claude Code & Codex 用の AI 拡張コマンドライン

何であるか – Anthropic の Claude Code（主）または OpenAI の Codex の上に軽量なシェル/CLI を設置し、構造的でテスト駆動の開発ワークフローを追加します。生のコード生成プロンプトを、要件収集、仕様策定、実装、バグ修正、自律的ビルドをカバーする再現可能で品質チェック済みのパイプラインに変換します。

なぜ存在するか – Claude Code と Codex はコードを迅速に生成できますが、フレームワークがなければ：

  • テストや linting をスキップする
  • セッション間でコンテキストを失う
  • 結果が一貫性がない Pilot Shell は 仕様駆動 および 目標駆動 のプロセス、品質ゲート、永続的な「メモリ」を注入することで、AI がより disciplined なエンジニアリングチームメイトのように振る舞うようにします。

コアコンセプトとコマンド

コマンド 使用タイミング 機能
/prd ぼんやりとしたアイデアや問題文があるとき。 ブレインストーミング、オプションのウェブ調査を行い、docs/prd/ 下に保存された製品要件書（PRD）を生成します。
/spec 明確な機能やバグを対象にしているとき。 AI に 計画 → 承認 → 実装（TDD）→ 検証 → 完了 の流れをガイドし、自動的な lint/format/type チェックとオプションの共同仕様レビューを実行します。
/build 完全な仕様なしで具体的な目標に到達したいとき。 短いタスクリストと受容基準を生成し、反復的にビルド、評価、改善を繰り返して基準を満たすまで続けます。
/fix テスト駆動のフローに合うバグ修正が必要なとき。 集中的な TDD ループを実行；修正が複雑になりすぎると中断します。
pilot（管理者エイリアス） インストール、更新、設定の管理。 ランタイムのインストール/アンインストール、ライセンスの有効化、モデルの切り替えなどを実行します。

主な機能

  • 品質フック – 各編集に対して自動的に linting、フォーマット、型チェック、テスト実行が強制されます。
  • コンテキスト工学とメモリ共有 – 決定、ルール、および「メモリ」は ~/.pilot/ に永続化され、プロジェクトリポジトリを通じて共有可能です。
  • セマンティック検索（Semble）＋コード知識グラフ（CodeGraph） – トークン使用量を削減する高速かつ正確なコードベース検索。
  • トークン最適化 – RTK 圧縮と Semble 検索により、コストを 60–90 % 削減。
  • Pilot Bot – 永続的なバックグラウンドエージェントで、スケジュールタスクや長時間実行ジョブを実行可能。
  • 拡張機能 – チームで共有できる再利用可能なルール、スキル、MCP（Message-Control-Protocol）サーバー。
  • コンソール – 実時間通知、セッションログ、現在の要件/仕様を表示するローカル Web ダッシュボード。

インストール（クイックスタート）

# macOS、Linux、Windows（WSL2）で動作するワンライナー
curl -fsSL https://raw.githubusercontent.com/maxritter/pilot-shell/main/install.sh | bash

インストーラーは以下の作業を行います：

  1. Homebrew、Node、Python 3.12+、git、jq の有無を確認。
  2. 対応する AI エージェント（Claude Code または Codex）を検出 – 事前にインストールが必要です。
  3. ~/.pilot/ 下に Pilot アセットとエージェント固有のアダプタをデプロイ。
  4. サポートツール（Semble、RTK、CodeGraph、Playwright、Chrome-DevTools MCP、言語サーバーなど）をインストール。
  5. bash、fish、zsh 用のシェルエイリアス（pilot、claude/codex ラッパー）を追加。

アンインストール（データを保持する場合）：

curl -fsSL https://raw.githubusercontent.com/maxritter/pilot-shell/main/uninstall.sh | bash

--purge-data を追加すると ~/.pilot/ を削除します。

前提条件

  • Claude Code – ネイティブインストーラ（Anthropic サブスクリプションが必要） または
  • Codex CLI / ChatGPT デスクトップ（OpenAI サブスクリプションが必要）。
  • 現代的なターミナル（Zentty 推奨、iTerm2、Ghostty なども動作可能）。

一般的なワークフローの例

# Claude Code（または Codex）を起動
claude                     # または：codex

# 1️⃣ PRD の作成
> /prd "チーム更新のリアルタイム通知を追加"

# 2️⃣ 仕様に変換して実装
> /spec "チーム更新のリアルタイム通知を追加"
# – Pilot が計画、E2E テストの作成、TDD による実装、検証、マージまでガイドします。

# 3️⃣ 後に素早い修正が必要な場合
> /fix "ページリロード後に通知が停止する"

すべてのステップはログに記録され、生成された仕様、ルール、メモリはリポジトリに保存され、将来の再利用が可能です。

誰が恩恵を受けるか？

  • Claude Code や Codex を既に使用しているが、体系的で再現可能なワークフローを望むソフトウェアエンジニア。
  • 共有仕様、品質ゲート、AI 生成知識をメンバー間で永続化したいチーム。
  • トークンコストを抑えつつ、AI アシスタントを安全でテスト駆動の形で活用したいソロ開発者。

リンク

関連

  • プロジェクト
    sangrokjung/claude-forge

    A professional equipment pack for Claude Code that adds specialist agents, safety hooks, and automated workflows to transform the terminal AI into a full-scale development kit.

  • プロジェクト
    wesammustafa/Claude-Code-Everything-You-Need-to-Know

    AnthropicのClaude Code CLIについて、インストール、プロンプト工学、および高度な拡張機能（Skills、Hooks、Sub-agents、Workflows、MCP）を豊富な例で解説する包括的なチュートリアル。開発者がリポジトリ全体のコード分析、編集、テスト、自動化にClaudeを活用できるようにします。

  • プロジェクト
    fengshao1227/ccg-workflow

    Claude Code をマルチモデルオーケストレーターに変換するワークフロー・エンジンで、複雑なソフトウェア開発のため、専門的な作業を他の LLM に委任します。

  • Dispatch
    Claude Codeを極める：カジュアルなプロンプトから自律的なエンジニアリングへ

    CLAUDE.md, カスタムスキル, サブエージェント, および Model Context Protocol を使用して、Claude Code を単純なチャットボットからプログラマブルなエージェントへと変貌させる方法についての深い考察。

  • プロジェクト
    Prorise-cool/Claude-Code-Multi-Agent

    Claude Code Multi‑Agent は、Anthropic の Claude Code プロジェクトに認識能力とエキスパートエージェント機能を追加するオープンソースフレームワークです。Python Hook システムとローカル実行の Ollama モデルを使用して、コードベースの種類を自動検出、ユーザーの意図を分析、300以上ものドメイン固有の「スキル」（バックエンド、フロントエンド、テスト、セキュリティなど）をロードし、自動ドキュメント（DEVELOPMENT.md、KNOWLEDGE.md、CHANGELOG.md）を強制します。リポジトリをクローンし、Ollama、モデル、uv をインストールした後、プロジェクトをリポジトリに配置するだけで、Claude Code は即座にコンテキストを把握し、適切なツールを提案し、`/backend‑specialist` や `/kiro/spec` のようなスラッシュコマンドで操作できます。 主な特徴： - ゼロ構成スタート；すべての設定は `.claude/settings.json` と `prompts.json` に保存。 - セッション開始、ユーザーのプロンプト、ツール使用などに応じて実行される Hooks で、プロジェクト検出、意図分析、ドキュメント更新を処理。 - Skills は `SKILL.md` ファイルで定義され、自動検出される。 - 外部 API を一切使わず、完全にローカルで動作。Git と統合可能。MIT ライセンス。 個人開発者や小さなチームが再現可能でオンプレミスの AI コーディングアシスタントを必要とする場合に最適です。