Jenkins 10. Jenkins에서 Kubernetes 배포로 연결할 때 경계는 어디에 두는가
Jenkins가 Docker 이미지를 만들고 Kubernetes가 원하는 상태를 맞추는 구조로 CI/CD 경계를 나누는 글.
AI coding agent 운영, 보안 분석, Rust, DevOps 기록
AI coding agent 운영·검증·보안, 보안 분석, Rust, DevOps를 다루는 기술 블로그입니다. Codex, Claude Code, AGENTS.md, CLAUDE.md, MCP, hooks, permissions/settings, token/context 관리와 실무 기반 글을 한국어와 영어로 정리합니다.
다루는 내용
AI coding agent 운영과 검증
Codex와 Claude Code를 코드 생성기가 아니라 권한, 검증, 작업 요청, 프로젝트 지침으로 운영하는 글을 먼저 배치했다.
- AI Engineering 허브: 코딩 에이전트 운영과 검증 AI 코딩 도구를 실행 환경, 권한 경계, 검증 흐름, handoff 계약으로 다루는 허브.
- AI agent 운영 실전 템플릿 AGENTS.md, CLAUDE.md, Codex 작업 요청, permissions/settings 기준 글을 한곳에 묶은 진입점.
- AGENTS.md 작성법 Codex가 먼저 읽을 저장소 목적, 수정 경계, 검증 기준을 짧게 정리하는 방법.
- CLAUDE.md 작성 범위 Claude Code 지침 파일에 남길 기준과 settings/hooks로 내려보낼 기준을 나누는 글.
- Codex 프로젝트 운영 템플릿 저장소에 Codex를 적용할 때 작업 요청, 검증, 완료 보고 기준을 묶는 운영 템플릿.
- Claude Code permissions/settings 기준 자연어 지시와 settings, permissions의 책임을 나누어 작업 경계를 고정하는 기준.
다른 트랙 대표 글
Rust, DevOps, Security 대표 글은 아래 트랙으로 분리했다.
Rust Track
- Rust 입문: 설치와 Hello World Rust를 처음 여는 독자가 rustup, rustc, cargo의 역할을 잡는 시작 글.
- Rust 실전 연결: 작은 CLI 프로젝트 기초 문법을 word counter CLI로 묶어 시리즈를 이어 읽게 하는 글.
DevOps Track
- Docker build cache와 invalidation Dockerfile 변경과 build cache가 이미지 재빌드에 미치는 영향을 정리한 글.
Security Track
- 매크로 문서형 악성코드 분석 DOCM 샘플의 진입점, 난독화, CustomXML 페이로드, 실행 체인을 따라가는 분석.
- RTF 문서형 악성코드 분석 RTF/OLE 구조와 Equation Editor exploit 흐름을 근거 중심으로 추적한 분석.
최근 포스트
Jenkins 장애 트러블슈팅 가이드: queue, agent, credential, plugin, Pipeline 원인 분리
Jenkins 빌드 실패가 났을 때 queue, agent, credential, plugin, Pipeline 중 어디서 먼저 원인을 좁힐지 정리한 운영용 트러블슈팅 가이드.
Jenkins 08. Jenkins에서 Docker 이미지 빌드와 레지스트리 푸시
Jenkins Pipeline에서 Docker 이미지를 빌드하고 registry로 push할 때 tag, credential, agent 경계를 정리한 글.
Jenkins 07. Jenkinsfile 실전 environment, parameters, when
Jenkinsfile에서 환경 변수, 사용자 입력값, 조건부 stage 실행을 다루는 기본 기준을 정리한 글.
Jenkins 06. Jenkinsfile 읽기: agent, stages, steps, post를 어떻게 구분할까
Jenkinsfile을 처음 읽는 사람이 agent, stages, steps, post 블록을 실행 흐름 기준으로 구분하는 방법을 정리한 글.
Jenkins 05. Declarative Pipeline 입문
Jenkins Declarative Pipeline을 Scripted Pipeline과 구분하고 초급자가 먼저 익혀야 할 이유를 설명한 글.
Jenkins 04. Freestyle Job과 Pipeline은 무엇이 다른가
Jenkins Freestyle Job과 Pipeline을 UI 설정과 코드 기반 자동화라는 관점에서 비교한 글.
Jenkins 03. 플러그인, credentials, tools를 어떻게 관리해야 하는가
Jenkins plugin, credentials, tools를 편의 기능이 아니라 운영 표면으로 보고 관리 기준을 정리한 글.
Jenkins 02. Jenkins 설치와 초기 설정
Jenkins 설치 방식을 고르기 전에 Java 요구사항, JENKINS_HOME, 초기 비밀번호, plugin 선택을 점검하는 글.
Jenkins 01. Jenkins는 무엇이고 왜 아직도 많이 쓰이는가
Jenkins를 Git, Docker 이후의 CI/CD 자동화 도구로 이해하고 controller, agent, plugin, Pipeline의 역할을 정리한 글.
Git 08. PR/MR 기반 협업 흐름과 리뷰 기준
Pull request와 merge request를 Git branch 협업 흐름 위에서 이해하고 리뷰 기준을 정리한 글.
Git 07. tag와 release로 Docker 이미지 버전과 배포 이력 연결하기
Git tag, GitHub release, Docker image tag를 구분하고 배포 이력으로 연결하는 기준을 정리한 글.
Git 06. rebase, squash, force push를 조심해서 다뤄야 하는 이유
Git rebase와 squash가 history를 어떻게 바꾸는지, force push를 언제 조심해야 하는지 정리한 글.
Git 05. conflict를 재현하고 해결하는 기본 절차
Git merge conflict가 왜 발생하는지와 status, 파일 수정, add, commit으로 해결하는 기본 절차를 정리한 글.
Git 04. remote, fetch, pull, push를 분리해서 이해하기
Git 원격 저장소 흐름을 remote, fetch, pull, push 명령의 역할별로 나눠 정리한 글.
Git 03. branch와 merge는 언제 어떻게 써야 하는가
Git branch와 merge를 폴더 복사본이 아니라 개발 흐름과 이력 연결 관점에서 이해하는 글.
Git 02. status, diff, add, commit, log로 변경 흐름 이해하기
Git의 기본 변경 흐름을 status, diff, add, commit, log 명령으로 나눠 초급자 관점에서 정리한 글.
Git 01. Git은 무엇을 기록하고 무엇을 기록하지 않는가
Git이 commit, index, working tree를 어떻게 다루는지와 Git이 자동으로 보장하지 않는 영역을 초급자 관점에서 정리한 글.
Claude Code 프로젝트 운영 템플릿: CLAUDE.md, rules, skills, settings 묶기
Claude Code를 프로젝트에 적용할 때 CLAUDE.md, AGENTS.md, rules, skills, settings, hooks, MCP, subagent 기준을 묶은 운영 템플릿.
Claude Code subagent 사용 기준: 전문 에이전트를 언제 분리할까
Claude Code subagent를 언제 쓰고 언제 쓰지 말아야 하는지 판단하는 기준.
Claude Code context budget: 긴 로그, 이슈, auto memory 관리 기준
Claude Code에서 긴 로그, 이슈, auto memory를 문맥 예산 안에서 다루는 기준.
Claude Code MCP 운영: 외부 문맥을 붙여 넣지 않고 연결하는 법
Claude Code에서 긴 외부 자료를 붙여 넣는 대신 MCP로 필요한 문맥을 연결하는 운영 기준.
Claude Code hooks 활용: 검증과 guardrail을 자동화하는 기준
Claude Code hooks를 검증, 차단, 완료 보고 점검에 사용하는 운영 기준을 정리한 글.
Claude Code permissions/settings 기준: 작업 경계를 고정하는 법
Claude Code에서 자연어 지시와 settings, permissions의 책임을 나누어 작업 경계를 고정하는 방법.
Claude Code rules와 skills 기준: 지시를 언제 로드할지 나누기
Claude Code에서 CLAUDE.md, .claude/rules, skills의 책임을 나누어 instruction loading을 관리하는 방법.
Claude Code와 AGENTS.md 병행 운영: 중복 없이 CLAUDE.md 연결하기
AGENTS.md를 이미 쓰는 저장소에서 Claude Code의 CLAUDE.md를 중복 없이 연결하는 방법.
CLAUDE.md 작성 범위: rules, skills, settings로 나누는 기준
Claude Code의 CLAUDE.md에 무엇을 넣고 무엇을 rules, skills, settings로 내려야 하는지 정리한 글.
Claude Code 운영 구조: 기능 목록이 아니라 하네스로 이해하기
Claude Code를 기능 목록이 아니라 CLAUDE.md, rules, skills, settings, hooks, MCP, subagent가 만드는 운영 구조로 이해하기 위한 첫 기준.
Codex 프로젝트 운영 템플릿: 요청, AGENTS.md, config, skill, 검증 묶기
Codex를 실제 프로젝트에 적용할 때 작업 요청, AGENTS.md, config, skill, subagent 기준을 하나로 묶은 운영 템플릿.
Codex subagent 사용 기준: 병렬 에이전트를 언제 써야 하나
Codex subagent를 병렬성과 전문화가 실제 이득을 줄 때만 사용해야 하는 이유와 판단 기준을 정리한 글.
Codex skill 사용 기준: 반복 작업을 언제 표준화할까
Codex에서 반복되는 작성, 리뷰, 릴리스 절차를 skill로 분리해 표준화하는 기준을 설명한 글.
Codex config 운영: 모델, 권한, sandbox를 고정해 일관성 확보하기
Codex 반복 작업에서 모델, 권한, sandbox, MCP 같은 설정을 config로 고정해야 하는 이유를 정리한 글.
Codex plan-first 운영: 수정 전 범위와 검증을 고정하는 법
복잡한 Codex 작업을 바로 수정하지 않고 계획, 위험, 검증 방법부터 정리하게 하는 운영 방식을 설명한 글.
AGENTS.md 작성법: 짧게 쓰는 기준과 분리 예시
좋은 AGENTS.md가 길어지면 왜 토큰 비용, 중복 지시, 책임 혼합이 커지는지 설명한 글.
AGENTS.md 작성법: Codex가 먼저 읽을 운영 기준을 짧게 쓰기
Codex용 AGENTS.md에 저장소 목적, 우선 확인 경로, 작업 원칙, 검증 기준을 어떻게 담을지 설명한 글.
Codex 작업 요청 작성법: 목표, 범위, 검증 기준을 담는 법
Codex 첫 작업 요청에 목표, 범위, 제약, 완료 기준, 검증 방법을 어떻게 담아야 하는지 정리한 글.
Everything Claude Code가 뜬 이유: Claude Code를 운영 시스템으로 바꾸는 저장소
168K stars를 받은 Everything Claude Code 저장소를 코드 구조, Claude Code 공식 확장 방향, 외부 글과 보안 이슈를 기준으로 정리한다.
Codex 하네스 설계: 좋은 요청만으로 부족한 이유
Codex 결과를 안정화하려면 좋은 요청뿐 아니라 프로젝트 규칙, 권한, 검증 구조가 필요한 이유를 설명한 글.
Codex 운영 기준: 코드 생성기가 아니라 작업 수행 에이전트로 보기
Codex를 단순 코드 생성기가 아니라 저장소 작업을 수행하는 에이전트로 다뤄야 하는 이유를 정리한 글.
Docker 05. 레지스트리 푸시와 배포용 이미지 관리 기준
Docker registry, repository, tag, push 흐름과 배포용 이미지 관리 기준을 초급자 관점에서 정리한 글.
Codex와 Claude Code 토큰 관리 전략: 컨텍스트 소비 방식의 차이
하네스 엔지니어링의 공통 원칙은 유지하되, Codex와 Claude Code의 문맥 소비 방식 차이에 맞춰 토큰 관리 전략을 어떻게 조정해야 하는지 설명한 글.
Docker 04. 이미지 빌드가 느려지는 이유와 캐시가 깨지는 지점
Docker build cache가 어떻게 재사용되고 언제 invalidation되는지, Dockerfile 순서가 왜 중요한지 정리한 글.
Agent context 압축 기준: 무엇을 남기고 무엇을 버릴 것인가
토큰 절약에서 중요한 것은 무조건 삭제가 아니라, 핵심 정보를 보존한 채 정보 밀도와 우선순위를 높이는 압축이라는 점을 설명한 글.
Docker 03. Dockerfile 기본 문법과 build context를 어떻게 이해해야 하는가
Dockerfile, WORKDIR, CMD, ENTRYPOINT, build context, .dockerignore를 초급자 관점에서 정리한 글.
Working state summary 설계: 토큰을 줄이고 작업 맥락을 유지하는 법
전체 히스토리 대신 현재 작업을 직접 제어하는 working state를 어떻게 설계해야 하는지 설명한 글.
Docker 02. 이미지, 레이어, 태그, digest를 어떻게 이해해야 하는가
Docker image, layer, tag, digest의 차이와 배포 시 무엇을 가변 값으로 두고 무엇을 고정해야 하는지 정리한 글.
Agent context 비대화: 긴 로그, 긴 계획, 긴 memory가 만드는 문제
로그, 계획, 메모리, 이전 대화가 왜 agent 컨텍스트를 비대하게 만들고 실행 품질을 떨어뜨리는지 구조적으로 설명한 글.
Docker 01. 컨테이너와 VM은 무엇이 다른가
Docker 컨테이너를 VM과 비교하면서 이미지, writable layer, volume, bind mount까지 초급자 관점으로 정리한 글.
AGENTS.md와 CLAUDE.md 토큰 낭비: 긴 지시 파일의 공통 문제
AGENTS.md, CLAUDE.md, 시스템 프롬프트가 왜 쉽게 비대해지고 토큰 낭비와 실행 품질 저하를 함께 만드는지 구조적으로 설명한 글.
Rust 13. 작은 CLI 프로젝트 만들기
지금까지 배운 Rust 기초를 묶어 작은 word counter CLI를 만드는 실전 가이드.
AI 에이전트 토큰 관리: 비용보다 중요한 컨텍스트 안정성
토큰 관리를 비용 절약이 아니라 agent 시스템의 안정성, 지연, 문맥 제어 문제로 설명한 글.
Rust 12. Serde로 JSON/TOML 다루기
serde, serde_json, toml로 Rust 타입과 JSON/TOML 데이터를 직렬화·역직렬화하는 기초 가이드.
Observable harness 전환: 문서 중심 agent 운영을 검증 가능하게 바꾸기
문서 중심 운영에서 관측 가능한 하네스로 옮겨 가는 실전 전환 로드맵을 정리한 글.
Rust 11. 파일 I/O와 커맨드라인 입력
std::fs::read_to_string, write, std::env::args, Result를 이용해 파일과 CLI 입력을 다루는 Rust 가이드.
Agent approval과 guardrail 경계: 비어 있으면 시스템이 흔들리는 이유
approval 경계와 guardrail이 비어 있을 때 agent 시스템이 흔들리는 이유를 다루는 글.
Rust 10. Rust 테스트 기초
cargo test, unit test, integration test, assert_eq!, Result 반환 테스트를 익히는 Rust 테스트 입문 가이드.
Agent trace 설계: 결과보다 실행 기록이 중요한 이유
결과만으로는 부족하고 trace가 필요한 이유를 운영, 디버깅, 평가 관점에서 설명한 글.
Rust 09. Crate, Package, 프로젝트 구조 이해하기
Cargo 프로젝트에서 crate, package, main.rs, lib.rs, mod, use, pub 구조를 익히는 Rust 가이드.
하네스 enforcement 설계: 자연어 원칙을 시스템 규칙으로 바꾸기
자연어 원칙을 실제 시스템 규칙과 강제 장치로 옮기는 방법을 다루는 글.
Rust 08. Vec, String, &str, HashMap 기초
Vec, String, &str, HashMap를 예제로 익히고 단어 빈도 수 예제로 연결하는 Rust 기초 가이드.
멀티에이전트 사용 기준: 기본값이 아니라 선택지로 다루기
멀티에이전트 구성이 항상 정답이 아닌 이유와 단일 에이전트 기준선을 설명한 글.
Rust 07. Modules, Smart Pointers, Concurrency, Async 기초
module, smart pointer, concurrency, async를 예제로 익히는 Rust 기초 가이드.
AI agent 검증 루프: build와 test만으로 부족한 이유
build와 test만으로 agent 작업을 검증하기 어려운 이유와 추가 검증 계층을 설명한 글.
Rust 06. Generics, Error Handling, Closures, Iterators 기초
generics, error handling, closure, iterator를 예제로 익히는 Rust 기초 가이드.
Handoff schema 설계: 자유 서술을 검증 가능한 계약으로 바꾸기
handoff를 자유 서술이 아니라 schema 기반 계약으로 바꾸는 이유와 설계 포인트를 정리한 글.
Rust 05. Structs, Enums, Pattern Matching, Traits 기초
struct, enum, pattern matching, trait을 예제로 익히는 Rust 기초 가이드.
프로젝트 지침 파일 범위: AGENTS.md와 CLAUDE.md가 하네스가 되면 안 되는 이유
프로젝트 지침 파일이 어디까지 책임져야 하는지와 하네스와의 경계를 다루는 글.
하네스 엔지니어링 개념: AI 에이전트 실행 환경 설계
하네스 엔지니어링을 AI 주변의 도구, 권한, 검증 구조 설계라는 관점에서 설명한 글.
AI 코딩 도구 결과 차이: 프롬프트 밖의 하네스 변수
AI 코딩 도구를 바꿀 때 결과가 달라지는 이유를 프롬프트 밖의 실행 환경 관점에서 설명한 글.
Rust 04. Ownership, Borrowing, Lifetime 기초
소유권, 대여, 수명 규칙을 예제로 설명하는 Rust 기초 가이드.
Rust 03. 변수, 타입, 제어흐름, 함수 기초
Rust의 변수, 기본 타입, 제어 흐름, 함수를 예제로 정리한 기초 문법 가이드.
Rust 02. rust-analyzer와 CodeLLDB로 디버깅하기
rust-analyzer와 CodeLLDB로 Rust 프로젝트를 디버깅하는 VS Code 실전 가이드.
Rust 01. 설치와 Hello World 실행하기
Windows와 VS Code 기준으로 Rust를 설치하고 Hello World를 실행하는 입문 가이드.
[RTF] 문서형 악성코드 분석
RTF 문서형 악성코드 샘플의 exploit 흐름과 실행 과정을 분석한 글.
[Macro] 문서형 악성코드 분석
매크로 기반 문서형 악성코드 샘플의 실행 흐름과 드로퍼 동작을 분석한 글.