Claude Code Workflows: 오케스트레이션을 대화에서 코드로 옮기다
Claude Code의 동적 워크플로우는 수백 개의 서브에이전트를 JavaScript 스크립트로 조율하는 기능이다. 계획이 Claude의 컨텍스트에서 코드로 이동하면 무엇이 달라지는지, pipeline과 parallel은 어떻게 골라야 하는지, 토큰 비용은 어떻게 관리하는지. 시니어 백엔드 개발자의 시선으로 뜯어본 기록.
Claude Code의 동적 워크플로우는 수백 개의 서브에이전트를 JavaScript 스크립트로 조율하는 기능이다. 계획이 Claude의 컨텍스트에서 코드로 이동하면 무엇이 달라지는지, pipeline과 parallel은 어떻게 골라야 하는지, 토큰 비용은 어떻게 관리하는지. 시니어 백엔드 개발자의 시선으로 뜯어본 기록.
security-guidance 플러그인은 Claude가 작성한 코드를 편집·턴 끝·커밋의 세 지점에서 서로 다른 깊이로 검토하고, 발견을 같은 세션에서 수정하게 만든다. 설치하면 자동으로 도는 이 3계층 구조를 뜯어보고, 우리 팀의 위협 모델을 어떻게 얹을지 정리했다.
안드레 카파시가 공개한 LLM Wiki 패턴(raw·wiki·schema 3계층, ingest·query·lint 3대 운영)을 시니어 백엔드 시각에서 팀 단위 AX 전환의 정규화된 substrate로 옮긴다. graphify의 god nodes·confidence 태그·MCP 서버를 이 패턴의 어디에 결합할지, raw/ immutable과 lint를 어떻게 CI로 강제할지, CLAUDE.md 스키마와 도입 4단계 시나리오까지 챕터 운영 노트로 정리한다.
Java 25 LTS는 2025년 9월에 출시되며 21에서 쌓인 함정들을 정리한 첫 LTS다. synchronized 핀닝 해소(JEP 491), Compact Object Headers(JEP 519), Scoped Values 정식화(JEP 506), AOT Method Profiling(JEP 515)이 21을 쓰는 팀에 어떤 의미인지, 그리고 서비스 유형별로 어떤 순서로 단계적으로 적용해야 할지 정리한 시니어 백엔드의 전략 노트.
40개 보험사 마이데이터를 동시에 끌어와야 하는 중계서버를 Java 21로 재설계했다. 평균 응답을 20~40초에서 5~10초로 줄이고, 느린 보험사가 전체를 끌어내리던 합산 지연을 끊어낸 과정. 비동기·격리·관측 세 축을 다시 들여다본 시니어 백엔드의 실전 회고.
5주간의 Claude Code 세미나는 챕터에 awareness를 만들었다. 하지만 진짜 전환은 도구 인식이 아니라 워크플로우 통합에서 시작된다. 챕터 오너의 시선에서 멤버 4단계 성숙도, 측정·학습·표준화·자산화의 4축 설계, 이슈 트래커 통합 자동화 같은 실제 워크플로우 사례, 그리고 Private GitLab Plugin으로 챕터 자산을 묶는 운영 방식까지, AX 전환을 어떻게 설계하고 6개월에 걸쳐 끌고 갈 것인지 정리한 백엔드 챕터 전략 노트.
Sub-Agent는 격리된 컨텍스트에서 독립 실행되는 특화 AI 어시스턴트다. 도구·권한·모델·hook을 제약해 안전하게 위임하고, 메인 대화는 깨끗하게 유지한다. 시리즈의 마지막 주차, 시니어 백엔드 개발자의 시선으로 정리한 회고.
Skill은 Claude가 '필요할 때 펼쳐 드는 표준 절차'다. 3단계 로딩으로 컨텍스트를 보호하고, frontmatter로 트리거를 정교화하며, skill-creator로 품질을 검증한다. Spring Boot 서비스 생성기까지 만들어 본 4주차 세미나 회고.
Hooks는 Claude Code 라이프사이클의 모든 시점에 끼어드는 사용자 정의 명령이다. 도구 호출 검증, 위험 명령 차단, Spotless 자동 포맷, 테스트 강제까지. 백엔드 운영자의 시선으로 정리한 3주차 세미나 회고.
세미나 2주차는 Memory였다. 같은 'Product 엔티티 만들어줘'가 어떻게 시니어 수준의 코드로 바뀌는지, CLAUDE.md와 자동 메모리라는 두 메커니즘을 백엔드 멀티모듈 관점에서 정리한 회고.
사내 기술연구소에서 진행한 Claude Code 세미나 1주차 회고. 사용자 프롬프트 한 줄이 실제로 Anthropic API에 어떤 모양으로 전달되는지, model · system · tools · messages 네 가지를 시니어 백엔드 개발자의 시선으로 해부한다.
Rule-based와 LLM-RAG를 하이브리드로 묶은 AI 상담사 시스템을 구축하며 마주한 WebFlux 이벤트 루프 차단, Read Timeout 연쇄 장애, 그리고 그것을 풀어낸 아키텍처적 선택들. 시니어 백엔드 개발자의 시선에서 정리한 실전 회고.
2025년 11월 20일 GA된 Spring Boot 4.0은 Spring Framework 7, Jakarta EE 11, Spring Security 7, Jackson 3을 한 번에 올리는 첫 메이저 릴리스다. JSpecify 기반 null 안전, API Versioning 일급화, 코어로 들어온 @Retryable·@ConcurrencyLimit, 모듈화된 자동설정이 Boot 3을 쓰는 팀에 어떤 의미인지, 그리고 서비스 유형별로 어떤 순서로 단계적으로 적용해야 할지 정리한 시니어 백엔드의 전략 노트.