# 스타일: X용 초안

출력 계약:
- 하나의 구체적인 숫자나 명명된 엔터티로 시작합니다. "고민해 봤는데..." 금지.
- 가능하면 문장을 18단어 미만으로 유지합니다.
- 리듬상 필요한 경우가 아니면 대시(em-dash)를 사용하지 않습니다.
- "파고들다", "활용하다", "견고한", "잠금 해제", "게임 체인저" 사용 금지.
- 3개 이상 항목을 나열할 경우 번호 대신 하이픈 목록을 사용합니다.
- 질문이 아닌 진술로 끝냅니다.

초안이 280자를 초과하고 사용자가 스레드를 요청하지 않은 경우,
답변하기 전에 그렇게 말하세요.

{
  "enabledPlugins": {
    "formatter@acme-tools": true,
    "deployer@acme-tools": false,
    "analyzer@security-plugins": false,
    "old-experiment@personal": false
  }
}

{
  "permissions": {
    "deny": [
      "Read(.env)",
      "Read(.env.*)",
      "Read(**/*secret*)",
      "Bash(rm -rf:*)",
      "Bash(sudo:*)"
    ]
  }
}

{
  "hooks": {
    "SessionStart": [
      {
        "matcher": "startup",
        "hooks": [
          {
            "type": "command",
            "command": "cat .claude/context-$(git branch --show-current).md 2>/dev/null || true"
          }
        ]
      }
    ]
  }
}

// /docs 프로젝트:
{ "model": "claude-haiku-4-5-20251001" }

// /infra 프로젝트:
{ "model": "claude-sonnet-4-6" }

// /core-engine 프로젝트:
{ "model": "claude-opus-4-7" }

{
  "mcpServers": {
    "github":   { "command": "...", "enabled": true },
    "postgres": { "command": "...", "enabled": true },
    "slack":    { "command": "...", "enabled": false },
    "linear":   { "command": "...", "enabled": false }
  }
}

{ "cleanupPeriodDays": 180 }

{
  "model": "claude-sonnet-4-6",

  "enabledPlugins": {
    "formatter@acme-tools": true,
    "old-experiment@personal": false
  },

  "permissions": {
    "deny": [
      "Read(.env)",
      "Read(.env.*)",
      "Read(**/*secret*)",
      "Bash(rm -rf:*)",
      "Bash(sudo:*)"
    ]
  },

  "hooks": {
    "SessionStart": [
      {
        "matcher": "startup",
        "hooks": [
          {
            "type": "command",
            "command": "cat .claude/context-$(git branch --show-current).md 2>/dev/null || true"
          }
        ]
      }
    ]
  },

  "disableAllHooks": false,

  "mcpServers": {
    "github":    { "command": "npx", "args": ["@modelcontextprotocol/server-github"], "enabled": true },
    "postgres":  { "command": "npx", "args": ["@modelcontextprotocol/server-postgres"], "enabled": false },
    "slack":     { "command": "npx", "args": ["@modelcontextprotocol/server-slack"], "enabled": false }
  },

  "cleanupPeriodDays": 180
}

// .claude/settings.json (문서 프로젝트인 경우)
{ "model": "claude-haiku-4-5-20251001" }

# 잘못된 예시 — 사용자 메시지 뒤에 중단점, 재사용 가능한 항목이 캐시되지 않음
messages = [
    {"role": "system", "content": SYSTEM_PROMPT},
    {"role": "user", "content": user_question,
     "cache_control": {"type": "ephemeral"}}
]

# 올바른 예시 — 안정적인 시스템 프롬프트 뒤에 중단점, 다음 호출 시 완전 캐시 히트
messages = [
    {"role": "system", "content": SYSTEM_PROMPT,
     "cache_control": {"type": "ephemeral"}},
    {"role": "user", "content": user_question}
]

{"cache_control": {"type": "ephemeral", "ttl": "1h"}}

## Claude.ai

- [ ] #1  메모리: 프로젝트 범위 활성화, 제외 목록 작성
- [ ] #2  확장 사고: 기본값 = Light
- [ ] #3  커스텀 스타일: 최소 1개의 워크플로우 스타일 생성
- [ ] #4  프로젝트 지침: 모든 활성 프로젝트에 작성
- [ ] #5  과거 채팅 검색: 켜기 (Pro+)
- [ ] #6  웹 검색 인용: 각주 모드
- [ ] #7  Cowork 신뢰 폴더: 검토 및 정리
- [ ] #8  시크릿 모드: 키보드 단축키 암기

## Claude Code

- [ ] #9  enabledPlugins: 활성 플러그인만 = true
- [ ] #10 permissions.deny: env 파일 + sudo + rm -rf 차단, OS 수준 백업 완료
- [ ] #11 hooks.SessionStart: 브랜치 인식 컨텍스트 로더
- [ ] #12 disableAllHooks: false (스위치 위치 파악)
- [ ] #13 model: 문서/인프라/코어 프로젝트별 오버라이드 설정
- [ ] #14 mcpServers: 전체 삭제가 아닌 enabled 플래그 사용
- [ ] #15 cleanupPeriodDays: 180

## API / 콘솔

- [ ] #16 cache_control: 안정적인 시스템 프롬프트 뒤에 중단점, 일일 안정 접두사는 1h TTL
- [ ] #17 inference_geo: 컴플라이언스가 실제로 요구하는 경우에만 설정
- [ ] #18 워크스페이스 속도 제한: 워크스페이스별 AND 기능별 상한 설정

#!/usr/bin/env bash

# claude-audit.sh — 7가지 Claude Code + 1가지 API 검사에서 설정 변경 감지

```bash
CLAUDE_DIR="$HOME/.claude"
SETTINGS="$CLAUDE_DIR/settings.json"

echo "=== 활성화된 플러그인 ==="
jq '.enabledPlugins // {} | to_entries | map(select(.value==true)) | length' "$SETTINGS" 2>/dev/null
echo "목표: 3-5개 활성화. 나머지는 세션별로 다시 활성화하세요."

echo
echo "=== 활성화된 MCP 서버 ==="
jq '.mcpServers // {} | to_entries | map(select(.value.enabled==true)) | length' "$SETTINGS" 2>/dev/null
echo "목표: 3개 항상 켜기. 나머지는 세션별로 활성화."

echo
echo "=== permissions.deny 규칙 존재 ==="
jq '.permissions.deny // [] | length' "$SETTINGS" 2>/dev/null
echo "목표: >=5개 규칙. 최소한 .env / sudo / rm -rf 포함."

echo
echo "=== SessionStart 훅 구성됨 ==="
jq '.hooks.SessionStart // [] | length' "$SETTINGS" 2>/dev/null
echo "목표: >=1개 항목."

echo
echo "=== cleanupPeriodDays ==="
jq '.cleanupPeriodDays // 30' "$SETTINGS" 2>/dev/null
echo "목표: 180."

echo
echo "=== 프로젝트별 모델 오버라이드 ==="
find . -maxdepth 3 -name "settings.json" -path "*/.claude/*" 2>/dev/null | while read f; do
  model=$(jq -r '.model // "—"' "$f")
  echo "  $f → $model"
done
echo "목표: docs → haiku, infra → sonnet, core → opus."

echo
echo "=== API cache_control 확인 (실행하려면 API_KEY 설정 필요) ==="
if [ -n "$ANTHROPIC_API_KEY" ]; then
  echo "수동 확인: 1K 토큰을 초과하는 모든 system_prompt는 1h TTL의 cache_control을 가져야 합니다."
else
  echo "건너뜀 — ANTHROPIC_API_KEY를 설정하여 활성화하세요."
fi