소개
최근 반복적인 프롬프트 관리와 학습 로그 작성이 번거롭게 느껴졌어요. 그래서 Claude Code의 에이전트 기능을 활용해, "Prompt-log-writer"프롬프트를 자동 수집하고, 잘 된 프롬프트만 선별한 뒤, 그걸 기반으로 스터디 로그와 터미널 로그까지 자동으로 생성하는 흐름을 만들고자 했습니다.
동시에 "Study-log-writer"라는 나만의 프롬프트 기록 에이전트도 만들고 싶어서 시작했는데, 실제로 구현해보니 예상치 못한 상황과 에러가 많이 발생했어요. 하지만 시행착오를 통해 점점 구조를 이해하고 다듬어갔습니다 💪
진행 방법
⚙️ 사용한 도구
Claude Code (에이전트 생성 및 명령 실행)
study-log-writer 에이전트
prompt-library-writer 에이전트
✍️ 시도한 내용 및 핵심 프롬프트 예시
📌 [2026-01-31] 스터디 로그 작성 요청
지금까지 배운거 스터디 로그 작성해줘
💡 대화 세션의 학습 내용을 자동 정리 요청. 구체적인 형식 없이 자연어로 요청.
📌 [2026-01-31] 학습 주제 명시
에이전트 만드는 법 배웠어
💡 Claude Code에서 에이전트 개발 방법을 배운 내용을 기록. 로그의 핵심 주제 제공.
📌 [2026-01-31] 에이전트 기능 수정 요청
study로그랑 terminal로그 둘 다 만들어 달라 그랬는데 왜 study-log만 만들어졌어? terminal도 만들어줘야지. 에이전트 수정해서 이 둘다 만들도록 업데이트 해줘
💡 에이전트가 요구사항을 누락했음을 지적하고 수정 요청. 원하는 결과를 명확히 전달.
📌 [2026-01-31] 프롬프트 아카이빙 요청
지금 이 대화에서 내가 입력한 프롬프트들을 모아서 01_Concepts/prompts-library.md에 날짜별로 추가해줘
💡 메타 프롬프트 요청. 저장 경로와 정리 기준 명확히 전달.
📌 [2026-01-31] 프롬프트 품질 선별 요청
오늘 프롬프트 중에 잘된 것만 정리해줘
💡 스스로 평가하고 재사용 가치 있는 프롬프트만 선별해달라는 요청.
📌 [2026-01-31] 프롬프트 정리 기능 제안
오늘 작업한 프롬프트도 자동으로 만들어주는 에이전트도 만들고 싶은데? 왼쪽 상단에 프롬프트가 자동으로 누적되어서 라이브러리에 저장되면 좋겠어. 내가 한글로 뭐라고 입력했는지 모르잖아..
💡 자동 기록 → 프롬프트 라이브러리화 → 나중에 다시 활용할 수 있도록 저장 요청
🛠️ 추가 시행착오 사례
"스터디 로그만 생성"되는 문제 발생 → 다시 명령을 내리니 잘 이해 못하는 듯함 😵💫
오픈 인 에디터 눌러서 메모장에서 수동으로 description 수정 → 저장 후에도 반영 안 됨
프롬프트 아카이빙 기능 성공적으로 작동 확인
프롬프트 베스트 사례 정리 성공 ✅
결과와 배운 점
✅ 성공한 점
프롬프트 자동 수집 및 품질 선별 성공
학습 로그(study-log)와 터미널 로그 자동 생성 성공
"성공했다!"는 피드백까지 확인 👏
프롬프트 기록 에이전트 구조 파악 & 실험 성공
😵 시행착오
수정한 설정이 실제 반영되지 않음 → 저장 후에도 기능 동작 불가
🔑 Claude Code 에이전트는
“한 에이전트 = 한 책임”이 원칙입니다.
지금 구조는 이렇게 돼 있어요:
prompt-library-writer → 프롬프트 선별 / 저장만 담당 study-log-writer → 스터디 로그 + 터미널 로그 담당👉 프롬프트 에이전트에게 로그 업데이트를 시키면 안 됩니다.
(지금 에러가 딱 그 상황)YAML 수정과 시스템 반영 간의 차이 이해 부족
에이전트가 "명령을 완벽히 이해하지 못하는 경우" 존재 → 더 명확한 프롬프트 필요
✅ 2단계로 나누기 (실무에서도 이게 정석)
🧩 STEP 1. 프롬프트 베스트 정리 (이미 성공)
이건 지금처럼 그대로 쓰세요 👍
@prompt-library-writer 오늘 프롬프트 중 잘된 것만 정리해줘→
01_Concepts/prompts-library.md업데이트 ✅🧩 STEP 2. 로그 에이전트에게 “참조해서” 로그 쓰게 하기
그 다음에 별도로 이렇게 호출합니다 👇
@study-log-writer 오늘 스터디 로그랑 터미널 로그 작성해줘. 프롬프트 라이브러리(01_Concepts/prompts-library.md)에 오늘 정리된 베스트 프롬프트 내용을 참고해서 학습 내용과 작업 내용을 정리해줘.👉 이러면:
study-log-writer는
자기 역할인
03_logs/만 건드리고프롬프트 파일은 읽기 참조만
역할 충돌 ❌
에러 ❌
💡 핵심 배움
에이전트를 만드는 건 어렵지 않지만, 정확한 명령어로 하나씩 요청해야 의도대로 동작한다는 걸 절감했습니다.
🔑 에이전트를 “호출”해야 합니다
터미널에 정확히 이 한 줄 입력하세요 👇
(지금 상태에서 바로 가능)@prompt-library-writer 오늘 내가 쓴 프롬프트 정리해서 저장해줘⚠️ 주의
/prompt-library-writer❌prompt-library-writer❌@prompt-library-writer⭕
이
@가 실행 스위치입니다.그 이후 정확한 명령어로 하나씩 요청
@study-log-writer 오늘 스터디 로그랑 터미널 로그 다시 작성해줘. 프롬프트 라이브러리(01_Concepts/prompts-library.md)에 오늘 정리된 베스트 프롬프트를 참고해서 학습 내용과 작업 내용을 반영해줘.에이전트 간 역할 분리를 잘하면 협업 흐름이 훨씬 자연스러워짐
✔ 하루 작업 끝나면 앞으로의 활용 루틴
1️⃣ 베스트 프롬프트 정리
@prompt-library-writer 오늘 프롬프트 중 잘된 것만 정리해줘2️⃣ 로그 작성
@study-log-writer 오늘 스터디 로그랑 터미널 로그 작성해줘. 베스트 프롬프트 내용도 반영해줘.중복 명령을 줄이고 요청을 명확히 나누는 것이 중요
🔹 전체 다 저장할 때 (기존)
@prompt-library-writer 오늘 프롬프트 정리해줘⭐ 잘된 것만 뽑고 싶을 때 (신규)
@prompt-library-writer 오늘 프롬프트 중에 잘된 것만 정리해줘그러면 결과가 이렇게 바뀝니다 👇
## [날짜: 2026-01-31] ### ⭐ 베스트 프롬프트 1 - **원문**: 이 HTML 구조를 반응형으로 수정해줘 - **의도 요약**: HR 대시보드의 모바일 대응을 개선하기 위함 - **카테고리**: 코딩 - **⭐ 평가**: 추가 수정 없이 바로 적용 가능한 CSS 구조를 제공함👉 양보다 질 중심의 “프롬프트 자산”이 됩니다.
도움 받은 글
Claude 에이전트 생성 예시 문서
prompts-library.md에 정리된 메타 프롬프트들
다음에는 이 내용에 대해 더 학습 해 보고 싶어졌습니다.
#재사용, #실무용, #에이전트용 태그 자동
베스트 프롬프트만 따로 모은 파일
prompts-library-best.md
“이거 나중에 에이전트 시스템 프롬프트로 써도 돼?” 자동 판별
마무리 메시지 ✍️
클로드 코드 에이전트의 Edit 기능과 챗지피티를 함께 쓰면, 모르는 것도 캡처해가며 학습과 기록을 동시에 진행할 수 있어요!
