전체 글 308

[AI 에이전트] GitHub Actions CI 게이트와 워크플로 권한, 시크릿 관리

이전 포스팅에서 Stop hook으로 테스트가 통과해야만 Claude가 작업을 끝낼 수 있게 하는 게이트를 만들었다.https://hsunnystory.tistory.com/326이 게이트는 Claude Code가 실행될 때만 동작한다. 사람이 직접 커밋하거나 hook 설정을 끄면 검증 없이 저장소에 들어간다. 이번 포스팅에선 push되는 변경을 서버에서 검사하는 CI 게이트를 GitHub Actions로 구성하고, 워크플로에 주는 권한과 시크릿 관리 방법을 정리한다.공식 문서 내용은 2026년 11월 19일 기준으로 정리한다.1. 로컬 게이트와 서버 게이트로컬 hook 게이트와 CI 게이트는 같은 테스트를 돌리지만 실행되는 위치가 다르다.구분로컬 hook 게이트CI 게이트실행 위치개발자 PC의 Clau..

AI 09:52:50

[AI 에이전트] Claude Code hooks와 검증 게이트 (Stop hook)

이전 포스팅에서 CLAUDE.md와 스킬로 에이전트에게 규칙과 절차를 전달하는 방법을 정리했다. 규칙 파일은 컨텍스트에 들어가는 지시이고, 그 지시를 따를지는 결국 모델이 판단한다.https://hsunnystory.tistory.com/325이번 포스팅에서는 모델의 판단에 맡기지 않고 하네스가 직접 검증하는 장치인 hooks를 정리하고, 테스트가 통과해야만 작업을 끝낼 수 있게 하는 검증 게이트에 대해 정리한다.공식 문서 내용은 2026년 11월 18일 기준으로 확인했다.1. 완료 보고와 실제 완료의 차이시리즈 첫 포스팅에서 정리했듯이 에이전트 루프는 모델이 도구 요청 없이 텍스트로만 응답할 때 끝난다. "작업을 마쳤다"라는 응답은 모델의 판단이고, 그 시점에 빌드가 깨져 있어도 루프는 끝난다.사람이 ..

AI 2026.11.19

[AI 에이전트] Claude Code 컨텍스트 엔지니어링 (CLAUDE.md, 스킬)

이전 포스팅에서 같은 지시도 실행할 때마다 결과가 달라지는 것을 확인했다. 이번 포스팅에서는 모델이 무엇을 보고 판단하는지와 그것을 어떻게 설계하는지(CLAUDE.md, 스킬)를 정리한다.https://hsunnystory.tistory.com/324개념 부분은 Claude Code 공식 문서(2026년 11월)를 기준으로 작성했고, 실습은 Claude Code v2.1.322에서 진행했다.1. 컨텍스트와 컨텍스트 윈도우컨텍스트는 모델이 한 번 호출될 때 입력으로 받는 정보 전체다. 앞 글에서 정리했듯이 모델은 이전 호출을 기억하지 않기 때문에, 하네스가 매 호출마다 지금까지의 내용을 묶어서 다시 보낸다. Claude Code 기준으로 이 묶음은 다음과 같이 구성된다.구성 요소예시특징시스템 프롬프트Cla..

AI 2026.11.18

[AI 에이전트] 에이전트 루프 구조와 Claude Code 권한 모드 비교

요즘 AI 에이전트 관련 글을 보면 하네스 엔지니어링, 루프 엔지니어링 같은 단어가 부쩍 많이 나온다. 용어만 아는 걸로는 부족해서, 연습용 Spring Boot 프로젝트를 하나 만들고 Claude Code로 직접 실습하면서 정리하고자 한다.실습 환경은 Spring Boot 4.1, JDK 21, Gradle이고 도구는 Claude Code CLI(v2.1.319)를 썼다.1. 에이전트와 챗봇의 차이챗봇은 질문을 받으면 답을 한 번 돌려주고 끝난다. 에이전트는 목표를 받으면 스스로 판단해서 도구를 쓰고, 그 결과를 보고 다음 행동을 다시 정한다.에이전트는 결과를 보고 다음 행동을 정하는 일을 반복한다.2. 에이전트 루프의 구조처음에 가장 헷갈렸던 건 "AI가 파일을 수정한다"는 표현이었다. 실제로 모델은..

AI 2026.11.17

[TLS] Extended Master Secret(EMS) 정리

앞 글에서 TLS 1.2의 Triple Handshake 공격을 정리했다. 서로 다른 두 세션의 마스터 시크릿을 같게 맞춘 뒤, 세션 재개와 재협상을 이어 붙여 공격자의 데이터를 피해자 인증 아래로 밀어 넣는 공격이었다.https://hsunnystory.tistory.com/322이번 글은 그 공격을 막으려고 나온 EMS(Extended Master Secret, RFC 7627)를 다룬다. 실무에서 이 확장 때문에 iOS 27 앱 설치가 막혔던 일은 따로 정리해 두었다.https://hsunnystory.tistory.com/3211. EMS의 마스터 시크릿 계산 방식기존 TLS 1.2의 마스터 시크릿은 pre-master secret과 양쪽 난수만으로 계산했다. EMS는 난수 자리에 ClientKe..

