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

지도의 세 가지 규칙

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

네 개의 섹션, 그 외에는 아무것도 없음

• Decided — 유효한 각 결정에 대해 한 줄씩 기재: 날짜, 결정한 사람, 그리고 이유. 제안은 결코 결정된 것으로 기재되지 않습니다.
• Next — 순서대로, 최대 10개까지. 각 줄에는 항목의 이름과 완성된 모습이 적혀 있습니다. 순서가 플랜이 가질 수 있는 유일한 상태입니다.
• 보류 중 — 제안된 아이디어들로, 아직 결정되지 않았으며, 각각 제안된 날짜가 표시됨.
• 사람에게 맡기기 — 오직 사람만이 내릴 수 있는 결정들로, 각각 한 줄씩, 날짜와 함께 기록됩니다.

썩지 않게 지키는 법칙

• 완료는 사라졌다는 뜻입니다. 항목을 완료한 사람은 같은 세션 안에서 그 항목을 삭제하고, 변경된 내용을 알맞은 곳에 옮겨 둡니다. 지도에는 선을, 기록에는 결정이나 측정값을, 커밋에는 코드를 넣습니다. '완료' 섹션은 존재하지 않습니다.
• 레저로 넘어갑니다. 여전히 중요한 항목은 'Next'나 'Parked'의 한 줄이 되어 레저를 떠나고, 나머지는 사라집니다.
• 한 번에 한 사람만 씁니다. 다시 쓰기 전에 계획을 먼저 읽고, 통째로 다시 써야 합니다.

my-app-plan — walked 2026-09-10 by the Tuesday session

## Decided
2026-08-14 · you · Postgres, not SQLite — two writers, one box
2026-09-02 · you · ship the importer before the dashboard — nobody can try it empty

## Next
1. Importer accepts CSV with a header row. Finished: a real customer file lands.
2. Retry the webhook on 5xx. Finished: one blip stops costing a record.
3. Dashboard: one chart, last 30 days. Finished: it answers "is it working".

## Parked
2026-08-30 · a public status page — nothing to show yet

## Open with your user
2026-09-08 · free tier: how many rows before it asks for money