저는 eDEX-UI를 처음부터 다시 작성한 elecdex를 개발하고 있습니다. eDEX-UI는 SF 영화 같은 터미널 겸 시스템 모니터이며, 2021년에 아카이브되었습니다. elecdex는 그 경험을 Electron 44, Svelte 5, TypeScript 7, xterm.js 6 위에 샌드박스된 렌더러로 다시 구현한 것입니다.
Claude Code나 Codex를 사용한 코딩이 당연해지는 시대에, 저는 멀티 페인(multi-pane) 터미널인 elecxterm을 만들었습니다. 이를 만들면서 AI 기반 개발에는 좀 더 흥분되는 사용자 인터페이스가 필요하다고 느끼게 되었고, 그러던 중 GPL-3.0으로 공개된 eDEX-UI를 발견했습니다.
- 세계관은 최고입니다. 하지만 2021년 아카이브 이후 일부 포크(fork) 외에는 업데이트되지 않았으며, 아키텍처 역시 당시 그대로입니다.
nodeIntegration: true
아이들 상태에서의 CPU 소비 등, 그대로 일상에서 사용하기에는 문제가 있습니다. 기능도 제한적이어서 실용성이 부족합니다.
AI를 활용한 코딩이 유행하는 가운데, AI만으로 최신 아키텍처로 얼마나 모던화하고 더 스타일리시하게 만들 수 있는지 실험해 본 것이 elecdex입니다. GPL-3.0으로 공개되어 있으니, git clone
어떤 포크든 환영합니다.
이 글은 기능 소개가 아니라 개발 과정의 기록입니다. 코드는 단 한 줄도 직접 작성하지 않았습니다. Claude Code에게 원본을 분석시켜 설계서를 작성하게 했고, 구현, 테스트, 기록까지 맡겼으며, Grok에게 리포지토리 리뷰를 요청하고, 그 지적 사항의 채택 여부를 Claude Code가 판단하는 과정을 반복했습니다. 이 과정이 10일 동안 진행되어 총 288개의 커밋과 13번의 릴리스를 거쳤습니다.
| 항목 | 값 (2026년 9월 13일~22일) |
|---|
| 커밋 | 288 |
| ... | |
- |
저: 무엇을 만들지 결정합니다. 설계안, 실측값, 선택지를 읽고 판단합니다. 작동하는 것을 만져보고 어색한 부분을 말로 표현합니다. -
Claude Code: 원본 분석, 설계서 작성, 구현, 테스트, 문서화, 커밋 메시지 작성을 담당합니다. 성능은 측정하여 숫자로 보고합니다. -
Grok: 리포지토리 URL로부터 소스 코드와 커밋 로그를 읽어 버그, 디그레이션(degrade), UI/UX의 문제점을 제기합니다.
Claude Code는 세션을 넘나들며 기억을 유지하지 못합니다. 판단과 이유는 매번 리포지토리에 기록으로 남기고, 다음 세션은 그것을 읽고 접하게 됩니다. 이 구조가 루프의 전제 조건입니다.
첫 번째 커밋에는 코드보다 먼저 555줄 분량의 설계서가 들어 있습니다. Claude Code에게 eDEX-UI v2.2.8 리포지토리를 분석시키면서, 무엇을 계승하고 무엇을 버릴지 먼저 결정하게 했습니다.
- 목적: SF풍 풀스크린 터미널 + 시스템 모니터라는 경험 가치 유지. 고정 레이아웃, 글로벌 상태, 구형 보안 모델, OS 의존 해킹(hack) 문제 해결. 페인/탭/위젯을 나중에 확장할 수 있는 기반 마련. -
비목적: 온스크린 키보드, 내장 뷰어, 원본 테마 JSON과의 호환성. -
라이선스: 원본의 코드, 테마, 효과음, 지구본 데이터는 가져오지 않았습니다. 육지는 Natural Earth에서 자체 생성했고, 폰트는 SIL OFL을 사용했으며, 효과음은 새로 제작했습니다. elecdex 역시 GPL-3.0이지만, 원본 유래 바이트는 0입니다.
원본 분석 결과는 '원본으로부터의 주요 변경 사항' 표로 정리되어 있습니다.
| 원본 | elecdex |
|---|
PTY 출력을 ws로 localhost의 TCP 포트로 전송 | |
MessageChannelMain으로 main과 renderer를 직접 연결 | |
cluster로 최대 7개 프로세스 fork | |
utilityProcess 1~2개 | |
위젯마다 setInterval로 systeminformation을 호출 | |
| 단일 스케줄러와 구독 기반. 구독이 0이면 폴링 중지 | |
nodeIntegration: true / contextIsolation: false / @electron/remote | |
| |
sandbox: true / contextIsolation: true. remote 미사용 | |
CWD 추적은 /proc ・lsof ・ps의 1초 폴링 (Windows 비지원) | |
| Shell Integration (OSC 7 / OSC 133)을 모든 OS에서 지원 | |
| --- | --- |
| 탭 5개 고정, 포트 사전 확보 | 탭과 페인은 무제한. 레이아웃은 트리 구조 |
테마 CSS를 innerHTML +=로 주입 | CSS 변수 대체. innerHTML는 Biome으로 금지 |
원본에서 어려움을 겪었던 부분은 유휴(idle) 상태의 CPU 사용량이었으며, 세 번째 줄이 그 원인이었습니다. 구독 기반의 단일 스케줄러가 설계의 중심이 되었습니다.
기술 스택 역시 설계서로 확정했습니다. Electron 44, Svelte 5 (runes), electron-vite, 순수 CSS와 CSS 변수, @xterm/xterm 6, node-pty, systeminformation (utilityProcess 내에서만 사용), three, zod, Biome, Vitest, Playwright입니다. 선택하지 않은 대안에 대한 이유도 나열했습니다 (Tailwind는 clip-path와 SVG 데코레이션이 주를 이루기 때문에 미채택, threlte는 순수 three로 충분함, pnpm은 네이티브 모듈과 electron-builder의 사정상 장점이 적음).
설계서 말미에는 구현 단계별 표가 있으며, 각 단계마다 완료 조건이 명시되어 있습니다. Phase 3은 “구독(subscription)이 0일 때 폴링이 멈추고 유휴 CPU 임계값을 만족함”, Phase 6은 “페인을 닫으면 수집과 렌더링 모두 멈춤. 추가 비용은 코어 1개의 약 1.5%”입니다. 조건들이 숫자로 되어 있어, Claude Code가 단계별로 측정하여 보고했고 저는 그 숫자를 기준으로 다음 진행 여부를 결정했습니다.
설계서는 TypeScript 5.9를 채택했으며, 7.x 버전을 보류한 이유는 “JS Compiler API를 포함하지 않으면 svelte-check가 작동하지 않기 때문”이라고 적혀 있었습니다. 두 번째 커밋에서 이를 수정하여, TypeScript 6.0.3 (JS API용)과 @typescript/native 7.0.2를 병렬로 두고 svelte-check --tsgo로 타입 검사를 하는 구성으로 변경했습니다. 같은 커밋에서 “Vite 8은 Rolldown이 Svelte 5.57을 분석하지 못해 빌드가 실패함”을 실제로 테스트하고, Vite 7에 머무르는 이유로 기록했습니다.
설계서는 계획의 고정된 것이 아니라, 확인된 사실들로 계속 덮어쓰는 기록입니다. 9월 20일에는 최초 계획 그대로 남아있던 부분(존재하지 않는 설정 파일, 10개였던 위젯 목록, 3%였던 유휴 예산, OffscreenCanvas의 차트, threlte의 지구본)을 모두 모아 구현에 맞게 수정했습니다.
- Phase 0: 스캐폴딩 (CI・electron-builder・Biome・Vitest・Playwright)
- Phase 1: 멀티탭 터미널과 Shell Integration
- Phase 2: 영구화되는 레이아웃 트리, 분할, 탭, 위젯 레지스트리
- Phase 3: eDEX-UI의 HUD 디자인 및 시스템 모니터링
- Phase 4: 파일 브라우저와 기상청 날씨 예보
- Phase 5: 리로드 없는 테마 전환, 설정, 효과음
- Phase 6: 내장 GeoIP를 이용한 연결지점 표시 지구본
- Phase 7: 설정 다이얼로그, 단축키 변경, 업데이트 체크, 태그 기반 릴리스 생성 CI
같은 날 CLAUDE.md (당초 107행)를 추가하고 README를 다시 작성하여 v0.0.1을 출시했습니다.
Phase 3 직후에 첫 번째 규칙이 생겼습니다. 단독 터미널에서 탭을 추가하거나 창을 새로고침하면, 셸의 히스토리가 깨졌습니다(화케ました). Claude Code는 PTY로의 리사이즈를 모두 로그에 출력했고, 백그라운드 탭으로 재마운트된 터미널이 display:none 상태로 고정되어 12×5 크기를 셸로 전송하면서, Windows의 ConPTY가 버퍼를 접어버리는 현상이 발생했음을 특정했습니다. 수정 사항은 '표시 중일 때만 맞추고, 120ms간 안정화된 후에 셸에 전달'하는 것이었습니다. CLAUDE.md에는 다음과 같이 적혀 있습니다.
- **Terminal sizing.** Never fit a hidden pane or send transient sizes to the PTY: ConPTY rewraps its buffer to every size and garbles history (see the remount regression test).
이 규칙이 있었기 때문에, 4일 후에 페인(pane)을 닫는 애니메이션을 만들었을 때도 Claude Code는 크기 보간(interpolation) 대신 '먼저 최종 크기로 설정한 후 클립으로 퍼지게 보여주는' 구현 방식을 선택했습니다.
2일차에 Business (Dark / Light) 테마를 추가했습니다. 라이트 테마는 '어두운 배경을 전제로 하지 않기 위함'의 존재이며, 이후 색상과 관련된 변경은 두 Business 모두에서 확인하는 규칙이 되었습니다.
CLAUDE.md에는 설계가 적혀있지 않습니다. 깨면 부서지는 규칙들과 그 이유가 어떤 문서의 몇 절에 있는지만 기록되어 있습니다.
This file holds the rules that must not be broken and where each one lives. The design, and every
decision with its reason and its measured numbers, is in [docs/architecture.md](docs/architecture.md)
(Japanese; §16 is the decision log); plugins are in [docs/plugins.md](docs/plugins.md). **Read the
...
규칙들은 거의 모두 무언가 사건이 발생한 날에 작성되었습니다.
9월 14일 '버그에는 반드시, 수정 없이는 실패하는 테스트를'. RSS 페인의 리뷰 수정 직후였습니다.
- **Every bug found gets a test.** When a problem turns up (from a user, a review, a flaky run),
add a test that fails on the old code and passes on the fix — and cover the related cases around
it (the same path through another widget, the edit or reload that reaches it another way).
...
핵심은 '수정 전 코드에서 실패하는 것을 확인'하는 것입니다. 수정과 동시에 작성된 테스트는 수정이 없어도 통과할 수 있습니다. 이후 커밋에는 '수정 전 코드에서 새로운 테스트 11개가 모두 실패함을 확인했다'와 같은 문장이 반복적으로 등장합니다.
9월 17일 '열고 닫는 것은 전부 CRT 연출로'. 페인을 닫는 연출, 다이얼로그, 알림과 전원 차단 연출을 추가한 후, 새로운 페인/다이얼로그/알림도 동일하게 처리하도록 규칙화했습니다. 연출의 일관성은 리뷰에서 지적되기 전까지는 인지하지 못하기 때문에, 규칙으로 만들어 두는 것이 더 저렴합니다.
9월 20일 'e2e 전체는 출시 전만'. e2e 테스트가 20분에 가까워졌기 때문에, 기능이나 수정 시에는 npm run verify (Biome・타입 검사・Vitest)와 빌드하고, 변경된 스펙과 '변경이 도달할 수 있는 스펙'만을 실행하며, 어떤 것을 실행했는지 커밋에 기록합니다. 영향 범위가 앱 전체의 변경과 출시 전은 전부입니다.
9월 20일 'CLAUDE.md를 주제별로 재편'. 7일간의 규칙들이 시간 순서대로 쌓여 읽기 어려워졌기 때문에, 6가지 주제로 나누고 코드에는 있지만 규칙이 아니었던 3가지를 추가했습니다.
저의 결정에는 날짜를 붙입니다. 기능 추가할 때마다 '겸사겸사 툴 호출도'라는 제안을 받기 때문에, 거절한 판단은 날짜와 함께 기록합니다.
- 도구 없음(No tools), MCP 없음, 이미지 없음, 브랜칭 없음, 이름 지정된 프롬프트 프로필 없음: 의도적으로 제외함
(사용자 결정 사항 2026-09-20 및 2026-09-21). 프로세스를 시작하거나 파일을 읽을 수 있는 모델은 플러그인처럼 동의(consent) 디자인이 필요합니다. 질문 없이 어떤 것도 추가하지 마십시오.
날짜가 있으면 '당시의 판단'으로 알 수 있고, 전제가 바뀌면 재검토 대상이 됩니다. '중첩된 탭 그룹은 설계 후 보류 (2026-09-17)', 'WebGPU는 사용하지 않음 (2026-09-19)'도 같은 형태입니다.
9월 22일자 CLAUDE.md의 'Rules that matter'를 주제별로 추출합니다.
경계(Boundary): renderer는 샌드박스 환경이며, 네트워크나 파일 시스템을 갖지 않습니다. 통신은 모두 main을 통해서만 이루어집니다. 경로를 받아 실행하는 API는 만들지 않습니다. Windows에서는 netsh wlan이 위치 정보 프롬프트를 내보내므로, systeminformation의 네트워크 관련 함수 호출은 하지 않습니다. 음성은 숨겨진 캡처 창에서만 가져옵니다. Web 페인(Web pane)은 WebContentsView를 사용하며, CSP는 느슨하게 만들지 않습니다. 플러그인은 blob Worker로 구동하고, main은 변환만 할 뿐 실행하지 않습니다. AI의 API 키는 페이지에 도달할 수 없습니다. -
성능(Performance): 측정하여 결정합니다. Windows에서는 읽기마다 프로세스를 생성하지 않습니다. spawn은 동기식이며, main은 브라우저 프로세스입니다. 애니메이션은 공유되는 10fps 프레임 루프에 배치하고, will-change와 남는 fill은 사용하지 않습니다. WebGL 컨텍스트는 예산 내에서 관리하며, xterm과 지구본만 가져옵니다. -
페인 및 레이아웃(Pane and Layout): 레이아웃은 트리 구조이며, 변경 사항은 모두 순수 함수(pure function)를 거칩니다. 재마운트가 발생하므로, 남겨둘 것은 페인 상태나 main에 배치합니다. 숨겨진 페인은 맞지 않습니다. 열고 닫는 동작은 CRT 연출이나 움직임을 줄이는 설정에서는 전부 생략합니다. 테마는 데이터 기반이며, 어두운 배경을 전제로 하지 않습니다. -
백그라운드 상주(Background Persistence): 플랫폼 이름으로 분기하지 않습니다. 트레이 유무나 Wayland 여부는 main이 해당 기기를 조사합니다. -
테스트(Testing): 외부 서비스와 실제 장치에 의존하지 않습니다. 버그에는 반드시 테스트를 거칩니다. 멈추는(hang) 테스트는 어디서 멈췄는지 명시해야 합니다. -
공개(Publishing): 스크린샷은 데모용 프로파일로 촬영합니다. 출처 표시(기상청・USGS・NOAA・NRO・Yahoo)는 삭제하지 않습니다. README의 상태 라인은 출시된 버전을 명확히 언급합니다. -
규약(Convention): TypeScript 7에서 strict 모드를 사용하며,
• noUncheckedIndexedAccess
• exactOptionalPropertyTypes
• erasableSyntaxOnly
를 준수합니다. Biome으로 인지적 복잡도(cognitive complexity) 15 이하로 제한합니다. 주석은 '왜' 작성해야 하는지를 기록합니다. 라이브러리는 최신 버전으로 고정하고, 사용할 수 없을 때는 그 이유를 기록합니다.
커밋 규약에 '행동 방식이나 데이터 소스가 변경되면 결정 로그와 README를 업데이트한다'고 명시되어 있으므로, 규칙의 개정은 전용 작업이 아니라 기능 추가나 수정 커밋에 포함됩니다. 288개의 커밋 내역은 다음과 같습니다.
| 종류 | 건수 |
|---|
| feat | 102 |
| ... | |
fix가 feat와 가깝게 보이는 이유는, 리뷰 과정과 스스로 발견한 어색함을 매일 수정했기 때문이며, 그 대부분에 테스트가 포함되어 있습니다. docs에는 CLAUDE.md만 변경하는 커밋이 하루 한 번 정도 있었고, 'Linux의 음성은 pulse 도구에 의존하고, wpctl은 사용하지 않는다', 'keepWhileHidden과 경계에 맞춘 타이머'와 같이 그날 알게 된 것을 규칙으로 옮겨 적었습니다. | |
'Measured, not assumed(추측이 아닌 측정)'가 하나의 규칙입니다. 기본 레이아웃의 유휴 예산(1코어의 약 13%)은 e2e 테스트로 제한했습니다. Claude Code가 실험하여 수치를 도출하는 동안, 저는 그 수치에 따라 결정만 내렸습니다.
⚠️ [IMG:N] 형식 토큰은 이미지 placeholder 입니다. 번역하지 말고 원래 위치에 그대로 유지하세요.
- ELEC 페인 오브 라이트(Pain of Light) (9월 21일): 세 가지 모델에 안건을 상정하는 Pain of Light 기능이 회의 중 코어의 약 70%를 사용했습니다. 효과를 하나씩 멈추며 측정해 보니(바닥을 멈춤: 74%, 빛을 끔: 59%, 둘 다: 51%, 플레이트 도색 전환까지 끔: 17%), 원인은 '무한 애니메이션이 하나만 있어도 스테이지 전체가 매 프레임 합성되기' 때문임을 특정했습니다. 10fps 프레임 루프로 옮겨서 28%로 줄였으나, 눈에 띄게 끊기는(튀는) 현상이 보여 같은 날 중으로 원래대로 되돌렸습니다. 부드러함을 확보하기 위해 70%를 수용했습니다. 측정값은 커밋에 남겼고, CLAUDE.md에는 '프레임 루프로 돌아가지 않는다. 효과를 하나나 둘 줄여도 절약이 되지 않는다'라고 적었습니다.
- 시작 시간이 2.9초에서 1.3초로 단축 (9월 21일): 부트 로그 앞의 '간격' 정체는 PowerShell의
spawn 때문이었습니다. spawn은 동기(synchronous) 방식인데, main은 브라우저 프로세스이기 때문에 기다리는 창문이 그려지지 않습니다. Windows는 CreateProcess 내에서 커맨드라인을 스캔하고 있었고, Shell Integration의 -EncodedCommand가 1.41.7초, 런처 스크립트가 0.71.3초씩 main을 멈추게 했습니다. 스크립트를 환경 변수로 전달하도록 수정하여, main의 최대 정지 시간은 1.7초에서 0.17초로 줄였습니다.
- 숨겨진 창이 계속 그리는 현상 (9월 18일):
backgroundThrottling: false 상태에서는 최소화해도 document.hidden 값이 false인 상태를 유지합니다. main에게 '숨겼다'고 알려 프레임 루프를 멈추게 하여, 대기 중이던 CPU 사용량이 약 26%에서 약 6%로 줄었습니다. 이 비율 역시 e2e(end-to-end) 방식으로 검사했습니다.
- 측정하고 포기한 것도 기록하기 (9월 20일): 차트의 눈금을 거칠게 하는 방안(얻는 것은 오차 정도이고 움직임이 2.5fps가 됨), DPR 2 이상에서 지구본의 MSAA를 끄는 방안(GPU 메모리는 줄지만 1픽셀 선이 가늘고 어두워짐)을 수치와 함께 결정 로그에 남겼습니다. 이유가 남아있지 않으면 다음 세션에서 또 제안할 것이기 때문입니다.
날씨(9월 13일)는 'MET Norway, 기상청(KMA), NWS를 하나의 프로바이더 계층 뒤에 배치하는 설계'를 작성한 후 구현했고, 플러그인(9월 15일)은 사양서와 그 개정 후에 구현했습니다. 기준은 경계를 넘나드는지 여부입니다. 날씨는 세 가지 외부 서비스의 이용 조건들을 따라야 했고, 플러그인은 사용자의 코드를 구동하기 때문에 권한/동의/크기 제한을 먼저 정하지 않으면 구현이 막힙니다. 플러그인의 타입 정의는 사용자의 플러그인 폴더에 그대로 복제되므로, '이 타입을 변경하는 것은 공개 API를 변경하는 것'이라는 규칙을 세웠습니다.
같은 모델은 같은 사각지대를 가지기 때문에, 리뷰는 Grok에게 맡겼습니다. 전달하는 것은 리포지토리 URL만이고, 소스 코드와 커밋 로그는 Grok이 스스로 읽습니다.
처음에는 v0.0.1 공개 직후에 이것만 던졌습니다.
답변의 발췌입니다.
아키텍처와 보안은 명확하게 우수합니다. 원본의 큰 문제점들을 거의 모두 해결했습니다. nodeIntegration: true / contextIsolation: false / @electron/remote $
ightarrow$ sandbox + contextIsolation + 단일 타입이 지정된 preload 브릿지. PTY를 localhost WebSocket으로 터널링 $
ightarrow$ MessageChannelMain(포트 불필요). 각 위젯이 독립적으로 systeminformation을 폴링(polling) $
ightarrow$ utilityProcess + 구독 기반의 단일 스케줄러(구독 0이면 정지).
약점 및 개선 여지. 아직 초초기 단계입니다. 릴리스는 미서명 프리릴리즈만 가능합니다. 성능이나 안정성은 실제 기기에서 장시간 사용해 봐야 알 수 있는 부분들이 있습니다.
설계서의 의도가 외부에서 읽어도 전달된다는 것을 확인했습니다. 이후로는 '리뷰'를 요청하고, 돌아온 내용을 그대로 Claude Code에 전달합니다. 지시는 매번 동일합니다. '사실인지, 채택해야 할지 신중하게 판단하여, UI/UX 일관성, 아키텍처, elecdex와 eDEX-UI의 세계관과 비교했을 때 해야 한다고 판단되면 반영한다.' 채택 여부와 이유는 결정 로그에 남깁니다.
고쳐졌습니다.
⚠️ [IMG:N] 형식 토큰은 이미지 placeholder 입니다. 번역하지 말고 원래 위치에 그대로 유지하세요.
- 9월 13일 (v0.0.1 직후): 8건이 사실임. 런처가 깜빡이는 동안 다른 앱을 실행하면 정렬 순서가 손실되는 경쟁(race condition) 문제가 있었습니다. 다이얼로그 뒤에서 레이아웃 변경 단축키가 작동합니다. macOS에서 읽을 수 없는 디스크 I/O를 "0 B/s"로 표시했습니다. 시작 e2e는 날씨 및 업데이트 확인의 실제 URL을 가리키고 있었으며, 예보 캐시가 계속 증가하는 문제가 있었습니다. 키 바인딩 항목 수에 제한이 없습니다. 사용되지 않는 export가 존재합니다. 지구본의 현재 위치 추정 시 도시별로
Intl을 호출합니다.
- 9월 14일 (RSS와 지진): 실패 중인 피드가 재구독할 때마다 대기 시간을 무시하고 다시 가져오는 문제가 있었습니다. 쓰나미 정보에서, 상세 정보 가져오기에 실패한 보도가 목록의 304 상태 코드로 영원히 가져와지지 않았습니다. 가져오는 도중에 발신원을 전환했다가 돌아오니 오래된 304 상태 코드로 목록이 비어지는 현상이 발생했습니다. 이 직후에 "버그에는 반드시 테스트"라는 규칙을 세우게 되었습니다.
- 9월 14일 (믹서): 상주 PowerShell의 C# 루프에서, 읽을 때마다 생성되는 COM 객체의 해제를 GC(Garbage Collection)에 맡기고 있었습니다. 그 결과, 75초 만에 1.4MB 증가했던 워킹 세트가 0.4MB로 줄었습니다.
- 9월 15일 (플러그인 보안): 지적은 모두 사실이었습니다. 다른 오리진으로 리다이렉트된 후에도
Authorization와 x-*를 전송하고 있었습니다. 동의(consent)는 플러그인 ID와 파일 이름 조합에 연결합니다. 저장 키는 [A-Za-z0-9_.:-]{1,100}로 한정하여 __proto__를 거부합니다. 링크 문자열과 이동 대상을 일치시킵니다. 개인 정보 관련 메트릭스와 통신을 동시에 요청하자 동의 화면에서 경고가 뜹니다. 새로운 테스트 11개가 수정 전 코드로 인해 모두 실패하는 것을 확인했습니다.
- 9월 21일 (AI 채팅 요약): "요약용 예약이 항상 작동하는지"를 확인하는 과정에서, 예약이 일률적으로 600 토큰이었기 때문에 컨텍스트 창(context window)이 1024인 프로바이더에서는 질문할 때마다 재설정하여 요약을 요청하고 있었다는 것이 밝혀졌습니다. 예약을 컨텍스트 창의 1/10로 설정하고, 일률적으로 600으로 되돌릴 경우 실패하는 테스트를 추가했습니다.
- 9월 22일 (페인 모서리 버튼): 8개 항목 중 채택된 것은 1가지입니다. 그룹의 ×가 브라우저의 "탭 하나 닫기"와 혼동된다는 지적에 따라, 레이블을 "close all N tabs"로 변경하고 × 위에 마우스를 올리는 동안 모든 탭을 흐리게 처리합니다. 나머지는 채택되지 않았습니다. 호버(hover)에서만 나타난다는 지적은 페인 전체의 호버 시 나타나므로 사실 오인이며, 확대 불가 탭에서의 ⤢ 비활성화 표시는 이틀 전 결정과 충돌하고, 44px의 히트 영역 판정은 옆 버튼 및 드래그용 제목에 침범합니다.
채택하지 않은 지적도 이유와 함께 기록하고 있습니다. 플러그인에서는 descriptor를 AST(Abstract Syntax Tree)로 정적으로 추출하는 방안(방지 가능한 것은 권한이 없는 코드의 CPU 3초 동안만), 사라진 플러그인의 자동 비활성화(에디터 저장 시 발생하는 일시적 소실로 인해 비활성화됨), DNS rebinding(HTTPS/443 고정 및 인증서 검증 하에서는 실효성이 없음)은 보류했습니다.
리뷰 지적의 절반 이상이 채택되지 않았습니다. 그럼에도 계속하는 이유는, 채택된 쪽의 지적이 구현한 본인에게는 보이지 않는 종류이기 때문입니다. 혼동되기 쉬운 레이블, 재구독으로 우회되는 재시도, 테스트가 실제 서비스에 닿는 경로는 작성한 모델이 다시 읽어봐도 나오지 않았습니다. Grok은 커밋 로그도 읽기 때문에, "이전 버전을 고친 것이 또 망가지지는 않았는지"라는 디그레이데이션(degrade) 관점까지 포함됩니다. Claude Code는 이전 세션을 기억하지 못하므로, 이 관점은 외부에서 가져와야 했습니다.
9일 동안 13회 출시했습니다. 태그를 누르면 GitHub Actions가 3개 OS에 대해 빌드하고 프리릴리스에 첨부하는 경로는 첫날에 완성되었고, 이후는 "모든 e2e 테스트가 통과하면 버전을 올리고 태그를 누르는" 것만 남았습니다. 빌드는 미서명(unsigned)이므로, README와 릴리스 노트에 SmartScreen 및 Gatekeeper 우회 절차를 영어로 기재했습니다.
macOS와 Linux는 CI의 e2e 테스트가 통과하는 것 외에는 확인된 바가 없으며, README에 "충분히 검증되지 않았음"이라고 적혀 있습니다. 누군가가 직접 사용하기 전까지 그 문구는 지우지 않을 것입니다. macOS CI 러너는 화면이 1024×640밖에 안 되는데, 1920×1080을 전제로 한 테스트가 1건 계속 실패했기 때문에, skip하지 않고 webContents.setZoomFactor를 이용해 CSS 픽셀 상의 크기를 보정했습니다.
테스트는 외부 서비스나 실제 기기에 접근할 수 없습니다. 날씨/시세/지진/업데이트 확인/Web 페인의 목적지는 기본적으로 닫힌 포인트를 향하며, 음성/알림 영역/로그인 시 시작/소켓 목록/AI 키의 암호화는 환경 변수로 스텁(stub)을 대체합니다.
기억은 리포지토리에 남긴다. 규칙은 CLAUDE.md로, 이유는 설계서에, 그리고 숫자는 날짜와 함께 기록한다. 커밋 메시지에 영일 병기를 한 것도 나 자신과 Claude Code 모두가 나중에 읽을 것이기 때문이다.
- 규칙보다 이유를 적는다. '숨겨진 페인이 맞지 않는다'라는 것만으로는 다음 세션에서 예외가 발생할 수 있다. 'ConPTY가 버퍼를 줄 바꿈한다'까지 구체적으로 적어두면, 다른 곳에서도 같은 판단을 내릴 수 있게 된다.
- 형용사가 아닌 숫자로 결정한다. 70%와 28%, 2.9초와 1.3초, 26%와 6%가 남아있다면 재실험이나 재검토는 필요 없다.
- 다른 모델에게 리뷰를 요청하고 채택 여부를 기록한다. 거절된 이유까지 남겨두면, 같은 제안이 들어와도 처음부터 다시 생각할 필요가 없어지기 때문이다.
- 나의 역할은 오직 '결정'만 내리는 것이 되었다. 무엇을 만들지, 숫자로 어느 쪽을 택할지, 리뷰 중 어떤 것을 채택할지. 코드도 테스트도 작성하지 않았지만, 결정 로그 187줄 전체는 내가 직접 읽고 판단한 내용들이다.
이 글 역시 git 로그와 설계서를 바탕으로 Claude Code가 초안을 잡았고, 내가 수정했습니다. 프롬프트 작성법, CLAUDE.md 실제 예시, 결정 로그의 특정 줄, 리뷰 과정 등 궁금한 점이 있다면 댓글이나 X(트위터)로 남겨주세요. 최대한 답변드리겠습니다.
개발 중인 SF풍 터미널 'elecdex'에 대하여
elecdex는 eDEX-UI의 경험을 현대적이고 보안성이 높은 스택으로 재구축한 터미널 에뮬레이터이자 시스템 모니터입니다. GPL-3.0으로 공개했으니, 클론(clone)이나 포크(fork)는 자유롭게 사용해 주세요.
Repository: GitHub - kurouna/elecdex
Download: Releases
X (Twitter): @elecxzy
Windows 외의 환경에서는 검증이 충분하지 않습니다. macOS나 Linux에서 구동한 결과를 Issues에 알려주시면 큰 도움이 될 것 같습니다.