장표 고르기

쓸 때

단계와 분기, 되돌아가는 고리가 있는 과정. 개념 사이의 인과나 의존을 화살표 하나씩 설명할 때.

피할 때

주체가 셋 이상이고 넘김이 핵심이면 swimlane, 시간 순서의 메시지면 sequence.

한도

브리프 9노드, 덱 7노드, 보고서 15노드 이하. 라벨은 이름 한 줄과 역할 한 줄.

브리프 적합덱 적합보고서 적합블로그·웹 적합

작성 규칙

• LR로 쓰면 좁은 폭(640px 아래)에서 Pele가 TB로 바꾼다. 방향을 고정하려면 지면이 autoDirection:false를 준다(print, slide 프로필).

Pele 1.6.0에서 알려진 점

• 서로 연결되지 않은 subgraph 둘은 LR이어도 세로로 쌓인다. 나란히 비교하려면 도식을 둘로 나눈다.

쓸 때

여러 주체가 한 과정을 나눠 맡을 때. 누가 어디서 넘기는지가 핵심일 때.

피할 때

주체가 하나면 flowchart.

한도

레인 4개, 노드 12개 이하.

브리프 조건부덱 적합보고서 적합블로그·웹 조건부

작성 규칙

• subgraph 하나가 레인 하나다. 레인 이름은 사람이나 역할.

Pele 1.6.0에서 알려진 점

• 328px로 줄여도 약 580px로 남는다. 블로그에서는 가로 스크롤을 감수하거나 레인을 줄인다.

쓸 때

대상이 거치는 상태와 전이 조건. 문서나 작업의 생애주기.

피할 때

상태가 아니라 행동의 순서면 flowchart.

한도

상태 8개 이하.

브리프 조건부덱 적합보고서 적합블로그·웹 조건부

작성 규칙

• direction LR을 주면 가로로 흐른다. note right of 로 규칙을 붙인다.

쓸 때

참가자 사이에 오가는 요청과 응답의 순서. 분기(alt)나 반복(loop)이 있는 상호작용.

피할 때

참가자가 6명을 넘거나 메시지가 15개를 넘으면 쪼갠다.

한도

참가자 5명, 메시지 12개 이하.

브리프 조건부덱 적합보고서 적합블로그·웹 조건부

작성 규칙

• autonumber로 번호를 붙인다. 자기 호출(A->>A)의 긴 라벨 대신 Note over A 를 쓴다.

Pele 1.6.0에서 알려진 점

• 좁은 폭에서 자기 호출 라벨이 여러 줄로 접히면 다음 메시지 라벨과 겹친다.

쓸 때

지면이나 화면, 시스템을 격자로 나눈 구조. 칸의 상대 크기가 의미일 때.

피할 때

흐름이 핵심이면 flowchart.

한도

열 4개, 블록 12개 이하.

브리프 적합덱 조건부보고서 조건부블로그·웹 조건부

작성 규칙

• columns N과 id:span으로 폭을 정한다.

쓸 때

AI 에이전트들이 일을 나눠 맡고 도구를 호출하는 구조. 9Yohan, 리그, 하네스 설명.

피할 때

도구 호출이 없는 일반 업무 흐름이면 swimlane.

한도

flow 4개, 노드 10개 이하.

브리프 조건부덱 적합보고서 적합블로그·웹 조건부

작성 규칙

• 노드 모양은 @{ shape: input | task | tool | action | refdoc }로 정한다.

Pele 1.6.0에서 알려진 점

• connector는 노드와 선으로 잇지 않고 따로 그린다. Pele 공식 예제도 같다.

쓸 때

날짜가 있는 사건을 시대나 단계로 묶어 보일 때.

피할 때

기간의 길이가 중요하면 gantt.

한도

섹션 3개, 시점 8개 이하.

브리프 적합덱 적합보고서 적합블로그·웹 적합

작성 규칙

• 시점 하나에 사건 여러 개는 : 로 잇는다.

Pele 1.6.0에서 알려진 점

• 섹션 헤더와 날짜 상자의 글자를 배경색(--pele-bg)으로 칠한다. 시리즈 색이 배경과 대비가 나야 읽힌다.

쓸 때

일정의 시작, 길이, 겹침. 마감과 이정표.

피할 때

