kwike - 유닉스 철학을 적용한 에이전트 간 오케스트레이션 도구

실용적 조언

반복적인 Git 작업이나 문서 업데이트 자동화 시 kwike의 watch 기능을 사용하여 변경 사항을 실시간으로 에이전트에게 전달할 수 있다.
에이전트 워크플로우 설계 시 JSON 스키마를 정의하여 에이전트의 출력이 다음 단계의 입력으로 적합한지 항상 검증해야 한다.

섹션별 상세

kwike는 SDK나 하네스 대신 유닉스의 파이프, 추가 전용 로그, 이벤트 구독 방식을 사용하여 에이전트 워크플로우를 구성한다. 사용자는 CLI를 통해 이벤트를 발행하거나 구독하며, 이는 복잡한 라이브러리 의존성 없이도 기술적인 문제를 해결하는 도구로 작동한다. 반복적인 버전 업그레이드나 문서 관리와 같은 지루한 작업을 자동화하는 데 최적화되어 있다.

시스템은 dispatch, consume, daemon이라는 세 가지 기본 요소로 구동된다. dispatch는 이벤트 저장소에 메시지를 발행하고, consumer는 구독 중인 파티션에서 메시지를 가져오며, daemon은 메시지 전달을 관리하는 메일 서버 역할을 수행한다. 이러한 구조는 한 에이전트의 도구 사용 결과가 다른 에이전트의 전용 워크플로우를 트리거하는 반응형 시스템을 가능하게 한다.

bash

# watch a git repo, dispatch changes, consume with an agent
kwike watch "git diff --stat HEAD~1" --type repo.change --interval 60s
kwike consume --config ./agents/writer/consumer.yaml

Git 변경 사항을 감시하고 에이전트가 이를 소비하도록 실행하는 CLI 명령어 예시

kwike 시스템의 에이전트 간 통신 흐름을 보여주는 시퀀스 다이어그램이다. — Diagramdispatch에서 시작된 문서 업데이트 요청이 daemon을 거쳐 writer와 reviewer 에이전트 사이에서 어떻게 순환되는지 보여준다. 특히 리뷰 결과에 따라 세션을 새로 시작하거나(fresh session) 기존 세션을 재개하는(resumes session) 로직이 시각화되어 있어 워크플로우 제어 방식을 이해하는 데 핵심적인 정보를 제공한다.

각 워크플로우 단계는 'uniform'이라 불리는 프롬프트 템플릿을 통해 실행된다. LLM이 일관된 계약(Contract)에 따라 데이터를 생산하도록 강제하기 위해 JSON 스키마를 사용하여 에이전트의 출력을 검증한다. 이를 통해 서로 다른 에이전트와 스크립트가 컨텍스트를 안전하게 교환하며 복잡한 작업을 수행할 수 있는 기반을 마련한다.

Claude-Code와 연동 시 이벤트 타입에 따라 세션을 새로 시작하거나 기존 세션을 재개하는 기능을 제공한다. 예를 들어 리뷰가 거절된 경우(task.review.rejected) 기존 세션을 재개하여 이전 맥락을 유지한 채 수정을 진행하고, 새로운 작업(task.implement)은 신규 세션으로 처리한다. 이 방식은 대화형 세션을 유지함으로써 작업 속도를 높이고 불필요한 컨텍스트 소모를 줄인다.

yaml

source:
  types:
    - "task.implement" # subscribed events
    - "task.review.rejected"
    - "task.review.approved"
session:
  fresh_types: [task.implement] # these create new sessions
  resume_types: [task.review.rejected] # these resume existing sessions
  # task.review.approved is neither → defaults to fresh

이벤트 타입에 따라 LLM 세션을 새로 시작하거나 재개하도록 설정하는 YAML 구성 예시

용어 해설

유닉스 철학(Unix Philosophy): — 각 프로그램이 하나의 일을 잘 수행하도록 만들고, 텍스트 스트림을 통해 서로 통신하며 복잡한 워크플로우를 구성하는 소프트웨어 개발 원칙이다. 이 아티클에서는 에이전트 오케스트레이션을 위해 SDK 대신 파이프와 로그 같은 유닉스 기본 요소를 사용하는 근거가 된다.
에이전트 워크플로우(Agentic Workflow): — LLM 에이전트가 목표 달성을 위해 일련의 단계나 도구 사용을 자율적으로 수행하는 과정이다. kwike는 이러한 워크플로우를 이벤트 기반 아키텍처로 조율하여 반복적인 기술적 작업을 자동화한다.
JSON 스키마(JSON Schema): — JSON 데이터의 구조를 정의하고 유효성을 검사하기 위한 선언적 언어이다. 에이전트가 생성한 출력이 정해진 형식을 따르는지 검증하여 에이전트 간 데이터 교환의 신뢰성을 보장하는 데 사용된다.
유향 비순환 그래프(DAG): — 방향은 있지만 순환하지 않는 그래프 구조로, 작업 간의 의존 관계와 실행 순서를 정의한다. kwike는 워크플로우의 정적 분석을 통해 설정된 작업 흐름이 올바른 DAG 구조를 갖는지 검증한다.

언급된 도구

kwike추천

유닉스 철학 기반의 에이전트 워크플로우 오케스트레이션 도구

Claude Code추천

세션 재개 기능을 지원하는 Anthropic의 코딩 에이전트

언급된 리소스

GitHubkwike 소스 코드 저장소