메인 콘텐츠로 건너뛰기
워크플로우는 복잡하거나 반복적인 작업을 Agent가 수행하도록 안내하는 일련의 단계를 정의하는 Markdown 파일입니다. 에디터에서 / 에 워크플로우 파일명을 붙여 입력하면 실행됩니다(예: /bookcover.md). 글쓰기는 단계의 연속입니다. 전체 개요를 잡고, 권별 구성으로 세분화하고, 다시 챕터별로 4〜5단계를 거쳐 품질을 높여 가는 과정은 수십 개의 단계를 올바른 순서로 실행하고 파일을 하나씩 업데이트해야 합니다. 하나라도 빠뜨리면 처음부터 다시 시작해야 합니다. 워크플로우는 이런 다단계 프로세스를 명령 하나로 만들어 줍니다. /chapteroutline.md 를 입력하면 Agent가 이야기 설정을 불러오고, 챕터 개요를 출력하고, 확인을 기다린 후 다음으로 넘어갑니다. 이후 모든 배치에서 같은 명령을 재사용할 수 있습니다. 당신은 검토하고 결정하는 일에만 집중하면 됩니다.

워크플로우 호출하기

채팅 입력창에 / 를 입력하면 SoloEnt가 사용 가능한 모든 워크플로우를 보여줍니다. 이어서 파일명을 입력하면 필터링됩니다 — /book 을 입력하면 bookcover.md 가 매칭됩니다. 워크플로우를 선택하고 Enter를 눌러 시작합니다. 채팅 입력창에 /bo를 입력하면 자동완성으로 bookcover.md 워크플로우가 표시되는 모습 Agent는 각 단계를 순서대로 실행하며, 결정이 필요할 때 일시 정지하고 기다립니다. 대화 중 언제든지 워크플로우를 중단할 수 있습니다.
새 작업을 완료한 후 Agent에게 “방금 진행한 과정을 워크플로우 파일로 정리해줘”라고 말해보세요. Agent가 대화를 분석하고 단계를 추출하여 워크플로우 파일을 생성합니다. 쌓아온 경험이 그대로 재사용 가능한 자동화가 됩니다.

워크플로우 저장 위치

워크플로우는 두 위치에 저장할 수 있습니다: 글쓰기 프로젝트 디렉토리, 또는 시스템 전역 디렉토리입니다. 전역 워크플로우는 시스템 수준 디렉토리에 저장되며 모든 프로젝트에서 호출할 수 있습니다. 표지 프롬프트 생성, 표준 원고 검토 체크리스트, 출판 준비 등 프로젝트를 가로질러 사용하는 범용 프로세스에 적합합니다. 워크스페이스 워크플로우는 프로젝트 루트의 .soloent/workflows/ 에 저장됩니다. 이 책의 챕터 개요 페이싱 로직, 이 시리즈의 특정 검토 규칙처럼 특정 프로젝트에 묶인 프로세스에 적합합니다.
your-novel/
├── .soloent/
│   └── workflows/         # 워크스페이스 워크플로우 (이 프로젝트에만 적용)
│       └── chapteroutline.md
├── SOLOENT.md
├── chapters/
└── ...
전역 워크플로우와 워크스페이스 워크플로우의 이름이 같을 경우, 워크스페이스 워크플로우가 우선합니다.

워크플로우 켜고 끄기

각 워크플로우에는 파일을 삭제하지 않고도 / 메뉴 표시를 제어하는 독립적인 토글이 있습니다. 워크플로우는 명령으로 호출하지 않는 한 자동으로 실행되지 않습니다.

워크플로우 만들기

전역 워크플로우 목록(bookcover.md, chapteroutline.md, outline.md)과 각각의 토글, 편집, 삭제 컨트롤을 보여주는 Workflows 패널
1

워크플로우 메뉴 열기

Agent 패널 왼쪽에서 네 번째 아이콘을 클릭하여 워크플로우 관리자를 엽니다.
2

새 워크플로우 파일 만들기

「New workflow file…」을 클릭하고 파일명 (예: bookcover)을 입력한 후 「+」를 클릭합니다. 파일은 .md 확장자로 생성됩니다.
3

워크플로우 단계 작성하기

Markdown 형식으로 제목과 단계를 추가합니다. 각 단계에서 무엇을 달성해야 하는지 설명하세요.

워크플로우 구조

워크플로우는 제목과 번호가 매겨진 단계를 가진 Markdown 파일입니다. 파일명이 곧 명령입니다: bookcover.md/bookcover.md 로 호출합니다. 단계는 다양한 수준의 상세도로 작성할 수 있습니다:
  • 고수준 지시: “소설 개요를 분석하여 주인공의 성격 특성 추출”——Agent가 실행 방법을 결정하게 함
  • 정밀한 제어: 구체적인 형식 요건이나 템플릿 사용——고정된 출력이 필요할 때

워크플로우에 작성할 수 있는 것

자연어 지시

일반 문장으로 단계를 작성하면 Agent가 이해하고 실행합니다:
## 단계 1: 소설 기본 정보 수집
SOLOENT.md를 읽고 추출한다: 책 제목, 주요 캐릭터, 세계관 톤, 장르.
정보가 불충분하면 작가에게 질문하고 답변을 기다린 후 계속 진행한다.

