지원

TaskHolder가 하는 일

TaskHolder는 마크다운 플랜을 보고 옮길 수 있는 카드로 바꿔요. AI가 쓴 플랜이든 직접 쓴 플랜이든 가져오면 Phase와 Task가 캔버스의 카드가 되고, 전체 구조는 작업 트리에 나타나요.

플랜 순서를 바꾸고, 카드를 편집하고, 진행 상태를 표시하고, 파일·링크·프롬프트를 붙일 수 있어요. 카드를 Claude Code나 다른 앱으로 끌어다 마크다운으로 넘기고, 다 끝나면 플랜을 다시 마크다운으로 내보내요. 가져오기는 원본 .md 파일을 절대 바꾸지 않아요.

선택 기능인 AI 컨트롤 타워는 어떤 Claude Code 세션이 어떤 카드를 작업 중인지 보여 줘요. 내 Mac에서만 동작하고 API 키가 필요 없어요.

설치

.dmg 파일을 다운로드 페이지에서 받아 연 다음, TaskHolder를 Applications로 끌어다 놓으세요. macOS 12 이상이면 되고, Apple Silicon과 Intel 모두 지원해요.

macOS가 앱이 "손상되었다"고 한다면: 다운로드 과정에서 서명이 깨졌다는 뜻이에요 — 대개는 다운로드가 중간에 끊긴 경우예요. 파일을 지우고 휴지통을 비운 뒤 다시 받아 보세요. 그래도 같은 메시지가 나오면 우회 방법을 찾지 마시고 연락해 주세요.

처음 14일

한 번 로그인하면 14일 동안 앱 전체를 쓸 수 있어요 — 모든 기능을, 카드 등록 없이요. 체험은 기기가 아니라 계정에 묶여 있어서, 다시 설치해도 기간이 새로 시작되지도 않고 줄어들지도 않아요.

기간이 끝나면 편집을 계속하기 위해 라이선스 구매를 요청해요. 작업물 내보내기는 언제나 열려 있어요, 체험이 끝난 뒤에도요. 파일은 당신 것이니까요.

첫 프로젝트 만들기

1. 프로젝트 만들기. ⌘N을 누르고 계획하는 일에 맞춰 Code, Video, Blog 중 하나를 골라요.

2. 플랜 가져오기. ⌘I를 누르거나 .md 파일을 캔버스에 끌어다 놓아요. 파일을 어떻게 읽었는지는 화면 아래 🧭 해석 방식에 표시돼요.

3. 다듬기. 왼쪽 작업 트리에서 순서를 바꿔요. 카드를 더블클릭하면 편집할 수 있어요.

4. 카드 넘기기. E를 눌러 내보내기 모드로 바꾸고, 카드를 골라 Claude Code나 채팅 창, 다른 앱으로 끌어다 놓아요. 마크다운으로 들어가요.

5. 저장하고 내보내기. ⌘S는 프로젝트를 .taskflow 파일로 저장해요. 파일 ▸ 내보내기에서 Markdown, JSON, YAML, 일반 텍스트로 내보낼 수 있어요.

도움말 ▸ 튜토리얼에서 이 과정을 앱 안에서 차례로 안내해요. 언제든 다시 볼 수 있어요.

구매한 뒤에는

한 번만 결제하면 영원히 쓸 수 있어요 — 구독이 아니에요. 라이선스는 계정에 들어 있어서 새 컴퓨터에서 로그인하면 그대로 복원돼요. 잃어버릴 라이선스 키도 없고 "구매 복원" 버튼을 찾아 헤맬 일도 없어요: 로그인이 곧 복원이에요.

플랜 가져오기

마크다운 파일을 캔버스에 끌어다 놓거나 ⌘I를 누르세요. 헤딩이 카드가 되고, 헤딩의 단계가 그대로 계층이 돼요. 헤딩 아래의 불릿은 그 카드 안에 글로 남아요. TaskHolder가 문서를 읽는 방식

TaskHolder는 원본 글을 프로젝트에 함께 보관해요. 원본 문서 보존을 켜면(설정 ▸ Editor, 기본값은 꺼짐) 가져온 파일을 전체 내보낼 때 편집하지 않은 부분은 서식·간격·주석까지 원래대로 유지돼요.

다듬기

작업 트리에서 끌어서 순서를 바꾸거나 다른 부모 밑으로 옮기세요. 캔버스에서는 카드를 자유롭게 배치하고, 빈 곳을 더블클릭하면 새 카드를 만들어요. 캔버스에는 맨 아래 단계 카드만 보이고, Phase 같은 부모 카드는 트리에 있어요.

⌘N

새 프로젝트

⌘O

프로젝트 열기

⌘S

저장

⌘I

