코드에서 연결까지: ForkToPost와 함께 우리의 작업 이야기를 자동화하기

Source: Dev.to

Veronika Kashtanova – @vero‑code

DEV 주말 챌린지: 커뮤니티

이것은 DEV Weekend Challenge: Community 에 대한 제출물입니다.

문제

“게시물을 쓸 힘이 너무 없어요.”
새벽 2시, 터미널이 드디어 초록색으로 바뀌고, 마지막 커밋을 푸시하면, 빈 텍스트 에디터를 바라보는 순간이 찾아옵니다. 코딩의 “서류 작업”—문서, 블로그 포스트, 스토리텔링—은 종종 어두운 저장소 안에서 사라지는데, 이는 우리가 그것을 쓸 감정적 에너지가 부족하기 때문입니다.

나는 ForkToPost를 지친 개발자들을 위해 그리고 빛을 보지 못한 저장소에 숨겨진 놀라운 코드를 가진 모든 사람들을 위해 만들었습니다.

내가 만든 것

ForkToPost는 GitHub 저장소를 바로 게시할 수 있는 DEV 포스트 초안으로 변환해 주는 AI 기반 서사 엔진입니다.

• 코드베이스, 포크, 커밋 및 프로젝트 구조를 분석합니다.
• 의도를 해석합니다(이전 Source Persona 프로젝트에서 영감을 얻음).
• DEV 기사 작성을 위한 의미 있는 시작점을 생성하여 구조적 글쓰기의 무거운 작업을 처리하고, 여러분은 개인적인 아이디어만 추가하면 됩니다.

데모

프로젝트를 탐색하고 변환이 실제로 어떻게 작동하는지 확인하세요:

👉 GitHub:

![GitHub 로고](https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fassets.dev.to%2Fassets%2Fgithub-logo-5a155e1f9a670af7944dd5e12375bc76ed542ea80224905ecaf878b9157cdefc.svg)

vero-code / forktopost
🚀 GitHub 저장소를 Gemini AI와 함께 DEV.to 스토리로 변환합니다. DEV Weekend Challenge: Community를 위해 제작되었습니다. 🔱

읽어 주셔서 감사합니다! 🎉

ForkToPost가 유용하다고 생각되시면, 레포에 별을 달거나, 이슈를 열거나, DEV에 직접 만든 이야기를 공유해 주세요. 즐거운 코딩—그리고 즐거운 글쓰기!

Source:

🔱 ForkToPost

ForkToPost은 DEV Weekend Challenge: Community를 위한 궁극적인 제출물 생성기입니다. GitHub 저장소를 매력적이고 스캔하기 쉬운 스토리로 변환하여 DEV.to 커뮤니티의 관심을 끌어냅니다.

• 가치 제안을 어떻게 표현해야 할지 고민 중인가요?
• 전문적이고 재치 있으며 읽기 쉬운 포스트를 원하시나요?

ForkToPost은 Google의 Gemini AI를 활용해 코드, README, 메타데이터를 승리 스토리로 엮어냅니다.

✨ Features

• AI‑powered copywriting – Gemini가 저장소를 기반으로 다듬어진 글을 생성합니다.
• One‑click export – DEV.to에 바로 올릴 수 있는 Markdown 파일을 다운로드합니다.
• Customizable tone – 전문, 캐주얼, 재치 있는 스타일 중 선택할 수 있습니다.
• Live preview – 입력을 조정하면서 최종 포스트를 실시간으로 확인합니다.

🚀 Getting Started

# Clone the repo
git clone https://github.com/yourusername/forktopost.git
cd forktopost

# Install dependencies
npm install

# Run the development server
npm run dev

📦 Installation (as a CLI)

npm i -g forktopost
forktopost --repo https://github.com/yourusername/awesome-project

🛠️ Usage (Web UI)

1. 보여주고 싶은 GitHub 저장소의 URL을 붙여넣습니다.
2. 톤을 선택합니다 (Professional / Casual / Witty).
3. Generate 버튼을 클릭합니다 – Gemini가 포스트를 작성합니다.
4. 미리보기를 검토하고 필요하면 편집한 뒤, Markdown 파일을 다운로드합니다.

🧩 Tech Stack

• React 19+ – UI 컴포넌트와 상태 관리.
• TypeScript 5+ – 신뢰성을 위한 강력한 타입 지정.
• Gemini AI API – 자연어 생성.

🤝 Contributing

기여를 환영합니다! 기여 가이드는 CONTRIBUTING.md를 참고해주세요.

📜 License

이 프로젝트는 MIT License 하에 라이선스됩니다 – 자세한 내용은 LICENSE 파일을 확인하세요.

✨ 기능

⚡ 주말을 위해 설계됨 – DEV 챌린지 참가자들이 품질을 희생하지 않고 촉박한 마감일을 맞출 수 있도록 설계되었습니다.

• 🤖 AI 기반 내러티브 – gemini-3-flash-preview를 사용해 저장소를 분석하고 구조화된 Markdown을 생성합니다.
• 🎨 이미지 생성 – gemini-3.1-flash-image-preview를 사용해 프로젝트에 영화 같은 시각적 은유를 만듭니다.

🧠 고급 작성 토글

• 공감 추가 – 게시물에 감정적 울림을 불어넣어 인간의 고군분투와 “아하!” 순간을 강조합니다.
• 아키텍처 심층 탐구 – 시스템의 구조화된 기술 분석을 자동으로 생성합니다.

어떻게 만들었는가

ForkToPost를 만들던 여정은 근본적인 공감의 과정이었습니다. 나는 계속 스스로에게 물었습니다: 지친 개발자가 실제로 필요로 하는 것은 무엇일까? 그 답은 복잡함이 아니라 동반자였습니다.

스택

기술 아키텍처

시스템은 Context → Extraction → Transformation 파이프라인을 따릅니다.

1. Ingestion Layer

   • 사용자가 저장소 URL을 제공합니다.
   • GitHub API가 파일 트리를 크롤링하며 README.md, package.json, 그리고 핵심 로직 디렉터리를 우선 순위로 잡습니다.

2. Context Synthesis Engine

   • “Context Scraper”가 기술 지문(스택, 규모, 주요 문제)을 추출합니다.
   • 토큰 사용량을 낮게 유지하고 초점을 높게 유지합니다.

3. Persona Layer

   • “Community‑First” 렌즈를 적용합니다(Source Persona에서 영감).
   • 감정적 훅을 찾습니다—프로젝트가 다른 개발자에게 왜 중요한지.

4. Markdown Generator

   • DEV 플랫폼에 맞게 포맷된 출력을 생성하고, 최종 다듬기를 위해 준비합니다.