AI 코딩 작업이 끝났다는 증거를 남기는 법: Moonshot Relay 워크플로우
Claude Code와 Codex 작업에서 계획, 실행, 검증, 기록을 하나의 흐름으로 묶어 끝났다고 말할 근거를 남기는 Moonshot Relay 구조를 정리합니다.
대표 글 읽기
메뉴
Moonshot Notes
AI 코딩 도구와 LLM 백엔드를 실제로 운영하기 위한 기술 노트
Claude Code, AI 코딩 에이전트 런타임, Production RAG, LLM 백엔드를 설계 원리와 운영 전략까지 다룹니다.
무엇을 해결하려고 오셨나요?
최신 글
오케스트레이션과 멀티 에이전트: 수퍼바이저와 HITL 승인 게이트
단일 에이전트의 한계를 극복하는 그래프 기반 오케스트레이션, 수퍼바이저 라우팅, 전문 서브에이전트 간 동적 핸드오프, 그리고 안전한 프로덕션 배포를 위한 HITL(Human-in-the-Loop) 승인 게이트와 트랜잭션 상태 관리 기법을 상세히 다룹니다.
도구 연동과 MCP 규격: Tool Calling과 스키마 검증
LLM Tool Calling 메커니즘부터 Model Context Protocol(MCP) 표준 규격, Pydantic v2 기반 스키마 검증, 방어적 인자 검증 체크리스트까지 엔터프라이즈 에이전트 도구 연동의 전 과정을 다룹니다.
텍스트 임베딩부터 트랜스포머까지: 현대 LLM의 핵심 연산 흐름 종합 정리
자연어 처리의 기본 원리인 텍스트 임베딩, 원핫 인코딩의 한계, RNN과 트랜스포머의 구조적 차이, 그리고 Q, K, V 셀프 어텐션 행렬 연산까지 LLM의 핵심 개념을 체계적으로 정리합니다.
에이전트 메모리와 상태 관리: 단기/장기 메모리와 컨텍스트 압축
AI 에이전트의 지속성과 추론 품질을 결정짓는 메모리 아키텍처와 상태(State) 스키마 설계, 단기/장기 메모리 연동, 그리고 컨텍스트 윈도우 압축 기법을 다룹니다.
AI 에이전트 아키텍처: 루프, 과업 분해, 그리고 추론 경계
단순한 LLM 프롬프트 호출을 넘어, 스스로 목표를 세우고 루프를 돌며 행동하는 프로덕션 레벨 AI 에이전트의 핵심 루프와 추론 경계(Reasoning Boundary)를 다룹니다.
AI 시대의 소프트웨어 엔지니어링: '이해의 병목' 극복을 위한 시스템 구현 전략
AI 에이전트가 코드를 자동 생성하는 시대, 개발의 새로운 제약으로 부상한 '이해의 병목'을 극복하기 위해 서술식 디프(Literate Diffs), 일회성 UI, MCP 공유 공간 등 구체적인 기술 아키텍처와 구현 전략을 제시합니다.
카테고리
AI Agent
오케스트레이션과 멀티 에이전트: 수퍼바이저와 HITL 승인 게이트
단일 에이전트의 한계를 극복하는 그래프 기반 오케스트레이션, 수퍼바이저 라우팅, 전문 서브에이전트 간 동적 핸드오프, 그리고 안전한 프로덕션 배포를 위한 HITL(Human-in-the-Loop) 승인 게이트와 트랜잭션 상태 관리 기법을 상세히 다룹니다.
도구 연동과 MCP 규격: Tool Calling과 스키마 검증
LLM Tool Calling 메커니즘부터 Model Context Protocol(MCP) 표준 규격, Pydantic v2 기반 스키마 검증, 방어적 인자 검증 체크리스트까지 엔터프라이즈 에이전트 도구 연동의 전 과정을 다룹니다.
에이전트 메모리와 상태 관리: 단기/장기 메모리와 컨텍스트 압축
AI 에이전트의 지속성과 추론 품질을 결정짓는 메모리 아키텍처와 상태(State) 스키마 설계, 단기/장기 메모리 연동, 그리고 컨텍스트 윈도우 압축 기법을 다룹니다.
AI Backend
RAG가 데모에서 망가지는 지점: 실제 문서, 토큰 예산, 프롬프트 인젝션
샘플 문서로 만든 RAG 흐름을 PDF, 웹 문서, Markdown 분할, token budget, prompt injection risk가 있는 운영 환경으로 옮길 때 확인할 경계를 정리합니다.
RAG 답변을 믿기 전에 봐야 할 것: 검색 평가, faithfulness, 출처 표시
RAG 답변이 그럴듯해 보여도 retriever 결과, answer faithfulness, citation, source attribution을 따로 확인해야 하는 이유와 점검 흐름을 정리합니다.
LangChain RAG 복습 04: 문서 구조를 살리는 검색 설계
LangChain RAG 학습 흐름을 따라 hybrid search, parent document retrieval, multi-vector retrieval로 검색 단위와 답변 단위를 분리하는 방법을 정리합니다.
AI Development
텍스트 임베딩부터 트랜스포머까지: 현대 LLM의 핵심 연산 흐름 종합 정리
자연어 처리의 기본 원리인 텍스트 임베딩, 원핫 인코딩의 한계, RNN과 트랜스포머의 구조적 차이, 그리고 Q, K, V 셀프 어텐션 행렬 연산까지 LLM의 핵심 개념을 체계적으로 정리합니다.
Karpathy microgpt.py 해부: GPT 학습과 추론이 한 파일에서 돌아가는 방식
Andrej Karpathy의 microgpt.py를 한 파일짜리 GPT 실행체로 해부합니다. 문자 tokenizer, scalar autograd, Q/K/V attention, Adam update, autoregressive sampling이 어떻게 연결되는지 설명합니다.
Claude 프롬프트는 질문이 아니라 작업 명세서다
Claude를 안정적으로 쓰는 첫 번째 기준은 프롬프트를 “질문”이 아니라 작업 명세서로 작성하는 것입니다.
Workflow
AI 코딩 작업이 끝났다는 증거를 남기는 법: Moonshot Relay 워크플로우
Claude Code와 Codex 작업에서 계획, 실행, 검증, 기록을 하나의 흐름으로 묶어 끝났다고 말할 근거를 남기는 Moonshot Relay 구조를 정리합니다.
사내 AI 에이전트 온보딩 가이드 만드는 법
사내에서 AI 에이전트를 적극적으로 사용하도록 만들기 위한 AX 온보딩 가이드 설계 방법을 정리합니다. 사용 사례, 보안 기준, 권한 관리, 4주 온보딩 프로그램, 실전 템플릿까지 다룹니다.
AI 시대의 개발자는 무엇을 설계해야 할까
AI 코딩 도구가 실무에 들어오면서 개발자가 새롭게 설계해야 할 컨텍스트, 도구, 권한, 검증, 추적 구조를 정리합니다.
Follow
새 글은 RSS로 받고, 글에서 반복해서 다루는 도구와 프로젝트는 GitHub와 GPT 링크로 바로 이어집니다.