문서 분석 및 블로그 포스트 작성

분석 대상: $ARGUMENTS

1단계: 대상 문서 수집

인자로 전달된 경로에서 문서를 수집합니다.

인자 형태별 처리

인자 형태	예시	처리
디렉토리	`/path/to/docs`	하위 모든 문서 파일 수집
glob 패턴	`/path/*/.md`	패턴에 맞는 파일 수집
파일 목록	`file1.md file2.md`	지정된 파일만 수집

문서 파일 탐색

bash

# 디렉토리인 경우 문서 파일 찾기
find $ARGUMENTS -type f \( -name "*.md" -o -name "*.mdx" -o -name "*.txt" -o -name "*.rst" \) | head -30

# 파일 수 확인
find $ARGUMENTS -type f \( -name "*.md" -o -name "*.mdx" \) | wc -l

2단계: 문서 내용 분석

2.1 전체 문서 읽기

수집된 모든 문서를 읽고 내용을 파악합니다:

•각 문서의 제목과 핵심 내용
•문서 간의 관계와 흐름
•공통 주제 또는 기술 키워드 추출

2.2 주제 분류

문서들을 분석하여 블로그 포스트로 작성할 주제를 도출합니다:

분류 기준	포스트 유형
기술 스택 설명	기술 소개/비교 포스트
설계 문서	아키텍처/설계 결정 포스트
트러블슈팅 기록	문제 해결 포스트
API/기능 명세	튜토리얼/가이드 포스트
회의록/회고	회고/인사이트 포스트
학습 노트	TIL/학습 정리 포스트

2.3 핵심 내용 추출

각 주제별로 다음을 정리:

•배경: 왜 이 기술/방법을 선택했는지
•내용: 핵심 개념과 구현 방법
•결과: 적용 결과와 배운 점
•코드: 참고할 만한 코드 예제

3단계: 포스트 구성안 제시

사용자에게 작성할 포스트의 구성안을 제시하고 확인합니다:

code

제안 포스트 목록:

1. <제목 1>
   - 주제: ...
   - 참조 문서: ...
   - 예상 분량: ...

2. <제목 2>
   - 주제: ...
   - 참조 문서: ...
   - 예상 분량: ...

확인 사항:

•포스트 개수와 주제가 적절한지
•추가/제외할 주제가 있는지
•포스트 톤앤매너 (기술 블로그, 회고, 튜토리얼 등)
•slug 이름 (파일명)

4단계: MDX 포스트 작성

_posts/<slug>.mdx 파일을 작성합니다.

Frontmatter 형식

yaml

---
title: '<포스트 제목>'
date: '<YYYY-MM-DD>'
description: '<한줄 요약>'
tags: ['<태그1>', '<태그2>', ...]
---

포스트 유형별 본문 구조

기술 소개/비교 포스트

markdown

# <제목>

## 배경

왜 이 기술을 도입했는지, 어떤 문제를 해결하려 했는지

## 핵심 개념

기술의 주요 개념 설명

## 적용 방법

실제 프로젝트에 적용한 방법과 코드 예제

## 비교/장단점

다른 대안과의 비교, 장단점 분석

## 마무리

정리 및 추천 사용 사례

문제 해결 포스트

markdown

# <제목>

## 문제 상황

어떤 문제가 발생했는지 구체적으로 설명

## 원인 분석

문제의 근본 원인 파악 과정

## 해결 방법

단계별 해결 과정과 코드

## 결과

해결 후 개선된 점

## 배운 점

이 경험에서 얻은 인사이트

회고 포스트

markdown

# <제목>

## 프로젝트 개요

프로젝트 간략 소개

## 잘한 점

성공적이었던 부분

## 아쉬운 점

개선이 필요한 부분

## 배운 점

기술적/비기술적 학습

## 다음 단계

향후 계획

작성 규칙

•한국어로 작성
•기술 용어는 영문 유지
•원본 문서의 사실을 기반으로 작성 (창작 금지)
•코드 예제는 원본에서 발췌하거나 단순화
•독자가 컨텍스트 없이도 이해할 수 있도록 작성
•내부 기밀이나 민감 정보 제외

5단계: 결과 보고

code

분석 문서 수: N개
생성된 포스트: M개

파일	제목	태그
`_posts/<slug>.mdx`	<제목>	<태그>