## 단계 2: 표지 방향 확인
이야기의 톤에 기반해 세 가지 표지 디자인 방향을 제안하고 작가가 선택하기를 기다린다.
이 방식은 로직은 명확하지만 실행 세부 사항에 Agent의 유연한 판단이 필요한 경우에 효과적입니다.

정밀한 템플릿 제어

고정된 출력 형식이 필요할 때는 템플릿을 워크플로우에 직접 포함합니다:
## 단계 3: 표지 프롬프트 생성

다음 템플릿을 사용하여 프롬프트를 생성하고, `***` 를 모두 구체적인 내용으로 대체한다:

```
내 소설 "***"의 표지를 생성해주세요.
크기: 600×800 px (인쇄 품질은 1800×2400 사용)

디자인 요소:
- 배경:
- 색상 팔레트:
- 이미지:

타이포그래피:
- 제목: 굵고 우아한 세리프 폰트
- 저자명: 깔끔한 산세리프 폰트

레이아웃:
[상단 20%] 여백과 분위기
[중단 40%] 제목
[하단 30%] 저자명
[하단 10%] 선택적 태그라인 (소문자)
```

워크플로우 예시

책 표지 프롬프트 생성

이 워크플로우는 표지 프롬프트를 생성하기 전에 먼저 소설을 이해합니다. 이야기의 실제 분위기와 동떨어진 표지가 만들어지지 않도록 하기 위해서입니다.
# 책 표지 프롬프트

이 소설의 표지 프롬프트를 생성한다.

## 단계 1: 소설 이해하기
SOLOENT.md를 읽어 개요와 주요 캐릭터를 파악한다. SOLOENT.md가 없거나 완전한 작품 정보가 없다면 작가에게 다음을 확인한다:
- 책 제목과 저자명
- 장르와 톤 (밝음 / 어두움 / 판타지 / 현실주의…)
- 주요 이미지나 상징적인 장면

## 단계 2: 표지 프롬프트 생성하기

다음 템플릿을 사용하여 모든 `***` 를 구체적인 내용으로 대체한다:

내 소설 "***"의 표지를 생성해주세요.
크기: 600×800 px (인쇄 품질은 1800×2400 사용)

디자인 요소:
- 배경:
- 색상 팔레트:
- 이미지:

타이포그래피:
- 제목: 굵고 우아한 세리프 폰트, 가벼운 텍스처
- 저자명: 깔끔한 산세리프 폰트
- 선택적 태그라인: ""

레이아웃:
[상단 20%] 오로라 효과가 있는 여백
[중단 40%] 제목
[하단 30%] 저자명
[하단 10%] 선택적 태그라인 (소문자)

배치 챕터 개요 생성

이 워크플로우는 장편 소설의 챕터 개요를 관리 가능한 배치로 나눕니다. 한 번에 검토할 수 있는 양 이상을 받지 않도록, 각 배치를 확인한 후 다음으로 넘어갑니다.
# 배치 챕터 개요 생성

한 번에 5챕터의 상세 개요를 생성하고, 각 배치를 확인한 후 계속 진행한다.

**챕터당 목표 분량: 2,000〜3,000자**

## 단계 1: 이번 배치 제안하기

SOLOENT.md의 이야기 개요를 읽고 이번 배치의 챕터 범위를 제안한다 (X챕터부터 Y챕터까지):
- 이번 배치가 다루는 챕터 번호를 명시한다
- 이야기 구조에서 페이싱을 참고한다 (예: 큰 장면 전에 2챕터의 긴장감 필요)
- 각 챕터에 한 문장 요약을 제공한다

**작가가 요약을 확인할 때까지 기다리고, 확인 후 다음 단계로 진행한다.**

## 단계 2: 각 챕터 개요 상세화하기

이번 배치의 각 챕터에 대해 다음 형식으로 완전한 개요를 출력한다:

```markdown
## X챕터: [제목]

**요약**: [한 문장]

**장면 구성**:
- 장면 1: [무슨 일이 일어나는지] + [글쓰기 가이던스: 감정적 톤, 세부 사항 요건]
- 장면 2: [무슨 일이 일어나는지] + [글쓰기 가이던스: 감정적 톤, 세부 사항 요건]

**복선과 실마리**:
- 심기: [새 복선] (Y챕터에서 회수 예정)
- 전개: [진행 중인 기존 실마리]
- 회수: [복선 회수] (Z챕터 콜백)

**엔딩 훅**: [독자를 다음 챕터로 끌어당기는 클리프행어 또는 질문]
```

**작가가 이 배치를 확인할 때까지 기다리고, 확인 후 다음 단계로 진행한다.**

## 단계 3: 설정 검토 및 조정하기

배치를 완료한 후 실행한다:

- **파워 시스템 확인**: 현재 설정이 이 권의 주요 장면을 지원할 수 있는가? 지원하지 못한다면 조정 방안을 제안한다
- **캐릭터 확인**: 이 권에 새로운 조연이 필요한가? 주인공에게 의미 있는 성장이 있는가?

