2026-11-22 홍보 준비, 알고리즘 갤러리

“홍보를 하고 싶습니다. 알고리즘에 관심이 많은 프로그래머들에게 어필할 수 있을 것 같아요.”로 시작했다. 첫 수로 알고리즘 갤러리와 글 한 편을 고르고, 갤러리 페이지(M70 G3)와 GeekNews · Show HN · Reddit 초안을 만들었다.

논의 흐름

  1. CONTRIBUTING. inbox 항목대로 “MVP를 개발하고 있다”를 “웹 베타”로(한국어 · 영어, 241c390). 홍보로 들어온 사람이 처음 볼 문서라 먼저.
  2. 첫 수. 선택 창에서 “갤러리 + 글”(추천안). 갈고리는 ① 알고리즘을 구조로 읽기, ② 코드를 주면 그려 주는 Claude 스킬.
  3. 묶음. 선택 창에서 고전 · 어려운 것 · 재미 셋 다. 에이전트가 16개를 그림(BFS · DFS를 나눠 앱 예제 6개와 합쳐 22개, 56c1529). 생성 스크립트 gallery-images가 .ns.svg 44개와 gallery.json(공유 링크 포함)을 만든다.
  4. M70 배치. G1 카드 그리드(추천) · G2 한 장씩 크게 · G3 목록 + 큰 그림. 메인테이너가 G3를 고름. 에이전트가 src/apps/gallery로 페이지를 만들어 사이트 빌드에 연결(0756e96): #kmp 바로 가기, ↑ ↓, 휴대폰은 select, 넓은 그림은 칸 안에서 가로 스크롤, 새 OG 그림, 사용법 “예제” 꼭지에 링크.
  5. 정확성. 다른 에이전트가 그림의 블록을 Python으로 그대로 옮겨 기준 구현 · 브루트포스와 견줌. 16개 모두 맞음, 고친 것 없음(17fc681, src/apps/gallery/verify/).
  6. 글 초안 → promotion
    • 메인테이너: “GeekNews에 정보처리기사 얘기는 빼주세요. 알고리즘 관심있는 한국 개발자들이 오히려 정보처리기사를 얕보는 경향이 있는 것 같습니다.”
    • 메인테이너: “‘다시 열어 편집할 수 있는 원본’이란 말은 한국 개발자들에게 잘 와닿지 않습니다.” → README에 넣으면 그림으로 보이고 편집기로 다시 열면 고친다는 장면으로.
    • 메인테이너: “GeekNews가 마음에 안 드네요. 너무 AI가 작성한 티가 납니다.” → 굵은 글씨 · 대칭 글머리표를 없애고 커뮤니티 말투로. 메인테이너의 경험은 지어 쓰지 않고 빈칸으로.
    • 메인테이너가 빈칸에 만든 까닭(플로우차트는 지면을 차지하고 NS 차트는 지우개로 다시 그려야 했다)을 썼다. Show HN에도 영어로 넣음. “met in school” · “helps you the way it helps me”는 그대로, “재미있던 것 한 줄” 빈칸은 뺌.

결정

  • 홍보 첫 수: 알고리즘 갤러리 + 글, 올리는 순서 GeekNews Show GN → Show HN → Reddit → 그 밖(promotion). 올리는 것은 메인테이너가 직접.
  • 갤러리 /gallery/(한국어 /gallery/ko/): M70 G3, 22개.
  • 홍보 글에 정보처리기사 이야기는 쓰지 않는다.

발견한 위험과 실수

  • 메인테이너의 글을 덮어씀. GeekNews 초안을 “계속 다듬어” 달라는 말에 Python으로 본문 구간을 통째로 갈아 끼우다, 메인테이너가 Obsidian에서 막 써 넣은 “만든 까닭”을 날림. git에도 없었고 메인테이너가 Obsidian에서 Ctrl+Z로 되살림. 앞으로 함께 여는 문서는 쓰기 직전에 다시 읽고 고칠 문장만 Edit로.
  • 에이전트의 파일이 내 커밋에. git commit -a로 18d1e16 · d0d5b81에 갤러리 에이전트가 고치던 파일 넷이 들어감(내용은 맞음, 6760f7d에 적음). 에이전트가 도는 동안은 파일을 골라 커밋.
  • 정확성 검사 중 “맞지만 헷갈릴 수 있는 곳”: 선언 없는 공유 변수(DFS · 유니온 파인드 · 세그먼트 트리 · N-Queen), 최대 유량의 s == t, KMP의 빈 패턴 → backlog

다음 할 일

inbox에서 옮긴 원문

7. 기타

  • CONTRIBUTING에 우리가 MVP하고 있다고 나와있네요.

매듭 중에 더한 것

  • 메인테이너: “대문 README 하나만이라도 영어 번역도 있으면 좋겠어요.” → 선택 창에서 “영어를 대문으로”: README.md는 영어, 한국어는 README.ko.md(사이트 /about의 원본).
  • 메인테이너: “한국어 README도 그렇게 고쳐 주세요.” → 첫 문단의 .ns.svg 설명을 “README나 블로그에 넣으면 그림으로 보이고, 편집기에서 다시 열면 고칠 수 있다”로.
  • 메인테이너: “나랑 얘기할 때 용어를 과도하게 한국어로 번역하지 마세요. 오히려 커뮤니케이션이 힘들어집니다.” (Claude가 “쓰는 장면”이라는 말을 지어 씀)