스스로 작성되는 승진 문서
요약
Claude Code의 커스텀 스킬을 활용하여 매일의 업무 성과와 피드백을 자동으로 기록하고 구조화된 마크다운 파일로 저장하는 워크플로우를 소개합니다. 이를 통해 성과 검토 시 필요한 증거를 체계적으로 관리하고 기억의 한계를 극복할 수 있습니다.
핵심 포인트
- Claude Code 커스텀 스킬로 업무 기록 자동화
- 성과 검토를 위한 구조화된 마크다운 데이터 구축
- 기억에 의존하지 않는 체계적인 커리어 관리 방법
- 기록의 캡처부터 합성까지의 마찰 최소화
요약 (TL;DR): 저는 나의 업무 일과에 대해 확인하고, 후속 질문을 던지며, 승진 증거로 사용할 수 있는 구조화된 마크다운 (Markdown) 파일을 저장하는 Claude Code 기술을 설정했습니다. 이것이 왜 효과적인지, 그리고 약 5분 만에 어떻게 구축할 수 있는지 소개합니다.
5월 6일
5월 6일, 나의 에너지 수준은 5점 만점에 2점이었습니다.
그날 Claude Certified Architect 시험 점수를 확인했습니다: 1000점 만점에 717점. 720점이 필요했습니다. 단 3점이 부족했습니다.
같은 기록의 네 줄 아래에는 매니저가 저에게 이렇게 말한 내용이 있었습니다: "당신의 리더십이 Artium 전반에서 느껴지고 있습니다. 좋은 영향력을 미치고 계시네요."
그날에 대해 말하자면 이렇습니다: 나쁜 숫자는 생생하고 자명합니다. 717점. 3점 차이. 그 숫자는 몇 주 동안 내 머릿속을 떠나지 않을 것이었습니다. 하지만 인정(recognition)은요? 그것은 조용히 증발해 버립니다. 기억에만 의존한다면, 5월 6일은 시험에서 3점 차로 떨어진 날일 뿐입니다. 하지만 기록된 페이지 위에서, 그날은 매니저가 나의 리더십이 회사 전반에 전달되고 있다고 말해준 날이기도 합니다.
이 기록은 내가 그렇지 않았다면 놓쳤을 것을 보존해 줍니다.
기억의 문제점
저는 수년 동안 이 부분에 서툴렀습니다. 성과 검토 (performance review) 시기가 되면, 실제로 무엇을 했는지 기억해 내려고 빈 문서를 응시하곤 했습니다. 40개가 아닌 4개 정도의 항목밖에 떠올리지 못했습니다. 매니저는 그녀가 우연히 목격한 것에 기반하여 저를 옹호해주었지만, 그것은 결코 전체 그림이 아니었습니다.
문제는, 저는 좋은 성과를 냈다는 점입니다. 단지 그것을 기록하지 못했을 뿐입니다.
몇 년 전, 저는 이 문제를 Google Forms를 이용해 해결하려고 시도했습니다. 매일 일과가 끝날 때마다 스프레드시트로 데이터가 전송되는 구조화된 양식을 작성하는 방식이었죠. 어느 정도는 효과가 있었습니다. 데이터는 쌓였지만, 마치 숙제를 하는 기분이었습니다. 양식은 후속 질문을 던지지 않았고, 제가 모호하게 작성할 때도 알아차리지 못했습니다. 작성하려면 특정 장소로 가야만 했습니다. 그리고 리뷰 시기가 되면, 모든 것을 취합하고, 무엇이 중요한지 파악하며, 이를 일관성 있는 형태로 조립하기 위해 또 다른 곳으로 가야 했습니다. 마찰(Friction)은 단순히 매일의 기록에만 있는 것이 아니었습니다. 캡처(Capture), 검색(Retrieve), 합성(Synthesize), 제시(Present)로 이어지는 전체 체인에 존재했습니다. 모든 단계에서 저는 혼자였습니다.
그래서 저는 더 나은 것을 만들었습니다.
내가 만든 것
저는 daily_self_evals라는 이름의 git 리포지토리(repository)를 가지고 있습니다. 그 안에는 매 영업일마다 각각의 마크다운(markdown) 파일이 생성됩니다.
entries/
└── 2026/
└── 03/
...
각 파일에는 YAML 프론트매터(frontmatter)(날짜, 요일, 에너지 수준, 태그)와 제가 완료한 작업(shipped), 그 작업의 영향력(impact), 성과(wins), 극복한 과제(challenges), 받은 인정(recognition), 그리고 다음 계획(what's next)을 위한 섹션이 포함되어 있습니다. 다음은 기록의 대표적인 예시입니다.
---
date: 2026-02-12
day: Thursday
...
기술 (The Skill)
Claude Code에서는 커스텀 스킬(custom skill)을 구축할 수 있습니다. 이는 Claude에게 언제 사용해야 하는지 알려주는 설명이 포함된 저장된 워크플로우(workflow)입니다. 저는 저널링(journaling)을 위한 스킬을 만들었는데, 좋은 점은 특별한 구문(syntax)을 사용하여 호출할 필요가 없다는 것입니다. 저는 그저 동료에게 말하듯 Claude Code에게 말하면 됩니다.
"헤이, 오늘 기록을 하나 만들자."
"방금 내가 거둔 이 성과를 기록해 줄래?"
Claude는 이 문장들이 저널링 스킬과 일치함을 인식하고 이를 실행합니다. (명령어를 입력하는 것을 선호한다면 /daily-eval을 통해 수동으로 호출할 수도 있지만, 저는 절대 그렇게 하지 않습니다.)
실행될 때, Claude는 먼저 오늘 날짜의 항목이 이미 존재하는지 확인합니다. 이미 존재한다면, 기존 내용을 읽고 제가 무엇을 추가하고 싶은지 묻습니다. 존재하지 않는다면, 새로 시작합니다. 어떤 경우든 기존 내용을 덮어쓰지 않고 추가(append)하기 때문에, 오후 2시에 무언가를 기록하고 하루 끝에 더 추가하더라도 모두 동일한 파일에 저장됩니다.
그런 다음 Claude는 대화하듯 질문을 하나씩 던집니다:
"오늘 아주 작은 일이라도 무엇을 출시하거나 진척시켰나요?"
"그것이 팀이나 제품에 어떤 영향을 미쳤나요?"
"누군가 당신에게 감사 인사를 하거나 좋은 피드백을 주었나요?"
이것은 양식(form)이 아닙니다. 진심으로 궁금해하는 동료와 5분 동안 디브리핑(debrief)을 하는 느낌에 더 가깝습니다. 대화가 끝나면 Claude는 파일을 작성하거나 업데이트하고, 어디에 저장했는지 알려줍니다.
대화형 형식이 중요한 이유
STAR 프레임워크 (Situation, Task, Action, Result; 상황, 과업, 행동, 결과)가 이름이 명시되지는 않았지만 질문 흐름 속에 내장되어 있습니다. 제가 과업을 설명한 후 Claude가 "그것이 어떤 영향을 미쳤나요?"라고 물을 때, 저는 더 깊이 생각하게 됩니다. 양식에 작성할 때보다 더 나은 답변을 내놓게 됩니다. 작성을 마칠 때쯤이면, 각 항목은 처음부터 프롬프트(prompt)가 그렇게 형성해 주었기 때문에 채용 담당자에게 전달하거나 성과 검토(performance review)에 바로 넣을 수 있는 수준의 글이 됩니다.
파일을 활용하는 방법
모든 것은 YAML 프론트매터 (YAML frontmatter)가 포함된 일반 마크다운 (markdown) 파일입니다. 별도의 앱도, 데이터베이스도, 종속성(lock-in)도 없습니다.
즉, 다음과 같은 작업이 가능합니다:
- Word 또는 PDF로 내보내기:
pandoc entries/**/*.md -o accomplishments.docx - 폴더 전체를 Notion 또는 Obsidian으로 가져오기
- 성과 검토 전에 Claude에게 3개월 치 항목을 요약해 달라고 요청하기
- 어떤 항목이든 승진 서류(promotion packet)나 1:1 미팅 문서에 직접 붙여넣기
- 영구적이고 타임스탬프(timestamp)가 찍힌 기록을 위해 개인 GitHub 저장소(repo)에 푸시(push)하기
YAML 프론트매터(frontmatter)가 에너지 레벨이나 태그 같은 구조화된 필드를 포함하고 있기 때문에, Claude에게 여러분의 모든 기록에 걸쳐 차트와 분석을 생성하도록 요청할 수도 있습니다. 시간 경과에 따른 에너지 레벨 변화. 어떤 주에 승리가 가장 많았는지. 얼마나 자주 배포(shipped)했는지 대 얼마나 자주 막혔었는지(blocked). 이 시스템의 Google Forms 버전은 정확히 이러한 종류의 시각화가 가능한 스프레드시트에 연결되었습니다. Claude Code 버전도 요청만 하면 같은 작업을 수행할 수 있습니다.
또 다른 활용법: 동료에게 피드백을 요청받았을 때
동료 피드백(Peer feedback) 요청은 항상 가장 안 좋은 타이밍에 찾아옵니다. 누군가 3개월 전에 함께 일했던 팀원에 대한 설문조사를 작성해 달라고 부탁하는데, 여러분은 어떤 구체적인 것도 기억하려 애쓰며 양식을 바라봅니다.
만약 여러분이 상호작용을 기록하고 있었다면, 기억할 필요가 없습니다. 저널에게
"승진 증거를 구축하기 위해 일일 업무 저널 (daily work journal)을 설정하고 싶어.
~/daily_self_evals/프로젝트를 생성하고, 그 안에CLAUDE.md, 연도와 월별로 정리된entries/디렉토리를 만들어줘. 그리고~/.claude/skills/daily-eval/SKILL.md에 글로벌 스킬 (global skill)을 설정해줘. 내가 일상적인 언어로 저널 항목을 작성하거나 성과 (win)를 기록해달라고 요청할 때 알아챌 수 있도록 스킬에 설명을 달아주고,/daily-eval로도 호출할 수 있게 해줘. 실행 시에는 질문을 하기 전에 대상 날짜에 이미 작성된 항목이 있는지 확인해야 해. 내가 무엇을 출시했는지 (shipped), 영향력 (impact), 성과 (wins), 도전 과제 (challenges), 인정 (recognition), 그리고 다음 단계 (what's next)에 대해 한 번에 하나씩 질문하고, 항목은 YAML 프론트매터 (YAML frontmatter)가 포함된 마크다운 (markdown) 파일로 저장해줘. 모든 항목은 추가 (appendable)가 가능해야 하며 기존 내용을 절대 덮어쓰지 않아야 해."
Claude가 모든 파일을 처리할 것입니다. 여러분은 Claude가 구축한 내용을 검토하고, 새로운 대화를 시작한 뒤, 오늘의 항목을 작성하고 싶다고 말하기만 하면 됩니다. (스킬은 대화 시작 시 로드되므로, 설정 후에는 새 대화를 여세요.)
몇 달 후 일어나는 일
이제 저는 이전에는 결코 가져본 적 없는 증거의 집합을 갖게 되었습니다. 구체적인 업적들. 측정 가능한 영향력. 동료들의 인용구. 그리고 시간이 흐름에 따라 저의 패턴을 보여주는 에너지 등급 (energy rating): 어떤 종류의 날이 저를 즐겁게 하는지, 어떤 종류의 날이 저를 소진시키는지 말이죠.
승진을 위한 근거를 제시하거나, 더 흥미롭고 보수가 높은 역할을 찾을 때가 되면, 저는 기억에 의존해 시작하지 않을 것입니다. 저는 기록으로부터 시작할 것입니다.
그리고 자격증 점수가 3점 모자라 낙방하여 하루 전체를 실패한 날이라고 믿고 싶어지는 날에도, 기록은 진실을 알고 있습니다.
마지막으로 한 가지 더: 이 시스템은 완성된 것이 아닙니다. 저는 질문을 계속 다듬고, 프론트매터 (frontmatter)가 포착하는 내용을 조정하며, 요약을 요청하는 방식을 실험합니다. 그것이 핵심 중 하나입니다. 이것은 제가 소유하고 개선할 수 있는 도구이며, 사용하면 할수록 사용법이 더 능숙해집니다. 오늘 제가 실행하고 있는 버전은 처음 시작했을 때보다 더 나으며, 6개월 후에 실행할 버전은 훨씬 더 나을 것입니다.
Julia Evans의 Get your work recognized: write a brag document와 저의 이전 실험이었던 Google Forms를 활용한 자기 평가 (self-evaluation)에서 영감을 받았습니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기