문서 초안과 방향 결정
  -> Claude 앱에서 자료·결정 기준을 정리한다.

현재 저장소 수정과 검증
  -> Claude Code에서 branch, diff, 테스트 명령을 확인한다.

둘을 이어 쓸 때
  -> 앱의 결론을 구현 명세로 옮기고, Code의 실제 검증 결과를 다시 반영한다.

Cowork 클라우드 세션(beta)
  -> Anthropic 서버의 격리 환경에서 장기 작업
  -> 웹 / 데스크톱 / 모바일에서 같은 세션 확인

로컬 파일·브라우저·컴퓨터가 필요함
  -> 해당 컴퓨터의 Claude Desktop을 통해 접근
  -> Desktop 앱이 연결되어 있어야 함

작업: 제공한 support request를 routing policy에 따라 분류한다.
input: <policy>와 <request>만 사실 근거로 사용한다.
완료: category, reason, missing_information을 JSON으로 반환한다.
제약: policy에 근거가 없으면 category를 추정하지 않는다.

<instructions>제공된 source만 사용한다.</instructions>
<documents>
  <document id="policy-v2"><source>policy.md</source><document_content>...</document_content></document>
</documents>
<input>{{request}}</input>
<output_format>claim마다 source ID를 포함한 JSON</output_format>

system: 역할 + 지속되는 평가 기준 + evidence 부족 시 행동
user: 이번 task + source + output contract + 우선순위·deadline
server: authentication + authorization + validation + audit

<examples>
  <example>
    <input>배송은 빠른데 포장이 찢어졌어요.</input>
    <output>{"sentiment":"mixed","action":"packaging_review"}</output>
  </example>
  <example>
    <input>인증 메일이 오지 않습니다.</input>
    <output>{"sentiment":"negative","action":"account_verification"}</output>
  </example>
</examples>

<documents>
  <document id="policy-2026-04">
    <source>policy.md</source>
    <updated_at>2026-04-01</updated_at>
    <document_content>...</document_content>
  </document>
</documents>

<task>위 자료만 사용해 질문에 답하고, source ID와 quote를 붙인다.</task>

extract evidence -> draft -> review against criteria -> refine -> final validation
     |                |              |                  |
   source IDs       draft ID       findings[]          pass / needs-review

{
  "output_config": {
    "format": {
      "type": "json_schema",
      "schema": {
        "type": "object",
        "properties": {
          "summary": { "type": "string" },
          "riskLevel": { "type": "string", "enum": ["low", "high"] }
        },
        "required": ["summary", "riskLevel"],
        "additionalProperties": false
      }
    }
  }
}

출력 계약
- fields: title, risk, evidence
- risk: low | medium | high
- evidence가 없으면 null
- 추가 설명이나 Markdown은 출력하지 않음

success criteria -> test cases -> baseline prompt -> score -> revised prompt -> same suite -> compare -> release / reject

답변 계약
1. <sources> 밖의 사실은 추가하지 않는다.
2. 핵심 claim마다 source ID와 짧은 quote를 붙인다.
3. evidence가 없으면 "제공 자료에서 확인되지 않음"으로 표시한다.
4. quote가 claim을 실제로 뒷받침하는지 마지막에 다시 점검한다.

response = client.messages.create(
    model="지원 모델 ID",
    max_tokens=1_024,
    cache_control={"type": "ephemeral"},
    system="변하지 않는 검토 정책과 용어집",
    messages=[{"role": "user", "content": "이번 변경의 위험만 요약해 줘."}],
)

{
  "name": "get_order",
  "description": "현재 사용자가 접근 가능한 주문 한 건을 읽습니다. 주문을 변경하지 않으며, 존재하지 않거나 권한이 없으면 오류 코드를 반환합니다.",
  "strict": true,
  "input_schema": {
    "type": "object",
    "properties": {
      "orderId": { "type": "string", "description": "조회할 주문 ID" }
    },
    "required": ["orderId"],
    "additionalProperties": false
  }
}

response = client.messages.create(
    model="지원 모델 ID",
    max_tokens=8_192,
    messages=[{"role": "user", "content": "변경 범위와 테스트 위험을 분석해 줘."}],
    thinking={"type": "adaptive"},
    output_config={"effort": "medium"},
)

# macOS, Linux, WSL: 권장 설치 경로
curl -fsSL https://claude.ai/install.sh | bash

# 설치와 현재 버전을 확인한다.
claude --version

# 작업할 저장소에서 시작한다.
cd /path/to/project
claude

