Waza
무엇인가
Waza는 엔지니어링 습관을 에이전트가 실행할 수 있는 작업 단위로 고정하는 스킬 팩이다. 각 습관은 하나의 작업에 대응하며, 그 작업의 산출물과 금지선, 결과 검증 방법을 먼저 선언하고 경로 선택은 모델에 맡긴다. 규율 대상은 요구사항 검증, 원인 추적, 변경 검토, 자료 수집과 종합, 문서 작성, 프로젝트 상태 점검이다.
어떻게 동작하나
각 스킬은 폴더 하나로 배포되고 SKILL.md 본문, 참조 문서, 보조 스크립트, 실제 실패에서 추출한 gotcha를 담는다. 설치 후 Claude Code에서는 `/check`, `/think`, `/hunt`, `/read`, `/learn`, `/write`, `/health` 같은 슬래시 명령으로 발동하고, Codex에서는 설치된 스킬을 이름으로 호출해 같은 플레이북을 따른다. `/check`는 실행 시점에 대상 저장소의 공개 맥락(README, 패키지 매니페스트, Makefile, CI 워크플로)과 작업 제약만 읽고, 비공개 경로·자격 증명·토큰은 읽지 않는다. 선택 규칙 세 가지는 별도 파일로 붙는다. english는 프롬프트의 영문 오류에 짧은 교정을 덧붙이고, anti-patterns는 행동 전 읽기·범위 확장 금지·요청 없는 요약 금지를 상시 적용하며, waza-routing은 비 Claude 호스트에 스킬 우선 라우팅 힌트를 준다.
무엇과 다른가
프롬프트를 매번 직접 작성하거나 단일 CLAUDE.md에 규칙을 몰아넣는 방식과 구조가 다르다. 습관별로 파일이 분리되어 있고, 각 스킬은 요청된 결과 지점에서 멈추며 다음 스킬로의 연결은 사용자가 명시적으로 지시한다. 프로젝트 맥락은 설치 시점에 하드코딩되지 않고 실행 시점에 공개 파일에서 읽는다. 설정 항목이 많은 대형 묶음 대신 습관 단위로 좁게 유지하고, 각 스킬에 트리거와 단일 책임을 둔다.
어떻게 쓰나
설치는 `npx skills add tw93/Waza -a claude-code codex cursor -g -y` 한 줄로 끝나며, 사본은 공용 스킬 디렉터리 `~/.agents/skills`에 놓이고 Claude Code는 심볼릭 링크로 연결된다. 갱신은 `npx skills update -g -y`. 호스트 플러그인을 쓰려면 Claude Code에서 `/plugin marketplace add tw93/Waza` 후 `/plugin install waza@waza`(네임스페이스 `/waza:check`), Codex에서 `codex plugin marketplace add tw93/Waza` 후 `codex plugin add waza@waza`. Claude Desktop은 waza.zip을 Customize > Skills에서 업로드하고, Pi는 `pi install npm:@tw93/waza`를 쓴다. 첫 사용은 `/think`로 계획을 세우고 승인한 뒤 "implement X"를 지시하고 `/check`로 검토하는 흐름이다.
전제와 한계
Claude Code, Codex, Cursor, Gemini CLI, Copilot, Amp, Kimi Code CLI, Antigravity CLI, Qwen Code, Pi, Claude Desktop에서 동작하며, npx skills CLI나 호스트 플러그인 관리자가 선행되어야 한다. 일반 엔지니어링 습관만 담고 프로젝트 고유 규칙은 담지 않으므로 저장소별 규약은 별도로 주입해야 한다. `/check`의 맥락 수집은 공개 파일로 한정되고, 상태 표시줄은 Claude Code에서 사용률, Codex에서 잔여 할당량을 보여 주는 차이가 있다. 제거는 `npx skills remove tw93/Waza -g`와 규칙 파일 삭제로 한다.