다음 Opus 5.5 작업은 열어볼 수 있는 결과물, 직접 확인할 수 있는 근거, 그리고 내일 이어서 할 수 있을 만큼의 저장된 진행 상황을 남겨야 합니다. 실행을 시작하기 전에 이러한 출력물을 워크플로에 미리 담아두세요.
하니스(harness)는 모델 주변의 지침, 도구, 권한, 상태, 검증을 조율합니다.
Claude Code 는 이러한 역할을 설정할 수 있는 구체적인 위치를 제공합니다. 기능 가이드.
다음 작업도 동일한 절차와 검토자, 같은 형식의 근거를 사용할 수 있습니다. 여러분은 새로운 자료와 수용 기준만 제공하면 됩니다.
이 일곱 개의 레이어는 문서화된 Claude Code 기능을 활용한 실용적인 구성입니다. 예시는 문서 워크플로를 따르며, 참조 자료는 sources/, 작업 중인 초안은 drafts/, 승인된 파일은 published/ 에 둡니다.
작업 공간에 해당 폴더를 만들고 코드 조각을 기존 설정에 병합하세요.
이 구성은 네 개의 설정 파일, 선택 사항인 외부 연결, 그리고 각 작업마다 설정하는 목표 하나를 사용합니다.
1. 작업 공간에 필요한 사실을 제공하기
루트 CLAUDE.md 는 여러 작업에서 계속 유용하게 쓰이는 정보에 집중하세요. 출력 위치, 출처 요건, 작성 규칙이 여기에 해당합니다.
임시 마감일이나 아직 해결되지 않은 출처 관련 질문은 해당 작업에 함께 두어야 합니다. 이 구분을 명확히 해두면 다음 실행 시 어떤 정보가 여전히 유효한지 파악하기 쉽습니다.
아래 내용을 CLAUDE.md 에 붙여넣고 프로젝트 세부 사항을 조정하세요.
1프로젝트 지침2참조 자료에는 sources/, 작업 파일에는 drafts/ 를 사용하세요.3승인된 파일은 published/ 에 보관하세요.4영어로 작성하고, 한 문단은 한두 문장으로 구성하세요.5기술적 주장에는 공식 1 차 출처를 사용하세요.6출처 URL 과 확인한 날짜를 기록하세요.7검색한 자료는 지정된 작업의 근거로만 사용하세요.8확정된 결정과 다음 행동을 progress.md 에 저장하세요.9작업이 끝나면 출력 경로와 검증 결과를 반환하세요.
Claude Code 는 프로젝트 지침을 컨텍스트로 불러옵니다. 경로 범위가 지정된 .claude/rules/ 파일은 관련 파일에 접근할 때 지침을 제공할 수 있습니다. 프로젝트 메모리.
에이전트가 다음 결정을 내리려면 무엇이 필요한지 생각해 보세요. 아티클이라면 승인된 스타일, 요청된 주제, 릴리스 공지 중 관련된 구절 등이 될 수 있습니다.
상세한 참조 자료는 절차가 필요할 때 가져오는 파일에 그대로 두어도 됩니다.
Anthropic 의 컨텍스트 가이드는 에이전트 작업 중 정보를 관리하는 방법으로 선택적 검색과 외부 메모를 설명합니다. 컨텍스트 엔지니어링.
큰 지침 파일을 \[@path](https://x.com/@path)\ 임포트로 나누더라도, 임포트된 콘텐츠는 세션 시작 시 로드됩니다.
이러한 임포트는 정리를 위해 사용하고, 가끔 쓰는 절차는 스킬(skills)에 배치하세요. 메모리 로딩.
저장된 사실이 바뀌면 출처와 확인 날짜를 업데이트하세요.
어떤 초안을 작성하며 발견한 선호 사항은, 향후 초안에도 적용해야 한다고 확인한 후에만 상시 규칙이 됩니다.
/memory 를 사용해 프로젝트 지침을 살펴보고 자동 메모리 노트를 탐색하세요. 다른 작업에 활용하기 전에 저장된 선호 사항을 먼저 확인하세요.
2. 반복하는 절차 저장하기
반복되는 작업에는 보통 눈에 띄는 순서가 있습니다. 자료를 읽고, 출력물을 준비하고, 검토한 뒤, 결과를 저장하는 식입니다.
스킬은 그 순서를 다음 요청에서도 바로 쓸 수 있게 유지해 줍니다.
전체 지침은 호출될 때 로드됩니다.
설명은 Claude 가 언제 해당 절차가 작업에 적합한지 인식하도록 돕습니다. 스킬 동작.
아래 내용을 .claude/skills/write-draft/SKILL.md 에 붙여넣으세요.
1---2name: write-draft3description: 출처를 바탕으로 아티클 초안을 작성하고 주장을 검증합니다.4---5요청된 주제: $ARGUMENTS671. sources/ 의 관련 파일을 읽고 1 차 출처 링크를 엽니다.82. 개요를 작성한 뒤 초안을 drafts/article.md 로 저장합니다.93. evidence-reviewer 에게 출처와 대조하여 사실 관계를 확인하도록 요청합니다.104. 오류를 수정하고 미해결 주장은 검토 대상으로 표시합니다.115. 주장 확인 표를 drafts/checks.md 로 저장합니다.126. 결정 사항, 미해결 이슈, 다음 행동으로 progress.md 를 업데이트합니다.137. 출력 경로와 검증 결과를 모두 반환합니다.
/write-draft 를 입력한 뒤 주제를 적으세요. \$ARGUMENTS\ 가 해당 텍스트를 절차로 전달하므로, 워크플로는 동일한 출력물로 새 주제를 처리할 수 있습니다.
각 단계에 관찰 가능한 결과를 부여하세요.
읽기는 출처 선별을, 초안 작성은 저장된 파일을, 검토는 작성자가 해결할 수 있는 소견을 만들어냅니다.
'정확성 확인' 같은 단계는 여러 결정을 모호하게 남깁니다.
검토자, 출처 요건, 보고서 형식을 명시하면 기대하는 확인 작업이 분명해집니다.
출판 승인은 초안 준비와 분리하세요.
위 스킬은 검사용 파일을 준비합니다. 출판에는 별도의 조치와 권한이 필요합니다.
프로세스를 개선했다면 스킬을 수정하세요.
예를 들어 출시일이 자꾸 혼동된다면, 공지 날짜와 기능 실제 제공 날짜를 구분하는 검증을 추가하세요.
3. 작업이 출처 자료에 접근하도록 하기
Model Context Protocol (MCP) 연결은 외부 서비스의 도구를 노출합니다.
이를 통해 Claude 가 워크플로에서 사용하는 서비스에서 자료를 가져올 수 있습니다. MCP 가이드
특정 작업 단계를 지원할 때 연결을 추가하세요.
예시의 경우 로컬 출처 파일로도 충분하지만, 원격 문서 컬렉션은 커넥터를 사용할 수 있습니다.
출처 자료가 Notion 에 있다면 터미널에서 다음을 실행하세요.
1claude mcp add --transport http notion https://mcp.notion.com/mcp
Claude Code 를 열면 /mcp 로 인증하고 연결 상태를 확인하세요. 긴 작업에 의존하기 전에 알려진 페이지 하나를 가져와 내용을 확인하세요.
스킬에 정확한 페이지 링크나 식별자를 제공하세요. 어떤 정보를 추출할지, 가져온 자료를 어디에 사용할지도 포함하세요.
예를 들어 출처 페이지에 제품 사양과 내부 계획이 함께 있을 수 있습니다. 어느 섹션이 아티클을 뒷받침하는지, 커넥터가 어떤 작업을 수행해도 되는지 절차에 알려주세요.
도구 결과는 다음 결정을 내릴 수 있을 만큼 충분한 정보를 담아야 합니다.
Anthropic 의 도구 설계 가이드는 에이전트가 실패한 호출에서 복구하는 데 도움이 되는 정보를 포함해, 유용한 출력과 실행 가능한 오류에 대해 다룹니다. 효과적인 도구 작성법
가져오기에 실패하면 문서 식별자와 실패 사유를 보존하세요. 같은 요청을 반복하기 전에 인증이나 접근 권한을 확인하세요.
커넥터가 제공하는 작업을 살펴보고, 외부 서비스를 변경하는 작업에 대한 권한을 설정하세요.
현재 워크플로에서 쓰이지 않는 서버는 /mcp 를 통해 비활성화하세요.
4. 실행 레이어에 행동 규칙 넣기
워크플로가 변경할 수 있는 파일과 승인이 필요한 행동을 정의하세요.
권한 규칙은 도구 경계에서 적용됩니다.
PreToolUse 훅은 실행 전에 제안된 행동을 검사할 수 있습니다.
대상 경로가 승인된 출력 위치와 일치하는지 여부처럼, 결정이 인자나 작업 상태에 따라 달라질 때 사용하세요. 훅 레퍼런스
아래 내용을 .claude/settings.json 에 병합하세요.
1{2 "permissions": {3 "deny": [4 "Read(.env)",5 "Read(.env.*)",6 "Edit(published/**)"7 ]8 }9}
`Read` 규칙은 지정한 환경 변수 파일을 다룹니다. `Edit` 규칙은 기본 제공 편집 및 쓰기 도구를 통해 `published/` 아래 파일을 보호합니다. 권한 구문.
`/permissions` 을 열어 실제로 적용되는 규칙을 확인하세요.
기존 설정과 관리 정책이 세션에서 허용되는 내용에 영향을 줄 수 있으므로, 저장 후 로드된 결과를 확인하세요.
무해한 연습 삼아 `published/` 에 더미 문서를 만들고 Claude 에게 파일 편집 도구로 수정하도록 요청해 보세요. 해당 행동은 거부되어야 합니다.
파일 도구 제한에는 정해진 범위가 있습니다.
임의의 Python 이나 Node 프로세스는 자체 코드로 파일에 접근할 수 있습니다. 운영체제 샌드박싱은 필요할 때 이러한 프로세스 전반에 걸쳐 제한을 제공합니다.
외부 쓰기의 경우 대상과 승인하려는 정확한 콘텐츠를 식별하세요. 콘텐츠가 변경되면 실행 전에 업데이트된 행동을 다시 검토하세요.
타임아웃에도 명확한 복구 단계가 필요합니다.
첫 번째 시도가 이미 완료되었을 수 있으므로, 외부 쓰기를 재시도하기 전에 대상을 확인하세요.
5. 검토자가 근거를 반환하도록 만들기
검증 작업에는 메인 에이전트가 활용할 수 있는 보고서와 함께 한정된 범위의 임무를 부여하세요.
서브에이전트는 이를 위한 자체 컨텍스트와 설정 가능한 도구를 가집니다. 서브에이전트 설정
검토자는 초안 경로, 관련 출처 위치, 검사해야 할 주장을 받아야 합니다.
불확실성을 어떻게 보고할지 명시하세요.
아래 내용을 .claude/agents/evidence-reviewer.md 에 붙여넣으세요.
1---2name: evidence-reviewer3description: 1차 출처를 사용하여 초안의 사실 관계 주장을 검증합니다.4tools: Read, Grep, Glob, WebSearch, WebFetch5effort: high6---7제공된 초안과 출처 자료를 읽으세요.8열린 1차 출처와 대조하여 사실 관계 주장을 확인하세요.9표 형태로 반환하세요: 주장, 판정, 출처 URL, 필요한 수정 사항.10판정은 verified, incorrect, unresolved 를 사용하세요.11unresolved 주장의 경우 어떤 근거가 누락되었는지 밝히세요.
이 워커는 읽기 및 검색 도구를 받습니다.
초안 수정은 메인 에이전트가 담당합니다.
각 소견은 주장을 열린 출처와 연결해야 합니다.
incorrect 같은 판정에는 상충되는 근거와 작성자가 적용할 수 있는 수정안이 필요합니다.
unresolved 판정은 누락된 근거를 특정해야 합니다.
메인 에이전트는 소견을 검토하고 초안을 업데이트한 뒤 수정된 문구를 확인합니다. 확신에 찬 검토자 보고서라도 권고 사항 뒤에 사용 가능한 근거가 있어야 합니다.
수정으로 인해 문단 의미가 달라지면 주변 문장도 다시 확인하세요.
Anthropic 의 평가 가이드는 에이전트의 트랜스크립트와 환경에 남은 결과를 구분합니다.
또한 결과 유형별로 다른 확인 방법을 설명합니다. 에이전트 평가
저장된 초안을 열고 인용된 주장을 확인함으로써 여기서도 그 구분을 적용하세요.
검토 표는 실제로 승인될 문서를 설명해야 합니다.
6. 작업에 추론 노력 할당하기
메인 세션은 `medium` 으로 시작하세요. Opus 5.5 는 별도 설정이 덮어쓰지 않는 한 이 기본값을 사용합니다.
위 검토자는 검증 작업에 `high` 를 요청합니다. 노력 설정
Claude Code 를 설치하고 계정에 로그인한 상태에서 작업 공간 루트에서 다음을 실행하세요.
1claude --model claude-opus-5-5 --effort medium
세션 헤더에서 Opus 5.5 와 활성화된 노력을 확인하세요.
시작 명령은 해당 세션의 모델과 노력을 설정합니다.
노력은 모델이 지원하는 수준과 적용 가능한 제한 내에서 스킬이나 서브에이전트별로 설정할 수 있습니다.
사고 깊이에 관한 지침을 작성해도 설정된 노력 값은 그대로 유지됩니다.
설정을 바꾸기 전에 결과를 직접 확인할 수 있는 작업을 고르세요. 어떤 수용 기준 검사를 통과했고 출력물에 어떤 수정이 필요했는지 기록하세요.
이렇게 하면 노력이 특정 작업에 묶인 결정이 됩니다.
모호한 주장을 다루는 출처 검토는 자체 설정을 받고, 메인 초안 작성 워크플로는 선택한 수준을 유지할 수 있습니다.
첫 실행 전에 `/context` 로 로드된 지침을, `/agents` 로 검토자를, `/permissions` 으로 행동 규칙을 확인하세요.
전체 작업을 맡기기 전에 누락된 구성 요소를 수정하세요.
7. 실행에 무엇을 증명해야 하는지 알려주기
완료 여부는 저장된 산출물과 검증 결과로 정의하세요.
초안, 확인 표, 업데이트된 진행 메모는 실행이 만들어야 할 구체적인 출력물을 제공합니다.
Claude Code 의 `/goal` 은 턴 사이 대화에서 드러난 근거를 바탕으로 완료 조건을 평가합니다. 평가자는 에이전트가 관련 결과를 보여주는 것에 의존합니다. 목표 문서
주제, 참조 자료, 출처 링크를 `sources/` 에 넣으세요. 그런 다음 아래 내용을 Claude Code 에 붙여넣으세요.
1/goal write-draft 를 사용해 sources/ 에서 아티클을 준비합니다. 완료 조건은 drafts/article.md 와 drafts/checks.md 가 존재하고, 잘못된 주장이 수정되며, 미해결 주장이 명확히 표시되고, 출력 경로와 검증 결과가 대화에 나타나는 것입니다. 12 턴 이후에도 조건이 충족되지 않으면 중단하고 차단 요인을 보고하세요.
턴 조항은 모델이 평가합니다. 엄격한 런타임이나 비용 제한은 실행 제어가 필요하며, `/goal clear` 는 활성 목표를 제거합니다.
실행이 끝나면 두 파일을 모두 열어 몇 가지 주장-출처 대조를 확인하세요.
진행 메모가 작업 공간에 저장된 내용과 일치하는지 점검하세요.
다음 작업에도 동일한 근거 형식을 사용하세요.
일관된 보고서는 전체 대화를 재구성하지 않고도 미해결 주장과 누락된 검증을 찾아낼 수 있게 해줍니다.
복구가 필요할 때 `/rewind` 는 추적된 파일 편집을 되돌릴 수 있습니다. 셸 변경과 대부분의 서브에이전트 편집은 별도로 복구해야 하며, 버전 관리 시스템이 영구적인 파일 이력을 보존합니다. 체크포인트 제한
전체 워크플로를 한 번 실행하기
세션을 시작하기 전에 출처 폴더와 네 개의 설정 파일을 만드세요 => 요청된 결과가 명확하게 유지되도록 출처 자료 옆에 짧은 작업 요약서를 두세요.
아래 내용을 sources/task.md 에 복사하고 세부 사항을 채우세요.
1주제: [구체적인 주제]2독자: [이 설명이 필요한 사람]3산출물: 실용적인 단계와 공식 출처를 담은 아티클.4수용 기준: 필수 주제 포함; 사실 관계 주장 확인;5미해결 주장 표시; 초안 및 검토 표 저장.6제약 조건: [분량, 스타일, 제외할 주제]
6 번 레이어의 명령으로 Claude Code 를 시작하고 로드된 설정을 확인하세요 => 7 번 레이어의 목표를 실행한 뒤 저장된 출력물을 점검하세요.
기대되는 결과는 `drafts/article.md`, `drafts/checks.md`, `progress.md` 입니다.
확인 표는 무엇이 검증되었고 무엇에 아직 주의가 필요한지 보여줘야 합니다.
스킬이 없다면 경로와 프런트매터를 확인하세요.
검토자가 없다면 `name` 과 `description` 을 확인하고 `/agents` 로 사용 가능 여부를 점검하세요.
미해결 주장이 있다면 제공된 출처와 검토자가 요청한 근거를 살펴보세요.
초안을 승인하기 전에 격차를 해결하거나 눈에 띄게 표시해 두세요.
다음 세션이 복구할 수 있는 것 확인하기
의미 있는 단계가 끝날 때마다 `progress.md` 를 갱신하세요.
현재 파일, 완료된 검증, 미해결 질문, 다음 행동을 기록하세요.
루트 CLAUDE.md 는 컴팩션 이후 다시 읽힙니다.
범위가 지정된 지침은 관련 파일에 접근할 때 다시 로드됩니다. 컴팩션과 메모리
진행 메모에는 다음 간결한 구조를 사용하세요.
1작업: [현재 주제]2출력물: [초안 및 검토 경로]3완료: [끝난 단계와 검증]4결정: [확정된 선택과 그 출처]5미해결 이슈: [누락된 근거 또는 차단 요인]6다음 행동: [하나의 구체적인 이어가기 단계]
같은 작업 공간에서 새 세션을 시작하고 아래를 붙여넣으세요.
1progress.md 를 읽고 참조된 초안과 검증을 확인하세요.2기록된 다음 행동부터 이어서 진행하고 진행 메모를 업데이트하세요.
세션은 저장된 작업을 식별하고 인수인계 지점부터 계속해야 합니다. 처음부터 다시 시작한다면 메모를 확인하고 누락된 결정이나 파일 경로를 추가하세요.
Anthropic 의 장기 실행 에이전트 가이드는 세션 간 작업을 지원하기 위해 지속적인 진행 기록을 사용합니다.
작업이 변함에 따라 이 기록을 갱신해서, 재개된 실행이 최신 정보를 갖도록 하세요. 장기 실행 하니스
승인된 작업으로 설정 측정하기
`/usage` 로 보고된 사용량을 확인하고 `/context` 로 작업 컨텍스트를 무엇이 차지하는지 살펴보세요. 위임된 검토와 재시도도 작업 총량에 포함하세요. 사용량 가이드
검토에 걸린 시간과 결과물이 요구한 수정 사항을 기록하세요.
대폭 손봐야 하는 출력물은 실행 전체의 가치를 바꿉니다.
설정 변경을 테스트할 때는 작업과 수용 기준을 일정하게 유지하세요.
한 가지 요소만 조정하고 작업을 반복한 뒤, 저장된 결과와 그 근거를 모두 확인하세요.
Anthropic 의 초기 테스터 보고서가 암시하는 60% 토큰 감소는 해당 모델 실험에 국한된 수치입니다.
자체 하니스에서 얻는 절감 효과는 완료된 작업을 직접 측정해 확인하세요. Opus 5.5 발표
처음 승인된 실행 이후, 새 주제와 출처 세트로 스킬을 재사용하세요. 검토자, 출력 경로, 완료 형식은 일관되게 유지하고, 반복되는 수정이 누락된 단계를 드러낼 때 절차를 업데이트하세요.
잃어버리지 않도록 저장해 두세요
더 많은 알짜 정보를 원하시면 @beamnxw를 팔로우하세요 :)
=> 내 Substack
![일본 더트 클래식 [S] 경주 분석](/cdn-cgi/image/width=1920,quality=90,format=auto,metadata=none/https%3A%2F%2Fcms-assets.youmind.com%2Fmedia%2F1791393139056_tgbkmu_HT9OCqSasAAks5y.jpg)
