Engineering Note
AI와 함께 쓰는 기술글 발행 흐름
Codex 또는 Claude Code로 초안을 만들 때 필요한 검수 단계와 PR 기반 발행 절차를 정리합니다.
AI 도구는 기술블로그의 시작 속도를 크게 높여줍니다. 하지만 발행 책임까지 넘길 수는 없습니다.
Pletor 기술블로그의 기본 흐름은 다음과 같습니다.
- 담당자가 주제, 독자, 핵심 메시지를 짧게 적습니다.
- Codex 또는 Claude Code로 초안, 코드 예시, 제목 후보를 만듭니다.
- 담당 엔지니어가 사실관계, 코드 실행 가능성, 보안 표현을 검수합니다.
- 한국어와 영어 글을 같은
translationKey로 맞춥니다. - GitHub PR에서 문장, 링크, 이미지, SEO 메타데이터를 리뷰합니다.
- Cloudflare Pages 미리보기에서 레이아웃을 확인한 뒤 병합합니다.
이 블로그에는 Pletor가 Konduo를 만들며 쌓는 운영 플랫폼, 인프라, 메트릭, 알림, 플러그인 설계 경험도 함께 정리합니다. Konduo는 여러 IT 인프라의 상태 확인과 메트릭·로그 근거, 알림 대응, 권한과 운영 이력을 하나의 흐름으로 연결하는 통합 관리 운영 플랫폼입니다.
frontmatter 기준
모든 글은 최소한 다음 메타데이터를 포함합니다.
title: "글 제목"
description: "검색과 공유 카드에 쓰일 한 문장 요약"
published: "2026-06-17"
author: "Pletor Engineering"
lang: "ko"
translationKey: "stable-post-key"
tags: ["security", "data"]
draft: false
외부 채널에 재게시할 때는 원문 URL을 canonical로 설정합니다. 원문 페이지는 자기 자신을 canonical로 두고, 외부 채널은 원문을 가리키게 하는 방식입니다.
함께 읽기 좋은 글
이 글의 관점과 이어지는 주제를 더 보려면 아래 글도 함께 읽어볼 수 있습니다.
- Pletor 기술블로그를 시작하며 - 기술블로그가 다루려는 운영과 제품 관점을 소개합니다.
- Kafka는 메모리가 남아 있는데 왜 OOM이 났을까 - heap 밖 direct buffer까지 포함해 Kafka broker 메모리를 다시 봅니다.
- 수정하지 않을 YAML 로그를 왜 전부 객체로 만들까 - immutable 로그를 전체 객체로 만들지 않고 선별하는 관점을 다룹니다.