YDMmobile / oss
KOEN

만들며 배운 것을 남깁니다.

Category
  1. 85

    캐시를 무효화할 자리가 아예 없다면 (부제: 시계는 write를 안 한다)

    캐시 무효화가 어렵다는 말은 다들 한다. 보통은 "무효화 코드를 어디에 넣을지 까먹는다"는 뜻으로 쓴다. 그런데 넣을 자리가 아예 없는 경우가 있다. 이 글은 그 경우 얘기다. 공개 페이지에 남은 자리 수를 보여준다고 하자. 행사 상세 페이지 같은 것. 트래픽은 붙을 테니 캐싱하고 싶어진다. 자연스럽다. 그리고 우리는 무효화를 어디에 넣어야 하는지도 안다. 값이 바뀌는 곳에 넣으면 된다. 그럼 남은 자리 수는 언제 바뀔까? 세어보자. 1번과 2번은 쉽다. 예약 처리하는 코드 끝에 무효화 한 줄, 환불 코드 끝에 한 줄. 3번과 4번에서 손이 멈춘다. 3번과 4번은…

    KO2026-08-18

  2. 86

    Prettier는 왜 내 Dart 코드만 그냥 두고 갈까 (부제: 그래서 만들어봤다)

    이메일로 마크다운 문서를 하나 받았다. 안에 Dart 코드가 블록 단위로 흩어져 있었는데, 하나같이 줄이 안 맞아 있었다. 그래서 이 짓을 하고 있었다. 블록 하나를 복사한다. dartpad.dev에 붙여넣는다. 포맷을 돌린다. 결과를 복사한다. 문서로 돌아와 그 자리에 붙여넣는다. 다음 블록으로 간다. 세 번째 블록쯤에서 현타가 왔다. 나는 이 문서를 어차피 prettier --write로 한 번 훑을 참이었다. 얘가 다 해주면 안 되나? Prettier로 마크다운을 포맷해본 사람은 알겠지만, 얘는 코드 블록 안쪽까지 건드린다. ```json에 중괄호랑 공백을…

    KO2026-08-18

  3. 87

    Your Subprocess Timeout Fires On Time and Your Program Still Hangs

    I set a 30-second timeout. The run took 120 seconds. The timeout was working perfectly. I write a small Prettier plugin that formats Dart code blocks inside Markdown. It does almost nothing on its own — it hands each block to the dart format binary you already have installed and puts the result back. A thin wrapper…

    EN2026-08-18

  4. 88

    코딩 AI에게 구현시키기 전에 코드베이스에서 찾아야 할 것

    코딩 AI에게 기능을 맡기기 전, “버튼 하나 추가해 줘”라고 바로 말하고 싶을 때가 있습니다. 문장도 짧고 결과도 빨리 보고 싶으니까요. 그런데 코드베이스는 빈 캔버스가 아닙니다. 이미 폴더의 역할, 상태를 다루는 방식, 데이터를 오가는 길, 그리고 지켜야 할 약속이 쌓여 있습니다. 그걸 찾지 않고 구현부터 시키면 AI는 열심히 일하면서도 엉뚱한 서랍에 양말을 넣을 수 있습니다 (정리한 사람만 더 피곤해지는 그 서랍 말입니다). AI가 코드를 잘 생성한다는 사실과, 이 저장소의 맥락을 이미 안다는 사실은 다릅니다. 요구사항은 “무엇을 만들지”를 알려 줍니다. 반면…

    KO2026-08-13

  5. 89

    AGENTS.md가 여러 개라면 AI는 어느 지침을 따라야 할까?

    프로젝트를 열었는데 루트에도 AGENTS.md가 있고, 작업할 폴더 안에도 또 AGENTS.md가 있다면 AI는 무엇을 읽어야 할까요? 둘 다 읽다가 갑자기 우왕좌왕하는 것 아닐까요? 사람도 규칙 문서 두 장만 만나면 표정이 복잡해지는데, AI라고 문서 더미 앞에서 초연할 리는 없습니다 (다만 표정 대신 다음 토큰을 낼 뿐입니다). 여기서 가장 흔한 오해는 가까운 문서 하나만 이긴다는 생각입니다. 하위 폴더의 지침이 있으니 루트 지침은 폐기되고, 두 문서가 경쟁하는 결승전처럼 보이는 것이죠. 하지만 유지보수하기 좋은 저장소 패턴에서는 조금 다르게 생각하는 편이…

    KO2026-08-13

  6. 90

    CLAUDE.md는 왜 얇게 유지해야 할까? (지침 문서가 둘이면 생기는 일)

    CLAUDE.md도 있고 AGENTS.md도 있다면, 둘 다 길고 자세하게 쓰는 편이 친절할까요? 처음에는 그래 보입니다. 도구마다 알아듣기 쉬운 문서를 하나씩 주면 될 것 같으니까요. 그런데 두 문서가 같은 빌드 명령, 같은 작업 규칙, 같은 검증 절차를 반복하기 시작하면 친절은 금세 두 개의 정답 후보가 됩니다. 문서가 두 명의 교장 선생님처럼 서로 다른 말을 하기 시작하는 순간이죠 (둘 다 진지해서 더 곤란합니다). 이 문제를 피하는 한 가지 관리 패턴이 얇은 도구별 어댑터입니다. 여기서 어댑터란, 특정 AI 도구가 저장소의 운영 방식을 찾고 따르도록 연결해…

    KO2026-08-13

  7. 91

    AI에게 선택지를 물을 때 자유 답변보다 메뉴가 나은 이유

    AI가 다음 행동을 정해야 하는 순간, 이런 질문을 받으면 어떨까요? “그래서 이제 무엇을 할까요?” 친절해 보입니다. 하지만 막상 답하려고 하면 생각이 길어집니다. 계획을 더 다듬을지, 작업을 시작할지, 잠깐 멈추고 정보를 더 줄지, 아니면 전혀 다른 방향을 말해야 할지 말이죠. 자유로운 질문 하나가 작은 빈칸 시험지가 되는 순간입니다. 이럴 때 메뉴형 질문은 질문을 없애지 않습니다. 대신 답의 모양을 정합니다. AI 도구의 AskUserQuestion 메뉴 패턴은 다음 단계의 선택지를 이름 붙은 항목으로 보여 주고, 사용자가 그중 하나를 고르게 하는 방식입니다.…

    KO2026-08-13

  8. 92

    슬래시 명령어에서 스킬로: AI 도구의 실행 단위를 바꾸는 이유

    AI 코딩 도구에서 /무언가를 입력해 보신 적이 있다면, 어느 날 그 명령이 사라지고 “스킬을 호출하세요”라는 안내를 만났을 때 조금 당황했을 법합니다. 이름만 바꾼 것 같은데, 왜 굳이 명령어를 스킬로 옮길까요? 명령어가 잘못해서 벌을 받는 것도 아닌데 말입니다. 이 질문을 풀 때 가장 먼저 버려야 할 생각은 **“명령어와 스킬은 같은 버튼의 다른 라벨”**이라는 모델입니다. 사용자 입장에서는 둘 다 어떤 일을 시작하는 입구처럼 보입니다. 하지만 도구를 만들고 배포하는 쪽에서는 입구의 이름보다, 그 뒤에 무엇을 묶어 두고 여러 환경에 어떻게 전달할지가 더 큰…

    KO2026-08-13

  9. 93

    AI 메모리는 언제 프로젝트 밖의 '공통 규칙'이 될까?

    한 프로젝트에서 잘 통했던 규칙을 다른 프로젝트에서도 바로 쓰면 더 똑똑해지는 걸까요? AI가 기억을 많이 할수록 편해 보이지만, 실제로는 기억의 범위가 넓어질수록 엉뚱한 전제가 따라올 위험도 커집니다. 어제의 정답이 오늘의 다른 저장소에서는 조용한 오답이 될 수 있으니까요. 여기서 필요한 것이 메모리 범위(scope) 입니다. 메모리 범위란 AI가 저장한 사실이나 규칙이 어느 맥락에서만 유효한지 표시하는 기준입니다. 이 기준은 기억을 많이 모으는 기술이 아니라, 기억을 어디까지 믿어도 되는지 정하는 규칙에 가깝습니다. 가장 위험한 마음속 공식은 이렇습니다. “A…

    KO2026-08-13

  10. 94

    AI가 과거 사례를 찾았다고 지금 일을 승인받은 것은 아니다

    AI가 “예전에 이렇게 결정했어요”라고 알려주면, 왠지 지금 할 일도 이미 통과한 것처럼 느껴지지 않나요? 근거를 찾아 준 건 분명 반가운 일입니다. 하지만 그 문장을 곧바로 “그럼 진행해도 된다”로 번역하는 순간, 과거 사례와 현재 승인이 한 덩어리가 됩니다. 둘은 닮았지만 같은 물건이 아닙니다 (비슷하게 생긴 리모컨을 눌렀다가 TV가 아니라 에어컨이 켜지는 것처럼요). 흔한 오해는 이렇습니다. AI가 과거의 판단, 규칙, 또는 비슷한 선택을 찾아냈다면 현재 계획도 맞다고 인증한 셈이라는 생각입니다. 그래서 조회 결과를 승인 도장처럼 쓰고, 별도의 판단이나 확인을…

    KO2026-08-13

  11. 95

    AI 대화의 도구 호출과 결과는 어떻게 짝을 찾을까?

    AI가 도구를 두 번 불렀는데, 결과도 두 개 돌아왔습니다. 그런데 결과가 호출 바로 다음 줄에 붙어 있지 않다면 어떨까요? 대화 기록을 읽는 쪽에서는 갑자기 작은 추리극이 시작됩니다. 이 결과는 어느 호출의 답일까? 그냥 가까이 있는 것끼리 붙이면 되는 걸까? 도구를 쓰는 AI 대화는 보통 도구 호출과 도구 결과를 별도 블록으로 남깁니다. 호출은 AI가 어떤 도구에 무엇을 요청했는지 나타내고, 결과는 실행 뒤에 돌아온 내용을 담습니다. 둘을 다시 연결하는 일을 여기서는 **짝짓기(pairing)**라고 부르겠습니다. 대화 화면에서는 한 덩어리처럼 보여도, 구조화된…

    KO2026-08-13

  12. 96

    AI가 확신 못 하는 일은 왜 '검토함'으로 보내야 할까?

    AI에게 문서를 정리하게 하면 가장 곤란한 순간은 틀린 답을 내놓을 때만이 아닙니다. 애매한데도 너무 매끄럽게 다음 행동까지 정해 버릴 때가 더 난감할 수 있습니다. 새 페이지를 만들어야 할지, 자료를 더 찾아야 할지, 그냥 지나가도 될지 모르는 상황에서 말이죠. 그때 모델이 “제가 알아서 처리했습니다”라고 하면 (친절한 척하지만), 우리는 무엇을 확인해야 하는지도 잃어버립니다. llm_wiki의 README는 이런 판단을 Async Review System, 즉 비동기 검토함으로 따로 보냅니다. ingest 과정에서 LLM이 사람의 판단이 필요하다고 본 항목을…

    KO2026-08-13