날짜 없이 순서만 있으면 timeline이나 flowchart.

한도

작업 10개, 섹션 4개 이하.

브리프 조건부덱 조건부보고서 적합블로그·웹 조건부

작성 규칙

• dateFormat과 axisFormat을 명시한다. 상태는 done, active, crit, milestone.

쓸 때

단계별 경험의 좋고 나쁨을 1~5점으로 보일 때.

피할 때

측정값이 없는데 점수를 지어내야 하면 쓰지 않는다. 설계 의도라면 캡션에 밝힌다.

한도

섹션 4개, 단계 10개 이하.

브리프 조건부덱 적합보고서 조건부블로그·웹 조건부

작성 규칙

• 점수가 가정이면 제목이나 캡션에 '가정'이라고 쓴다.

쓸 때

버전, 브랜치, 병합의 흐름. 초안과 개정판의 갈래.

피할 때

브랜치가 없으면 timeline.

한도

브랜치 3개, 커밋 12개 이하.

브리프 피함덱 적합보고서 조건부블로그·웹 적합

작성 규칙

• 키워드는 대소문자를 지켜 gitGraph로 쓴다(gitgraph는 Mermaid도 인식하지 못한다).
• 병합이 있으면 config의 gitGraph.rotateCommitLabel: false를 준다.

Pele 1.6.0에서 알려진 점

• 45도로 돌린 커밋 라벨이 병합 곡선을 가린다.

쓸 때

화면, 명령, 이벤트, 처리기가 시간 순으로 상태를 바꾸는 설계.

피할 때

설계 문서가 아니면 sequence가 더 읽기 쉽다.

한도

타임프레임 8개 이하.

브리프 피함덱 조건부보고서 적합블로그·웹 피함

작성 규칙

• data 블록으로 명령과 이벤트의 필드를 적는다.

쓸 때

결정 대기, 진행, 완료처럼 상태별 작업 목록.

피할 때

날짜가 핵심이면 gantt.

한도

열 4개, 카드 12개 이하.

브리프 피함덱 적합보고서 조건부블로그·웹 조건부

작성 규칙

• 카드 메타는 @{ ticket, assigned, priority }.

Pele 1.6.0에서 알려진 점

• 자연 폭(약 640px)보다 좁으면 세 열을 2+1로 접는다.

쓸 때

전체 대비 부분의 비율이 메시지일 때.

피할 때

조각이 7개를 넘거나 값 차이가 작으면 xychart.

한도

조각 6개 이하, 나머지는 '기타'로 묶는다.

브리프 적합덱 적합보고서 적합블로그·웹 적합

작성 규칙

• showData로 값을 함께 보인다. 수치 출처를 캡션에 적는다.

Pele 1.6.0에서 알려진 점

• 1% 미만 조각은 퍼센트 라벨을 생략한다.

쓸 때

범주별 크기 비교나 시간에 따른 추이.

피할 때

축이 셋 이상인 프로필이면 radar.

한도

범주 12개, 계열 3개 이하.

브리프 적합덱 적합보고서 적합블로그·웹 적합

작성 규칙

• 범주가 7개를 넘거나 이름이 길면 xychart horizontal로 쓴다.
• y축 범위는 데이터 최댓값보다 조금 크게 잡고, 0부터 시작한다.

Pele 1.6.0에서 알려진 점

• 세로 막대에서 범주 라벨이 안 들어가면 하나 건너 하나씩 빼고, 뺐다는 표시가 없다.
• 좁혀도 높이가 비례해 줄지 않는다(243px 폭에서 243x300). 좁은 인쇄 칸에는 높이 한도를 따로 둔다.

쓸 때

양이 어디서 어디로 나뉘어 흐르는지. 퍼널, 예산 배분, 처리 결과의 갈래.

피할 때

단계마다 값이 없으면 flowchart.

한도

노드 12개 이하.

브리프 조건부덱 적합보고서 적합블로그·웹 조건부

작성 규칙

• 노드 이름은 ASCII만 쓴다(한글은 큰따옴표로 감싸도 Mermaid 문법상 안 된다). 한글 설명은 캡션에 둔다.
• 노드 이름에 합계를 넣지 않는다. 값은 Pele가 이름 뒤에 붙인다.

Pele 1.6.0에서 알려진 점

