에픽

한 프로젝트에서 주제가 둘 이상 돌기 시작하면 보드가 섞입니다. 사이드바를 뜯어고치는 티켓과 결제 버그 티켓이 같은 대기 레인에 나란히 앉습니다. 어느 쪽이 어디까지 갔는지는 제목을 하나씩 읽어야 압니다.

에픽이 그 사이에 줄을 긋습니다. 티켓 머리말에 epic: 한 줄을 적으면 그 티켓이 묶음 하나에 들어가고, 보드 왼쪽에 그 묶음의 목록이 섭니다.

엔진은 이 값을 보지 않습니다. 디스패치 순서도 우선순위도 그대로입니다. 달라지는 것은 화면 셋과 묶음마다 하나씩 생기는 메모리 폴더뿐입니다.

epic: - 티켓을 번호로 묶는 한 줄

값은 번호 하나입니다.

---
ticket: 230f26c5
title: 매뉴얼 - 에픽 장
kind: work
persona: writer
epic: P273
---

deps와 달리 목록이 아닙니다. 티켓 하나는 에픽 하나에 듭니다. 여러 묶음에 걸치는 티켓이 있다면 그건 대개 티켓이 큽니다.

값은 글자 그대로 키입니다. 앱도 엔진도 이 문자열을 뜯어보지 않으니 P273과 P273-2는 서로 다른 에픽으로 섭니다. 로드맵 번호를 쓰신다면 번호 본체만 적으세요. 로드맵이 없는 프로젝트라면 묶음마다 겹치지 않는 짧은 이름이면 됩니다.

비워도 됩니다. epic:이 없는 티켓이 정상입니다. 그런 티켓은 화면에서 (에픽 없음) 한 줄로 모입니다.

티켓에 epic:을 적는 자리

발행 다이얼로그에는 이 칸이 없습니다. 티켓 파일을 직접 열어 머리말에 한 줄 적으세요.

• 큐 폴더는 화면 오른쪽 위, 프로젝트 이름 옆 회색 경로입니다. 티켓 파일은 그 아래 tickets/에 있습니다.
• 파일 이름은 티켓 상세의 frontmatter 절 맨 아래 파일 행에 그대로 적혀 있습니다.
• 진행중인 티켓은 세션이 그 파일을 쥐고 있습니다. 잠금 카드의 할당 해제를 누르고 고치세요.

한 줄을 적고 저장하면 다음에 보드를 열 때 사이드바에 그 에픽이 서 있습니다. 이미 끝난 티켓에 소급해서 붙이지는 마세요. 완료 티켓은 읽기 전용입니다.

에픽을 새로 열 때 - 제목은 README.md 첫 줄

번호는 기계가 읽고 제목은 사람이 읽습니다. 둘은 다른 파일에 삽니다.

큐 폴더 아래 epics/<번호>/README.md를 만들고 첫 줄에 제목을 적으세요. 사이드바 항목, 스윔레인 띠 머리, 에픽 화면 머리 셋 다 이 한 줄을 가져다 씁니다.

<큐 폴더>/epics/P273/README.md    첫 줄이 제목, 그 아래가 본문
<큐 폴더>/epics/P273/memory/      메모리. 세션이 만듭니다

첫 줄 뒤에 이어 쓴 본문은 에픽 화면 머리 아래에 그대로 뜹니다. 이 묶음이 무슨 일인지, 어디까지 가면 닫는지를 적어 두는 자리가 거기입니다.

안 적으면 화면이 그렇게 말합니다. 제목 자리에 제목 없음 (P273)이 서고, 에픽 화면 머리에는 README 없음 배지가, 스윔레인 띠 머리에는 경고 삼각형이 붙습니다. 조용히 번호만 띄우지 않습니다. 빠진 것은 빠졌다고 보여야 채우게 되니까요.

번호는 제목 옆에 계속 남습니다. 로드맵에 적힌 번호와 이 화면이 같은 것을 가리킨다는 사실을 확인할 단서가 그것뿐이라서요.

보드 왼쪽 사이드바 - 한 에픽만 보기

보드를 열면 툴바 아래 왼쪽에 에픽 목록이 섭니다. 줄 하나가 에픽 하나입니다. 윗줄에 번호와 제목, 아랫줄에 그 에픽의 티켓 건수가 서고 도는 세션이 있으면 진행중 n이 오른쪽에 붙습니다. (에픽 없음)은 맨 아래입니다.

줄을 누르면 주소에 ?epic=이 붙고 보드가 그 에픽만 그립니다. 새 화면이 아니라 분류 · 페르소나 · 상태와 같은 필터 하나입니다. 그래서 필터끼리 겹쳐 걸립니다. 칸반에서 걸어 두고 테이블로 넘어가도 그대로 남습니다. 풀려면 상단의 보드를 다시 누르세요.

줄 오른쪽 끝의 공책 아이콘은 그 에픽의 메모리 화면으로 갑니다(아래 §에픽 화면).

테이블 뷰에는 에픽 컬럼이 맨 오른쪽에 하나 있습니다. 헤더를 누르면 그 값으로 정렬되니, 필터를 걸지 않고 묶음별로 훑고 싶을 때 씁니다.

스윔레인 - ?lane=epic

