그림은 결론 문장이 제목이고, 상자는 15개를 넘지 않으며, 색과 선의 뜻은 바뀌지 않는다

01작도 규칙 8

1. 제목은 결론 문장 — 15단어 이내로 "이 그림이 증명하는 한 문장".
2. 한 그림 한 메시지 — 두 가지를 말하려면 두 장.
3. 한 그림 한 추상화 수준 — 레벨 0(전체 그림) / 1(한 상자의 내부). 레벨 1은 "레벨 0의 ○○ 상자를 확대"를 적는다.
4. 선의 의미 고정 — 실선 = 확정 · 점선 = 미확정(결정 대기). 화살표 = 파일·데이터가 흐르는 방향.
5. 색의 의미 고정 (이 프로젝트 전체에서 재정의 금지)
6. 파랑 = 우리가 만드는 것(시스템이 하는 일)
7. 회색 흰 바탕 점선 = 바깥(고객, 고객 서류, 외부 서비스)
8. 금색 = 사람이 확인·결정·관리하는 것
9. 초록 = 기록·감사(페르소나, 기록 페이지)
10. 빨강 = 위험·검산·안전 경계
11. 범례·출처·버전·확인 상태를 하단에 작은 글씨로.
12. 밀도 상한 상자 10~15 — 넘으면 레벨을 나눈다. 지시자 요청으로 이 프로젝트는 7개 안팎을 목표로 한다("중학생도 이해할 수 있게").
13. 범례 대신 직접 라벨 — 선·상자 위에 바로 쓴다.

02이 프로젝트에 더한 것

• 입력이 맨 위, 출력이 맨 아래. 위에서 아래로 읽는다(지시자 지시, 2026-09-02).
• 쉬운 말. 원장 → 서랍, 오케스트레이터 → 비서, 승인 → "할까요?" 식으로 일상어를 먼저 쓰고, 기술어는 괄호로.

03구현 규칙

• 순수 SVG를 코드(gen_kpf_diagrams.py)로 좌표 지정해 만든다. mermaid 같은 자동 배치 도구는 쓰지 않는다.
• viewBox는 작게, width/height는 2배. 글꼴 Malgun Gothic.
• 파일명 이름_v0.1.svg. 고치면 버전을 올리고 구버전은 남긴다.

04문서 규율

• 문서가 원본, 화면은 산출물. docs/*.md를 고치고 build_docs.py를 돌린다. public/을 직접 고치지 않는다.
• 그림 → 확인 → 기록 → 코드. 중요한 구조 변화는 그림을 먼저 그려 지시자 확인을 받고, 확인된 것만 개발 이력에 적고, 그다음 코드.
• 발견 → 확인 → 조치. 발견은 근거(파일:행, 쪽 번호, 로그)를 대야 기록된다. 처리는 반영 / 반려 / 질의 전환 / 보류 중 하나로 명시.
• 정책 공백은 코드가 아니라 질의로. 판단이 필요한 것은 Q-번호로 지시자에게 묻고 답을 장부(question)에 남긴다.
• 모델 배정. 설계·구상·지시 = Fable 5.1, 복잡한 구현 = Opus, 단순 코딩 = Sonnet, 대량 저비용 = Haiku.
• 고객 서류는 저장소에 넣지 않는다. 샘플/은 .gitignore.