nWave-ai/nWave

nWave – Claude Code용 AI 기반 기능 제공 보조 도구

무엇인가요

• Anthropic의 Claude Code IDE 내부에 존재하는 AI 에이전트 세트로, 구조화된 7단계 '웨이브' 워크플로우(Discover → Diverge → Discuss → Design → DevOps → Distill → Deliver)를 통해 개발자를 안내합니다.
• 각 웨이브는 전용 에이전트가 처리하며, 문서, 설계, 테스트, 코드 등의 아티팩트를 생성합니다. 다음 웨이브가 시작되기 전에 인간이 검토합니다. 시스템은 인간의 승인 없이 종단 간 실행을 수행하지 않습니다.

작동 방식

• 설치는 단일 스크립트로, 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. 각 에이전트가 생성한 아티팩트(마크다운 문서, 설계 다이어그램, 테스트 파일)를 다음 웨이브 승인 전에 검토합니다.

품질 및 토큰 효율성

• 엄격성 프로파일을 통해 언어 모델 크기(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, 페어 리뷰, 인프라스트럭처 as 코드를 포함한 체계적인 AI 보조 워크플로우를 프로젝트 간에 표준화하고자 하는 팀.
• Claude Code의 코드 생성 기능을 활용하면서도 엔지니어링 최고 관행을 강제할 수 있는 조직.

---

위 정보는 리포지토리의 README에서 직접 가져왔으며, 추가 기능은 추측되지 않았습니다.