클라우드 핵심가이드 cloude code

클라우드_핵심가이드

 

 

 

 

클라우드 코드(Cloud Code) 종합 가이드

효율적인 컨텍스트 관리와 개발 생산성 극대화를 위한 에이전틱 워크플로우

☁️ 클라우드 MD와 초기 세팅

클라우드 MD는 프로젝트의 모든 컨텍스트를 담는 핵심 파일이며, 클라우드 코드는 이 파일을 읽고 플랜을 수립하거나 태스크를 수행합니다.

• 실행 위치: 반드시 프로젝트 루트 디렉토리에서 실행해야 합니다. 하위 디렉토리에서 실행 시 해당 폴더만 탐색하므로 매우 비효율적입니다.
• 생성 방법: /init 명령어로 생성하며, 프로젝트의 전체 컨텍스트를 포함합니다.
• 포함해야 할 핵심 내용:
  • 절대 규칙 (예: 프로덕션에 커밋 금지 등)
  • 아키텍처 구조 (트리 형식 작성 권장)
  • 빌드 및 테스트 명령어
  • 도메인 컨텍스트 (비즈니스 로직 예: 상품 색상, 사이즈 등)
  • 코딩 컨벤션 (예: 컴포넌트는 PascalCase, 유틸은 camelCase)
  • 핵심 패턴 (예: 서버 컴포넌트, 클라이언트 상태 관리)
• 토큰 최적화: 파일은 300자 이내 유지를 권장합니다. 프로젝트가 크다면 폴더별(API, 웹, DB 등)로 분리하여 토큰 소모와 컨텍스트 윈도우를 최적화하세요.
• 유지보수 및 협업: 직접 수정할 필요 없이 명령어로 업데이트가 가능하며, 팀 단위 작업 시 공유하여 동일한 규칙을 유지(컴파운드 엔지니어링)할 수 있습니다.
• 트리거 키워드: 복수의 명령어를 한 커맨드로 묶어 실행할 수 있습니다. (예: "배포" 키워드 입력 ➔ 테스트 실행 ➔ 실패 시 중단 / 성공 시 커밋 ➔ 푸시 ➔ 결과 출력)

클라우드 MD 프로젝트 루트 트리거 키워드 토큰 최적화 팀 공유

⌨️ 단축키 및 내비게이션

핵심 시스템 단축키

• Shift + Tab (플랜 모드 전환):
  • 플랜 모드: 쓰기 권한 없이 계획만 수립하여 불필요한 코드 생성을 막고 토큰을 아낍니다.
  • 엑셉트 모드: 플랜 검토 후 실행하며, 실제 파일 생성 및 수정이 가능합니다.
• ESC: 현재 작업 중단 (인터럽트)
• ESC 두 번: 이전 프롬프트로 되돌아가기 (리와인드 기능)

터미널 및 UI 활용

• UI 작업: 스크린샷 및 드래그 앤 드롭을 활용해 이미지로 UI/아키텍처 다이어그램을 전달하면 효율적입니다.
• 터미널 분할 및 이동: Cmd + D(세로 분할), Cmd + Shift + D(가로 분할), Cmd + 좌/우 방향키(탭 전환)
• Bash 명령어 실행: 클라우드 터미널 내에서 !(느낌표) 접두어를 붙여 즉시 실행 가능 (예: !git status, !npm run build)

플랜 모드 ESC 스크린샷 터미널 단축키 bash 커맨드

📂 필수 슬래시 명령어 및 모델 관리

슬래시 명령어 요약

명령어	기능 설명
/clear	전체 컨텍스트 및 대화 히스토리 초기화
/compact	컨텍스트는 압축(요약)하고 히스토리는 유지
/context	현재 컨텍스트 토큰량 확인
/model	사용 중인 AI 모델 정보 확인
/re	종료된 세션으로 복귀 (터미널 밖에서는 cloud --re 사용)
/mcp	연결된 MCP 서버 목록 및 상태 확인
/help	클라우드 코드 명령어 및 도움말 조회
/config	설정 값 확인 및 변경
/export	현재 세션 컨텍스트를 다른 세션으로 내보내기
/output_style	출력 스타일 변경 (예: 설명, 경고, 코딩 학습 모드)