• 값이 아주 작은 흐름은 머리카락 굵기로 그려 다크에서 잘 안 보인다.

쓸 때

여러 기준으로 본 대상 몇 개의 프로필 비교.

피할 때

기준이 둘이면 quadrant, 하나면 xychart.

한도

축 3~8개, 곡선 4개 이하.

브리프 조건부덱 적합보고서 적합블로그·웹 조건부

작성 규칙

• max와 min을 명시하고 graticule polygon을 쓴다.

쓸 때

두 기준으로 대상을 배치하고 사분면에 이름을 붙일 때.

피할 때

위치가 근거 없는 인상이면 쓰지 않거나 캡션에 판단임을 밝힌다.

한도

점 12개 이하.

브리프 적합덱 적합보고서 적합블로그·웹 적합

작성 규칙

• 축 라벨, 사분면 라벨, 한글 점 이름은 모두 큰따옴표로 감싼다(Obsidian의 Mermaid 11.13은 따옴표 없는 한글을 거부한다).
• title은 감싸지 않는다. Pele는 quadrant 제목의 따옴표를 그대로 그린다.
• 축·사분면 라벨에 괄호와 콜론을 쓰지 않는다.

Pele 1.6.0에서 알려진 점

• 최소 폭이 약 280px이라 그보다 좁은 칸에서는 축소해 보인다(브리프 V1에서 0.62배). 정사각형 칸(V3, V4)이 낫다.

쓸 때

두세 집합의 겹침과 교집합에 무엇이 놓이는지.

피할 때

집합이 넷 이상이면 표나 quadrant.

한도

집합 3개 이하.

브리프 적합덱 적합보고서 조건부블로그·웹 적합

작성 규칙

• 교집합 라벨은 짧게 쓴다.

Pele 1.6.0에서 알려진 점

• 가운데 영역보다 긴 라벨은 원 경계 밖으로 넘친다.

쓸 때

계층이 있는 수량의 크기를 면적으로 비교할 때.

피할 때

계층이 없으면 pie나 xychart.

한도

그룹 5개, 잎 15개 이하.

브리프 조건부덱 적합보고서 적합블로그·웹 조건부

작성 규칙

• 작은 잎이 많으면 '기타'로 묶는다.

Pele 1.6.0에서 알려진 점

• 390px처럼 좁으면 면적이 작은 그룹이 이름과 자식 없이 빈 상자가 된다.
• 작은 타일 이름은 '80.…'처럼 글자 단위로 잘린다.

쓸 때

객체의 속성과 메서드, 합성과 의존 관계.

피할 때

비개발자 독자에게는 flowchart로 단순화한다.

한도

클래스 6개 이하.

브리프 피함덱 조건부보고서 적합블로그·웹 조건부

쓸 때

데이터 엔티티와 카디널리티, 키.

피할 때

속성 목록이 길면 표로 대신한다.

한도

엔티티 6개 이하.

브리프 피함덱 조건부보고서 적합블로그·웹 피함

Pele 1.6.0에서 알려진 점

• 한 엔티티에서 나가는 관계 마커가 아래쪽 가운데에 몰린다.
• 좁은 폭에서도 약 770px로 남는다.

쓸 때

요구사항과 그것을 만족하거나 검증하는 요소의 추적.

피할 때

발표용이면 표가 낫다.

한도

요구사항 5개 이하.

브리프 피함덱 피함보고서 적합블로그·웹 피함

작성 규칙

• 한글 text와 docref는 큰따옴표로 감싼다.
• type 값으로 test 같은 예약어를 쓰지 않는다.

Pele 1.6.0에서 알려진 점

• 좁은 폭에서도 약 790px로 남는다.

쓸 때

사람, 내부 시스템, 외부 시스템 사이의 관계를 한 장으로.

피할 때

구성 요소의 배치가 핵심이면 architecture.

한도

요소 8개 이하.

브리프 조건부덱 조건부보고서 적합블로그·웹 조건부

작성 규칙

• 관계 라벨이 겹치면 UpdateRelStyle(from, to, $offsetX, $offsetY)로 옮긴다.

쓸 때

서비스와 저장소, 그룹 사이의 연결 구성.

피할 때

사람과 외부 맥락이 중요하면 C4.

한도

