Skip to main content

워크플로 베스트 프랙티스

좋은 워크플로를 만들기 위해서는 명확한 지시, 모듈화, 도구 사용의 균형이 필요합니다. 아래 팁을 참고하세요.

Careti으로 워크플로 만들기​

Careti 프로젝트 컨텍스트를 이해하므로 워크플로 설계 파트너로 매우 유용합니다.

워크플로를 만드는 워크플로​

워크플로 작성은 생각보다 쉽습니다. 워크플로를 만들어주는 워크플로도 있습니다.

먼저 create-new-workflow.md 파일을 워크스페이스에 저장하세요(예: .agents/context/workflows/).

그다음 /create-new-workflow.md를 입력하면 Careti 다음 순서로 안내합니다:

  1. 목적과 간단한 이름을 질문
  2. 목표와 기대 결과를 설명하도록 유도
  3. 주요 단계 목록 정리
  4. 구조화된 워크플로 파일 생성
💡Tip

작업 기록을 자동화하세요: 이미 완료한 작업은 최고의 워크플로 후보입니다. 작업을 끝낸 뒤 "방금 한 과정을 워크플로로 만들어줘"라고 요청하면 Careti 대화를 분석해 워크플로 파일을 생성합니다.

워크플로는 프로젝트 전용이면 .agents/context/workflows/, 전역이면 ~/Documents/캐러티/Workflows/에 둡니다. 동일한 이름이 겹치면 프로젝트 워크플로가 우선됩니다.

워크플로 설계​

💡Tip

작게 시작하세요: 단일 작업 워크플로부터 시작하고 익숙해진 뒤 확장하세요.

모듈화​

하나의 큰 워크플로보다 작고 재사용 가능한 워크플로로 쪼개면 유지보수와 디버깅이 쉬워집니다.

명확한 코멘트​

코드처럼 워크플로도 “왜”를 설명하는 코멘트가 중요합니다. 이는 Careti 사용자 모두가 의도를 이해하는 데 도움이 됩니다.

버전 관리​

워크플로는 .agents/context/workflows/에 두고 Git에 포함시키세요. 버전 관리와 팀 공유가 수월합니다.

Careti용 프롬프트 설계​

도구 사용을 구체적으로​

"파일 찾아줘"보다는 어떤 도구를 쓰는지 명확히 지시하세요.

  • 나쁜 예: "유저 컨트롤러 찾아줘"
  • 좋은 예: "search_files로 src/controllers에서 UserController를 찾아줘"

고급 테크닉​

사용 가능한 도구​

워크플로 안에서 사용할 수 있는 대표 도구는 다음과 같습니다:

execute_command​

터미널 명령 실행(테스트, 빌드, git 등)

<execute_command>
  <command>npm run test</command>
  <requires_approval>false</requires_approval>
</execute_command>

read_file​

파일 읽기(코드/설정 분석)

<read_file>
  <path>src/config.json</path>
</read_file>

write_to_file​

파일 생성/덮어쓰기(보일러플레이트, 문서 등)

<write_to_file>
  <path>src/components/Button.tsx</path>
  <content>
    // File content goes here...
  </content>
</write_to_file>

search_files​

정규식 기반 검색

<search_files>
  <path>src</path>
  <regex>TODO</regex>
  <file_pattern>*.ts</file_pattern>
</search_files>

ask_followup_question​

사용자에게 확인/입력 요청

<ask_followup_question>
  <question>프로덕션에 배포할까요?</question>
  <options>["Yes", "No"]</options>
</ask_followup_question>

browser_action​

내장 브라우저 제어(웹 UI 테스트/스크래핑)

<browser_action>
  <action>launch</action>
  <url>http://localhost:3000</url>
</browser_action>

MCP 도구 활용​

Model Context Protocol(MCP) 도구를 워크플로에서 활용하면 GitHub/Slack/DB 등 외부 서비스를 연결할 수 있습니다.

컨텍스트 윈도우 관리​

워크플로가 너무 길거나 데이터가 많으면 컨텍스트 한계를 넘을 수 있습니다.

  • 분리: 긴 워크플로는 여러 개로 쪼개기
  • 간결함: 지시문은 핵심만 명확히 작성

더 알아보기​

캐러티 Learn

Careti 맞는 프롬프트 작성 전략과 고급 패턴을 더 깊게 학습하세요.