에이전트가 전체 시스템의 지도를 그립니다. 이후의 모든 세션이 그 지도를 불러옵니다.

지도의 세 가지 규칙

• 토폴로지는 루트에 한 번만 그립니다. 플레이트는 연결선을 다시 서술하지 않으며, 자신의 세부 사항과 절차만 담습니다. 중복은 어긋남이 시작되는 지점이므로, 구조적으로 중복이 없습니다.
• 값은 지도 어디에도 담지 않습니다. 포트, 용량, 가격, 개수 없음 — 페이지는 숫자가 어디에 있는지만 말할 뿐, 그 값이 무엇인지는 말하지 않습니다. 값을 담고 있는 지도는 일주일 안에 틀립니다.
• 연결선을 변경한 사람은 같은 세션에서 지도를 업데이트합니다. 루트에는 <what>에 대해 <date>에 검증됨이라는 한 줄이 있으며, 읽는 사람은 그 범위까지만 지도를 신뢰합니다.

루트 맵에 담기는 내용, 순서대로

• 프로젝트가 무엇인지 두 문장으로, 그리고 검증된 줄.
• 다이어그램: 상자와 화살표, 연결선마다 하나의 화살표와 그 위를 흐르는 것을 표시합니다. 방향이 페이지의 그 무엇보다 중요합니다.
• 연결선 목록: 누가 시작하는지, 무엇이 흐르는지, 무엇이 절대 흐르지 않는지. 거짓을 잡아내는 바로 이 섹션입니다.
• 저장소: 상태가 존재하는 모든 곳, 무엇을 담는지, 무엇을 절대 담지 않는지.
• 색인: 각 플레이트는 이름별로, 각 절차는 플레이트와 섹션별로.

플레이트에 담기는 것

• 해당 평면의 각 부분에 대해: 그것이 무엇인지, 무엇을 담는지, 누구와 어떤 방향으로 통신하는지, 절대 하지 않는 일은 무엇인지, 그리고 실행될 때 무슨 일이 일어나는지.
• 값이 있는 곳 — 포인터이지, 값 자체가 아닙니다.
• 절차: 정확한 명령어, 성공 여부를 확인하기 위해 읽어볼 것, 그리고 실제로 어떤 문제가 발생했는지와 그 날짜.

형태로 본 루트 맵

my-app-map — verified 2026-09-04 against commit a1b2c3d and the live containers

  browser ──(requests, session cookie)──▶ api ──(SQL)──▶ postgres
                                          │
                                          └──(jobs)──▶ worker ──(files)──▶ object store

Wires: the browser never talks to the worker; the worker never reads a cookie.
Stores: postgres (users, orders — never card numbers) · object store (uploads).
Plates: my-app-map-api · my-app-map-worker · my-app-map-data · my-app-map-ops
Procedures: deploy → my-app-map-ops, deploy · restore → my-app-map-data, restore