서비스 10개 이하.

브리프 조건부덱 적합보고서 적합블로그·웹 조건부

작성 규칙

• 라벨은 모두 큰따옴표로 감싼다: service x(server)["이름"]. Obsidian의 Mermaid 11.13은 따옴표 없는 한글, 점, 하이픈을 거부한다.
• 선언 순서가 배치를 정한다. 선이 다른 노드를 관통하면 선언 순서를 바꾼다.

Pele 1.6.0에서 알려진 점

• 꺾인 선이 그룹 테두리와 겹칠 수 있다.

쓸 때

사용자가 시스템으로 이루려는 목표와 범위.

피할 때

기능 목록이면 표가 낫다.

한도

액터 3명, 유스케이스 8개 이하.

브리프 조건부덱 조건부보고서 적합블로그·웹 조건부

작성 규칙

• 액터 id는 ASCII로 두고 표시 이름을 괄호 안 큰따옴표로 준다: actor Yohan("구요한").

쓸 때

고정 길이 필드의 위치와 폭. 식별자나 코드의 자리 규칙.

피할 때

필드 길이가 가변이면 railroad.

한도

필드 12개 이하.

브리프 조건부덱 조건부보고서 조건부블로그·웹 조건부

작성 규칙

• 비트가 아니라 글자 위치를 나타내면 제목에 밝힌다.

쓸 때

표기 규칙과 문법을 EBNF로 보일 때. 링크, 파일명, 명령 형식.

피할 때

규칙이 한 줄이면 본문에 예시로 쓴다.

한도

규칙 6개 이하.

브리프 피함덱 조건부보고서 적합블로그·웹 조건부

작성 규칙

• 선택 항목은 [ ... ]로 쓴다. 한 규칙에 ?를 두 번 쓰면 EBNF 특수 시퀀스(? ... ?)가 된다.

쓸 때

폴더와 파일 구조, 경로가 있는 계층.

피할 때

계층에 크기가 있으면 treemap.

한도

줄 20개 이하.

브리프 조건부덱 적합보고서 적합블로그·웹 적합

작성 규칙

• ## 뒤에 오른쪽 주석을 단다. 폴더는 / 로 끝낸다.

쓸 때

한 주제에서 갈라지는 개념과 분류.

피할 때

가지 사이 관계가 중요하면 flowchart.

한도

1단계 9개, 전체 25개 이하.

브리프 적합덱 적합보고서 조건부블로그·웹 조건부

작성 규칙

• mindmap 안에 classDef를 쓰지 않는다(Mermaid 문법상 두 번째 루트가 된다).

Pele 1.6.0에서 알려진 점

• 자식이 없는 1단계 노드는 상자 없이 글자만 그린다. 하위 항목을 하나라도 붙이거나 모양을 명시한다.

쓸 때

한 문제의 원인을 범주별로 모을 때.

피할 때

원인 사이의 인과가 핵심이면 flowchart.

한도

범주 4~6개, 원인 15개 이하.

브리프 적합덱 적합보고서 적합블로그·웹 조건부

작성 규칙

• 첫 줄이 머리(문제), 들여쓰기 한 단계가 범주, 두 단계가 원인이다.

쓸 때

일을 clear, complicated, complex, chaotic 영역으로 나누고 이동을 보일 때.

피할 때

영역 판정 근거가 없으면 쓰지 않는다.

한도

영역당 항목 3개 이하.

브리프 조건부덱 적합보고서 적합블로그·웹 피함

작성 규칙

• 항목은 큰따옴표 문자열로 쓴다.

Pele 1.6.0에서 알려진 점

• 전이 라벨이 영역 경계 점선과 겹친다.
• 좁은 폭에서도 약 780px로 남는다.

쓸 때

가치 사슬의 구성 요소를 가시성과 진화 단계로 배치할 때.

피할 때

좌표가 근거 없는 인상이면 캡션에 판단임을 밝힌다.

한도

구성 요소 10개 이하.

브리프 조건부덱 적합보고서 적합블로그·웹 조건부

작성 규칙

• 한글이나 점(.)이 든 이름은 큰따옴표로 감싼다.
• 좌표는 [가시성, 진화] 순서다.

Pele 1.6.0에서 알려진 점

• note가 제목과 같은 굵기로 나온다.