#agentic-coding
노트 20개
AI & Data
Claude Code터미널에서 도는 에이전틱 코딩 도구 Claude Code를 묶은 주제다. 처음 쓰는 법과 명령어 레퍼런스, 설정·권한·메모리·훅·스킬·서브에이전트 같은 확장 장치, RPI 같은 개발 워크플로와 실전 팁, 도구를 만든 사람들의 설계 원칙을 하위 노트로 나눴다.
AI & Data › Claude Code
커맨드·스킬·서브에이전트 고르기Claude Code를 확장하는 세 단위(커맨드, 스킬, 서브에이전트)를 실행 맥락·호출 방식·지원 필드로 비교하고, 어느 것을 언제 쓰는지와 같은 일을 셋 다 할 때 무엇이 먼저 뜨는지, 서브에이전트 프론트매터 16개 필드와 내장 에이전트 5개, 서브에이전트를 쓸지 판단하는 기준(도구 출력이 다시 필요한가), 상관없는 맥락 창이라는 진짜 가치, 커맨드 → 에이전트 → 스킬로 엮는 오케스트레이션 패턴과 프리로드 스킬 대 직접 호출 스킬의 차이를 정리했다.
AI & Data › Claude Code
Claude Code 개발 워크플로: RPI에서 CRISPY·교차 모델·에이전트 팀까지코딩 에이전트로 기능을 만드는 워크플로를 비교한다. 단계마다 게이트를 둔 RPI(Research → Plan → Implement), 지시 예산(약 150~200개)과 dumb zone(맥락 약 40%) 때문에 RPI를 일곱 단계로 쪼갠 CRISPY와 「계획 말고 코드를 읽어라」, grill-me → PRD(목적지) → 수직 슬라이스 칸반(여정) → AFK Ralph 루프 → clear 후 리뷰 → 사람 QA로 이어지는 흐름, Claude와 Codex로 계획·검토·구현·검증을 나누는 교차 모델 워크플로, 공유 작업 목록으로 협업하는 에이전트 팀, /goal·/loop·/schedule, 그리고 공개 워크플로 12종의 공통 골격을 정리했다.
AI & Data › Claude Code
Claude Code 메모리: CLAUDE.md·rules·자동 메모리Claude Code가 세션을 넘어 기억하는 네 가지 장치(사람이 쓰는 CLAUDE.md와 .claude/rules, Claude가 쓰는 자동 메모리, 서브에이전트별 에이전트 메모리)를 비교하고, 모노레포에서 CLAUDE.md가 조상은 즉시·하위는 필요할 때·형제는 읽히지 않는 로딩 규칙, paths로 지연 로드하는 rules, 에이전트 메모리의 user·project·local 범위와 MEMORY.md 200줄 규칙, 그리고 CLAUDE.md를 짧고 살아 있게 유지하는 운영법을 정리했다.
AI & Data › Claude Code
Claude Code 명령어·플래그 레퍼런스Claude Code의 내장 슬래시 명령(세션·맥락·모델·설정·확장·원격·프로젝트), 번들 스킬, 시작 플래그와 하위 명령, 세션을 나누고 옮기는 명령(/branch, /fork, /subtask, /btw, --teleport, /remote-control), /powerup 강좌, 그리고 worktree·예약 작업·원격 제어·코드 리뷰 같은 기능이 어디에 있는지를 한 장의 지도로 정리했다. 명령 이름과 버전은 v2.1.325(2026-11) 기준이다.
AI & Data › Claude Code
Claude Code 설정과 권한 규칙Claude Code의 settings.json 계층(관리 정책 > CLI > 로컬 > 프로젝트 > 사용자)과 목록 병합 규칙, 전역(~/.claude)과 프로젝트(.claude)에 두는 것, 저장소가 스스로 권한을 올리지 못하게 막는 예외, allow·ask·deny 규칙 문법(경로 접두사, Bash 와일드카드, 복합 명령 분해, 파라미터 매칭), 권한 모드별 세부 동작, 카테고리별 주요 설정 키와 환경변수, 샌드박스·상태줄·MCP·플러그인 거버넌스를 정리했다. 버전에 묶인 값은 v2.1.322(2026-11) 기준이다.
AI & Data › Claude Code
Claude Code 실전 팁: 만든 사람들의 사용법Claude Code를 만든 Anthropic 팀(Boris Cherny, Thariq, Cat Wu)과 Dex Horthy·Matt Pocock 같은 실무자의 팁을 주제별로 묶었다. 계획에 힘을 쏟아 한 번에 구현하기, 검증 수단 주기와 /go 패턴, worktree 병렬 세션, 맥락 관리 수치(context rot 30만~40만 토큰, dumb zone 40%)와 compact·clear·rewind·서브에이전트 선택법, 훅·권한·샌드박스, 모델과 추론 강도, Claude에게 도전하는 프롬프트, 모바일·원격 세션, /loop로 돌리는 실제 루프, squash와 작은 PR, 터미널 설정까지 정리했다.
AI & Data › Claude Code
Claude Code 활용 가이드채팅형 AI와 무엇이 다른지부터 설치, 질문 → 편집 → 도구 → 맥락 → 자동화로 익숙해지는 순서, 슬래시 명령·단축키, MCP 연결과 범위·추천 서버, Skills와 CLAUDE.md, 팀 설정 공유, 권한 모드와 자동 모드, 여러 계정을 나눠 쓰는 인증 설정, 플랜 한도·API 크레딧·사용량 크레딧으로 나뉜 과금 구조, `claude -p` 자동화, Claude Code에 맞는 프롬프트 습관, 개발 팀장처럼 위임하는 작업 방식까지 Claude Code를 쓰는 데 필요한 요점을 한 장으로 정리.
AI & Data › Claude Code
Claude Code 훅: 도구 호출 앞뒤에 규칙 걸기훅은 Claude Code의 특정 시점(도구 실행 전후, 응답 종료, 압축 전 등)에 내 명령을 자동으로 실행하는 장치다. 포맷터·타입 검사·민감 파일 차단처럼 모델에게 부탁하지 않고 반드시 지켜야 하는 규칙을 건다. 이벤트 종류, 설정 위치와 matcher, 표준 입력 JSON과 종료 코드 2의 의미, .env 읽기 차단 예제, 유용한 훅(큰 파일 읽기를 저비용 모델로 돌려 토큰을 줄이는 구성 포함), 보안 주의점과 디버깅 방법을 정리했다.
AI & Data › Claude Code
Claude Code의 설계 원칙: 모델을 상자에 가두지 않는다Claude Code를 만든 팀이 밝힌 제품 설계 원칙을 정리했다. 6개월 뒤 모델을 위해 만들기, bitter lesson과 버릴 각오로 만드는 스캐폴딩, 최소 도구와 사람·모델이 함께 쓰는 도구, RAG를 버리고 glob·grep 에이전틱 검색을 고른 이유, 스위스 치즈식 안전, 잠재 수요와 걷어 내기, 온보딩 없는 제품, 문서보다 프로토타입, 그리고 팀 운영과 엔지니어 역할의 변화(생산성 수치, 제너럴리스트, 인쇄기 비유)까지 다룬다.
AI & Data
내 일을 줄이는 하네스 만들기에이전트 코딩의 단위는 결과물이 아니라 결과물을 만드는 장치(하네스)다. 대화로 맥락을 쌓고, CLAUDE.md·PLAN/PROGRESS 파일·명령·서브에이전트·참고 자료 캐시로 장치를 만들고, 결과가 아니라 장치를 고치며, cron과 claude -p로 이슈 → 구현 → 보고까지 돌리는 방법을 정리했다. 병목의 이동(토큰·머지·thinking·추론 속도), 사람의 인지 부하, 코드와 소프트웨어의 가치 변화도 다룬다.
AI & Data
디자인 시스템을 아는 화면 생성 에이전트 설계하기프롬프트→코드 한 번의 점프 대신 구체화·기억·참고·생성·검증·축적 루프를 하네스로 묶고, 중간 표현(스펙)·온디맨드 스킬·자동 채점기·세션 간 메모리로 결과를 일관되게 만드는 에이전틱 코딩 기법.
AI & Data
루프 엔지니어링에이전트에게 한 턴씩 프롬프트하는 대신, 일을 찾고·맡기고·검증하고·기록하고·다음 단계를 고르는 루프를 설계한다. 자동화·워크트리·스킬·커넥터·서브에이전트·상태 파일로 구성하고, 검증과 이해는 사람이 끝까지 쥔다.
AI & Data
바이브 코딩에서 에이전틱 엔지니어링으로프롬프트가 곧 프로그램인 Software 3.0, LLM은 명세할 수 있는 것보다 검증할 수 있는 것을 자동화한다는 원리와 들쭉날쭉한 지능, 바닥을 올리는 바이브 코딩과 품질 기준을 지키며 빨라지는 에이전틱 엔지니어링의 차이, 사람이 맡을 설계 판단·취향·근본 이해, LLM을 동물이 아닌 유령으로 보는 관점, 에이전트 네이티브 인프라, 그리고 「사고는 맡겨도 이해는 못 맡긴다」는 원칙을 정리했다.
AI & Data
에이전트를 믿을 수 있는 환경 만들기에이전트를 한두 개 붙잡고 돌보는 단계에서 수십·수백 개를 병렬로 돌리는 단계로 가는 열쇠는 신뢰이고, 신뢰는 환경에서 나온다. 앱을 직접 실행해 증거를 모으는 검증 스킬(CLI + 기능 지도)과 검증용 테스트(E2E·속성 기반·차등 테스트), 엔지니어의 작업 방식을 담은 스킬, 그리고 에이전트를 교정할 때마다 고르는 다섯 층(코드베이스 → 정적 분석 → 규칙·리뷰 봇·스킬 → 스타일 가이드)을 정리했다. 나쁜 패턴이 바이러스처럼 번지는 이유, 지름길이 곧 옳은 길이 되는 에이전트 친화 프레임워크, 정원사 역할도 다룬다.
AI & Data
프롬프트에서 하네스로: 에이전틱 패턴의 진화AI 개발의 중심은 프롬프트 엔지니어링(무엇을 말할까) → 컨텍스트 엔지니어링(무엇을 보여 줄까) → 하네스 엔지니어링(어떤 시스템을 만들까)으로 옮겨 왔다. 엔지니어링의 엄밀함은 사라지지 않고 위치만 옮긴다. 각 단계의 핵심 기법(CoT·ReAct·플로우 엔지니어링, Write/Select/Compress/Isolate, KV 캐시, 하네스 2×2), 실전 사례, 프롬프트로 흉내 낼 수 없는 하네스의 능력, 치명적 삼요소와 2의 규칙을 정리한다.
AI & Data
AI 네이티브 프론트엔드 개발코드를 AI만으로 쓰는 팀에서 프론트엔드가 일하는 방식. 금지 규칙 대신 대화로 뽑은 스킬, 구조를 직접 바꾸며 이해하기, 의도 정렬 순서, 이슈·PR로 맥락 관리, 병렬 작업과 이탈 감지, 디자인 픽셀 비교와 상태 재현 환경, BE·디자인을 정본으로 삼아 FE를 얇게 만들기, AI에게 관측 통로 달아 주기, 통합과 완성도로 옮겨 가는 역할을 정리한다.
AI & Data
AI 코딩 실무 가드레일AI 코딩 에이전트로 프로덕션 코드를 다룰 때의 실무 규칙. 프로젝트 규모에 따른 세 가지 모드, CLAUDE.md와 앵커 주석(AIDEV-NOTE), 테스트는 사람이 쓴다는 원칙, 맥락을 아끼지 않는 프롬프트, 작업마다 새 세션, AI가 건드리면 안 되는 영역, 에이전트에 넘기는 권한의 범위, 실수의 등급을 정리한다.
AI & Data
AI로 개발 가속하기: AI 네이티브 작업 방식과 규칙을 키우는 개발AI를 가끔 꺼내 쓰는 도구가 아니라 리서치·기획·구현·테스트·운영 전반에 깔린 협업자로 다루는 작업 방식. AI부터 시도하고 사람이 검증하는 원칙과 도입 단계, 도구 네 범주와 개발 생명 주기별 활용, 거대한 한 방 프롬프트와 도메인 지식 문서, PRD → 태스크 리스트 흐름, AI가 짜고 사람이 검토하는 바이브 코딩의 현실적 패턴, 이상 행동을 볼 때마다 규칙을 더하는 Rule-Growing Development, AI가 코드를 찾는 방식을 고려한 주석·이름, AI가 맡을 수 있는 작업 길이, 팀·윤리 규칙과 사람의 역할을 정리한다.
AI & Data
LLM 동작은 왜 날마다 다른가「오늘 모델이 멍청해졌다」의 원인을 층별로 정리했다. 가중치는 고정이어도 세션 맥락, 시스템 프롬프트, 후속 학습, 샘플링, 추측 디코딩, MoE 라우팅과 배치 구성(일별 ±8~14%), 하드웨어, 양자화, 컴파일러가 동작을 바꾼다. Anthropic이 인정한 2025년 8~9월 인프라 버그 세 건, seed 파라미터가 없고 temperature 0도 같은 출력을 보장하지 않는 이유, 같은 모델이라도 CLI와 Agent SDK의 시스템 프롬프트가 달라 결과가 달라지는 이유, 그리고 스냅샷 고정·일일 카나리·구조화 출력 같은 대응을 다룬다.