마크다운 가져오기

⌘E

내보내기

⌘Z

실행 취소

캔버스 단축키는 대부분 Settings → Shortcuts에서 다시 지정할 수 있어요.

다시 일로 돌려보내기

⌘E를 누르면 기본 형식으로 내보내고, 파일 ▸ 내보내기에서 Markdown, JSON, YAML, 일반 텍스트 중에 고를 수도 있어요. 카드 몇 장만 AI에게 넘기려면 E를 누르고 카드를 골라 Claude Code나 채팅 창으로 끌어다 놓으세요.

마크다운과 .taskflow의 차이: 마크다운은 읽고 넘겨주기 위한 형식이에요. .taskflow는 카드 위치, 클립 등 모든 것을 담은 완전한 프로젝트 파일이고요. 작업을 저장할 때는 이 쪽을, 공유할 때는 마크다운을 쓰세요.

Claude Code 따라가기 (선택)

설정 ▸ AI & Agents에서 AI 모드를 켜고 Claude Code에 연결을 고르세요. 연결 창은 무엇을 쓰기 전에 어떤 설정 파일이 바뀌고 무엇이 추가되는지 먼저 보여 줘요. 연결 해제는 추가했던 것만 지워요.

카드를 Claude Code 세션으로 끌어다 놓거나, AI 패널의 Claude Code에서 시작으로 플랜 전체를 들고 세션을 시작하세요. 카드마다 그 카드를 작업 중인 세션이 표시돼요. 자동 상태를 켜 두면 Claude가 끝낸 카드는 Test로 옮겨져요. Done 표시는 언제나 직접 해요.

같은 Mac에 Claude Code 2.1.269 이상이 필요해요. API 키나 추가 비용은 없어요.

TaskHolder가 문서를 읽는 방식

TaskHolder는 파일 하나를 한 가지 방식으로 읽어요. 아래 다섯 방식을 차례로 확인해서 문서 전체에 맞는 첫 번째 방식을 써요.

키워드 구조

## Phase 1 · ### Task 1.1

번호 구조

## 1. · ### 1.1

식별자 구조

AW-03 · FR-1 · Article 1 · 제1조

체크리스트 구조

- [ ] 줄

헤딩 구조

# 개수가 단계를 정함

키워드 구조는 Phase, Step, Stage, Part, Chapter, Task, Item, Action, Todo, Subtask를 알아들어요. "Phase 1", "Task 2.3"처럼 뒤에 번호가 있어야 해요.

어떤 방식으로 읽었는지는 화면 아래 🧭 해석 방식에 나와요. 카드가 기대와 다르게 나뉘었다면 거기서 다른 방식을 고르세요. 원본 파일을 그 방식으로 다시 읽고, 가져온 뒤 편집한 내용은 사라지므로 가져온 직후에 바꾸는 것이 좋아요.

버리는 내용은 없어요. 첫 작업 앞의 제목이나 소개, 마지막 작업 뒤의 섹션도 프로젝트에 보관돼요. 일반 불릿과 굵은 글씨 라벨은 카드 안에 글로 남아요. 캔버스에는 맨 아래 단계 카드가 보이고, Phase 같은 부모 카드는 작업 트리에 있어요.

잘 읽히는 플랜 쓰는 요령

작업마다 헤딩을 따로 주세요. 예를 들어 ## Phase 1: 준비 아래에 ### Task 1.1: 설치처럼 써요. 헤딩 하나가 카드 한 장이 돼요.

키워드에는 번호를 붙이세요. "Phase 1", "Task 2.3"은 구조로 읽지만, 번호 없는 "Phase"는 구조로 보지 않아요.

파일 하나에는 한 가지 스타일만 쓰세요. 파일 전체를 한 방식으로 읽기 때문에 번호 헤딩과 키워드 헤딩을 섞으면 예상과 다른 카드가 나올 수 있어요.

세부 내용은 헤딩 아래에 쓰세요. 헤딩 아래의 불릿과 문단은 그 카드의 내용이 돼요. 목록 항목을 카드로 나누고 싶다면 설정 ▸ Editor의 카드 깊이 레벨을 바꾸세요.

ID는 헤딩에 넣으세요. Phase 아래의 ### AW-01, ### P0-1 같은 헤딩은 하위 카드가 돼요.

한국어로 쓰나요? 키워드는 영어 단어예요. ## 1., ### 1.1 같은 번호 헤딩이나 제1조 같은 문서 번호를 쓰세요.

AI에게 이 형식을 부탁하세요. 예: "플랜을 ## Phase N: 제목, ### Task N.M: 제목 헤딩으로 쓰고, 각 작업의 세부 내용은 그 헤딩 아래 불릿으로 적어 줘."