칸반을 에픽마다 가로 띠로 가르는 모드가 있습니다. 켜는 자리는 주소입니다. 보드 주소 끝에 ?lane=epic을 붙이세요(/p/<프로젝트>/?lane=epic). 툴바에 버튼은 아직 없습니다.

열은 그대로 셋입니다. 대기 · 진행중 · 완료가 위에 한 번 서고, 그 아래로 에픽마다 띠가 하나씩 깔립니다. 띠 머리 글자는 사이드바 항목과 같고 옆에 그 띠의 건수가 붙습니다. 순서도 사이드바와 같아서 (에픽 없음)이 맨 아래입니다.

• 완료 열은 20건까지만 그리는데, 그 자르기가 띠마다 걸립니다. 첫 띠가 20건을 다 먹고 아래 띠가 비는 일은 없습니다.
• ?epic= 필터와 같이 걸면 띠가 하나만 남습니다. 서로 방해하지 않습니다.
• 테이블 뷰에는 걸리지 않습니다. 표에는 위의 에픽 컬럼이 그 일을 합니다.

기본이 꺼짐인 것은 켜 봐야 손해인 큐가 있어서입니다. epic:을 붙인 티켓이 몇 건 안 되면 거의 전부가 (에픽 없음) 띠 하나로 들어가고, 머리 한 줄만 늘어납니다. 묶음이 둘셋 서고 나서 켜 보세요.

에픽 화면 - 메모리를 읽고 지우는 자리

사이드바 줄 오른쪽의 공책 아이콘을 누르면 /p/<프로젝트>/epics/<번호>로 갑니다. 상단 탭은 늘지 않습니다. 이 화면에서도 활성 탭은 보드고, Esc를 누르면 보드로 돌아옵니다.

왼쪽은 보드와 같은 에픽 목록입니다. 오른쪽 머리에 제목과 번호, 그 옆에 보드에서 보기 버튼이 있습니다. 그 아래 한 줄이 대기 n · 진행중 n · 완료 n이고, 다시 그 아래가 README.md의 첫 줄 뒤 본문입니다.

머리 아래 메모리 절이 이 화면의 본론입니다. 파일 한 줄이 개념 하나입니다. 이름 옆 회색 글씨는 그 파일의 첫 줄이고 줄을 누르면 본문이 펼쳐집니다.

여기서 할 수 있는 것은 읽기와 지우기뿐입니다. 추가도 편집도 없습니다. 메모리를 쓰는 쪽은 세션이고 이 화면은 사람이 보는 창입니다. 페르소나 메모리 화면과 다른 자리가 여기입니다.

삭제를 누르면 지울 파일 경로를 확인창이 보여 줍니다. 되돌릴 수 없고, 다음 디스패치부터 세션이 그 개념을 못 찾습니다. 자리가 틀린 메모리를 걷어내는 데 쓰세요.

아무것도 없으면 메모리가 없습니다가 뜹니다. 그게 정상입니다. 폴더는 처음 메모리를 남기는 세션이 만듭니다.

에픽 메모리에 남기는 것 - 가르는 문장 하나

세션이 티켓을 끝낼 때 배운 것을 어디에 적을지는 문장 하나로 가릅니다.

다른 에픽의 세션이 읽어서 참이면 온톨로지나 페르소나 메모리이고, 이 에픽 안에서만 참이면 에픽 메모리입니다.

접힌 시도가 이 폴더의 단골입니다. ?group=을 먼저 써 보고 접었다면 그 사유가 여기 남습니다. 다음 세션이 같은 길로 다시 들어가지 않게 막아 주는데, 에픽이 닫히면 아무 데도 쓸모가 없는 글이라 온톨로지에 올릴 것은 아닙니다.

반대로 개념 하나를 여러 묶음이 같이 쓰면 그건 온톨로지 쪽입니다. 카드에 에픽 태그를 달지 않는 이유가 이것입니다. 태그를 달기 시작하면 같은 개념의 카드가 묶음 수만큼 생깁니다.

epic:은 세션이 뒤지는 범위를 좁히지 않습니다. 온톨로지도 페르소나 메모리도 프로젝트 문서도 여전히 전부 열려 있습니다. 좁아지는 것은 에픽 메모리 하나뿐이고, 그래서 여기 적힌 글은 이 묶음 밖으로 새지 않습니다.

큐 폴더 안의 epics/ 하나

에픽은 데이터베이스에 없습니다. 큐 폴더 안의 epics/<번호>/ 하나가 전부입니다. 그 안에 README.md와 마크다운 몇 장이 있습니다. 페르소나와 온톨로지가 이미 사는 그 층입니다.

메모리 파일 형식도 그 둘과 같습니다. 파일 하나가 개념 하나, 링크는 [[이름]] 표기입니다. memory/ 바로 아래 .md만 읽으니 하위 폴더를 만들어도 화면에는 안 뜹니다.

목록의 정본은 큐입니다. 앱은 로드맵 문서를 읽지 않고 티켓의 epic: 값을 셉니다. 그래서 그 에픽의 티켓이 전부 완료여도 사이드바에는 계속 서 있고, 티켓이 큐에서 없어져야 목록에서도 빠집니다. 폴더는 그때도 그대로 남습니다.

다음은 인증입니다.