Step 1. 개요, 블로그 기획하기

들어가며

요즘같은 AI 시대에 본인의 강점을 어필하기는 쉽지 않은 것 같습니다. 그래서 AI와 함께 구현한 프로젝트를 어떤 흐름으로 진행하였는지에 대한 기록을 남겨보려 합니다.

이 글을 보시는 분들도 이 포스팅 조차 직접 작성한 건지, AI가 작성한 건지 명확히 판단할 수 없습니다.도움은 받겠지만 블로그만큼은 힘 닿는 데까지 직접 작성해보려 합니다.

블로그 개설 후 첫 글은 이 블로그를 만드는 이야기입니다.

1. 왜 직접 만들었나

이전에는 티스토리에 글을 썼습니다. 불편했던 건 스킨이나 광고보다도 글이 제 손을 떠나 있다는 느낌이었습니다.

백업을 받아보면 글 한 편이 HTML 덩어리로 나옵니다. 문단마다 인라인 스타일이 붙어 있고 이미지는 플랫폼 주소를 가리킵니다. 다른 곳으로 옮기려면 그걸 다시 파싱해야 합니다.

여기에 글 쓰는 방식이나 기능 자유도, AI로 인한 빠른 개발 및 검수 등등, 커스텀에 제약이 있는 부분도 블로그 구현을 선택하게 된데에 많은 영향이 있었습니다.

이 블로그의 문서관리 규칙은 다음과 같습니다.

• 본문은 마크다운 평문으로 보관한다. 렌더링 결과가 아니라 원문을 저장한다.
• 이미지는 본문에서 /posts/<slug>/<파일> 상대 경로로만 가리킨다. 실제 저장 위치는 본문이 모른다.

옵시디언처럼 md파일을 그대로 저장하고 실시간 렌더하는 툴들에서 아이디어를 얻었고, 기존에도 마크다운으로 작성된 문서들을 좋아하여 이 방식들을 채택하였습니다.

2. 한방 프롬프트를 버리기

AI를 사용해오면서 가장 크게 느꼈던 건 "블로그 만들어줘" 같은 한방 프롬프트의 한계입니다. 입력한 프롬프트에 비하면 훌륭한 작업물을 산출해주지만, 대부분 뜻하는 대로 되지 않습니다. 이후에 기능과 디자인을 하나하나 고쳐가며 디버깅하는 작업때문에 훨씬 많은 시간을 소요하게 됩니다.

그래서 작업순서를 체계화하고 고정했습니다.

claude-design을 적극적으로 채용해 디자인 시스템과 와이어프레임을 먼저 잡았고, 충분히 만족할 만한 형태가 나온 다음에 구현을 진행했습니다. 이 과정은 다음 편에서 디테일하게 다루겠습니다.

3. 요구사항을 인터뷰 형식으로 분해

큰 질문 하나를 작은 질문 여러 개로 쪼갰습니다.

• 개발 환경은? 서버는?
• 카테고리 구조는 플랫인가, 서브 카테고리까지인가?
• 마크다운인가, MDX인가?
• 댓글은 어떤 형식으로 구현할건가?
• 티스토리에서 어떻게 옮겨올 것인가?

물론 이외에도 진행하면서 결정해야 하는 것, 변경되어야 할 것들도 수두룩합니다. 다만 이 단계에서 최대한 상세히 정의해두면 불필요한 수정을 줄일 수 있습니다.

4. AGENTS.md / CLAUDE.md와 같은 에이전트 지침 SSOT로 운영 룰 고정

CLAUDE.md 에는 응답 언어, 커밋 컨벤션, UI 라벨에 이모지 금지 같은 개인 규칙을 작성하였습니다. 한 번 적어두면 매 세션 반복하여 프롬프팅 하지 않아도 됩니다.

5. 정본 기획문서 작성

5.1. 기획 문서

항상 정본으로 참조할 수 있는 기획문서를 만들고, 변경사항이 생겼을때 최신화하여, 이미 한 결정이 누락되거나 변형되는 일이 없도록 하였습니다. 여기에는 목표, 배경, 스택과 디자인 등 실제 최신 기준의 스펙과 결정사항을 기록합니다. 특히 블로그 프로젝트를 시작하며, 있으면 좋겠다했던 기능들과 꼭 구현되어야 하는 기능들을 적어두었습니다

5.2. 개발 로드맵

개발을 진행하며 현재 어떤 단계인지, 어떤 작업이 남았는지 방향을 잃지 않고 파악이 가능하도록 로드맵을 작성하고 기록/추적합니다.

닫으며

기획 단계에서 남은 산출물은 코드가 아니라 문서입니다.
다음 단계는 디자인입니다.