2026-10-14 inbox 검토: ADR 묶음, 대문 줄이기, IDE 플러그인과 AI 대화창
2026-10-14의 첫 세션이다 (← 2026-10-13-03-before-architecture). 메인테이너의 첫 말은 “inbox 체크해주세요.”였다. 짧은 세션이었고, 답은 거의 한 글자씩이었다.
논의 흐름
- inbox 여섯 줄. “일하는 방식” 넷(ADR 분류, README의 시안 목록, 쓰이지 않는 파일, 배포 대상 갱신)과 “기능” 둘(웹 버전의 AI 대화창, IDE 플러그인). Claude가 항목마다 사실을 확인하고 안을 붙여 한 번에 물었다. 쓰이지 않는 파일은 md가 아닌 파일 53개를 파일 이름으로 검색해 찾았다.
- “1: ok / 2: 가 / 3: 제안 수용 / 4: 6번까지 포함 / 5: 가. 브라우저 스토리지에 저장할 수 있지 않을까요? / 6: 우선순위 제안 수용, 코드가 원본, VSCode 먼저” 한 줄씩의 답으로 여섯이 정해졌다. 5번의 물음에는 “된다. 다만 같은 페이지의 다른 스크립트(광고)가 읽을 수 있다”고 답했다 → browser-storage-and-api-keys
- “지금 봐야할 두가지를 하나씩 처리합시다” Claude가 정해 놓은 것 가운데 둘을 골라 하나씩 물었다. “코드가 원본”의 풀이와 접기 영역의 이름을 두는 곳(“가”: 코드의 영역 주석), 흉상 스크립트를 지운 것(“가”: 지운 대로).
- “마무리” 아키텍처 초안의 일곱 가지 확인은 이번에도 다음으로 넘어갔다.
결정
| 무엇 | 결정 | 어디에 |
|---|---|---|
| ADR 목록 | 여섯 묶음으로 나눈다. 번호는 그대로 | index |
| 대문의 시안 목록 | README에는 프로토타입과 목록 링크만. 목록은 한 곳에 | sketchbook |
| 배포 대상 | 일곱: 웹, Obsidian, 데스크톱, Google Drive, Confluence, IDE 플러그인, Claude skill | 01-requirements |
| AI 대화창 | 웹 버전에 P3. 사용자가 자기 API 키를 넣고 브라우저에 보관 | R-WEB-07 |
| IDE 플러그인 | P2. VSCode 먼저, 그다음 IntelliJ. 양방향 실시간 반영은 P3 | 01-requirements |
| IDE 플러그인의 원본 | 코드가 원본. .ns 파일을 만들지 않는다 | 01-requirements |
| IDE 플러그인의 접기 영역 | 코드의 영역 주석(region)으로 남긴다 | R-IDE-05 |
발견한 것과 위험
- IDE 플러그인은 지금의 아키텍처 초안에 맞지 않을 수 있다. 초안은 “배포 대상마다 다른 것은 파일 입출력 하나”라고 적었는데, IDE에서는 읽고 쓰는 것이 소스 코드다. 코드와 모델을 오가는 자리가 더 필요하다. 설계하지 않았고 자리만 적어 두었다 → 7. 배포 구성, 뒤따르는 문서에 반영
- 코드와 다이어그램의 왕복이 가장 어렵다. 코드에는 NS 다이어그램에 없는 것(주석, 선언, 예외 처리,
break)이 있다. 다이어그램을 고친 뒤에도 그것들이 코드에 남아야 한다 → 6. 미결정 사항 - 브라우저에 둔 API 키는 광고 스크립트가 읽을 수 있다. AI 대화창과 광고가 한 페이지에 있으면 생기는 일이다 → 6. 미결정 사항
- 배포 대상이 일곱으로 늘었다. 처음 세 대상도 아직 코드가 없다. 늘어난 넷은 모두 “나중에”이고 MVP 범위는 그대로다.
- 실수로 올라간 파일이 있었다. 지난 세션에 Python 캐시(
__pycache__)가 커밋됐다..gitignore에 넣었다. - 고친 문서를 Obsidian 화면으로 열어 보지 못했다. 요구사항 2장의 표(같은 문서의 절을 가리키는 링크 일곱), ADR 목록의 여섯 표, sketchbook의 네 칸 표.
커밋
| 커밋 | 무엇 |
|---|---|
1a84cb9 | inbox의 원문을 지키려고 |
bc17ab4 | 쓰이지 않는 파일 여덟을 지움 |
9540a91 | inbox 여섯 항목: ADR 묶음, README, 배포 대상, IDE 플러그인, AI 대화창 |
31f15d0 | IDE 플러그인의 접기 영역은 코드의 영역 주석으로 |
ed5d59f | 흉상 스크립트는 지운 대로 |
inbox 원문 (지운 항목)
“1. 일하는 방식”에 있었다.
- ADR이 많아졌습니다. 아키텍처 결정 기록 (ADR)에서 분류해서 보여주면 좋겠습니다.
- 시안 목록을 README에 보여주는게 적절할요? sketchbook와 중복되기도 하고 README는 이 repo에 대한 소개를 하는 대문이라서 너무 상세한 정보를 전달하려다 아무것도 전달이 되지 않을까 걱정이 됩니다.
- 쓰이지 않는 파일이 있는지 체크해주세요. 예를 들어 백링크가 없는 svg나 png
- 2. 배포 대상을 갱신하세요.
“3. 기능”에 있었다.
- 웹 버전에 Claude나 ChatGPT를 쓰는 대화창을 달면 어떨까? “퀵소트를 그려주세요”라든지 “반복되는 부분을 메소드 다이어그램으로 도출해주세요” 같은 것을 할 수 있나요?
- IDE 플러그인 버전(배포 대상)도 요구사항에 추가하고 싶습니다.
- 기능
- 리버스 엔지니어링
- 코드 생성
- 양방향 실시간 반영
- 지원 IDE
- VSCode
- IntelliJ
메인테이너의 답: “1: ok / 2: 가 / 3: 제안 수용 / 4: 6번까지 포함 / 5: 가. 브라우저 스토리지에 저장할 수 있지 않을까요? / 6: 우선순위 제안 수용, 코드가 원본, VSCode 먼저”
처리
| 항목 | 한 일 | 어디에 |
|---|---|---|
| ADR 분류 | 목록을 여섯 묶음으로 나눔. 번호와 절 제목은 그대로 | index |
| README의 시안 목록 | 대문에는 프로토타입 링크와 목록 링크만. “무엇을 다루나” 설명은 목록의 칸으로 옮김 | sketchbook |
| 쓰이지 않는 파일 | 여덟을 지움: 떨어진 문자 로고 시안 SVG 다섯, 흉상 스크립트, .gitkeep, 실수로 올라간 Python 캐시. __pycache__/를 .gitignore에 | 커밋 bc17ab4 |
| 배포 대상 갱신 | 2장의 머리와 표를 일곱 대상으로 다시 씀 | 01-requirements |
| AI 대화창 | P3으로 넣음. 사용자가 자기 API 키를 넣고 브라우저에 보관 | R-WEB-07 |
| IDE 플러그인 | 2.7로 넣음. 대상 P2, 양방향 실시간 반영 P3, 코드가 원본, VSCode 먼저 | 01-requirements, ADR-0002 · ADR-0011의 이후 변경 |
처리한 부채
- “코드가 원본”의 풀이(IDE 플러그인은
.ns파일을 만들지 않고, 다이어그램은 코드에서 만들어 보여 주며, 다이어그램을 고치면 코드가 바뀐다)와 접기 영역의 이름을 두는 곳 → 정함 (2026-10-14: “가”). 코드의 영역 주석으로 둔다. 견준 안은 저장하지 않기(나), 코드 옆의 따로 된 파일(다) → R-IDE-05 -
2026-10-10-logo-trace-bust.py(흉상 사진을 따던 초기 스크립트)를 “지우거나 한 줄 적기” 가운데 지우기로 고른 것 → 확인함 (2026-10-14: “가”, 지운 대로 둠). git 기록(bc17ab4의 앞)에 있음
Claude가 정해 놓고 확인받지 못한 것은 확인해 주세요에, 뒤따르는 일은 뒤따르는 문서에 반영에 있다.
마무리 뒤에
메인테이너: “AI회사는 claude, chatgpt, grok 세가지를 염두하고 있습니다. 웹버전에 AI채팅창을 달 수 있는지 지금 확인해볼 수 있나요?” 세 회사의 API가 브라우저에서 바로 부르는 것을 받아 주는지 curl로 확인했고, 셋 다 받아 주었다. 진짜 키와 진짜 브라우저로는 해 보지 않았다 → 브라우저에서 AI 회사의 서버를 직접 부를 수 있나. 요구사항 R-WEB-07에 Grok을 더했다. Claude가 진짜 키로 해 보는 스파이크 페이지를 제안했고 답은 받지 못했다 → 정해 주세요. 메인테이너가 한 번 더 “마무리”라고 했다.
다음 할 일
- 메인테이너가 아키텍처 초안을 읽고 Claude가 정해 적은 일곱 가지를 확인한다. 하나씩, 그림이나 작은 예제로 → 8. 확인받지 못한 제안
- UI 프레임워크 결정 → 0010-ui-framework
- 상세 설계 01-model
- 프로토타입 51번째 판 써 보기, 리뷰 3판 → 리뷰 순서
- 번들할 글꼴 고르기, Firefox에서 스파이크 열어 보기 → outbox
마무리
- 메인테이너의 말: “마무리”.
- 기술 설명은 browser-storage-and-api-keys에 정리했다.