프로젝트 보육원

Source: Dev.to

커서에게 복사할 자체 패턴 제공하기

AI는 패턴을 복사하는 데는 꽤 능숙합니다. 하지만 새롭게 발명하는 데는 그다지 뛰어나지 않죠. 빈 캔버스를 주고 “서비스 레이어를 만들어줘”라고 하면 일반적인 결과를 얻을 수는 있지만… 아마도 괜찮을지는 몰라도 여러분이 직접 할 방식은 아닐 겁니다. 여러분이 좋아하는 방식으로 이미 동작하는 코드를 가리키면, AI는 그 코드를 복사합니다.

인사이트

뒤돌아보면 당연한 이야기지만, 제가 깨닫는 데는 시간이 좀 걸렸습니다. 저는 새 프로젝트를 처음부터 시작하면서 원하는 것을 설명하고, 그럭저럭 괜찮은 결과를 얻곤 했습니다. 그 사이에 제가 시간이 지나면서 다듬어 온 여러 작업 프로젝트가 그대로 남아 있었거든요.

프로젝트 심링크하기

제가 이 개념을 깨달은 트릭은 기존 프로젝트들을 새 프로젝트와 같은 상위 폴더에 심링크(symlink)하는 것이었습니다:

mkdir ~/projects/nursery

그 다음 그 폴더를 Cursor에서 열었습니다. 이제 “flow‑myna처럼 인증 컨텍스트를 만들고 싶어” 혹은 “leveloh와 같은 Alembic 마이그레이션 설정을 사용해” 라고 말하면, Cursor가 해당 폴더/파일들을 볼 수 있게 됩니다. 다른 코딩‑에이전트 환경에서는 어떻게 되는지는 잘 모르겠지만, 이 트릭 덕분에 Cursor 안에서 관리가 훨씬 쉬워졌습니다.

심링크에 대한 좋은 점 하나는: Cursor가 심링크된 폴더 안의 파일을 편집하려 할 때 확인을 요청한다는 것입니다. 그래서 참조 프로젝트가 보호됩니다… AI가 파일을 읽을 수는 있지만 실수로 수정하지는 않으며, 수정이 필요하면 직접 허용하면 됩니다.

저는 이 폴더를 새로운 프로젝트를 위한 보육원(nursery) 으로 생각합니다. 다른 프로젝트들은 템플릿이 아니라… 단지 눈에 보이는 실제 동작 코드일 뿐입니다. 각각은 필요에 따라 다른 방향으로 갈라졌습니다. 어떤 프로젝트는 인증이 있고, 어떤 프로젝트는 없고. 어떤 것은 결제 처리를 포함하고, 다른 것은 정적 사이트일 뿐입니다.

보일러플레이트보다 더 잘 작동하는 이유

보일러플레이트 레포를 유지하는 것과는 다릅니다. 보일러플레이트를 만들 때는 앞으로 필요할 것을 미리 예상하고 재사용 가능한 형태로 추상화하려고 합니다. 이는 초기 작업이 많이 들고, 6개월 뒤면 여러분의 선호도가 이미 바뀌어 있을 가능성이 높습니다.

여기서는 유지할 것이 전혀 없습니다. 각 프로젝트는 그 자체입니다. 새로운 무언가를 시작할 때 저는 AI에게 “다른 프로젝트가 X를 어떻게 처리하는지 보고 비슷하게 해줘” 라고 말합니다. AI는 복사를 수행하고, 이번에 실제로 필요한 것에 맞게 조정합니다.

제가 직접 만든 코드를 사용할 때는 이미 패턴을 알고 있습니다. 왜 그런 구조를 가지고 있는지, 문제가 생겼을 때 어디를 보면 되는지도 압니다.

다른 사람의 보일러플레이트를 사용할 경우, 여러분은 그들의 관습을 배우면서 무언가를 만들게 됩니다. AI는 어떤 부분이 핵심이고 어떤 부분이 단순히 선호도인지 알지 못합니다. 모든 것이 이미 익숙할 때가 더 쉽습니다.

스택 및 예시 프로젝트

컨텍스트를 위한 제 스택:

• 프론트엔드: Tailwind와 함께하는 Next.js 14
• 백엔드: FastAPI와 PostgreSQL

특별한 점은 없습니다… 그냥 제가 이전에 사용해 본 것들이고, 동작하는 예제가 있는 것들입니다.

몇 년 동안 간단한 메트릭 서비스 아이디어(사용자가 차트 이름과 값을 POST 하면 차트가 자동으로 생성되는 서비스) 때문에 도메인을 잡아두고 있었는데, 프로젝트 규모가 몇 주가 걸릴 것 같아 계속 미루었습니다. 이 설정을 이용하면 며칠에 걸쳐 약 8시간 정도면 충분했습니다. 서비스는 spikelog.com 에서 확인할 수 있습니다.

결론

이 방법이 모든 사람의 워크플로에 적용되는지는 모르겠지만, 핵심 아이디어는 타당해 보입니다: 시간이 지나면서 쌓아온 패턴을 재사용할 가치가 있으며, 이를 AI에게 보이게 하는 것이 쉬운 방법이라는 점입니다. 앞으로는 새 프로젝트를 이렇게 시작할 예정입니다.