고르는 방법
- AGENTS.md나 CLAUDE.md는 짧게 유지하고, 문서를 옮겨 적지 말고 가리키게 하세요.
- 사람이 읽기 전에 테스트, 타입 검사, linter가 에이전트의 작업을 판정하게 하세요.
- 워크플로 프레임워크는 프로젝트당 하나, 변경 규모에 맞게 쓰세요. 에이전트는 샌드박스에서 돌리고 파괴적인 명령은 막으세요.
확인할 점
선택지를 가르는 질문을 중요한 순서대로 정리했습니다.
01
다른 파일을 가리키는 짧은 컨텍스트 파일
AGENTS.md나 CLAUDE.md는 모든 세션에 로드되므로, 한 줄 한 줄이 매 턴마다 토큰을 쓰고 작업과 모델의 주의를 두고 경쟁합니다. OpenAI의 harness 팀은 커다란 지시 파일 하나가 금세 낡고 자동으로 검증할 수도 없다는 것을 확인하고, 구조화된 docs/ 폴더의 목차 역할을 하는 약 100줄짜리 AGENTS.md로 바꿨습니다. 근거를 댈 수 있는 몇 가지 규칙으로 시작하고(Karpathy의 CLAUDE.md는 네 가지입니다), 에이전트가 같은 실수를 반복할 때만 한 줄을 더하며, 세부 내용은 에이전트가 필요할 때 여는 파일에 두세요.
02
행동 전에는 가이드, 행동 후에는 센서
martinfowler.com에 실린 Birgitta Böckeler의 모델은 harness를 두 가지로 나눕니다. 작업 전에 에이전트를 이끄는 가이드(컨텍스트 파일, skills, 명세, 언어 서버)와, 결과를 확인해 에이전트가 스스로 고치게 하는 센서(테스트, linter, 타입 검사기, 구조 테스트, 리뷰)입니다. 둘 다 필요합니다. 가이드만 있으면 효과가 있었는지 알 수 없고, 센서만 있으면 같은 실수를 매번 잡아내게 됩니다. AI 리뷰보다 빠르고 저렴하며 반복 가능한 결정적 센서를 우선하고, linter 메시지에는 문제를 고치는 방법까지 적어 두세요.
03
skills, 플러그인, hooks의 컨텍스트 비용
skills는 쌓이기 전까지는 저렴합니다. Anthropic 문서에 따르면 시작 시 비용은 설치된 skill 하나당 약 100토큰이고, 하나가 실행되면 최대 5,000토큰이 더 듭니다. ECC는 전체 설치 시 규칙과 skills가 컨텍스트 창의 상당 부분을 차지해서 최소 프로필을 따로 제공합니다. Claude Code에서는 claude plugin details로 각 플러그인이 매 턴 추가하는 양을 확인할 수 있습니다. 작업 흐름을 감당하는 가장 작은 조합만 설치하고, 한 달 동안 쓰지 않은 것은 지우세요.
04
변경 규모에 맞춘 프로세스
명세 기반 프레임워크와 여러 역할을 쓰는 프레임워크는 에이전트의 작업을 검토할 수 있는 문서로 바꿔 주지만, 그만큼 비용이 듭니다. Scott Logic의 시험에서 Spec Kit은 기능 하나당 사람의 검토 시간이 약 2~3.5시간 걸렸습니다. BMAD는 기능마다 여러 계획 문서를 만들고, Superpowers는 작은 수정에도 느리고 토큰을 많이 씁니다. Matt Pocock의 skills는 그 반대편에 있어서, 직접 부르지 않으면 아무것도 실행되지 않습니다. 한 줄짜리 수정에는 프로세스를 줄여 주는지 확인하고(BMAD의 Build skill은 이제 그렇게 합니다), 워크플로 프레임워크는 프로젝트당 하나만 설치하세요. Superpowers, BMAD, ECC, Addy Osmani의 팩은 기능이 겹치고 서로 충돌합니다.
05
세션이 끝나도 남는 상태
새 세션은 이전 세션을 기억하지 못한 채 시작합니다. 장시간 실행 에이전트에 관한 Anthropic의 글은 단순한 파일로 해결하는 방법을 설명합니다. 항목마다 통과 여부를 표시한 JSON 기능 목록, 진행 기록, 앱을 띄우는 init.sh, 세션당 기능 하나, 그리고 세션마다 끝에 남기는 git 커밋입니다. 메모리 플러그인은 이를 자동화하지만 대가가 있습니다. claude-mem은 매 세션을 비용을 내는 모델로 요약하고, 로컬 worker는 요청을 인증하지 않습니다. context-mode는 도구 출력을 로컬 인덱스에 저장하고 압축(compaction) 뒤 작업 상태를 다시 구성합니다. 단순한 파일부터 먼저 써 보세요.
06
샌드박스와 명령 가드, 둘 중 하나가 아니라 둘 다
에이전트는 설득당하면 무엇이든 실행할 수 있으므로, 제한은 프롬프트가 아니라 운영체제에 두어야 합니다. Claude Code의 /sandbox를 움직이는 Anthropic의 Sandbox Runtime은 파일 쓰기와 네트워크 접근을 허용한 범위로 제한하지만, 프로젝트 안의 쓰기는 설계상 허용하므로 git reset --hard와 git push --force는 그대로 실행됩니다. CC Safety Net은 셸 명령을 실행 전에 읽고 이런 명령을 막지만, 파일과 네트워크는 통제하지 않습니다. 함께 쓰면 서로의 빈틈을 메웁니다.
07
토큰 절감 주장은 내 청구서로 확인하기
여러 도구가 더 작은 컨텍스트와 더 낮은 비용을 약속합니다. 도구 출력이 짧아진다고 세션이 싸지는 것은 아닙니다. rtk에 대한 독립적인 테스트 두 건은 주요 실행에서 절감 효과를 찾지 못했고(각각 7.6%, 5.8% 증가), 그 이유 중 하나는 hook이 Bash 호출만 본다는 점입니다. context-mode 무료 플러그인의 비용 테스트를 공개한 곳은 없습니다. 데모 작업 하나가 아니라 평소 작업 일주일 동안, 자신의 사용 로그(ccusage가 로컬에서 읽습니다)로 도입 전후를 비교하세요.
08
에이전트 안에서 실행되는 코드를 누가 바꿀 수 있는가
플러그인과 skill 팩은 사용자 권한으로 hooks와 MCP 서버를 실행합니다. Claude Code 공식 마켓플레이스는 항목마다 특정 커밋에 고정하지만, Anthropic은 등재가 보안 감사가 아니라고 밝히며 플러그인은 기본적으로 자동 업데이트됩니다. ECC의 README는 미러에 악성코드가 있을 수 있다고 경고하고, CC Safety Net의 기본 설치는 @latest를 받아 옵니다. 원래 저장소에서 설치하고, 팀에서는 버전을 고정하며, 활성화하기 전에 hook 스크립트를 읽어 보세요.
선택지별 차이
harness 엔지니어링은 코딩 에이전트의 안이 아니라 주변을 다루는 일입니다. 에이전트가 읽는 파일, 결과를 판정하는 검사, 세션을 넘어 작업을 이어 가는 루프가 그 대상입니다. 여기의 도구는 몇 가지 그룹으로 나뉩니다. 컨텍스트 파일과 skill 팩(Karpathy의 CLAUDE.md, Anthropic Skills, Addy Osmani와 Matt Pocock의 skills)은 에이전트에게 규칙과 절차를 줍니다. 워크플로 프레임워크(Superpowers, Spec Kit, BMAD, ECC)는 명세, 계획, 테스트, 리뷰로 이어지는 전체 순서를 강제하며, 주로 사람이 읽어야 하는 문서의 양에서 차이가 납니다. 컨텍스트와 메모리 도구(context-mode, rtk, claude-mem)는 컨텍스트 창을 작게 유지하거나 세션 사이에 상태를 이어 가려 합니다. 안전 계층(Sandbox Runtime, CC Safety Net)은 에이전트가 어떤 지시를 받았든 할 수 있는 일을 제한합니다. 대부분은 Claude Code 공식 마켓플레이스를 통해 설치하며, Learn Harness Engineering은 이 분야 전체를 가르치는 강좌입니다.
에이전트 자체(Claude Code, Codex, OpenCode)는 안쪽 harness이며 코딩 에이전트 리뷰에서 다룹니다. 바깥쪽 harness에서 가장 중요한 센서는 대개 이미 갖고 있는 것들입니다. 테스트 스위트, 타입 검사기, linter, CI입니다. 아래 도구 중 어느 것도 이를 대신하지 못하며, 여러 도구는 이것들이 있어야 제대로 작동합니다.
도구 14개 비교
저희 평점 순입니다. 각 리뷰에서 출처, 가격, 전체 평가를 확인할 수 있습니다.
| 도구 | 평점 | 저희 평가 | 추천 대상 | 가격 |
|---|---|---|---|---|
| Superpowers저장소 | 4.7/5 | 코딩 에이전트를 신중한 주니어 엔지니어처럼 행동하게 만드는 규율 계층이며, 한 줄짜리 수정보다 큰 일이라면 늘어나는 토큰값을 합니다. | 에이전트가 계획, 테스트, 리뷰를 갖춘 채 몇 시간짜리 기능을 진행하기를 원하는 개발자. | MIT의 무료 오픈소스입니다. 이를 돌리는 에이전트의 모델 사용료를 냅니다. |
| Matt Pocock's Skills저장소 | 4.5/5 | Matt Pocock의 스킬은 에이전트가 코드를 쓰기 전에 사용자와 계획을 끝까지 따지게 만들며, /grill-me 하나만으로도 설치할 가치가 있습니다. | 프로세스를 프레임워크에 넘기지 않고 가벼운 계획과 TDD 습관을 원하는 엔지니어. | MIT 라이선스의 무료 오픈소스입니다. 에이전트의 모델 사용료만 냅니다. |
| Anthropic Skills저장소 | 4.4/5 | 직접 스킬을 쓰기 전에 읽어 보고, Claude Code에서 Office 파일과 PDF를 다뤄야 한다면 설치하십시오. 다만 문서 스킬을 포크할 수 있는 것으로 착각하면 안 됩니다. | 스킬을 작성하는 모든 사람, 그리고 Office와 PDF 처리가 필요한 Claude Code 사용자. | 무료입니다. 예제 스킬은 Apache-2.0이 고, 문서 스킬은 오픈소스가 아니라 소스 공개입니다. |
| Anthropic Sandbox Runtime (srt)저장소 | 4.4/5 | 코딩 에이전트는 무엇이든 하도록 설득당할 수 있지만 운영체제는 그렇지 않으며, srt는 운영체제에게 결정권을 줍니다. | 자기 기기에서 코딩 에이전트를 돌리는 모든 개발자의 첫 번째 보호 계층. | Apache 2.0의 무료 오픈소스입니다. |
| Spec Kit저장소 | 4.3/5 | Spec Kit은 에이전트 작업을 git 안의 검토 가능한 문서로 바꾸며, 그 대가를 기능마다 몇 시간의 사람 읽기 시간으로 받습니다. | 에이전트가 코드를 쓰기 전에 글로 쓴 검토 가능한 명세를 원하는 팀. | MIT의 무료 오픈소스입니다. |
| Agent Skills (Addy Osmani)저장소 | 4.3/5 | Addy Osmani의 팩은 시니어 엔지니어의 습관을 에이전트가 말로 빠져나갈 수 없는 관문으로 바꾸며, 브라우저를 진지하게 다루는 드문 스킬 모음입니다. | 명세부터 출시까지 하나의 체계적인 스킬 팩을 원하는 웹 개발자. | 무료 오픈소스(MIT)입니다. 에이전트의 모델 사용료는 직접 냅니다. |
| Claude Code official plugin marketplace저장소 | 4.3/5 | 서드파티 마켓플레이스를 추가하기 전에 여기서 시작하십시오. 커밋에 고정된 항목과 눈에 보이는 컨텍스트 비용 덕분에 가장 안전한 기본값이지만, 목록에 올랐다고 보안 감사를 거친 것은 아닙니다. | 플러그인을 찾을 때 가장 먼저 볼 곳이 필요한 모든 Claude Code 사용자. | 무료입니다. 카탈로그 저장소는 Apache-2.0이고, 플러그인마다 라이선스가 따로 있으며, 많은 벤더 플러그인은 해당 벤더의 유료 계정이 필요합니다. |
| Learn Harness Engineering저장소 | 4.1/5 | 에이전트 코딩에서 화려하지 않은 부분, 즉 모델 주변의 발판을 다루는 제대로 된 교육과정이며, 독창성보다 구성이 더 뛰어납니다. | 이미 Claude Code나 Codex를 쓰면서 무인 에이전트 세션을 더 믿을 만하게 만드는 체계적인 방법을 원하는 엔지니어. | 무료(MIT)입니다. 프로젝트를 하려면 Claude Code나 Codex 같은 자신의 코딩 에이전트가 필요합니다. |
| CC Safety Net저장소 | 4.0/5 | 샌드박스가 일부러 허용하는 피해, 즉 자기 프로젝트 안에서의 force-push, hard reset, rm -rf를 막는 안전벨트입니다. | 코딩 에이전트가 셸 명령을 하나하나 승인받지 않고 실행하게 두는 모든 사람. | MIT 무료 오픈소스입니다. |
| BMAD Method저장소 | 3.8/5 | BMAD는 결재하는 이해관계자가 있는 프로젝트에서는 문서 작업만큼의 값을 하지만, 그보다 작은 일에서는 몇 시간을 대가로 치르게 합니다. | PRD, 아키텍처, 스토리를 생성하고 검토받기를 원하는 대형 프로젝트의 팀. | 무료 오픈소스(MIT)입니다. "BMad"와 "BMAD-METHOD"는 BMad Code, LLC의 상표입니다. |
| Everything Claude Code (ECC)저장소 | 3.8/5 | ECC는 워크플로라기보다 부품 상자입니다. minimal 프로필로는 쓸모 있지만, 전체 설치에서는 컨텍스트에 상시 부담을 줍니다. | 대형 툴킷을 원하면서 minimal 프로필로 줄여 쓸 Claude Code 파워 유저. | 무료 오픈소스(MIT)입니다. 비공개 저장소용 ECC Pro GitHub App은 좌석당 월 $19이고, Enterprise는 별도 견적입니다. 에이전트의 모델 사용료는 직접 부담합니다. |
| claude-mem저장소 | 3.7/5 | Claude Code에 실제로 세션 간 기억을 주지만, 호스팅 구독으로 이끄는 설치 프로그램과 지켜봐야 할 압축 비용이 함께 따라옵니다. | 에이전트가 지난 세션을 기억하기를 원하는, 장기 프로젝트를 하는 개발자. | 오픈소스(Apache-2.0)입니다. 압축은 사용자의 Anthropic 요금제나 자체 키로 실행됩니다. 호스팅 CMEM 요금제는 Pro 월 $30, Heavy 월 $70, Max 월 $100이며 초과 요금이 붙습니다. TeamBrain 가격은 발표되지 않았습니다. |
| context-mode저장소 | 3.6/5 | 압축 후 흐름을 놓치는 긴 세션이라면 써 볼 만합니다. 다만 무료 플러그인이 요금을 낮춘다는 것은 아직 아무도 보여 주지 않았습니다. | 긴 세션이 압축 후 작업 흐름을 놓치는 Claude Code 사용자. | 플러그인은 무료(Elastic License 2.0)입니다. 호스팅 게이트웨이는 1회 한정 무료 요청 1,000회, Starter 월 $20(요청 10,000회), Pro 월 $49(요청 50,000회)이며, 모델 공급자에게는 직접 비용을 냅니다. |
| rtk (Rust Token Killer)저장소 | 3.4/5 | 셸 출력을 짧게 만들지만 그것이 Claude Code를 싸게 만드는 것과 같지는 않으며, 두 독립 비용 테스트 모두 싸지지 않았다고 결론 내렸습니다. | 셸 출력이 매우 시끄럽고 효과를 직접 측정할 개발자. | 무료입니다(Apache-2.0 CLI와 BUSL-1.1 엔진, Apache 전용 rtk-oss 제공). 상업적 재판매에는 라이선스가 필요합니다. 팀 에디션 RTK Pro는 유료이며 7일 체험이 있습니다. |
사양 비교
이 단계에서 중요한 사양입니다. 2026년 11월 6일에 확인했습니다. 도입 전에 공급업체 사이트에서 확인하세요.
| 도구 | 유형 | 더해 주는 것 | 지원 에이전트 | 컨텍스트 또는 토큰 비용 | 라이선스 |
|---|---|---|---|---|---|
| Superpowers | 워크플로 skills 플러그인 | 브레인스토밍, 계획, TDD, 서브에이전트 리뷰 | 16개 harness | 높음. 계획의 작업 수에 따라 증가 | MIT |
| Matt Pocock's Skills | 조합형 skills | /grill-me, /tdd, /code-review | Claude Code, Codex, Copilot. 그 밖은 npx | 호출할 때만. 서브에이전트 리뷰는 누적됨 | MIT |
| Anthropic Skills | 레퍼런스 skills와 명세 | docx, pdf, skill-creator 등 skills 19개 | Claude Code, claude.ai, Claude API | skill당 약 100토큰. 사용 시 최대 5,000 | Apache 2.0. 문서 skills는 소스 공개 |
| Anthropic Sandbox Runtime (srt) | 운영체제 수준 샌드박스 | 파일 쓰기와 네트워크 허용 목록 | 모든 프로세스. Claude Code의 /sandbox | 없음 | Apache 2.0 |
| Spec Kit | 명세 기반 CLI와 명령 | 헌장, 명세, 계획, 작업, 수렴 점검 | 41개 에이전트 | 에이전트 사용료에 더해 기능당 2~3.5시간 검토 | MIT |
| Agent Skills (Addy Osmani) | 엔지니어링 워크플로 skills | skills 25개, 명령 9개, 증거 관문 | Claude Code, Codex, skills CLI로 70개 이상 | 세션이 길어짐. 공개된 수치 없음 | MIT |
| Claude Code official plugin marketplace | 플러그인 마켓플레이스 | 커밋에 고정된 플러그인 315개 | Claude Code | 플러그인별. claude plugin details로 표시 | Apache 2.0 |
| Learn Harness Engineering | 강좌: 강의 14개, 프로젝트 8개 | 템플릿, harness-creator skill, 감사 스크립트 | 에이전트에 무관 | 무료. 에이전트 사용료만 | MIT |
| CC Safety Net | 명령 가드(hook) | 파괴적인 git, rm -rf, 비밀 정보 읽기 차단 | Claude Code, Codex, Cursor 등 | 없음 | MIT |
| BMAD Method | 역할 기반 애자일 프레임워크 | 브리프, PRD, 아키텍처, 스토리 | Claude Code, Codex 등 | 높음. 기능당 여러 문서 | MIT(이름은 상표) |
| Everything Claude Code (ECC) | harness 키트 | 에이전트 71개, skills 311개, hooks, AgentShield | Claude Code는 안정, 나머지는 베타 | 전체 설치 시 무거움. 최소 프로필 제공 | MIT |
| claude-mem | 세션 간 메모리 플러그인 | hooks가 세션 기록. MCP로 불러오기 | Claude Code, Codex, OpenCode 등 | 매 세션 압축용 토큰 | Apache 2.0 |
| context-mode | 컨텍스트 플러그인 겸 MCP 서버 | 도구 출력 색인. 압축 뒤 상태 재구성 | 17개 플랫폼 | 절감이 목표. 무료 플러그인은 검증 안 됨 | Elastic 2.0 |
| rtk (Rust Token Killer) | 셸 출력 프록시(hook) | 100개 이상 명령의 출력 압축 | 18개 에이전트 | 독립 테스트 두 건에서 절감 효과 없음 | Apache 2.0 / BUSL-1.1 |
이 가이드의 출처
- OpenAI: Harness engineering, leveraging Codex in an agent-first world
- Birgitta Böckeler: Harness engineering for coding agent users (martinfowler.com)
- Anthropic: Effective harnesses for long-running agents
- Anthropic: Beyond permission prompts (Claude Code sandboxing)
- Agent Skills overview (Claude Platform docs)
- Putting Spec Kit through its paces (Scott Logic)
- rtk Claude Code token savings benchmark (JetBrains)