[TLS] Triple Handshake 공격 정리

얼마 전 iOS 27에서 인하우스 앱 설치가 실패하는 문제를 겪었다. 원인은 서버가 TLS 1.2에서 EMS(Extended Master Secret)를 협상하지 못한다는 것이었다.https://hsunnystory.tistory.com/321해결할 때는 "EMS가 없으면 안 된다"는 사실만 따라갔는데, 정작 EMS가 무엇을 막으려고 생긴 건지는 몰랐다. 찾아보니 EMS는 2014년에 발표된 Triple Handshake 공격을 막기 위해 만든 확장이었다. 이번 글에서는 그 공격을 먼저 정리하고, EMS 자체는 다음 글에서 다룬다.1. TLS 1.2 마스터 시크릿 계산 방식TLS 1.2에서 데이터를 암호화하는 키는 마스터 시크릿(master secret)에서 나온다. 마스터 시크릿은 핸드셰이크 중에 클라..

iOS 27 인하우스 앱 설치 실패 원인과 해결 (TLS 1.2 EMS 미지원)

1. 증상고객사에서 사내 배포(인하우스) 앱이 설치되지 않는다는 연락을 받았다. 설치 페이지는 정상적으로 열리는데, 설치 버튼을 누르면 "TLS 오류로 인해 보안 연결이 실패했습니다." 라는 메시지만 뜨고 진행이 되지 않았다.확인해 보니 iOS 27로 업데이트한 기기에서만 발생했다. iOS 26 이하와 안드로이드는 그대로 설치가 됐고, 서버 쪽은 최근에 작업한 게 없었다.아이폰을 Mac에 연결하고 Xcode 콘솔에서 로그를 확인해보니 아래와 같은 로그가 있었다.Manifest for UPP: https://app.example.co.kr:8443/store/apps/iOS/MyApp.plist clientID: itunesstoredDownloading requested manifest at URL: h..

[Tomcat] 톰캣 기동의 원리 4편 : 상대 경로의 기준점과 user.dir

1편에서 스크립트 체인, 2편에서 Windows 서비스의 레지스트리 스냅샷, 3편에서 JAVA_HOME이 두 번 설정되는 구조를 알아보았다.https://hsunnystory.tistory.com/318이 시리즈를 시작하게 만든 증상은 따로 있었다. 같은 배포본, 같은 설정 파일인데 bin\startup.bat으로 띄우면 설정 안의 경로를 ../resources/...로 적어야 잡히고, 서비스로 띄우면 resources/...로 적어야 잡혔다. 홈도 같고 JDK도 같은데 상대 경로의 기준만 달라졌다.자바는 상대 경로를 무엇을 기준으로 해석하고, 그 기준은 실행 방식에 따라 왜 달라지는가?이번 포스팅에서는 상대 경로의 기준점이 어디서 결정되는지, 실행 방식별로 그 값이 어떻게 달라지는지, 그리고 어떻게 고..

Infra/WEB · WAS 2026.10.16

[Tomcat] 톰캣 기동의 원리 3편 : JAVA_HOME과 내장 JDK 패키징

1편에서 톰캣의 스크립트 체인을, 2편에서 Windows 서비스가 레지스트리 스냅샷으로 뜨는 구조를 알아보았다.https://hsunnystory.tistory.com/317톰캣 7 시절부터 수백 곳에 같은 방식으로 납품해 온 배포본이 있었는데, 톰캣 9로 재패키징한 새 배포본이 개발 PC에서는 서비스 등록까지 잘 되던 게 정작 고객사 서버에서는 등록이 실패하는 상태였다. 파일을 전부 열어보고 비교해보니 이전 패키지들(톰캣 7)은 JAVA_HOME이 두 군데 적혀 있었고, 새 패키지(톰캣 9)는 한 군데에만 적혀 있었다.자바가 설치되어 있지 않은 서버에 JDK를 내장해서 배포할 때, bat 기동과 서비스 기동 두 경로 모두가 그 내장 JDK를 바라보게 하려면 어디에 무엇을 적어야 할까?이번 포스팅에서는 ..

Infra/WEB · WAS 2026.10.15

[Tomcat] 톰캣 기동의 원리 2편 : Windows 서비스와 레지스트리에 박제되는 설정

이전 포스팅에서 톰캣의 디렉터리 구조와 CATALINA_HOME, 그리고 startup.bat에서 catalina.bat, setenv.bat으로 이어지는 스크립트 체인을 알아보았다.https://hsunnystory.tistory.com/3161편 마지막에 "서비스로 뜨는 톰캣은 이 스크립트 체인을 전혀 거치지 않는다"고 적었다. 처음 이 사실을 확인했을 때 꽤 당황했던 기억이 있다. 배포본의 setenv.bat에 내장 JDK 경로를 지정해 두고 서비스로 돌리고 있었는데, 정작 서비스는 그 파일을 읽은 적이 없고 install하던 날 PC에 깔려 있던 다른 JDK로 계속 돌고 있었기 때문이다. 버전이 우연히 같아서 아무 증상이 없었을 뿐이다.이번 편은 Windows 서비스로 등록된 톰캣이 실제로 어떻게..

Infra/WEB · WAS 2026.10.13