주요 AI 모델 라인업

• 오프스 4.6: 가장 똑똑하지만 토큰 소모가 큼 (복잡한 아키텍처 및 문제 해결에 적합)
• 소넷: 중간 수준의 성능, 병렬 작업 시 토큰 절약용으로 적합
• 하이쿠: 가장 빠르고 토큰 소모가 적음 (단순 탐색 및 반복 작업용)

⚠️ MCP 사용 주의사항: MCP 서버 연결 시 도구 설명(Description)이 항상 컨텍스트를 차지하여 토큰 소모가 증가합니다. 거대한 MCP 보다는 필요한 기능만 포함한 커스텀 MCP 사용을 권장합니다.

슬래시 명령어 모델 종류 MCP 서버 컨텍스트 관리 토큰 절약

🛠️ 커스텀 슬래시 명령어 및 트리거 키워드

• 커스텀 명령어 생성: /commands 폴더 내에 .md 파일로 명령어를 정의하여 나만의 자동화 플로우를 구축할 수 있습니다. (예: "테스트 실행 후 커밋 푸시" 자동화)
• 장점: 슬래시 커맨드 형태로 자동 완성 및 인식을 지원하므로 구조적으로 안전하며 생산성이 향상됩니다. 반복 작업을 팀과 공유하기 좋습니다.
• 트리거 키워드와의 차이점:
  • 트리거 키워드: 단순 텍스트/키워드 감지 후 동작 실행
  • 슬래시 명령어: 명확한 구조 정의와 IDE 차원의 자동 완성 지원

커스텀 명령어 슬래시 커맨드 자동화 트리거 키워드

⚙️ 세컨드 브레인과 컨텍스트 관리 전략

• 세컨드 브레인: 프로젝트의 중요한 의사결정, 개발 패턴, 인사이트를 로컬 마크다운 파일로 누적 관리하는 전략입니다.
• 자동 메모리 기능 (/memory): 작업 중 학습한 내용을 AI가 자동 저장하고, 새 세션 시작 시 자동으로 로드하여 효율성을 높입니다.
• 핵심 격리 전략:
  • 클라우드 MD는 최소한의 요약만 담고 상세 내용은 별도 파일로 분리합니다.
  • 한 세션에는 하나의 기능만 구현하여 작업 단위를 세분화하세요. (예: 로그인 기능 개발과 결제 웹훅 처리는 별도 세션으로 분리)
  • 플랜 모드에서 설계를 마친 후, 새 세션을 열어 구현 및 테스트를 진행하면 컨텍스트 오염을 완전히 막을 수 있습니다.

세컨드 브레인 slash memory 컨텍스트 윈도우 작업 단위 세분화

🤖 스킬 (Skills)

스킬은 AI에게 부여하는 재사용 가능한 업무 매뉴얼(작업 절차, 형식, 체크리스트 등)입니다.

• 프롬프트와의 차이: 매번 새로 입력해야 하고 결과 편차가 큰 일반 프롬프트와 달리, 스킬은 일관된 결과 보장 및 자동 트리거가 가능합니다.
• 컨텍스트 최적화: 평소에는 스킬의 이름과 설명(Description)만 컨텍스트를 차지하다가, 호출되는 순간에만 전체 본문 프롬프트가 로딩되므로 토큰 소모를 최소화합니다.
• 구성 방법: skill.md 파일 내에 이름과 디스크립션을 정의합니다. 직접 작성하기보다는 내장된 스킬 크리에이터 플러그인 활용을 권장합니다.
• 디스크립션 작성 팁: 핵심 기능을 첫 문장에 명시하고, 사용자가 부를 만한 표현을 3개 이상 포함하세요. (예: "PPT 만들어 줘", "발표자료 생성", "슬라이드 제작")

스킬 업무 매뉴얼 컨텍스트 최적화 재사용성 자동 트리거

🤝 서브 에이전트 및 에이전트 팀

서브 에이전트 (Sub Agents)

메인 세션과 분리된 독립된 작업 공간과 독자적 권한을 가진 에이전트입니다.

