docs: OS.md 파일 및 스킬 생성

[bgyoons]

변경 개요

Claude Code를 개인 OS처럼 운영하기 위한 스킬 시스템과 에이전트 구성을 추가합니다.
귀찮은 반복 작업(분석, 테스트, 리뷰, 커밋, PR)은 Claude가 자동화하고, 판단이 필요한 작업(코드 작성, 기술 결정)은 사용자가 담당하는 구조입니다.

추가된 파일

종류	파일	역할
문서	OS.md	Claude OS 청사진 및 구현 로드맵
스킬	.claude/skills/ticket-start/SKILL.md	기획서 분석 + 브리핑 생성
스킬	.claude/skills/task-impl/SKILL.md	개발 태스크 분해 + 구현 루프
스킬	.claude/skills/dev-loop/SKILL.md	테스트+리뷰+PR 오케스트레이터
스킬	.claude/skills/dev-test/SKILL.md	테스트 실행 + 정적 분석
스킬	.claude/skills/dev-ship/SKILL.md	리뷰 루프 + PR 생성
스킬	.claude/skills/auto-commit/SKILL.md	보안 체크 + 커밋 자동화
스킬	.claude/skills/skill-stats/SKILL.md	스킬 사용 통계 조회
에이전트	.claude/agents/spec-analyzer.md	기획서 소스 감지 및 파싱
에이전트	.claude/agents/code-reviewer.md	React/TypeScript 코드 리뷰
에이전트	.claude/agents/static-code-tester.md	정적 코드 분석 (런타임 없이)
설정	.claude/settings.json	스킬 호출 자동 로깅 훅

스킬 워크플로우

개발 시작부터 PR 생성까지 4개 스킬이 순서대로 실행됩니다.

/ticket-start [기획서 소스]
↓
/task-impl
↓
/dev-loop (= /dev-test → /dev-ship)

1단계: /ticket-start — 기획서 분석

기획서를 읽고 개발 준비를 자동화합니다.

• Notion URL, Slack URL, 로컬 파일, HTTP URL, 텍스트 직접 입력 지원
• spec-analyzer 에이전트 호출 → 요구사항·제약조건·키워드 추출
• Explore 서브에이전트 호출 → 코드베이스에서 영향받는 파일 탐색
• docs/ticket-briefing.md, docs/qa-checklist.md 자동 생성

2단계: /task-impl — 태스크 구현 루프

브리핑을 개발 단위로 쪼개고 하나씩 구현합니다.

• docs/ticket-briefing.md 자동 감지 또는 자유 형식 설명 입력
• 태스크 목록을 출력하고 사용자 확인 후 시작
• 태스크 수 ≥ 5 또는 의존성 없음 → 병렬 에이전트 위임 모드
• 그 외 → 직접 실행 모드 (구현 → 커밋 순차 반복)
• 완료 시 /dev-loop 실행을 안내

3단계: /dev-test — 테스트 + 정적 분석

테스트를 통과시키는 것에 집중합니다.

• 테스트 명령어 자동 감지 (npm test → npm run test:ci → make test)
• static-code-tester 에이전트 호출 → 정적 분석 (런타임 없이 논리 버그·엣지케이스 탐지)
• Playwright QA: docs/qa-checklist.md 있으면 시나리오 실행, 없으면 diff 기반 스모크 테스트
• 실패 시 자동 수정 → 커밋 → 재실행 (최대 3회)
• 통과 후 code-reviewer 에이전트 단발 리뷰 (이 단계에서는 수정 없음)

4단계: /dev-ship — 코드 리뷰 루프 + PR

리뷰를 통과시키고 PR을 생성합니다.

• code-reviewer 에이전트 호출 → CRITICAL/WARNING 이슈 분류
• CRITICAL + AUTO-FIXABLE → 자동 수정 → 커밋 → 재리뷰 (최대 3회)
• CRITICAL + MANUAL → 중단, 수동 수정 요청
• WARNING → 사용자 확인 후 계속
• PR 템플릿 자동 감지 (.github/pull_request_template.md 등)
• gh pr create로 PR 생성 (push 전 사용자 확인)

/dev-loop — 오케스트레이터

/dev-test와 /dev-ship을 순서대로 실행하는 래퍼입니다.
/dev-test가 실패하면 /dev-ship을 실행하지 않습니다.

에이전트 실행 시점

에이전트	호출 스킬	실행 시점
spec-analyzer	/ticket-start	기획서 소스를 받아 요구사항·제약조건·키워드 추출
static-code-tester	/dev-test	테스트 루프의 각 회차에서 정적 분석 실행
code-reviewer	/dev-test, /dev-ship	/dev-test 통과 후 단발 리뷰; /dev-ship에서 CRITICAL 없을 때까지 반복

자동화 훅

.claude/settings.json의 PostToolUse 훅이 모든 스킬 호출을 .claude/skill_calls.log에 기록합니다.
/skill-stats로 사용 통계를 조회할 수 있습니다.

보안 체크

모든 커밋 전 .env, secrets, credentials 패턴을 감지합니다.
감지 시 사용자 명시적 허가 없이는 커밋을 중단합니다.
main/master 브랜치에서는 모든 스킬 실행을 거부합니다.