Workflows

목표

Workflows의 개념을 이해하고, 재사용 가능한 멀티스텝 플랜을 백그라운드에서 실행하는 방법과 레시피 저장 규칙을 파악합니다.

Workflows란?

Workflows는 재사용 가능한 멀티스텝 에이전트 플랜을 백그라운드에서 실행하는 기능입니다. 각 스텝은 자체 agent 세션에서 실행되며, 사용자는 부모 대화(main conversation)를 계속 이어가면서 위임한 작업의 진행을 지켜볼 수 있습니다.

• 부모 채팅에서 작업하는 동안 위임한 작업이 백그라운드에서 진행됩니다.
• 각 스텝 세션은 실행 중 일시정지·재개·방향 조정(steer) 할 수 있고, 실행이 끝난 뒤에도 후속 질문을 위해 다시 열 수 있습니다.
• 부모 채팅 위의 Workflows 영역에서 실행 목록을 보고, 스텝 트리와 상태를 확인하며, 스텝 전용 탭을 열 수 있습니다.

🔬 활성화 필요 (opt-in)

Workflows는 기본적으로 꺼져 있습니다. 2026년 9월말 기준 Kiro IDE 1.2 및 Kiro CLI 2.26(V3) 이상에서 사용할 수 있습니다.

• IDE: Agent Focus의 Workspace Configuration에서 Workflows를 켜거나, 설정에서 kiroAgent.workflows.enabled를 활성화한 뒤 새 채팅 세션을 시작합니다.
• CLI(V3): /settings → Features → Workflows 활성화 후 Kiro CLI를 재시작합니다.

번들 레시피

Workflows는 바로 시작할 수 있는 번들 레시피를 제공합니다(가용 레시피는 클라이언트 버전·계정에 따라 다를 수 있습니다).

레시피	용도
investigate	읽기 전용(read-only) 조사
feature-pipeline	단계적 기능 전달(staged feature delivery)
publish-pr	PR 생성 및 리뷰 피드백 대응

번들 레시피는 하나의 유용한 형태를 보여주는 예시이므로, 스텝·에이전트·모델·effort·한도·핸드오프·완료 근거를 작업에 맞게 수정해 사용합니다.

레시피 저장 규칙

Workflow 레시피는 입력(inputs)과 노드 트리를 선언하는 JSON 또는 YAML 파일입니다.

.kiro/
└── workflows/
    ├── my-flow.workflow.json
    ├── my-flow.workflow.yaml
    └── my-flow.workflow.yml

• 프로젝트 레시피는 .kiro/workflows/에 위 접미사(*.workflow.json / *.workflow.yaml / *.workflow.yml) 중 하나로 저장합니다. Kiro가 런타임에 자동으로 발견합니다.
• 같은 이름(stem)에 여러 접미사가 있으면 JSON이 우선하고, 나머지는 충돌로 보고됩니다.
• 워크스페이스를 넘어 사용할 개인 레시피는 ~/.kiro/workflows/에 저장합니다.
• 레시피 이름 우선순위: project → user → synchronized account → bundled. 상위 우선순위 레시피가 유효하지 않더라도, 유효한 하위 우선순위 레시피를 가리지는 않습니다.

🔒 신뢰 워크스페이스

에이전트가 .kiro/workflows/의 레시피 파일을 변경하려 할 때 Kiro는 (더 넓은 파일 권한이 허용되어 있어도) 먼저 확인을 요청합니다. 신뢰되지 않은(untrusted) 워크스페이스에서는 레시피가 로드되지 않으며, 워크스페이스를 신뢰해야 로드됩니다.

해볼 것

1단계: Workflows 활성화

위 "활성화 필요" 안내에 따라 IDE 또는 CLI(V3)에서 Workflows를 켠 뒤 새 세션을 시작합니다.

2단계: 레시피 실행

번들 레시피로 시작하거나, 원하는 결과를 자연어로 설명해 Kiro가 Workflow를 만들도록 요청합니다.

• CLI(V3): /workflow run으로 레시피를 실행하고, /workflow 명령으로 실행을 조회·관리합니다.
• IDE: 부모 채팅 위의 Workflows 영역에서 실행을 시작하고 진행을 확인합니다.

3단계: 진행 확인과 조정

Workflows 영역에서 실행을 펼쳐 스텝 트리와 상태를 확인하고, 스텝을 선택해 전용 탭을 엽니다. 실행 중 스텝을 일시정지·재개·방향 조정할 수 있습니다.

기대 결과

• 멀티스텝 플랜이 백그라운드에서 실행되고, 부모 대화는 그대로 이어감
• 각 스텝이 자체 세션에서 실행되며 개별적으로 조회·조정 가능
• 레시피를 .kiro/workflows/에 저장해 팀과 공유하거나 재사용

Crew의 Workflows와의 차이

Crew에도 Workflows가 있지만 성격이 다릅니다. Crew의 Workflow는 여러 에이전트를 명시적 단계로 오케스트레이션하는 Python 스크립트로, 병렬 실행·출력 체이닝·결과 검증을 코드로 작성합니다. 반면 app(IDE·CLI·Web)의 Workflows는 .kiro/workflows/의 선언형 레시피(JSON/YAML) 로 harness 위에서 동작합니다.

✅ 핵심 요약

• Workflows = 재사용 멀티스텝 플랜을 백그라운드에서 실행. 각 스텝은 자체 agent 세션
• 기본 off. IDE 1.2 / CLI 2.26(V3) 이상에서 활성화
• 레시피는 .kiro/workflows/*.workflow.{json,yaml,yml} (JSON 우선)
• 번들 레시피: investigate · feature-pipeline · publish-pr
• 최신 정보: kiro.dev/docs/workflows