Argus는 Claude Code에 대해 결정론적 워크플로우 (deterministic workflows)를 강제하여, AI 추론 (reasoning)을 구조화된 실행 경로 (structured execution paths)로 대체함으로써 토큰 사용량을 약 80% 절감합니다. 몇 분 안에 설치할 수 있습니다.
변경 사항 — Argus가 Claude Code에 결정론적 워크플로우를 도입하다
Argus는 Claude Code가 반복적인 워크플로우를 처리하는 방식을 변화시키는 새로운 오픈 소스 에이전트 기술 (agent skill)입니다. AI가 이전에 수백 번 수행했던 작업의 모든 단계를 매번 추론하게 하는 대신, Argus는 미리 정의된 실행 경로를 강제합니다. 그 결과는 무엇일까요? 정확도의 손실 없이 반복적인 작업에서 토큰 사용량을 최대 80%까지 줄일 수 있습니다.
네 가지 사용 사례(벤치마크 참조)에 걸쳐 측정된 결과, Argus는 토큰 소모가 많은 AI 추론의 추측 과정을 구조화된 흐름으로 대체합니다. Argus는 상태 변화 (state changes)를 추적하며, 현재 단계에 필요한 정확한 컨텍스트 (context)만을 에이전트에 제공합니다. 즉, 전체 파일이나 대화 기록을 컨텍스트 윈도우 (context window)에 통째로 쏟아붓는 일이 더 이상 발생하지 않습니다.
사용자에게 미치는 의미 — 일상적인 Claude Code 사용에 미치는 구체적인 영향
다음 중 하나라도 Claude Code를 사용하고 있다면, Argus는 귀하의 비용과 시간을 직접적으로 절약해 줍니다:
- CI/CD 파이프라인 (pipelines) — 여러 프로젝트에 걸쳐 동일한 린팅 (linting), 테스트 또는 배포 단계를 실행할 때
- 코드 리뷰 워크플로우 (Code review workflows) — 모든 PR에 일관된 분석 패턴을 적용할 때
- 리팩터링 (Refactoring) 작업 — 코드베이스 전체에 동일한 구조적 변경을 적용할 때
- 문서 생성 (Documentation generation) — 모든 API 엔드포인트에 대해 동일한 프로세스를 따를 때
Claude Code가 매번 "이 프로젝트를 어떻게 린팅할까?"라고 다시 추론하는 대신, Argus는 다음과 같이 지시합니다: 1단계 실행, 그다음 2단계, 그다음 3단계 실행. AI는 수정 전략을 선택하는 것과 같이 실제 추론이 필요한 단계에서만 활성화됩니다. 그 외의 모든 것은 결정론적 (deterministic)입니다.
지금 바로 시도해보세요 — 설치 및 첫 번째 워크플로우 실행
설치
botcircuits-agent-solution
curl -fsSL https://raw.githubusercontent.com/botcircuits-ai/botcircuits-argus/main/scripts/install.sh | bash
그 다음, 프로젝트 폴더에서 초기화합니다:
이 명령은 .botcircuits/settings.json 파일을 생성하고 워크플로우 스킬 (workflow skills)을 ~/.claude/skills에 설치합니다.
워크플로우 작성 (Authoring a Workflow)
Claude Code에게 평이한 언어로 프로세스를 설명하세요. 작성 (authoring) 스킬이 여러분을 대신해 워크플로우 JSON을 작성해 줍니다. 예를 들어:
"변경되었던 모든 파일에 대해 린트 (lint)를 수행하고, 단위 테스트 (unit tests)를 실행한 다음, 커버리지 (coverage)를 보고하는 워크플로우를 생성해 줘. 린트 에러를 수정하는 것에 대해서만 추론(reason)하고, 나머지는 결정론적 (deterministic)으로 처리해."
Argus가 흐름 구조를 생성합니다. 원한다면 JSON을 직접 작성할 수도 있습니다.
워크플로우 실행 (Running a Workflow)
작성이 완료되면 실행을 트리거합니다:
botcircuits run <workflow-name>
Argus는 각 단계를 Claude Code로 전달하며, 해당 단계에 필요한 컨텍스트 (context)만 제공합니다. AI는 전체 워크플로우를 보는 것이 아니라, 오직 현재 작업만을 보게 됩니다.
고급 설정 (Advanced Configuration)
.botcircuits/settings.json에서 런타임 (runtime) 설정을 재정의할 수 있습니다:
{
"runtime": "claude-code",
"runtimes": {
...
{prompt}는 Argus가 각 단계의 세그먼트 프롬프트 (segment prompt)로 대체하는 플레이스홀더 (placeholder)입니다. 설치 시 --link를 사용하면 스킬들을 심볼릭 링크 (symlink)로 연결하여 업데이트를 자동으로 가져올 수 있습니다:
전문가 팁: 유지보수가 필요 없는 업데이트를 위한 심볼릭 링크 (Symlink)
botcircuits init --link --runtime claude-code
이제 Argus가 업데이트되면, 여러분의 Claude Code 스킬들도 자동으로 업데이트됩니다. 재설치가 필요하지 않습니다.
출처: github.com
원문 게시지: gentic.news