일반인을 위한 Claude Code 팀 설정: "Claudio" v2를 소개합니다

얼마 전 저는 CC(Claude Code)를 위한 세션 로그 설정을 공유한 적이 있습니다. 그것이 어떻게 발전했는지 소개합니다.

시작 단계: 로그

저의 첫 번째 실제 CC 프로젝트는 노트북이 충돌하면서 끝이 났습니다. 채팅도 사라지고, 컨텍스트(Context)도 사라졌습니다. CC는 세션 간의 메모리(Memory)가 없어서 매번 모든 것을 다시 설명해야 합니다. 그래서 저는 세션 로그를 만들었습니다. CC가 자동으로 생성하고, 작업을 수행하기 전에 읽으며, 세션 내내 업데이트하는 마크다운(Markdown) 파일입니다.

기능:

• 결정 사항, 버그, 다음 단계 등을 발생하는 즉시 캡처합니다.
• 작업 흐름을 끊지 않고 세션 중간에 보류 항목을 추가할 수 있습니다 ("이걸 보류 항목에 추가해줘: 모바일의 인증 오류 수정"). 로그가 이를 캡처하면 당신은 계속 진행하면 됩니다.
• 자체적으로 가지치기(Self-prunes)를 합니다: 새로운 항목이 나타나면 추가하고, 해결된 항목은 삭제합니다. 해결하려던 문제 자체가 비대해지는 것을 방지합니다.

발전 단계: 하나의 팀

Claudio가 오케스트레이터(Orchestrator)로서 최상단에 위치합니다. 에이전트(Agents)들은 행동하는 시점에 따라 조직됩니다: 어떤 것들은 위험한 행동 전에 실행되고, 어떤 것들은 온디맨드(On-demand)로 실행되며, 어떤 것들은 세션 종료 시 자동으로 실행됩니다.

실제 워크플로우

새 프로젝트:

"XYZ를 만들고 싶어"와 같이 말합니다. Claudio는 로그를 생성하고, Architect를 호출하여 범위를 정의하며, 공유 참조 문서인 PRODUCT.md를 생성합니다.

기존 프로젝트:

디렉토리에서 CC를 열고 "이 작업을 재개하고 싶어"라고 말하기만 하면 됩니다. Claudio는 로그를 읽고 다음과 같이 응답합니다: "지난 세션에서 X를 완료했고, Y가 보류 중입니다. 거기서부터 시작할까요, 아니면 새로운 것을 할까요?"

세션 종료:

"종료할게" 또는 "가봐야 해"라고 말합니다. Claudio는 로그를 업데이트한 다음, 일괄 요약(Batched summary)을 제안합니다: 변경된 사항에 대한 QA 실행, UI 검토, 배포 확인 등. 당신은 지금 처리할 것과 다음으로 남겨둘 것을 선택합니다.

시간이 흐를수록 학습하는 당신의 팀

• 각 에이전트는 프로젝트와 함께 성장하는 메모리(Memory) 섹션을 가집니다.
• 인터넷에서 발견한 새로운 리포지토리(Repo)를 Claudio에게 가리키며 "좋은 점은 무엇이고, 나쁜 점은 무엇이며, 우리가 무엇을 적용할 수 있을까?"라고 물을 수 있습니다. 최근에 몇몇 유명한 리포지토리를 대상으로 이를 수행해 보았습니다. 결론: 시스템이 이미 수행하고 있는 기능과 중복되었습니다.

포함된 내용

CLAUDE.md: 오케스트레이터 (orchestrator) 정의, 라우팅 (routing), 세션 종료 절차
6개의 에이전트 (agent) 파일 (Architect, QA, Impact Analyst, UX Designer, Production Auditor, Migration Auditor)
2개의 Node 훅 (hooks): 세션 추적 (session tracking) 및 긴급 신호 탐지 (urgency signal detection)
템플릿 및 설정 문서

이름은 Claudio입니다. Claudio는 Claude의 스페인어 형태이며, 언어유희를 의도했습니다. :)
github.com/juandanielreich/claudio
각 구성 요소가 어떻게 작동하는지에 대한 질문은 언제든 환영합니다.
제출자: /u/JuandaReich
[link] [comments]