cytostack/openwolf

Claude Code를 위한 두 번째 뇌.

6개의 훅 스크립트 (hook scripts)를 통해 프로젝트 인텔리전스 (Project intelligence), 토큰 추적 (token tracking), 그리고 보이지 않는 강제 실행 (invisible enforcement)을 제공합니다. 워크플로우의 변화는 전혀 없습니다.

Claude Code는 강력하지만 눈을 가린 채 작동합니다. 파일을 열기 전까지는 파일에 무엇이 들어있는지 알지 못합니다. 50토큰짜리 설정 파일과 2,000토큰짜리 모듈을 구분할 수 없습니다. 한 세션 내에서 동일한 파일을 인지하지 못한 채 여러 번 읽기도 합니다. 프로젝트에 대한 인덱스 (index)도, 사용자의 수정 사항에 대한 기억 (memory)도, 이미 시도했던 것에 대한 인식 (awareness)도 없습니다.

OpenWolf는 Claude에게 두 번째 뇌를 제공합니다: 파일을 읽기 전에 파일 내용을 알 수 있게 해주는 파일 인덱스 (file index), 사용자의 선호도와 과거의 실수를 축적하는 학습 메모리 (learning memory), 그리고 모든 것을 추적하는 토큰 원장 (token ledger)입니다. 이 모든 것은 Claude의 모든 동작에서 실행되는 6개의 보이지 않는 훅 스크립트 (hook scripts)를 통해 이루어집니다.

대규모 활성 프로젝트에서 테스트되었습니다. 동일한 코드베이스 (codebase)와 동일한 프롬프트 (prompts)를 사용하되, 설정만 다르게 했습니다:

OpenClaw + Claude ██████████████████████████████████████ ~3.4M tokens
Claude CLI (no OpenWolf) ████████████████████████████████ ~2.5M tokens
OpenWolf + Claude CLI ████████ ~425K tokens

OpenWolf는 동일한 프로젝트에서 순수 Claude CLI를 사용했을 때보다 약 80%의 토큰을 절약했습니다.

20개의 프로젝트, 132개 이상의 세션에 걸쳐 테스트한 결과: 평균 토큰 감소율은 65.8%였으며, 반복적인 파일 읽기의 71%를 포착하여 차단했습니다. 이 수치들은 벤치마크 (benchmarks)가 아닌 실제 사용 데이터입니다. 결과는 프로젝트 규모와 사용 패턴에 따라 달라질 수 있습니다.

npm install -g openwolf
cd your-project
openwolf init

그게 전부입니다. 평소처럼 claude를 사용하세요. OpenWolf가 지켜보고 있습니다.

openwolf init은 프로젝트 내에 .wolf/ 디렉토리 (directory)를 생성합니다:

파일	용도
anatomy.md	설명 및 토큰(token) 추정치가 포함된 프로젝트 파일 맵 (map)
cerebrum.md	학습된 선호도, 수정 사항, Do-Not-Repeat (반복 금지) 목록
memory.md	토큰 추정치가 포함된 연대순 작업 로그 (log)
buglog.json	버그 수정 메모리, 검색 가능하며 재발견 방지
token-ledger.json	누적 토큰 추적 및 세션 기록
hooks/	6개의 Claude Code 라이프사이클 훅 (lifecycle hooks, 순수 Node.js)
config.json	합리적인 기본값이 설정된 구성 (configuration)
identity.md	이 프로젝트를 위한 에이전트 페르소나 (persona)
OPENWOLF.md	Claude가 매 세션마다 따르는 지침 (instructions)

Claude가 파일을 읽기 전에, OpenWolf는 해당 파일에 무엇이 들어있는지, 크기가 어느 정도인지 알려줍니다. 만약 Claude가 이번 세션에서 이미 해당 파일을 읽었다면, OpenWolf는 이를 경고합니다. Claude가 코드를 작성하기 전에, OpenWolf는 알려진 실수를 방지하기 위해 사용자의 cerebrum.md를 확인합니다. 모든 작성 작업이 끝난 후에는 프로젝트 맵을 자동으로 업데이트하고 토큰 사용량을 기록합니다. 사용자는 이 과정 중 아무것도 볼 수 없습니다. 그저 자동으로 일어날 뿐입니다.

사용자가 메시지를 입력함
↓
Claude가 파일을 읽기로 결정함
...

cerebrum.md - 학습 메모리 (learning memory)

사용자가 Claude를 수정하거나, 선호도를 표현하거나, 결정을 내릴 때 Claude는 이 파일을 업데이트합니다. Do-Not-Repeat (반복 금지) 목록은 세션 전반에 걸쳐 동일한 실수가 반복되는 것을 방지합니다.

## Do-Not-Repeat
- 2026-03-10: `var`를 절대 사용하지 말 것 - 항상 `const` 또는 `let` 사용
- 2026-03-11: 통합 테스트 (integration tests)에서 데이터베이스를 모킹 (mock) 하지 말 것 - 실제 연결을 사용할 것
...

anatomy.md - 프로젝트 맵 (project map)

모든 파일에는 설명과 토큰 추정치가 부여됩니다. 요약 정보만으로 충분할 경우, Claude는 파일을 직접 여는 대신 이 파일을 읽습니다.

