유레카엔터프라이즈
유레카엔터프라이즈

AI-Based Workflow

반복적인 워크플로우는 AI를 고도화하여 병렬 처리하며, 핵심 로직만 코어 개발자가 직접 참여하여 완성도를 높입니다.

Architecture & Guidelines

아키텍처 & 가이드라인

CLAUDE.md에 프로젝트의 핵심 스펙을 정의합니다.

  • •Tailwind 디자인 시스템
  • •shadcn/ui 컴포넌트 셋
  • •REST API 명세
  • •내부 라이브러리 문서

Persistent Memory로 세션 간 인사이트를 유지하고, 설정은 Enterprise → Personal → Project 우선순위로 병합됩니다.

CLAUDE.mdTailwind based Design Systemshadcn/ui Component SetREST API SpecificationInternal Library DocsPersistent MemoryAgent Memory.claude/agents/*.md.mcp.json
Agent & Prompt Modules

에이전트 & 프롬프트 모듈

PRD → TRD → Specification 3단계 프롬프트 체인으로 요구사항을 정제합니다.

Skills와 Custom Agents로 재사용 워크플로우를 구축하고, 아래 인프라로 자동화와 외부 연동을 처리합니다.

  • •Hooks: 자동화 규칙 적용
  • •MCP: Figma · GitHub · Supabase 연결
  • •Internal Plugins: 팀 전체에 패키징 배포
Skills
PRD → TRD → Spec요구사항 3단계 정제 프롬프트 체인
Skills (SKILL.md)재사용 워크플로우 정의 및 /command 호출
Session History에이전트 세션 컨텍스트 누적 관리
context: fork독립 서브에이전트 컨텍스트에서 실행
$ARGUMENTS동적 인자 치환 및 셸 커맨드 삽입
SubAgents (Built-in)
ExploreHaiku · Read-only · 코드베이스 탐색
PlanInherit · Read-only · 계획 수립 리서치
General-purposeInherit · All tools · 복합 멀티스텝
Custom Agents도메인 특화 에이전트 (.md 정의)
Infrastructure
Custom HooksPreToolUse · PostToolUse · Stop 자동화 트리거
MCP ToolsFigma · GitHub · Supabase 등 외부 연동
Internal PluginsSkills + Agents + Hooks 사내 패키징 배포
LSP ServersTypeScript · Python 실시간 코드 인텔리전스
Parallel Execution

병렬 에이전트 실행

목적에 따라 두 가지 실행 모델을 조합합니다.

  • •SubAgent: 결과만 반환하는 경량 위임
  • •Agent Teams: 에이전트 간 협업이 필요한 복합 작업

각 에이전트는 독립된 컨텍스트 윈도우에서 작업하며, 공유 Task List와 메시징으로 자기 조율합니다.

SubAgents vs Agent Teams
SubAgentsAgent Teams
컨텍스트독립 윈도우 → 결과만 반환독립 윈도우 · 완전 독립 운영
통신메인 에이전트에만 보고팀원 간 직접 메시지 교환
조율메인 에이전트가 관리공유 Task List로 자기 조율
적합 작업결과만 필요한 집중 작업토론·협업이 필요한 복합 작업
토큰 비용낮음 (결과 요약 반환)높음 (인스턴스별 컨텍스트)
Agent Team Architecture
Team Lead팀 생성 · 작업 분배 · 결과 종합
Teammates독립 컨텍스트 · 할당 작업 수행
Shared Task List상태 관리 · 의존성 추적 · 자동 언블록
MessagingDM · Broadcast · Shutdown Request
Verification

자동 검증

Hook 라이프사이클의 각 단계에서 자동 검증을 수행합니다.

  • •SessionStart: 디자인 시스템 컨텍스트 재주입
  • •PreToolUse: 보호 파일 차단, 위험 명령 검증
  • •PostToolUse: Prettier · ESLint 자동 실행
  • •Stop: Spec 기준 완료 조건 검증
Hook Event Lifecycle
01
SessionStart세션 시작 · 재개 · 컴팩션디자인 시스템 · API 스펙 컨텍스트 재주입
02
UserPromptSubmit프롬프트 제출 시PRD/TRD 기반 입력 검증
03
PreToolUse도구 실행 전보호 파일 차단, 위험 명령 검증
04
PostToolUse도구 실행 후Prettier 포맷팅, 린트 자동 실행
05
Stop응답 완료 시Spec 기준 완료 조건 검증
06
SubagentStop서브에이전트 종료결과 로깅 및 세션 히스토리 저장
Hook Types
type: "command"

셸 명령 실행

exit 0 허용 · exit 2 차단 · JSON 구조화 응답

type: "prompt"

단일 LLM 판단

Haiku 기본 · ok: true/false · reason 피드백

type: "agent"

다단계 검증

파일 읽기 + 테스트 실행 · 최대 50턴 · 60초 타임아웃

PR Review & Auto Loop

PR 리뷰 & 자동 루프

PR 생성 시 아래 항목을 자동 검사합니다.

  • •코드 품질 및 가독성
  • •내부 아키텍처 컨벤션 준수
  • •보안 취약점 탐지
  • •테스트 커버리지 검증

Spec 기준으로 완료 조건을 검증하고, Review → Feedback → Fix → Re-verify 루프를 반복하여 Merge 승인까지 자동화합니다.

PR Auto Review
Code Quality: 코드 품질 및 가독성 검사
Architecture Compliance: 내부 컨벤션 준수 확인
Security Scan: OWASP Top 10 기반 보안 탐지
Test Coverage: 테스트 커버리지 검증
Auto Feedback Loop
Stop Hook → Spec 기준 완료 조건 검증
Review → Feedback 자동 생성
Fix → Re-verify → Approve 반복 루프
TaskCompleted → Merge 승인 게이트
Human in the Loop

최종 검토

Permission Mode로 에이전트 자율성을 단계별로 조절합니다.

  • •Plan Mode: 구현 전 계획을 승인
  • •Delegate Mode: 팀 리드를 코디네이션에 한정

AI가 생성한 결과물을 사람이 최종 검토하고 승인하여 품질을 보장합니다.

Permission Modes
default표준 권한 확인 프롬프트제어 높음
plan읽기 전용 탐색 (구현 전 계획 승인)제어 높음
acceptEdits파일 편집 자동 승인제어 중간
delegate팀 리드를 코디네이션에 한정제어 중간
dontAsk명시적 허용 도구만 실행 · 나머지 자동 거부제어 높음
bypassPermissions모든 권한 체크 스킵 (주의 필요)제어 낮음