-
Notifications
You must be signed in to change notification settings - Fork 0
Development Workflow
l2juhan edited this page Apr 18, 2026
·
1 revision
PayCheck-mobile 프로젝트의 Claude Code 하네스 엔지니어링 기반 개발 체계를 설명합니다.
| 항목 | 내용 |
|---|---|
| 도입 시점 | 2026-04-04 (PR #63) |
| 목적 | AI 보조 개발 체계 구축 — 반복 컨텍스트 제거 + 팀 단위 오케스트레이션 |
| 진입점 |
paycheck-issue 스킬 (GitHub Issue 기반) |
| 관련 문서 |
CLAUDE.md, docs/FRONTEND.md, docs/DESIGN.md, docs/design-docs/core-beliefs.md
|
한 마디로: Claude에게 "어떻게 일할지"를 코드처럼 정의해두는 것.
매 세션마다 "React Native 프로젝트야, colors.ts 써야 해, Text 컴포넌트 직접 쓰면 안 돼"를 반복 설명할 필요 없이, 하네스가 이 맥락을 파일로 저장해 자동 주입한다. 복잡한 작업은 UI 전문가·로직 전문가·코드 리뷰어가 팀을 이뤄 병렬로 작업하도록 오케스트레이션한다.
┌─────────────────────────────────────────────────────────────────┐
│ Issue 기반 작업 흐름 │
├─────────────────────────────────────────────────────────────────┤
│ │
│ 사용자: "issue #42 작업해줘" │
│ │ │
│ ▼ │
│ paycheck-issue 스킬 자동 실행 │
│ │ │
│ ▼ │
│ 1) gh issue view 42 → 이슈 내용 파악 │
│ │ │
│ ▼ │
│ 2) 작업 규모 판단 │
│ │ • 전체 기능 (화면+훅+API) → paycheck-feature │
│ │ • UI만 → paycheck-component │
│ │ • 훅/API만 → paycheck-hook │
│ │ • 버그 수정 → 규모에 맞춰 라우팅 │
│ │ │
│ ▼ │
│ 3) docs/exec-plans/active/ 에 작업 계획서 자동 생성 │
│ │ │
│ ▼ │
│ 4) 적절한 에이전트 팀에 구현 위임 │
│ │ │
│ ▼ │
│ 5) 완료 후 계획서 업데이트 + 결과 보고 + PR 생성 │
│ │
└─────────────────────────────────────────────────────────────────┘
| 에이전트 | 전문 영역 | 주요 산출물 |
|---|---|---|
paycheck-ui |
UI/컴포넌트 | Screen, Component, StyleSheet, 네비게이션 연결 |
paycheck-logic |
훅/API | 커스텀 훅, API 모듈, Zustand 스토어 |
paycheck-qa |
코드 품질 검토 | RN 이슈, 타입 정합성, 재사용 기회, 네이티브 빌드 요건 |
협업 패턴:
-
paycheck-feature실행 시 UI/Logic이 병렬 작업 후 QA 리뷰 - 단일 도메인 작업은 해당 에이전트만 단독 실행
| 스킬 | 용도 | 언제 트리거 |
|---|---|---|
paycheck-issue |
메인 진입점 — Issue 읽기 → 라우팅 | "issue #숫자 작업해줘" |
paycheck-feature |
전체 기능 구현 오케스트레이터 | 화면+훅+API 통합 작업 |
paycheck-component |
단일 컴포넌트/화면 작업 | "이 컴포넌트 고쳐줘", "모달 만들어줘" |
paycheck-hook |
훅/API 작업 | "훅 만들어줘", "API 연동 추가해줘" |
paycheck-review |
코드 리뷰 / PR 전 점검 | "코드 리뷰해줘", "문제 없는지 봐줘" |
PayCheck-mobile/
├── CLAUDE.md # 매 세션 자동 주입되는 프로젝트 가이드
├── .claude/
│ ├── agents/ # 전문 에이전트 역할 정의
│ │ ├── paycheck-ui.md
│ │ ├── paycheck-logic.md
│ │ └── paycheck-qa.md
│ └── skills/ # 작업 워크플로우 정의
│ ├── paycheck-issue/ # ★ 메인 진입점
│ ├── paycheck-feature/
│ ├── paycheck-component/
│ ├── paycheck-hook/
│ └── paycheck-review/
└── docs/ # 에이전트 지식 저장소
├── FRONTEND.md # 프로젝트 코딩 컨벤션
├── DESIGN.md # 디자인 시스템
├── QUALITY_SCORE.md # 코드 품질 등급 추적
├── design-docs/
│ ├── index.md
│ └── core-beliefs.md # 프론트엔드 핵심 원칙 7가지
├── generated/
│ └── api-schema.md # API 엔드포인트 명세 (자동 생성)
├── exec-plans/
│ ├── README.md
│ └── active/ # 진행 중인 작업 계획서
├── product-specs/ # 프로덕트 명세서
└── references/ # 외부 라이브러리 레퍼런스
| 문서 | 역할 |
|---|---|
CLAUDE.md |
세션마다 자동 주입되는 짧은 가이드 — 역할·기술스택·핵심 규칙·에이전트 사용법 |
docs/FRONTEND.md |
프로젝트의 실제 코드에서 도출한 프론트엔드 컨벤션 (파일 구조, 컴포넌트 작성 패턴, 커스텀 훅 패턴, API 호출 패턴) |
docs/DESIGN.md |
디자인 시스템 (colors 토큰, Pretendard 타이포, 스페이싱, 애니메이션) |
docs/design-docs/core-beliefs.md |
판단 기준 최상위 원칙 7가지 (재사용 우선, 데이터/UI 분리, 타입 안전성, 단일 출처, 측정 기반 최적화, 접근성, 네이티브 모듈 신중 설치) |
docs/generated/api-schema.md |
백엔드 엔드포인트 자동 생성 명세 (직접 수정 금지) |
docs/QUALITY_SCORE.md |
코드 품질 등급 추적 |
-
Text는 항상components/common/Text사용 — RNText직접 사용 금지 - 색상은
src/constants/colors.ts의colors객체만 사용, 하드코딩 금지 - 새 컴포넌트 전
src/components/하위 재사용 가능한 것 먼저 확인 - 네이티브 모듈 신규 설치 시 Development Build 재빌드 필수 — 사용자에게 반드시 알림
- git commit에
Co-Authored-By: Claude라인 절대 포함 금지 - 백엔드 코드 수정 제안 금지 (프론트엔드+디자인 전담)
- #63 feat: Claude Code 하네스 엔지니어링 도입 (2026-04-04, 머지됨)