## src/
- `index.ts` - 메인 엔트리 포인트 (entry point). CLI를 위한 `createProgram()`을 내보냄 (exports). (~180 tok)
- `server.ts` - 미들웨어 체인 (middleware chain)을 포함한 Express HTTP 서버. (~520 tok)
...

token-ledger.json - 영수증 (receipt)

모든 세션은 항목별로 기록됩니다. 누적 합계를 통해 OpenWolf가 실제로 토큰을 절약하고 있는지 확인할 수 있습니다.

{
"lifetime": {
"total_tokens_estimated": 503978,
...

buglog.json - 버그 메모리 (bug memory)

무엇인가를 수정하기 전에, Claude는 해당 수정 사항이 이미 알려져 있는지 확인합니다. 수정을 마친 후에는 해결 방법을 기록(log)합니다.

{
"id": "bug-012",
"error_message": "TypeError: Cannot read properties of undefined (reading 'map')",
...

openwolf init .wolf/ 디렉토리를 초기화하고 훅(hooks)을 등록합니다
openwolf status 상태, 통계, 파일 무결성을 표시합니다
openwolf scan 프로젝트 구조 맵을 새로고침합니다
...

실행 중인 앱의 전체 페이지 스크린샷을 캡처하여 Claude가 디자인을 평가하게 하세요.

openwolf designqc

개발 서버를 자동 감지하고, 모든 경로(route)의 뷰포트 높이(viewport-height) JPEG 섹션을 캡처하여 .wolf/designqc-captures/에 저장합니다.

그 다음 Claude에게 스크린샷을 읽고 평가하도록 요청하세요. puppeteer-core가 필요합니다.

Claude에게 UI 프레임워크 선택을 도와달라고 요청하세요. OpenWolf는 실전에서 검증된 마이그레이션 프롬프트(migration prompts)와 함께 12개의 프레임워크(shadcn/ui, Aceternity, Magic UI, DaisyUI, HeroUI, Chakra, Flowbite, Preline, Park UI, Origin UI, Headless UI, Cult UI)로 구성된 큐레이션된 지식 베이스를 제공합니다. Claude는 .wolf/reframe-frameworks.md를 읽고, 몇 가지 질문을 던진 후, 귀하의 프로젝트에 적합한 프롬프트를 사용하여 마이그레이션을 실행합니다.

OpenWolf는 AI 래퍼(wrapper)가 아닙니다. 이는 6개의 훅 스크립트(hook scripts)와 .wolf/ 디렉토리입니다. OpenWolf는 귀하를 대신해 AI를 실행하거나 워크플로우를 변경하지 않습니다. 대신 Claude Code에 부족한 것들을 제공합니다: 읽어야 할 양을 줄여주는 프로젝트 맵(project map), 더 빠르게 학습할 수 있게 하는 메모리(memory), 그리고 토큰이 어디로 소비되는지 확인할 수 있는 원장(ledger)입니다.

• Node.js 20 이상

• Claude Code CLI

• Windows, macOS 또는 Linux

• 선택 사항: 지속적인 백그라운드 작업을 위한 PM2

• 선택 사항: Design QC 스크린샷을 위한 puppeteer-core

• Claude Code 훅(hooks)은 비교적 새로운 기능입니다. 훅이 작동하지 않을 경우 OpenWolf는 CLAUDE.md 지침으로 대체(fallback)됩니다.

• 토큰 추적은 정확한 API 카운트가 아닌 추정치(문자 대 토큰 비율)를 기반으로 합니다. 약 15% 이내의 오차가 있을 수 있습니다.

• cerebrum.md는 수정 후 이를 업데이트하도록 하는 Claude의 지침 준수에 의존합니다. 준수율은 100%가 아닌 약 85-90%입니다.

• 이것은 v1.0.4 버전입니다. 기능이 작동하지 않을 수 있습니다. 파일 관련 이슈가 있을 수 있습니다.

우리는 Cytostack에서 Claude Code를 사용하여 제품을 개발하던 중 무언가 잘못되었다는 것을 알아차렸습니다. 세션이 예상보다 훨씬 빠르게 토큰 (tokens)을 소모하고 있었습니다. 원인을 파헤쳐 보니, Claude가 동일한 파일을 여러 번 다시 읽고, 단 하나의 함수를 찾기 위해 디렉토리 (directories) 전체를 스캔하며, 파일을 직접 열지 않고는 그 파일에 무엇이 포함되어 있는지 알 방법이 없다는 것을 발견했습니다. 프로젝트 맵 (project map), 읽기 인지 (read awareness), 토큰 가시성 (token visibility)이 전혀 없었습니다. 그래서 우리는 우리가 간절히 원했던 도구들을 직접 만들었습니다. Claude가 덜 읽을 수 있게 하는 파일 인덱스 (file index), 더 똑똑해질 수 있게 하는 학습 메모리 (learning memory), 그리고 모든 토큰을 추적하는 원장 (ledger)이 그것입니다. 그것이 바로 OpenWolf가 되었습니다.

Farhan Palathinkal Afsal - Cytostack 제작