**작가의 확인을 기다린 후, 다음 배치의 단계 1로 돌아가거나 이 권의 개요를 마무리한다.**

효과적인 워크플로우 작성법

  • 먼저 단순하게 작성한다. 처음에는 자연어로 단계를 작성하고, 고정된 출력 형식이 필요할 때만 정밀한 템플릿을 추가한다.
  • 결정 포인트를 명확히 한다. 당신의 선택이 필요한 단계는 명확하게 명시한다: “작가가 확인할 때까지 기다린 후 계속 진행한다.”
  • 실패 처리를 명시한다. 무언가 빠진 경우 Agent가 해야 할 일을 알려준다: “정보가 불충분하면 작가에게 질문하고, 추측하지 않는다.”
  • 집중력을 유지한다. bookcover.md 는 표지만 담당하고, chapteroutline.md 는 챕터 개요만 담당한다. 복잡한 프로세스는 독립적으로 실행할 수 있는 여러 워크플로우로 분리한다.
워크플로우는 당신의 권한으로 실행되며 프로젝트 파일을 읽고 수정할 수 있습니다. 외부 소스의 워크플로우는 실행 전에 내용을 검토하세요.

워크플로우 vs. 명령어

내장 명령어 (/review, /marketing)는 SoloEnt가 기본으로 제공하는 워크플로우로, 글쓰기 전문가가 설계했으며 별도 설정 없이 바로 사용할 수 있습니다. 워크플로우는 직접 정의하는 것으로, 자신의 프로젝트와 프로세스에 맞게 완전히 커스터마이징할 수 있습니다. 두 가지는 서로 보완합니다: 표준화된 품질 검사에는 내장 명령어를, 자신만의 글쓰기 프로세스를 자동화하는 데는 커스텀 워크플로우를 사용하세요.

문제 해결

다음을 확인하세요:
  • 워크플로우는 Workflows 패널에서 켜져 있어야 합니다——꺼진 워크플로우는 메뉴에 표시되지 않습니다
  • 파일은 .md 확장자를 가져야 하며 전역 워크플로우 디렉토리 또는 프로젝트의 .soloent/workflows/ 폴더에 위치해야 합니다
  • 방금 파일을 만들었다면 패널을 닫고 다시 열어 목록을 새로 고침해보세요
Agent는 명시적으로 대기하라는 지시가 없으면 자동으로 진행합니다.
  • 모든 결정 포인트에 명확한 일시 정지 지침을 추가하세요: “작가가 확인할 때까지 기다린 후 계속 진행한다”
  • 단계를 연속된 블록으로 작성하는 것을 피하세요——개별 번호 섹션으로 분리하여 Agent가 각 섹션을 별도의 단계로 처리하도록 하세요
  • 단계가 완전히 건너뛰어진다면, 해당 지침이 도달 가능한지 확인하세요 (Agent가 예시로 읽어버린 템플릿 블록 안에 묻혀있지 않은지)
가장 가능성 높은 원인: 워크플로우의 파일 경로가 실제 프로젝트 구조와 일치하지 않습니다.
  • 프로젝트 루트로부터의 상대 경로를 사용하세요 (예: SOLOENT.md, chapters/ch-01.md)
  • 워크플로우가 SOLOENT.md를 읽으려 하는데 파일이 없다면 Agent가 자동으로 실패할 수 있습니다——폴백 지침을 추가하세요: “SOLOENT.md가 없으면 작가에게 필요한 정보를 물어봐라”
  • 워크스페이스 워크플로우는 열려 있는 프로젝트 폴더 컨텍스트에서 실행됩니다——명령어를 호출할 때 올바른 프로젝트가 열려 있는지 확인하세요
워크스페이스 워크플로우가 우선하지만 이름이 정확히 일치해야 합니다.
  • 파일 이름(확장자 포함)이 완전히 동일한지 확인하세요: chapteroutline.md vs chapteroutline.md
  • 이름이 한 글자라도 다르면 두 워크플로우가 독립적으로 공존하며 어느 것도 다른 것을 덮어쓰지 않습니다
  • 워크스페이스 워크플로우가 프로젝트 루트의 .soloent/workflows/에 저장되어 있는지 확인하세요 (하위 디렉토리가 아닌)
워크플로우는 전체 권한으로 실행되며 프로젝트의 모든 파일을 읽고 수정할 수 있습니다.
  • 실행 전에 워크플로우의 단계를 검토하세요, 특히 외부 소스에서 가져온 것은
  • 예상치 못한 파일이 수정되었다면 “모든 챕터 파일 업데이트”와 같은 광범위한 지침이 있는지 확인하세요——범위를 명확하게 지정하세요
  • 출력 파일을 쓰는 워크플로우는 Agent가 스스로 위치를 선택하지 않도록 단계에 정확한 대상 경로를 지정하세요

더 많은 고급 팁

명령어 (Commands)

SoloEnt 내장 /review 및 /marketing 명령어 알아보기

규칙 (Rules)

글쓰기 습관을 규칙으로 기록하고 워크플로우와 함께 활용하기