01 / 관심 주제로 글 만들기
주제를 정하고,
오늘 읽을 글을 굽습니다.
관심 주제와 글 수, 모델을 설정해 둡니다. ‘오늘 글 굽기’에서 내용을 확인하고 시작하면, 주제별 글이 생성됩니다.
02 / 하루치 공부를 모으는 곳
구워진 글은,
다시 꺼내 읽기 좋게
주제별 글을 날짜 단위로 모았습니다. 관심 있는 글을 고르고, 본문과 목차를 따라 읽습니다. 매일 공부하는 습관을 돕되, 글 생성은 사용자가 ‘오늘 글 굽기’를 누를 때 시작합니다.
03 / 기억하고 싶은 곳에 잼 한 번
모르는 문장을 지나치지 않게
질문도, 메모도 그 자리에
읽다가 궁금한 구간을 선택합니다. AI에게 묻거나 내 생각을 노트로 남깁니다. 본문의 잼 표시로 그 문장에서 시작한 기록을 다시 엽니다. 문장과 노트를 연결한 방식에 위치 복원의 조건과 한계를 남겼습니다.
짧게 읽고, 기억하고 싶은 문장에 잼을 발라 보세요.
작업 큐를 읽는 아침
본문에서 궁금한 문장을 골라 보세요.
새 대화창에서,
다시 설명하지 않아도
질문에는 글과 선택한 구간, 같은 스레드의 이전 대화를 함께 전달합니다. 답변은 노트로 저장하고 본문 강조 표시와 연결합니다. 다른 구간에서 시작한 대화는 섞지 않습니다. 대화와 노트의 출처를 구분한 기록에서 이 연결의 기준을 설명합니다.
04 / 이름이 된 습관
카야토스트를 먹으며
기술 글을 읽곤 했습니다.
주말 아침의 읽기 습관을 동료들도 쓸 수 있는 학습 도구로 옮겼습니다.
관심 주제로 글을 만드는 기능은 빵 굽기로, 본문에 메모나 대화를 남기는 기능은 잼 바르기로 표현했습니다.
05 / 생성 작업과 읽기 기록의 관리
생성 상태를 남기고,
대화와 노트를 저장합니다.
한 Node·PM2 프로세스 안에서 생성 큐를 실행하고, SQLite에 작업 상태와 읽기 기록을 남깁니다.
전체 연결 읽기 · 5개
- 주제별 입력 → 큐 → Claude CLI
- 큐 → Claude CLI → 실행 상태
- 실행 상태 → 재시도 · 미완료 정리
- 글 · 선택 구간 · 대화 · 노트 → SQLite 기록
- 글 · 선택 구간 · 대화 · 노트 → 후속 평가 · 점선 연결
운영에서 남긴 기준
실행 순서를 조정하는 큐와 재시작 후 판단할 작업 기록을 나눴습니다. 중단된 실행을 자동으로 이어가거나 여러 프로세스의 중복 생성을 막는 구조는 아닙니다. 프로세스 내부 큐의 복구 정책에 상태별 처리와 검증 범위를 정리했습니다.
문장을 질문과 노트에 연결하는 기능까지 구현했고, 답변의 정확성과 학습 효과는 후속 평가로 남겼습니다. 기록을 다시 찾을 수 있다는 동작과 실제로 학습에 도움이 됐다는 판단을 구분합니다.
선택해서 보기 · 가상 워크플로 평가 예시
가상 평가 예시 · 실측 전
읽던 위치와 질문을 다시 찾는 과정
글과 질문을 별도로 저장하는 방식과, 본문의 잼 표시·대화·노트로 이어 읽는 방식을 비교하는 가상 시나리오입니다.
수치·표본 설정·피드백은 평가 화면을 설명하기 위해 만든 가상 예시입니다. 실제 동료에게서 수집한 기록이나 의견이 아니며, 개선 효과를 입증하지 않습니다.
| 관찰할 과정 · 단위 | 기존 방식 글 · 별도 대화 · 메모 | 도구 사용 본문 표시 · 연결된 기록 | 가상 차이 실제 개선율 아님 |
|---|---|---|---|
| 표시한 위치 다시 찾기초 / 작업 | 90 | 58 | 35.6% |
| 이어 물을 문맥 준비분 / 작업 | 2.5 | 1.7 | 32% |
| 질문과 설명 기록 연결분 / 작업 | 3 | 2.4 | 20% |
표본·계산식·관찰 범위와 다음 평가
가상 작업 같은 기술 글의 표시한 구간을 다시 읽고 질문 기록 남기기
가상 표본 설정 역할 시나리오 8종 × 작업 4회 = 방식별 32회. 참여자를 모집하거나 수행한 실험이 아닙니다.
같은 글·질문·메모 내용을 가정합니다. 구간 1곳과 질문 1건을 다루는 작업당 평균이며, 대기·AI 답변 생성 시간은 제외합니다. 지식 습득이나 답변 정답률은 평가 범위에 넣지 않습니다.
가상 차이 = (기존 방식 값 − 도구 사용 값) ÷ 기존 방식 값. 가상 평균값으로 계산한 비율이며, 실제 개선율이나 인과관계의 근거가 아닙니다.
표의 각 값은 방식별 32회 평균을 가정합니다.
- 표시한 위치 다시 찾기의 관찰 범위
- 저장한 글을 연 뒤 이전에 표시한 문장과 연결 기록을 찾을 때까지의 사람 작업 시간.
- 이어 물을 문맥 준비의 관찰 범위
- 해당 위치를 찾은 뒤 문장·이전 질문을 확인하고 후속 질문을 보낼 때까지. 답변 대기는 제외.
- 질문과 설명 기록 연결의 관찰 범위
- 답변이 나온 뒤 질문·설명을 메모로 남기고 원문 위치에 연결할 때까지의 사람 작업 시간.
관련 기술 기록
만들며 마주한 문제와 선택을 기술 기록으로 이어 읽습니다.
답변을 노트로 저장할 때 출처 ID를 남기는 이유
같은 본문만으로는 어떤 답변을 이미 저장했는지 판단할 수 없습니다. 출처 메시지 ID와 부분 유일 인덱스를 연결하고, 노트·대화 삭제와 동시 삽입의 경계를 살펴봅니다.
코드 블록의 선택을 문자 오프셋으로 저장하기
구문 강조된 코드의 선택 끝점은 텍스트 노드가 아닐 수 있습니다. DOM Range로 오프셋을 계산하고, 여러 블록을 드래그했을 때 저장 범위와 복원의 한계를 정합니다.
메모리 큐와 DB 작업 상태가 맡는 일을 나누기
메모리 큐는 동시 실행을 제한하고 SQLite는 작업 상태를 남깁니다. 재시작 때 대기 작업은 다시 넣고 실행 중인 작업은 실패로 정리하며, 중복 실행을 막는 보장과 구분합니다.