첫 요청에 붙일 자료와 참조할 자료를 나누는 법

첫 보고서 초안을 맡기려는데 자료가 열 개라면, 모두 첨부하기보다 이번 결론에 필요한 자료부터 고르세요. 이 글은 ClawPod Cloud에서 처음 업무를 맡기는 실무자가 자료와 지침을 나누고, Agent가 무엇을 실제로 읽었는지 확인하는 방법을 설명합니다. 사용자와 Agent가 대화하는 공간인 Room에 접근할 수 있고, 업무에 사용할 권한이 있는 자료가 준비되어 있어야 합니다. 여기서는 읽기와 초안 작성만 다루며, 계정 연결·지침 변경·외부 발송은 하지 않습니다.

핵심은 지금 필요한 내용은 요청에, 긴 상세 자료는 위치와 읽을 범위를 함께, 반복 규칙은 별도 관리입니다. 다만 첨부하거나 위치를 적었다는 사실만으로 읽기 성공을 판단하지 마세요. 먼저 확인한 자료와 읽지 못한 자료를 나눠 받습니다.

자료의 양보다 역할을 먼저 나눕니다

자료는 이번 판단의 근거이고, 지침은 일을 처리하는 기준입니다. 예를 들어 이번 분기 실적표는 자료, “근거 없는 원인을 추정하지 않는다”는 지침입니다. 아래는 제품의 자동 분류 기능이 아니라 요청을 준비하는 편집 기준입니다.

구분	첫 요청에서 할 일	예
이번 결론에 꼭 필요	필요한 부분을 붙이거나 허용된 파일로 첨부	이번 분기 실적과 단위
길지만 특정 부분만 필요	정확한 위치·버전·읽을 절을 지정	보고 양식 v3의 필수 항목
반복해서 쓰는 규칙	이번 요청에는 핵심만 적고 장기 관리는 따로 검토	사실과 미확인을 분리
이번 판단과 무관	제외	지난 회의의 잡담

반복 규칙을 정리한다고 이번 작업 중 운영 지침 파일까지 고칠 필요는 없습니다. 첫 요청에서는 필요한 규칙을 짧게 적고, 재사용 여부는 결과를 본 뒤 결정하세요.

첨부와 참조는 읽기 확인이 다릅니다

첨부는 이번 대화에 파일을 제공하는 방식입니다. 공식 Guide는 허용된 형식과 크기 범위에서 Room 파일 첨부를 안내하지만, 업로드·미리보기·결과물 생성은 서로 다른 기능이라고 설명합니다. 업로드 성공이나 화면의 미리보기를 파일 전체를 읽었다는 증거로 쓰지 마세요. 이 글은 첨부 크기나 모델별 입력 예산을 계산하는 안내가 아닙니다.

참조는 파일 경로나 문서 주소처럼 자료가 있는 곳을 알려 주는 방식입니다. 위치만 적는 대신 대상 Agent가 접근할 수 있는지, 읽을 도구가 준비됐는지 확인하도록 요청하세요. 내 컴퓨터에서 보이는 파일이 Agent의 작업 공간에도 있다는 전제로 요청하지 않습니다. 파일 작업은 허용 경로와 필요한 도구를, 웹 자료는 대상 주소와 계정 범위를 함께 정합니다. 읽을 수 없다면 필요한 부분을 조직에서 허용하는 방식으로 제공하거나 담당자에게 접근 경로를 확인하세요. 권한을 우회하거나 읽지 못한 내용을 추정하는 방식으로 해결하지 않습니다.

공식 Guide가 말하는 “긴 파일은 잘릴 수 있다”는 주의는 Agent 시작 지침인 bootstrap 파일에 관한 것입니다. 핵심 규칙을 앞에 두고 긴 절차는 별도 문서로 분리하라는 권고를, 모든 첨부가 같은 크기 제한을 쓴다는 주장으로 넓힐 수는 없습니다. 참조 문서를 나눴다고 모든 자료의 자동 읽기가 보장되는 것도 아닙니다.

첫 요청에는 자료 목록과 멈출 조건을 함께 씁니다

좋은 요청에는 결과물, 사용할 자료, 금지 사항, 불확실할 때의 처리 방법이 들어갑니다. 자료마다 이름·버전 또는 날짜·읽을 부분을 붙이면 결과의 근거를 대조하기 쉽습니다. 특히 “파일을 못 읽으면 먼저 알려 달라”는 조건을 초안 작성보다 앞에 두세요.

아래는 가상 예시입니다. 실제 고객 자료나 제품 실행 기록이 아닙니다. 교육을 위해 직접 붙이는 작은 표와, Agent 작업 공간에 이미 준비됐다고 가정한 양식 파일을 사용합니다. 실제 환경에서는 경로와 읽기 권한부터 확인해야 합니다.

요청: 분기 실적의 사실 요약만 만듭니다

이번 분기 보고서의 사실 요약을 이 Room에 작성해 주세요. 아래 표는 가상 자료이며 단위는 건입니다. 다른 자료나 웹 검색은 쓰지 마세요.

• 전 분기: 접수 120, 완료 90
• 이번 분기: 접수 150, 완료 120

양식은 reports/report-format-v3.md의 “필수 항목” 절만 참조해 주세요. 먼저 해당 파일과 절을 실제로 읽을 수 있는지, 버전이 v3인지 알려 주세요. 읽을 수 없거나 버전이 다르면 요약 작성 전에 멈추고 필요한 자료를 요청하세요.

양식의 항목에 맞춰 실적과 미확인 사항을 나누고, 각 수치의 근거를 적어 주세요. 접수·완료는 각각 해당 분기의 집계이므로 같은 건들의 완료율을 뜻한다고 해석하지 마세요. 증감 원인은 추정하지 마세요. 원본 수정, 지침·기억 갱신, 외부 전송은 하지 마세요.

