Zoku: 클로드 코드에서 반복되는 워크플로우를 자동으로 감지하는 도구

Zoku는 Claude Code 세션을 모니터링하여 반복되는 워크플로우를 발견하고 자동화하기 위해 Claude Code로 구축된 도구입니다. 이 도구는 개발자가 grep 실행, 파일 열기, 편집, 테스트 실행, 린팅 문제 수정과 같은 동일한 작업 순서를 매일 반복 수행하고 있음을 깨닫고 만들어졌습니다.

작동 방식

Zoku는 hookSpecificOutput, PostToolUse, Stop, SessionStart, UserPromptSubmit과 같은 특정 훅을 사용하여 Claude Code의 이벤트 시스템과 통합됩니다. 세션 동안 모든 도구 작업을 조용히 기록합니다. 여러 세션에서 데이터를 수집한 후, 시퀀스를 분석하여 "Grep 후 Read 후 Edit 후 Bash 후 Bash"와 같은 패턴이 여러 세션에 걸쳐 나타나는 것을 찾아냅니다.

새로운 세션을 시작할 때, Zoku는 발견된 패턴을 Claude에게 전달하여 Claude가 식별된 워크플로우를 사전에 제안하거나 자동으로 실행할 수 있도록 합니다.

주요 기능 및 세부 사항

• 종료 코드 및 오류를 포함한 도구 응답을 캡처합니다.
• MCP 도구 이름을 정규화합니다(예: mcp__github__push_files를 github:push_files로 변환).
• 사용자 프롬프트를 기록하여 의도와 실제 도구 사용을 상관관계를 분석할 수 있도록 합니다.
• 패턴은 Claude Code의 컨텍스트 압축을 통해 유지되며 자동으로 재주입됩니다.
• 설정이 필요하지 않으며 외부 의존성이 없습니다.
• 모든 데이터는 로컬에 유지되며 ~/.zoku/에 저장됩니다. 외부로 전송되는 것은 없습니다.
• 현재 버전 0.1.2이며, macOS, Windows, Linux에서 67개의 테스트를 통과했습니다.

설치 및 사용법

pip를 통해 설치: pip install zoku

설정 명령: python -m zoku setup

설치 후 Claude Code를 정상적으로 사용하세요. 두 개 이상의 세션을 완료한 후, 감지된 패턴을 확인하려면: python -m zoku patterns

개발 상태 및 향후 계획

이 도구는 초기 개발 단계이지만 적극적으로 유지 관리되고 있습니다. 계획된 기능으로는 워크플로우 재생, 프로젝트 간 패턴 집계, 에이전트 간 변환이 있습니다. 후자는 Claude Code에서 워크플로우를 기록하고 Cursor와 같은 다른 에이전트에서 재생할 수 있도록 합니다.

소스 코드는 GitHub에서 확인할 수 있습니다: https://github.com/kasparovabi/zoku.