• 장점: 여러 작업을 동시 실행하는 병렬 처리가 가능하며, 메인 컨텍스트 오염을 방지(격리)합니다.
• 기본 제공 에이전트: 익스플로 에이전트(코드 탐색-하이쿠), 플랜 에이전트(계획 수립), 배쉬 에이전트(터미널 명령 실행)
• 주의사항: 독립된 작업에 적합하며, 상호 의존성이 높은 작업을 동시에 병렬 처리하는 것은 지양해야 합니다. 또한 에이전트 간 직접 통신은 불가능합니다.

에이전트 팀 (Agent Teams)

• 협업 구조: 리더 에이전트가 전체 작업을 조율하고 팀원 에이전트에게 분배하는 방식입니다.
• 차이점: 메인 세션하고만 소통할 수 있는 서브 에이전트와 달리, 팀원 에이전트끼리 직접 메시지를 주고받으며 실제 개발팀처럼 협업합니다.

서브 에이전트 병렬 처리 컨텍스트 격리 에이전트 팀 협업

🪝 훅스 (Hooks)

이벤트 발생 시 지정된 액션(파일 저장, 도구 호출, 알림 등)을 유기적으로 실행하는 클라우드 코드의 자동화 엔진입니다.

• 프리유즈 (Pre-use): 도구 실행 직전 단계로, 동작을 검증·승인하거나 수정할 수 있습니다.
• 포스트유즈 (Post-use): 도구 실행 직후 단계로, 린트(Lint)나 포맷팅 등 후처리를 자동 실행합니다.
• 노티피케이션 (Notification): 긴 응답이나 대기가 필요할 때 macOS 알림이나 슬랙(Slack) 연동으로 알림을 보냅니다.
• 스톱 (Stop): 에이전트 턴이 완전히 종료되었을 때 최종 정리 및 요약 보고서를 생성합니다.

💡 실행 팁: 훅이 실행되는 동안 클라우드는 동작을 멈추고 기다리므로 타임아웃 설정이 필수적입니다. 무거운 작업은 백그라운드 처리를 권장합니다.

훅 이벤트 기반 자동화 알림 프리유즈 포스트유즈

🚀 고급 팁 및 생산성 극대화

• 멀티 인스턴스 운영: 터미널 탭을 여러 개 열어 독립적인 작업을 동시에 병행합니다. 탭 이름과 색상을 다르게 지정하면 시각적 구분이 쉽습니다.
• 깃 워크트리(Git Worktree) 활용: 브랜치를 전환(Checkout)할 필요 없이 브랜치별로 독립된 작업 디렉토리를 생성하여 다중 브랜치 작업을 동시에 수행합니다.
• 음성 입력 기능 (voice): 한국어를 포함한 20개 이상의 언어를 지원합니다. 말로 녹음하면 텍스트로 깔끔하게 변환되므로 길고 복잡한 피드백을 전달할 때 유용합니다.
• 커스텀 MCP 서버 구축: 필요한 도구 기능만 콤팩트하게 래핑하여 토큰을 절감하고 응답 품질을 향상시킵니다.
• 시간 기반 자동화 (/slue): 일정 시간마다 배포 상태를 확인하는 등의 정기적인 모니터링 작업을 자동화할 수 있습니다.

멀티 인스턴스 음성 입력 커스텀 MCP 시간 기반 자동화 병렬 작업

📋 핵심 워크플로우 요약

단계	진행 내용	키포인트
1단계	플랜 모드에서 전체 작업 설계 및 단계 분할	Shift + Tab으로 플랜 모드 필수 진입
2단계	새 세션 생성 혹은 /clear 명령어로 히스토리 초기화	한 세션에 단 하나의 기능 구현 권장 (토큰 절약)
3단계	첫 번째 단계 구현 및 TDD 진행	테스트 작성 및 실행을 통한 안정적인 개발
4단계	서브 에이전트를 활용한 작업 처리	독립 작업은 병렬로 속도 업, 의존 작업은 순차 처리
5단계	검증 완료 후 다음 단계 세션 진행	컨텍스트 오염을 막고 초기 상태에서 다음 스텝 착수

 

222222