Date: 2026-02-09 Status: Accepted
콘텐츠 모델은 flat Markdown 파일에서 글 단위 폴더 구조로 발전했다. 현재
저장소는 posts/** 아래에 글을 저장하고, 유효한 글 폴더는 본문
index.mdx와 주변 메타데이터 meta.json을 함께 가진다.
중첩된 시리즈 디렉터리도 모델의 일부다. repository 계층은 폴더를 재귀적으로 탐색하고, 라우트, 피드, 사이트맵, 검색에 글을 노출하기 전에 Zod로 메타데이터를 검증한다.
posts/**/index.mdx와 posts/**/meta.json을 표준 콘텐츠 형식으로 사용한다.
시리즈는 단일 목록으로 평탄화하지 않고 중첩 폴더로 표현한다.
- 본문과 메타데이터가 가까운 위치에 유지된다.
- 시리즈를 디렉터리 구조로 표현할 수 있다.
- repository 계층은 재귀 탐색과 검증을 보존해야 한다.
- 새 글 생성 도구는 두 파일을 모두 만들어야 한다.
- flat
posts/*.mdx: 탐색은 단순하지만 시리즈와 주변 자산 관리에 약하다. - frontmatter-only MDX: 파일 수는 줄지만 메타데이터 검증과 정책 검사가 약해진다.
- 외부 CMS: 편집 UI는 좋아지지만 이 프로젝트에는 운영 비용이 과하다.
1e5355d(2026-02-09): SEO 친화적 콘텐츠 폴더와 slug 도입.1cd4e06(2026-02-13): 시리즈와 조회수 통합 확장.5be50b5(2026-02-28): 표준 콘텐츠 루트를content/에서posts/로 이동.21a4a6a(2026-04-14): 메타데이터 정책과 글 스캐폴딩 변경.