gc/snp-connection-monitoring
6
1
포크 0
generated from gc/template-java-maven
코드 이슈 1 풀 리퀘스트 Actions 위키 활동
38d7ac5642
snp-connection-monitoring/.claude/rules/subagent-policy.md
HYOJIN 38d7ac5642 feat: 프론트엔드 통합 프로젝트 초기 구조 구성 
- Spring Boot 3.2.1 백엔드 (com.gcsc.connection, 포트 8042, context /snp-connection)
- React 19 + TypeScript + Vite 7 + Tailwind CSS 4 프론트엔드
- frontend-maven-plugin 통합 빌드 설정
- 팀 워크플로우 v1.6.1 동기화

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-07 10:56:10 +09:00

2.2 KiB
Raw Blame 히스토리

서브에이전트 활용 정책

커스텀 에이전트(.claude/agents/)를 활용하여 컨텍스트를 보호하고 병렬 작업을 수행한다. 메인 세션은 리더 역할(설계, 조율, 최종 판단)에 집중하고, 실제 작업은 서브에이전트에 위임한다.

에이전트 구성

에이전트 역할 자율성 모델
explorer 코드베이스 탐색/분석 (읽기 전용) 높음 sonnet
implementer 모듈 단위 코드 구현 중간 sonnet
reviewer 코드 리뷰/품질 검증 (읽기 전용) 높음 sonnet

사용 시점

explorer

  • 3개 이상의 파일/디렉토리를 탐색해야 할 때
  • 프로젝트 구조나 패턴을 파악할 때
  • 의존성 체인, 임포트 관계를 추적할 때

implementer

  • 독립 모듈/컴포넌트를 구현할 때
  • 여러 모듈을 병렬로 구현할 때 (각각 별도 implementer)
  • 반복 패턴을 여러 파일에 적용할 때

reviewer

  • 구현 완료 후 커밋 전 검증
  • MR 생성 전 자체 리뷰
  • 변경 범위가 클 때 (5개 이상 파일)

사용하지 않는 경우

  • 단일 파일의 간단한 수정
  • 위치를 이미 아는 코드 수정
  • 설정 파일 변경

메인 세션 작업 흐름

단일 모듈

  1. 메인: 계약(인터페이스, 타입) 설계
  2. implementer: 계약 기반 구현 + 자체 검증
  3. reviewer: 변경 파일 리뷰
  4. 메인: 결과 확인 → 커밋

다중 모듈 (병렬)

  1. 메인: 모듈 간 공유 인터페이스 확정
  2. implementer A + B: 각 모듈 동시 구현
  3. 메인: 통합 확인 (인터페이스 일치)
  4. reviewer: 전체 변경 리뷰
  5. 메인: 최종 확인 → 커밋

분석

  1. explorer: 탐색 영역 + 목적 전달 → 분석 결과 반환
  2. 메인: "추정" 항목만 직접 확인 → 판단

핵심 원칙

  • 읽기 전용 에이전트(explorer/reviewer): 결과가 부정확해도 손해 없음 → 높은 자율성 부여
  • 쓰기 에이전트(implementer): 계약은 고정, 내부 구현은 자율 → 중간 자율성
  • 같은 파일을 두 에이전트가 동시에 수정하지 않는다
  • 커밋/푸시는 반드시 메인 세션에서 수행