이 가상 양식의 “필수 항목”은 실적 요약·미확인 사항·근거 세 가지라고 가정합니다. 파일을 가리키는 요청과 그 파일의 내용을 구분하기 위해 양식의 내용도 여기서 공개합니다.

채워진 결과: 읽은 자료와 한계를 먼저 받습니다

가상 결과 표본 — 아래 문장은 실제 파일 접근 성공을 입증하지 않습니다.

자료 확인: 요청 본문의 두 분기 수치를 사용했습니다. report-format-v3.md의 버전 v3와 “필수 항목”의 세 항목을 확인했습니다. 다른 절이나 외부 자료는 사용하지 않았습니다.

실적 요약: 접수는 120건에서 150건으로 30건 증가했습니다. 완료는 90건에서 120건으로 30건 증가했습니다.

미확인 사항: 증가 원인은 제공 자료만으로 확인할 수 없습니다. 분기별 접수·완료가 동일한 대상 집단인지는 확인되지 않아 완료율을 계산하지 않았습니다.

근거: 접수와 완료 수치는 요청 본문의 “전 분기”·“이번 분기” 행, 구성은 양식 v3의 “필수 항목” 절입니다. 원본·지침·기억은 변경하지 않았고 외부로 보내지 않았습니다.

완료 여부는 원자료와 대조합니다

“확인했습니다”라는 응답만으로 검증을 끝내지 마세요. 위 예시에서는 다음을 직접 대조합니다.

1. Agent가 보고한 파일명·버전·절이 지정한 양식과 같은지 확인합니다. 해당 절의 실제 항목이 결과에 빠짐없이 들어 있어야 합니다.
2. 요청 표와 결과의 네 수치가 일치하는지 확인합니다. 접수는 150−120=30, 완료는 120−90=30입니다.
3. 결과에 근거 없는 원인이나 완료율이 없는지 확인합니다. 자료 부족이 “미확인”으로 남아 있어야 합니다.
4. 중요한 원본은 조직에서 쓰는 변경 이력이나 원본 사본으로 변경 여부를 확인합니다. 변경·전송하지 않았다는 보고와 그 사실을 독립적으로 확인한 증거는 구분합니다.

수치가 맞아도 다른 버전의 양식을 사용했다면 요청대로 완료한 것이 아닙니다. 결과를 외부에 사용하기 전에 검토자가 근거와 범위를 확인해야 합니다.

자료가 막히면 그 부분에서 멈춥니다

예를 들어 Agent가 “양식 파일에 접근할 수 없습니다. 초안은 만들지 않았습니다”라고 답했다면, 다른 폴더를 무작정 찾게 하지 마세요. 경로가 맞는지 확인하고, 허용된 읽기 경로를 준비하거나 “필수 항목” 절만 민감정보를 제거해 제공한 뒤 다시 요청합니다. 이때 참조 파일 대신 직접 제공한 절을 사용했다는 사실도 결과에 남깁니다.

양식 버전이 다르면 사용할 버전을 지정하고 다시 확인합니다. 수치가 틀리면 해당 문장과 근거 행을 대조해 고치게 합니다. 초안에서 원인을 지어냈다면 그 문장을 제거하고 미확인 사항으로 되돌리세요. 처음 요청한 범위를 넓히는 조사나 계정 연결은 별도 결정입니다.

비밀값과 장기 지침은 이번 자료에서 분리합니다

파일을 올리기 전에 개인정보·고객 원문·비밀값이 필요한지 확인하고 불필요한 내용은 제거합니다. 업로드는 외부 전송이나 영구 보관을 지시하는 행위가 아닙니다. API 키나 비밀번호를 양식·요청 본문·일반 메모리에 넣지 마세요. 업무용 비밀값이 정말 필요하면 사용 가능한 시크릿 스토어와 조직이 허용한 전달 방식을 먼저 확인합니다. 등록만으로 모든 도구의 인증이 연결되거나 기존 대화의 비밀값이 지워지는 것은 아닙니다.

반복해서 쓸 지침의 위치는 역할에 따라 다릅니다. 공식 Guide는 역할·말투를 SOUL.md, 반복 업무 규칙을 AGENTS.md, 도구 사용 메모를 TOOLS.md, 안정적인 선호와 기록을 USER.md 또는 기억 문서로 구분합니다. 저장한 파일이 모든 대화에 자동 적용된다고 가정하지 않습니다. 변경이 필요하면 대상 파일·절·보존할 보안 규칙·검토자를 정하고 운영 담당자의 절차로 확인하세요.

지침 문장은 실행 권한을 부여하거나 승인·접근 제한을 자동으로 강제하는 장치가 아닙니다. 실제 도구 권한과 조직 정책은 따로 지켜야 합니다. 이 글은 지침 편집 화면, 입력 예산 표시, 모든 형식의 읽기 성공을 보장하지 않습니다.

다음 첫 요청에서는 자료 목록 하나를 먼저 적어 보세요. 지금 제공할 내용, 위치와 범위를 지정할 내용, 제외할 내용을 나누고, 초안보다 앞서 읽기 확인을 받는 것으로 시작하면 됩니다.

Sources

• ClawPod Guide — Agent workspace 파일: 지침의 역할, 참조 분리, 권한과 적용의 경계.
• ClawPod Guide — 파일 형식과 artifact: 업로드·미리보기·생성의 구분.
• ClawPod Guide — Chat Room: 요청의 구성과 자료 취급.
• ClawPod Guide — Browser와 CLI 작업: 경로·도구·계정 범위와 검증.
• ClawPod Guide — Secret과 민감한 값: 비밀값 전달·등록·사용의 경계.