코드베이스를 매번 AI에게 설명하는 것을 멈추세요
Source: Dev.to
모든 AI와의 대화는 똑같은 방식으로 시작됩니다. “Rails 앱을 만들고 있는데, Hetzner에 배포하고, SQLite를 사용하고 있어요…” 이런 식으로 수백 번 입력했을 겁니다.
AI는 똑똑하지만 기억을 가지고 있지 않습니다. 각 채팅은 처음부터 시작하므로 프로젝트 컨텍스트, 관례, 과거 결정 등이 사라집니다.
만약 AI가 이미 그 모든 것을 알고 있다면 어떨까요? 아래 다섯 가지 노트가 그 일을 가능하게 합니다.
1. 한 번만 저장하는 스택 정보
기술 스택, 배포 설정, 관례를 담은 노트를 하나 작성하세요. 이제 모든 대화가 그 컨텍스트로 시작됩니다.
이제 물어보세요: “Stripe에 사용자 데이터를 동기화하는 백그라운드 잡을 작성해 줘.”
AI는 노트를 읽고 Rails임을, Solid Queue를 사용한다는 것을 알고, 당신의 관례를 따릅니다—서두가 필요 없습니다.
2. 다시 마주칠 오류 수정
Kamal 배포를 디버깅하는 데 45분을 쓰고 해결책을 찾았는데, 일주일 뒤 같은 오류가 다시 나타났다고 가정해 보세요. 다시 구글링하는 대신 그 해결책을 노트에 저장합니다.
다음에 같은 상황이 되면 이렇게 물어보세요: “Kamal 배포에서 health check timeout이 발생하고 있어. 이전에 본 적 있나요?”
AI는 저장된 해결책을 즉시 찾아줍니다—몇 분이 아니라 몇 초 만에.
3. 이유와 함께한 아키텍처 결정
특정 이유 때문에 SQLite를 Postgres 대신, Turbo를 React 대신 선택했습니다. 그 결정을 노트에 기록하세요:
제목: 왜 SQLite를 Postgres 대신 선택했는가
- Hetzner 단일 서버 배포 → 연결 풀링이 필요 없음.
- 백업을 위해 Litestream을 S3에 사용.
- 운영이 간단해짐 → 관리해야 할 서비스가 하나 줄어듦.
읽기 복제본이 필요하거나 WAL 모드가 감당하지 못하는 동시 쓰기가 발생하면 다시 검토할 예정.
누군가 “왜 Postgres가 아니죠?” 라고 물으면, “우리 데이터베이스 선택과 그 이유를 요약해 줘.” 라고 답할 수 있습니다. 오래된 Slack 스레드를 뒤적일 필요가 없습니다.
4. AI가 따를 프로젝트 규칙
명시되지 않은 관례를 문서화해 두면 AI가 이를 존중합니다.
제목: 프로젝트 관례
- 서비스 객체는
app/services/에 위치. - RSpec이 아니라 Minitest 사용.
- 커스텀 JS보다 Turbo Frames를 선호.
- 명확히 필요하지 않은 한 백그라운드 잡을 만들지 않음.
- 모든 API 응답은 JSON serializer 사용.
- 컨트롤러는 얇게 유지 — 로직은 모델이나 서비스에 둠.
이제 AI에게 코드를 작성해 달라고 하면 당신만의 패턴을 따르게 됩니다. 일반적인 Stack Overflow 답변이 아니라요.
5. 어차피 재사용할 코드
설정 패턴이나 배포 스크립트 같은 재사용 가능한 스니펫을 저장해 두세요.
제목: Snippet — Rack::Attack rate limiting
# config/initializers/rack_attack.rb
Rack::Attack.throttle("login/ip", limit: 10, period: 60) do |req|
req.ip if req.path == "/session" && req.post?
end다음 프로젝트에서: “지난번에 레이트 리밋을 어떻게 설정했는지 보여줘.”
AI가 스니펫을 찾아 주어, 오래된 레포지토리를 검색하지 않아도 바로 붙여넣고 수정할 수 있습니다.
작동 원리
AI는 MCP라는 프로토콜을 통해 당신의 노트를 읽을 수 있습니다. Hjarni 은 내장된 MCP 서버를 갖춘 노트‑테이킹 앱입니다.
- 임베딩 설정이 필요 없음.
- 관리해야 할 별도 시스템이 없음.
- AI가 읽을 수 있는 노트만 있으면 됨.
빠른 설정 (≈2 분)
- hjarni.com 에 가입.
- Claude 혹은 ChatGPT에서
https://hjarni.com/mcp를 커넥터로 추가. - 당신의 노트만으로 답할 수 있는 질문을 시작.
무료 플랜은 MCP 전체 접근이 가능한 25개의 노트를 제공합니다. 10개 이상의 노트를 만들면 AI가 더 이상 낯선 존재가 아니게 됩니다.