Claude Code /insights로 사용 패턴 분석하고 12개 개선안 전부 반영하기

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

## 서버 관리 규칙

서버를 재시작하거나 관리할 때 반드시 아래 절차를 따른다.

**표준 재시작 절차 (5단계):**
1. **인스턴스 탐색**: ps aux | grep, lsof -i :<포트>
2. **전체 종료**: 발견된 모든 인스턴스 종료
3. **포트 확인**: 포트에 프로세스가 남아있지 않은지 확인
4. **새 인스턴스 시작**: 표준 명령어로 서버 시작
5. **검증**: 서버 응답 확인

**주의사항:**
- 새 인스턴스를 시작하기 전에 반드시 기존 인스턴스를 모두 종료한다
- 5단계 검증까지 완료하지 않으면 작업 완료로 간주하지 않는다

1
2
3
4
5
6

## 분석 및 작성 기준

### 작성 규칙
1. **가정을 사실로 기술 금지** — '가능성 높음', '~로 보임' 등 유보적 표현 사용
2. **날짜/요일/수치 재확인** — 제시 전 원본 데이터와 대조
3. **어조 조절** — 간결하고 절제된 어조, 단정적 표현 금지

1
2
3
4

## AWS SSO 로그인 규칙
- AWS CLI 명령어를 실행하기 전에, 먼저 `aws sts get-caller-identity`를 실행하여
  세션 토큰이 유효한지 사전 확인한다.
- 토큰이 만료된 경우, 실제 작업 진행 전에 `aws sso login`을 실행하여 재인증한다.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22

# 서버 재시작 스킬

## 절차

### 1단계: 실행 중인 인스턴스 탐색
- ps aux, lsof로 모든 PID와 포트 나열
- 사용자에게 발견 결과를 보여주고, 종료 전 확인

### 2단계: 전체 인스턴스 종료
- kill 명령으로 종료, 5초 대기 후 남아있으면 kill -9

### 3단계: 포트 확인
- 대상 포트에 프로세스가 없는지 확인

### 4단계: 새 인스턴스 시작
- 올바른 프로젝트 디렉토리에서 시작 (가정하지 않고 탐색)

### 5단계: 검증
- curl, 헬스체크 엔드포인트로 정상 확인
- DB 상태가 UI와 동기화되었는지 확인
- Playwright 스크린샷으로 시각적 확인
- 최종 상태 보고

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "command": "if echo \"$CC_TOOL_INPUT\" | grep -qE '\\.(css|html|js)$';
          then npx prettier --write \"$CC_TOOL_INPUT\" 2>/dev/null; fi;
          if echo \"$CC_TOOL_INPUT\" | grep -qE '\\.py$';
          then ruff check --fix \"$CC_TOOL_INPUT\" 2>/dev/null; fi"
      }
    ]
  }
}

1
2
3
4
5
6

#!/bin/bash
# scripts/headless-server-health.sh
claude -p "현재 실행 중인 모든 서버 프로세스를 확인하고,
  각 서버의 헬스 엔드포인트에 curl로 접근하여 응답 상태를 확인하라.
  정상/비정상 여부를 요약 테이블로 보고하라." \
  --allowedTools "Bash,Read"

1
2
3
4
5
6
7

#!/bin/bash
# scripts/headless-datadog-cost-check.sh
DAYS=${1:-7}
claude -p "Datadog MCP를 사용하여 최근 ${DAYS}일간 APM 사용량을 조회하고,
  20% 이상의 비용 급증을 요약하여 마크다운 테이블로 포맷하라.
  결과를 원시 데이터 / 관찰 / 가설 구조로 제시하라." \
  --allowedTools "mcp__datadog__logs,mcp__datadog__traces,mcp__datadog__metrics,Read,Bash"

1
2
3
4
5
6
7

#!/bin/bash
# scripts/headless-server-restart.sh
PORT=${1:-8080}
claude -p "포트 ${PORT}의 모든 실행 중인 서버 인스턴스를 찾아 종료하고,
  포트가 비었는지 확인한 후, 표준 명령어로 서버를 시작하라.
  최종 상태를 보고하라." \
  --allowedTools "Bash,Read"

[원시 데이터]
• 찾은 정확한 수치와 타임스탬프

[관찰]
• 발견한 패턴과 신뢰도 (높음/중간/낮음)

[가설]
• 미검증으로 명시된 가능한 설명

1. Datadog 로그/트레이스 조회
2. 데이터 분석
3. 결과 구조화 (원시 데이터 → 관찰 → 가설)
4. 게시 전 주장 검증
5. Slack/Jira 게시 (사용자 승인 후)

에이전트 1 (콘텐츠): Markdown/HTML 카피 수정
에이전트 2 (스타일링): CSS/HTML 조정
에이전트 3 (검증): Playwright 스크린샷 시각적 검증

flowchart LR
    subgraph 문제["반복 마찰"]
        A[서버 재시작 실패<br/>176건]
        B[사실 오류<br/>208건]
        C[SSO 만료<br/>7건]
    end

    subgraph 해결["구현한 것"]
        D[CLAUDE.md<br/>서버 관리 5단계]
        E["/restart 스킬"]
        F[CLAUDE.md<br/>분석/작성 기준]
        G[게시 전 검증<br/>체크리스트]
        H[SSO 사전 점검]
        I[PostToolUse 훅<br/>Prettier + ruff]
        J[헤드리스 스크립트<br/>3종]
        K[병렬 에이전트<br/>가이드]
    end

    A --> D
    A --> E
    B --> F
    B --> G
    C --> H

    style 문제 fill:#fef2f2,stroke:#fca5a5
    style 해결 fill:#f0fdf4,stroke:#86efac

gdoc_arrow_left_alt AI 인프라 자동화 #1 에이전트가 일을 할 수 있는가 비용 리포트 자동화 구축기 gdoc_arrow_right_alt