2026-05-27 · 바이브코딩

AI 블로그 일일 게시를 위한 릴리즈 체크리스트

Futory의 Next.js Markdown 블로그 운영을 기준으로 매일 새 글을 추가할 때 확인해야 할 Markdown 파일, 콘텐츠 검증, 테마 검증, 빌드, PM2/Nginx 공개 확인 절차를 정리했습니다.

요약

AI와 함께 블로그를 운영할 때 가장 중요한 것은 글을 빠르게 쓰는 것보다 매일 같은 기준으로 공개 여부를 확인하는 일입니다. Futory처럼 content/posts/*.md에 Markdown 글을 추가하고 Next.js로 빌드한 뒤 PM2와 Nginx를 통해 공개하는 구조에서는 글 하나도 작은 릴리즈로 다뤄야 합니다.

이 글은 Futory 일일 게시 루틴에서 사용할 수 있는 릴리즈 체크리스트를 정리합니다. 새 글 파일을 만들고, frontmatter를 확인하고, 콘텐츠 검증과 테마 검증을 통과한 뒤, 내부 앱과 공개 도메인에서 실제 날짜가 보이는지 확인하는 흐름입니다.

왜 체크리스트가 필요한가

AI가 작성한 글은 빠르게 만들어질 수 있지만 운영 환경에 반영되는 과정은 별개의 문제입니다. 파일은 추가됐지만 빌드가 실패할 수 있고, 빌드는 성공했지만 실행 중인 프로세스가 예전 산출물을 보고 있을 수 있습니다. Nginx가 정상이어도 내부 앱 포트가 죽어 있으면 공개 페이지는 갱신되지 않습니다.

그래서 매일 게시 루틴에는 다음 기준이 필요합니다.

  • 오늘 날짜의 Markdown 파일이 추가됐는가
  • frontmatter의 title, description, date, category, tags가 올바른가
  • npm run test:content가 통과하는가
  • npm run test:theme가 통과하는가
  • npm run build가 성공하는가
  • 내부 앱 127.0.0.1:8042가 응답하는가
  • 공개 도메인 futory.oig.kr에서 오늘 날짜가 보이는가

Futory 기준 일일 릴리즈 순서

1. 공개 페이지에서 마지막 날짜 확인

먼저 실제 독자가 보는 페이지에서 마지막 게시 날짜를 확인합니다. 서버에 파일이 있다고 해서 게시가 완료된 것은 아닙니다. 공개 페이지에 보이는 날짜가 기준입니다.

curl -L https://futory.oig.kr/ | grep "2026-05"

2. Markdown 파일 추가

새 글은 기존 글과 같은 위치에 추가합니다.

/opt/futory/content/posts

파일명은 slug 중심으로 만들고, 날짜는 frontmatter의 date에 명확히 기록합니다.

3. 검증과 빌드

Futory 운영에서는 콘텐츠 검증과 테마 검증을 분리해서 확인합니다.

npm run test:content
npm run test:theme
npm run build

콘텐츠 검증은 Markdown 구조와 frontmatter를 확인하고, 테마 검증은 글 추가와 무관하게 기존 UI 기능이 깨지지 않았는지 확인합니다.

4. 앱과 공개 도메인 확인

빌드 후에는 내부 앱과 공개 도메인을 나누어 확인합니다.

curl -I http://127.0.0.1:8042/
curl -I https://futory.oig.kr/

내부 앱이 정상인데 공개 도메인만 실패하면 Nginx 문제일 가능성이 높고, 내부 앱부터 실패하면 Next.js 프로세스나 빌드 산출물 문제일 가능성이 높습니다.

마무리

일일 게시 체크리스트는 운영 속도를 늦추기 위한 문서가 아니라 실수를 줄이기 위한 기준입니다. Futory처럼 AI와 함께 운영하는 블로그에서는 매일 반복되는 작은 배포를 안정적으로 처리하는 루틴이 장기적으로 더 큰 생산성을 만듭니다.

자주 묻는 질문

체크리스트를 매일 모두 실행해야 하나요?

운영 서버에 직접 반영하는 글이라면 모두 실행하는 편이 안전합니다. 특히 test:content, test:theme, build, 공개 URL 확인은 서로 다른 문제를 잡기 때문에 생략하지 않는 것이 좋습니다.

글 파일이 있으면 게시된 것 아닌가요?

아닙니다. Next.js 블로그에서는 Markdown 파일 추가, 빌드, 실행 프로세스 반영, 공개 페이지 확인이 모두 끝나야 게시 완료라고 볼 수 있습니다.

내부 앱과 공개 도메인을 둘 다 확인하는 이유는 무엇인가요?

내부 앱은 Next.js 프로세스 상태를 보여주고, 공개 도메인은 Nginx 프록시와 외부 접근 상태를 보여줍니다. 둘을 나누어 확인하면 실패 지점을 빠르게 좁힐 수 있습니다.

결론

Futory의 일일 게시 루틴은 새 글 작성보다 검증과 공개 확인이 핵심입니다. 같은 체크리스트를 반복하면 AI와 함께 운영하는 블로그에서도 안정적인 게시 흐름을 유지할 수 있습니다.