Anthropic의 Claude Code 사용을 위한 서브에이전트, 명령어, 스킬, 훅, 메모리, 워크플로를 다루는 엄선된 최신 모범 사례 가이드이자 참고 자료입니다.
nWave-ai/nWave
Claude Code에서 기능을 아이디어부터 테스트 코드까지 진행하는 전문 AI 에이전트 워크플로 프레임워크로, 각 단계 사이에 사람이 검토합니다.
- 스타
- 633
- 포크
- 67
- 열린 이슈
- 33
- 마지막 커밋
- 4시간 전
어떤 프로젝트인가요?
nWave는 Claude Code 안에서 실행되며 기능 개발을 discover, diverge, discuss, design, devops, distill, deliver의 7개 웨이브로 구성하는 AI 에이전트 모음입니다. 전문 에이전트는 각 웨이브에서 요구사항, 아키텍처, Given-When-Then 인수 테스트 같은 문서 산출물을 만들고, 다음 웨이브가 시작되기 전에 개발자가 이를 검토하고 승인합니다.
이 프로젝트는 에이전트, 명령어, 훅을 ~/.claude/에 연결하는 nwave-ai CLI를 설치합니다. DES 훅은 구현 중 TDD 단계별 게이트를 적용하며, 활성화된 딜리버리 세션 밖에서 수정이 이뤄지면 차단할 수 있습니다. 저장소별로 프로젝트 참여 여부를 설정할 수 있고, /nw-rigor 설정으로 검토 깊이와 TDD 엄격도를 간소한 수준부터 철저한 수준까지 조정합니다. 설계 단계에서 중복 규칙을 찾아내는 feature-delta validator와 outcomes registry도 포함되어 있습니다.
설치 프로그램은 Claude Code, OpenCode, OpenAI Codex CLI를 지원하며 Python 3.10 이상이 필요합니다. Windows 사용자는 WSL을 사용해야 합니다.
핵심 기능
- 01발견부터 TDD 기반 딜리버리까지 이어지는 7단계 워크플로와 단계별 검토 게이트.
- 02요구사항, 아키텍처, 인수 테스트, 구현을 담당하는 전문 에이전트.
- 03DES 훅으로 TDD 단계를 적용하고 활성화된 딜리버리 세션 밖의 소스 코드 수정을 차단.
- 04린부터 철저한 수준까지 에이전트 모델, 동료 검토, 변이 테스트를 조정하는 엄격도 프로필.
- 05설계 단계 검증을 위한 feature-delta validator와 outcomes registry.
- 06Claude Code, OpenCode, Codex CLI 지원.
활용 사례
- 기존 코드베이스에 새 기능을 추가하면서 요구사항과 인수 테스트를 먼저 문서화할 때.
- 코드를 작성하기 전에 체계적인 설계 검토를 진행할 때.
- 여러 개발자가 AI 지원을 받아 같은 프로젝트에서 작업하면서 TDD 규율을 적용할 때.
- 변경 위험도에 따라 검토 깊이를 조정할 때.
빠른 시작
- 1
Python 3.10 이상과 Claude Code가 설치되어 있는지 확인합니다
- 2
README에 있는 공식 설치 스크립트를 실행합니다
- 3
설치 프로그램이 완료되면 Claude Code를 다시 시작합니다
- 4
Claude Code에서 buddy에게 다음에 무엇을 해야 하는지 물어봅니다
/nw-buddy What should I do next?
사용 전 알아둘 점
- nWave가 내부에서 실행되는 Claude Code가 필요합니다.
- Windows 사용자는 WSL을 사용해야 합니다.
- DES 적용이 작동하지 않으므로 플러그인 마켓플레이스를 통한 설치는 지원되지 않습니다.
- 알려진 메타데이터 수정 문제 #78은 v3.22.1에서 아직 해결되지 않았습니다.
포함된 컬렉션
토픽
자주 묻는 질문
- nWave은(는) 무엇인가요?
- Claude Code에서 기능을 아이디어부터 테스트 코드까지 진행하는 전문 AI 에이전트 워크플로 프레임워크로, 각 단계 사이에 사람이 검토합니다. nWave는 Claude Code 안에서 실행되며 기능 개발을 discover, diverge, discuss, design, devops, distill, deliver의 7개 웨이브로 구성하는 AI 에이전트 모음입니다. 전문 에이전트는 각 웨이브에서 요구사항, 아키텍처, Given-When-Then 인수 테스트 같은 문서 산출물을 만들고, 다음 웨이브가 시작되기 전에 개발자가 이를 검토하고 승인합니다.
- nWave은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- nWave은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- nWave은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. nWave의 마지막 커밋은 2026년 11월 7일입니다.
- nWave은(는) 어디에 사용할 수 있나요?
- 기존 코드베이스에 새 기능을 추가하면서 요구사항과 인수 테스트를 먼저 문서화할 때. 코드를 작성하기 전에 체계적인 설계 검토를 진행할 때. 여러 개발자가 AI 지원을 받아 같은 프로젝트에서 작업하면서 TDD 규율을 적용할 때. 변경 위험도에 따라 검토 깊이를 조정할 때.
- nWave는 어떻게 설치하나요?
- Python 3.10 이상과 Claude Code가 설치되어 있는지 확인합니다 README에 있는 공식 설치 스크립트를 실행합니다 설치 프로그램이 완료되면 Claude Code를 다시 시작합니다 Claude Code에서 buddy에게 다음에 무엇을 해야 하는지 물어봅니다: /nw-buddy What should I do next?
- nWave은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/nWave-ai/nWave
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
Claude Code와 Codex에 멀티 에이전트 스웜, 자가 학습 메모리, 벡터 검색, 머신 간 에이전트 연합을 추가하는 에이전트 하네스입니다.
AI 에이전트가 하나의 상위 목표를 바탕으로 소프트웨어를 만들고 검증하며 발전시키도록 협업하는 오픈소스 Elixir 시스템입니다.
Claude Code와 Codex 같은 코딩 어시스턴트를 위한 TDD, 버그 진단, 계획 수립, 코드 리뷰 등의 에이전트 스킬 모음
AI 에이전트를 시각적으로 만들고 모델과 MCP 도구를 연결해 채팅이나 자동화에서 실행하는 오픈소스 로컬 우선 워크스페이스입니다.
superpowers AI 코딩 스킬 프레임워크를 중국어로 완역하고 중국 개발자용 스킬 4종을 추가해, AI 코딩 도구 26종에 설치할 수 있는 프로젝트입니다.