nWave-ai/nWave

nWave – Claude Code向けAI駆動型機能提供アシスタント

何であるか

• AnthropicのClaude Code IDE内に存在するAIエージェントのセットで、構造化された7ステップ「ウェーブ」ワークフロー（discover → diverge → discuss → design → devops → distill → deliver）に開発者を導く。
• 各ウェーブは専任エージェントが処理し、文書、設計、テスト、コードなどのアーティファクトを生成する。それらは次のウェーブが開始される前に人間がレビューする。システムは人間の承認なしにエンドツーエンドで実行されることはない。

動作方法

• インストールは1つのスクリプトで、nwave‑ai CLIを追加し、エージェントをClaude Codeプラグインとして登録する。CLIはuv（推奨）またはpipxでインストール可能。
• Claude Code内でスラッシュコマンドでエージェントを呼び出す。例：/nw‑discover、/nw‑design、/nw‑deliver。/nw‑buddyというコンシェルジュコマンドで次に開始すべきウェーブを知ることができる。
• DES（Design‑Enforcement‑System）レイヤーがすべてのエージェント呼び出しを監視し、TDDフェーズ、ペアレビュー要件、その他の厳格性プロファイルを強制する。安全でない編集はブロックされ、明確なメッセージが報告される。
• /nw‑rigorでプロジェクトごとに厳格性を調整可能（リーン、スタンダード、トゥーサム、エクステンシブ、またはカスタムプロファイル）。トークンコストと品質のバランスを取れる。

主要概念

ウェーブ	通常のエントリポイント	エージェント	目的
DISCOVER	グリーンフィールド開始	product‑discoverer	市場／問題領域の探索
DIVERGE	グリーンフィールドのブレインストーミング	nw‑diverger	複数の可能な解決策の生成
DISCUSS	任意のプロジェクト	product‑owner	要件とユーザー体験の記述
DESIGN	すべて	system‑designer, ddd‑architect, solution‑architect	アーキテクチャとドメインモデル
DEVOPS	すべて	platform‑architect	インフラストラクチャとデプロイメント計画
DISTILL	すべて	acceptance‑designer	受け入れテスト（Given‑When‑Then）
DELIVER	すべて	software‑crafter	TDD実装（RED→GREEN→COMMIT）

インストール（5分）

sh -c "$(curl -fsSL https://raw.githubusercontent.com/nWave-ai/nWave/main}/scripts/install/install.sh)"

• Python 3.10+と実行中のClaude Codeインスタンスが必要。
• スクリプトはCLI（nwave‑ai）をインストールし、エージェントを~/.claude/にコピーする。
• オプション：より高速で隔離されたインストールにはuvを使用；pipxも利用可能。

通常の最初のステップ

1. Claude Codeを開き、/nw‑buddy What should I do next?を実行する。バディが次のウェーブを指示する。
2. 次の順序でウェーブコマンドを実行する。例：

   /nw‑diverge "authentication approaches"
   /nw‑discuss "login with email & password"
   /nw‑design --architecture=hexagonal
   /nw‑distill "user‑login"
   /nw‑deliver
   

3. 各エージェントが生成するアーティファクト（Markdownドキュメント、設計図、テストファイル）を承認する前にレビューする。

品質とトークン効率

• 厳格性プロファイルにより、言語モデルのサイズ（haiku, sonnet, opus）を選択し、ミューテーションテストやペアレビューの実行可否を決定できる。
• リーンモードでは最小モデルを使用しレビュアーをスキップ。スパイクに最適。エクステンシブモードでは最大モデルを使用し、プロダクションに重要なコードに対して完全なミューテーションテストを実行。

メンテナンス

• CLIはClaude Code起動時に更新をチェック。uv tool upgrade nwave‑ai && nwave‑ai install（または同等のpipxコマンド）でアップグレード可能。
• nwave‑ai uninstallでアンインストール。エージェント、コマンド、DESフックは削除されるが、プロジェクトファイルはそのまま残る。

ドキュメントとコミュニティ

• 完全なドキュメントは docs.nwave.ai で提供 – ガイド、リファレンス、リリースごとにバージョン管理。
• クイックスタートチュートリアル：Your First Feature。
• サポートと議論のためのDiscordコミュニティ。
• 問題と貢献はGitHubリポジトリで管理。

対象ユーザー

• 各ステップで完全なコントロールを維持したい個人開発者。
• チームとして一貫した、AI補助型のワークフロー（TDD、ペアレビュー、インフラストラクチャとしてのコード）をプロジェクト間で標準化したいチーム。
• Claude Codeのコード生成機能を活用しつつ、エンジニアリングのベストプラクティスを強制したい組織。

---

上記のすべての情報はリポジトリのREADMEから直接取得；追加機能は推測されていない。