PocketTeam: 후크 기반 안전성과 학습 에이전트를 갖춘 Claude 코드 파이프라인

PocketTeam의 기능

PocketTeam은 Claude Code 기반으로 구축된 파이프라인으로, 도구 호출 수준에서 안전성을 강제하고 시스템이 모든 작업 실행 후 개선되는 학습 메커니즘을 구현합니다.

주요 기능

• 훅 기반 안전성(프롬프트 기반 아님): 9개의 안전 계층이 도구 호출이 실행되기 전에 이를 가로챕니다. .env에 대한 쓰기, rm -rf /, DROP DATABASE 명령어와 같은 위험한 작업은 런타임 계층에서 차단됩니다. 이러한 규칙은 LLM의 컨텍스트가 아닌 훅 코드에 구현되어 프롬프트 주입이나 컨텍스트 압축 공격에 강합니다.
• 학습 시스템: Observer 에이전트가 모든 완료된 작업 끝에 실행됩니다. 무슨 일이 일어났는지, 무엇이 작동했는지, 무엇이 작동하지 않았는지 분석하고 에이전트별 파일에 구조화된 학습 내용을 작성합니다. 이러한 파일은 향후 에이전트 컨텍스트에 주입되어 에이전트가 이전 실행에서 저지른 실수를 피할 수 있게 합니다.
• GitHub Actions를 통한 자가 복구: 빌드가 실패하면 GitHub Actions 워크플로우가 자동으로 Claude Code 세션을 트리거합니다. 수정 계획을 생성하고 Telegram을 통해 승인을 요청하여 원격 빌드 실패 해결을 가능하게 합니다.
• 59개의 내장 스킬: OWASP 감사 워크플로우, TDD 루프(ralph: mode), 코드베이스 매핑, 데이터베이스 진단, 비용 추적, 작업 트리 분리와 함께하는 팬아웃 병렬 실행 등을 포함하는 구조화된 절차 라이브러리입니다.
• 매직 키워드: autopilot: add dark mode(전체 파이프라인, 인간 개입 없음), ralph: fix failing tests(최대 5회 반복으로 테스트 통과까지 TDD 루프), quick: rename this var(직접 구현으로 이동), deep-dive: our DB schema(3개의 병렬 연구 에이전트)와 같은 명령어입니다.
• 내장 헤드리스 브라우저(ptbrowse): 스크린샷(수천 개의 토큰) 대신 접근성 트리 스냅샷(호출당 약 100–300 토큰)을 사용합니다. QA 에이전트는 실제 Chromium 브라우저에서 페이지를 탐색하고, 요소를 클릭하고, 양식을 작성하고, 조건을 기다리고, 어설션을 실행할 수 있습니다. 스크린샷도 사용 가능하며 .pocketteam/screenshots/에 저장됩니다.
• 실시간 대시보드: pt dashboard 명령어는 Docker에서 실시간 에이전트 활동을 표시하며, 실행 중인 작업, 통과한 작업, 실패한 작업을 보여줍니다.
• Telegram 원격 제어: 모바일 장치에서 양방향 제어 및 계획 승인을 위한 네이티브 Claude Code 채널 플러그인입니다.

설치 및 이용 가능성

pipx install pocketteam을 통해 설치하세요. 이 도구는 Claude Code 구독 시 무료로 이용 가능하며 MIT 라이선스로 배포됩니다. Source는 https://github.com/Farid046/PocketTeam에서 확인할 수 있습니다.