Hello Claude Code

핵심 철학

원칙	설명
정확성	확실한 정보만 답변, 추측은 "추측:" 명시
집중	요청 범위에 집중, 불필요한 확장 방지
코드 기반	실제 코드 분석 후 판단, 추측 금지
간결함	Over-engineering 금지, 요청 범위만 수정

---

프로젝트 구조

hello-claude-code/
├── rules/           # 핵심 규칙 (10개) - 항상 적용
├── agents/          # 서브에이전트 (6개) - 위임 작업용
└── skills/          # 스킬 (14개) - 필요시 호출

---

설치 방법

1. 레포지토리 클론

git clone https://github.com/[your-username]/hello-claude-code.git
cd hello-claude-code

2. 파일 복사 (선택)

원하는 구성 요소만 복사:

# 규칙만 사용
cp rules/*.md ~/.claude/rules/

# 에이전트도 사용
cp agents/*.md ~/.claude/agents/

# 스킬도 사용
cp -r skills/* ~/.claude/skills/

---

사용 방법

Rules (규칙)

자동 적용 - Claude Code가 항상 참조합니다.

파일	용도
00-anti-hallucination.md	헛소리 방지, 정확도 검증
01-mandatory-checklist.md	응답 전 필수 체크리스트
02-context-anchoring.md	컨텍스트 고정, 범위 제한
03-core-principles.md	응답 철학, 금지/허용 표현
04-communication.md	커뮤니케이션 스타일
05-security.md	보안 규칙, 즉시 경고 항목
06-coding-style.md	간결성 원칙, 언어별 컨벤션
07-testing.md	테스트 규칙, 빌드/린트
08-performance.md	서버 성능 최적화
09-tool-autonomy.md	도구 자율 사용 원칙

Agents (에이전트)

복잡한 작업을 위임할 때 사용:

에이전트	역할
planner	구현 계획 수립, 작업 분해
architect	시스템 설계, 아키텍처 결정
code-reviewer	코드 품질/보안/유지보수성 리뷰
security-reviewer	보안 취약점 전문 분석
refactorer	코드 리팩토링
tdd-guide	TDD 가이드

Skills (스킬)

사용자 호출 (슬래시 명령어로 직접 호출):

스킬	용도
/brainstorming	구현 전 설계 논의 (plan 전 단계)
/plan	복잡한 구현을 위한 계획 수립
/review	코드 품질/보안/유지보수성 검토
/setup-serena-mcp	Serena MCP 프로젝트 활성화 및 온보딩
/tdd	TDD 방식 개발 (RED-GREEN-REFACTOR)
/ui-toolkit-design	Unity UI Toolkit (UXML/USS) 가이드라인

자동 호출 (시스템이 상황에 맞춰 자동 활성화):

스킬	용도
error-response	에러 응답 표준 형식
executing-plans	계획을 배치로 실행하고 체크포인트에서 검증
quality-verification	코드 품질 기준 + 완료 검증 프로세스
research-context	기술 조사, 라이브러리 비교, 아키텍처 결정
sequential-thinking	Sequential Thinking MCP 사용 가이드
serena-mcp	Serena MCP 시맨틱 코드 분석 및 프로젝트 지식 관리
systematic-debugging	체계적 디버깅 프로세스
ui-toolkit-design	Unity UI Toolkit (UXML/USS) 작업 시 자동 활성화
web-search	웹 검색 가이드 및 도구 우선순위

---

커스터마이징

규칙 수정

rules/ 폴더에서 직접 수정:

# 예: 코딩 스타일 수정
vim rules/06-coding-style.md

에이전트 추가

agents/ 폴더에 새 파일 생성:

---
name: my-agent
description: 에이전트 설명
tools: Read, Grep, Glob, Bash
---

# 에이전트 내용
...

---

파일 목록

Rules (10개)

rules/00-anti-hallucination.md
rules/01-mandatory-checklist.md
rules/02-context-anchoring.md
rules/03-core-principles.md
rules/04-communication.md
rules/05-security.md
rules/06-coding-style.md
rules/07-testing.md
rules/08-performance.md
rules/09-tool-autonomy.md

Agents (6개)

agents/planner.md
agents/architect.md
agents/code-reviewer.md
agents/security-reviewer.md
agents/refactorer.md
agents/tdd-guide.md

Skills (14개)

사용자 호출 (6개)

skills/brainstorming/SKILL.md
skills/plan/SKILL.md
skills/review/SKILL.md
skills/setup-serena-mcp/SKILL.md
skills/tdd/SKILL.md
skills/ui-toolkit-design/SKILL.md

자동 호출 (9개 — 일부는 사용자 호출도 겸함)

skills/error-response/SKILL.md
skills/executing-plans/SKILL.md
skills/quality-verification/SKILL.md
skills/research-context/SKILL.md
skills/sequential-thinking/SKILL.md
skills/serena-mcp/SKILL.md
skills/systematic-debugging/SKILL.md
skills/ui-toolkit-design/SKILL.md
skills/web-search/SKILL.md

---

주의사항

컨텍스트 윈도우

MCP를 너무 많이 활성화하면 컨텍스트가 줄어듭니다:

• 권장: 프로젝트당 MCP 10개 이하

---

라이선스

MIT License