CLAUDE.md: "커밋 전 npm test를 실행한다."
auto memory: "이 저장소의 통합 테스트에는 local Redis가 필요하다."
강제 정책: permissions.deny로 secret 파일 읽기를 막는다.

{
  "preferredNotifChannel": "terminal_bell",
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh",
    "padding": 1
  }
}

대화가 길지만 현재 판단을 이어야 한다  -> /compact
이전 대화와 완전히 다른 문제를 시작한다 -> /clear
같은 저장소의 다른 작업을 이어간다     -> /resume
규칙이나 도구가 예상과 다르게 적용된다   -> /memory, /permissions, /mcp

{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Read(./config/credentials.json)"
    ]
  }
}

# 기계가 읽을 최종 결과와 실행 한도를 함께 둔다.
claude -p --output-format json --max-turns 3 --max-budget-usd 2 \
  "현재 git diff에서 수정된 파일과 테스트 위험만 JSON으로 반환해 줘. 파일은 수정하지 마."

# 프롬프트가 필요한 호출을 모두 거부하는 CI용 시작점이다.
claude -p --permission-mode dontAsk --max-turns 3 \
  "테스트 결과를 읽고 실패 원인만 요약해 줘."

# 현재 세션을 계획부터 시작한다.
claude --permission-mode plan

# 비대화형 CI는 승인 대기 대신 허용되지 않은 호출을 실패시킨다.
claude -p --permission-mode dontAsk "테스트 결과만 요약해 줘."

# plan에서 나온 계획을 수정으로 전환하기 전에는 파일·테스트 범위를 다시 확인한다.

선택 코드가 중요할 때
1. 편집기에서 범위를 선택한다.
2. Prompt footer에서 선택 줄 수와 공개 상태를 확인한다.
3. Option+K(macOS) / Alt+K(Windows·Linux)로 @-mention을 넣는다.
4. 목표·수정 허용 범위·검증 명령을 함께 요청한다.

"항상 다이어그램 먼저 설명" -> output style
"이 저장소는 npm test를 실행" -> CLAUDE.md
"이번 CI 실행에서만 JSON으로 출력" -> --append-system-prompt 또는 prompt
"현재 diff를 read-only로 review" -> skill 또는 subagent

# 현재 대화를 보존하고, 다른 해결책은 새 session에서 시도한다.
claude --resume auth-refactor --fork-session

# 같은 저장소에서 파일 변경을 격리한 병렬 작업을 시작한다.
claude --worktree feature-auth

Project
  +- chats: 같은 주제의 대화 기록
  +- knowledge: 반복해서 참조할 자료
  +- instructions: Claude가 따를 작업 규칙

요청: 결과물의 타입 + 대상 + 포함 조건을 명시
  -> Artifact 생성
  -> 부분 수정 또는 새 버전 반복
  -> 보관하려면 Publish로 Artifacts sidebar에 추가

style: "짧은 결론 뒤에 근거를 설명한다."
profile instructions: "기본 응답 언어는 한국어다."
project instructions: "이 Project의 제품명과 release process는 제공된 정의를 따른다."
prompt: "이번 changelog를 200자 이내로 정리한다."

조사 요청에 넣을 정보
- 질문: 무엇을 결정하거나 비교할 것인가
- 범위: 기간, 지역, 제품·버전, 포함·제외 기준
- 근거: 공식 문서·1차 자료 우선 여부, 사용할 연결 자료
- 결과: 사실 / 해석 / 추천을 구분하고 각 사실에 인용을 붙일 것

입력 데이터 + 산출물 형식 + 계산/표현 규칙
  -> 격리 환경에서 생성
  -> 파일 다운로드 또는 Google Drive 저장
  -> 대상 앱에서 열어 수식·레이아웃·출처 검증

---
name: code-reviewer
description: "변경된 파일의 correctness와 보안 위험을 읽기 전용으로 검토할 때 사용합니다."
tools: Read, Grep, Glob, Bash(git diff *)
---

파일 위치와 근거가 있는 finding만 보고합니다. 파일을 수정하지 않습니다.

import { query } from "@anthropic-ai/claude-agent-sdk";

for await (const message of query({
  prompt: "Find error-handling gaps and report them without editing files.",
  options: {
    allowedTools: ["Read", "Glob", "Grep"],
    permissionMode: "dontAsk",
    maxTurns: 5,
  },
})) {
  if (message.type === "result" && message.subtype === "success") {
    console.log(message.result);
  }
}