승진
줄표(em-dash) 사용 금지. 이 스킬이 작성하는 모든 내용에는 줄표(em-dash)가 포함될 수 없습니다. 대신 쉼표, 콜론 또는 괄호를 사용하세요. 이는 저장소 훅에 의해 강제됩니다.
/flagrare:write-docs를 참조하세요.
평이한 용어 사용. 사용자가 읽는 모든 내용에는
<플러그인 루트>/lib/career/GLOSSARY.md에 있는 평이한 이름을 사용하세요 ("평가 기준 행(rubric rows)" 대신 "시니어 행동", "패킷(packet)" 대신 "작성된 사례", "이니셔티브(initiative)" 대신 "소유한 프로젝트"). 용어가 처음 등장할 때는 몇 마디로 의미를 설명하고, 사용자가 회사에서 듣게 될 용어(회사 자체 용어)를 괄호 안에 추가하세요.
승진은 사용자가 참석하지 않은 회의실에서, 사용자를 대부분 모르는 사람들이, 미리 정해진 일정에 따라, 작성된 사례를 기반으로 결정됩니다. 이 스킬은 이러한 사실을 초기에 파악할 수 있게 해줍니다: 사용자가 어디로 가고 싶어 하고 그 이유는 무엇인지, 회사가 실제로 어떻게 결정하는지, 평가 기준이 요구하는 사항은 무엇인지, 누가 사용자의 업무를 직접 알고 있는지, 그리고 핵심 대화가 언제 이루어져야 하는지.
승진 맵을 작성합니다: 사용자가 읽고 1:1 미팅에 가져갈 promotion-map.md와, 다른 경력 스킬이 동일한 사실을 사용할 promotion-map.json입니다. 맵은 로컬에 저장되며 비공개입니다. 이 스킬은 절대 어떤 것도 게시, 전송 또는 공개하지 않습니다.
라이브러리
이 플러그인은 <플러그인 루트>/lib/career/에 도우미 스크립트를 제공합니다. 플러그인 루트는 이 스킬의 기본 디렉토리에서 두 단계 위에 있습니다. 각 스크립트는 python3 <플러그인 루트>/lib/career/<스크립트>.py ...와 같이 실행합니다. 이 스크립트들은 JSON을 읽고 출력만 할 뿐입니다. 이 스킬은 Write 도구를 사용하여 모든 파일을 작성합니다. 샌드박스 셸은 ~/.claude/skills 아래에 쓸 수 없기 때문입니다.
career_state.py paths|contributions|plan --home "$HOME": 파일 위치, 기여 로그 (이전 및 새 위치의 합집합), 마이그레이션 계획.map_schema.py check <map.json> --today YYYY-MM-DD: 오류, 누락된 섹션, 오래된 섹션 (90일 이상), 충돌.deadlines.py --deadline YYYY-MM-DD --today YYYY-MM-DD [--dead START:END ...] [--published]: 관리자와 대화해야 할 시기.--dead는 선택 사항이며 반복 가능합니다.
맵의 구조는 reference/map-schema.md에, 마크다운 레이아웃은 reference/map-template.md에 있습니다. 기타 공유 상태 파일 (기여 로그, 플래그, 이니셔티브)은 <플러그인 루트>/lib/career/STATE.md에 설명되어 있습니다. 처리된 플래그를 지우려면 flags.json에서 해당 플래그를 제외하고 다시 작성하세요.
1. 상태 로드 (매 실행 시)
career_state.py plan을 실행합니다. 각write동작을 Write 도구로 적용하고, 대상 파일이 이미 존재하는 경우 먼저 읽습니다 (Write 도구는 읽지 않은 파일을 덮어쓰지 않습니다).mkdir동작은 별도 단계가 필요 없습니다. 폴더는 해당 폴더에 첫 번째 파일이 작성될 때 생성됩니다. 플레이스홀더 맵을 작성하지 마세요. 절대 아무것도 삭제하지 마세요.~/.claude/skills/flagrare/config.json(최상위 ID 키,skills.promotion블록)과 기존 맵(있는 경우)을 읽습니다. 설정 파일이나skills.promotion블록이 없으면 기본값으로 계속 진행합니다.- 맵이 없으면 첫 실행 (섹션 3)입니다.
map_schema.py check출력에missing섹션이 나열된 맵은 중단된 첫 실행을 의미합니다. 누락된 섹션이 있는 가장 이른 단계부터 재개합니다. 그렇지 않으면 사용자가packet모드(섹션 5)를 요청하지 않는 한 갱신 (섹션 4)을 실행합니다.
/flagrare:career에 의해 호출됩니다. 인수는 모드 (first_run, resume 또는 refresh)와 작업할 섹션을 지정합니다: 해당 섹션만 수행합니다. scheduled라고도 말하는 경우, 인터뷰하거나 묻지 말고 사용자의 답변이 필요 없는 섹션 (프로세스, 일정, 평가 기준, 조직, 선례)만 다시 조사하고 저장한 다음, 사용자가 필요한 각 섹션 (목표, 사람, 관리자 질문)을 조정자의 Needs you 목록에 있는 줄로 반환합니다. 두 경우 모두 전체 맵 대신 변경된 사항에 대한 간단한 요약을 반환합니다.
2. 모든 사실에 대한 규칙
- 출처, 날짜, 상태. 모든 사실에는 링크나 인용 위치, 확인한 날짜, 상태가 포함됩니다:
verified(원시 출처에서 읽고 인용함),unverified(요약, 발췌 또는 간접 정보),inferred(추론). - 원시 출처에서 그대로 인용하세요. 가져오기 도구는 요약 및 의역을 수행합니다. 의존할 인용문의 경우, 원시 페이지 (예: 페이지의 JSON 또는 HTML)를 다시 읽고 정확한 단어를 확인하세요.
- 충돌을 표시하고, 조용히 선택하지 마세요. 두 출처가 일치하지 않으면 (조직도 vs 분대 디렉토리, 프로세스 페이지 vs 레더 파일), 둘 다
alternatives로 저장하고 사용자에게 알리세요. - "찾을 수 없음"은 유효한 결과입니다. 단계에서 아무것도 찾지 못하면 추측하는 대신 구체적인 질문을
manager_questions에 추가하세요. 많은 회사에 문서화된 프로세스가 없습니다. - 사람에 관한 사실은 민감합니다. 사용자 자신의 상호 작용만 읽으세요. 사용자의 업무에 대한 직접적인 컨텍스트를 가진 사람을 기록하고, 사람들의 유용성 순위를 매기지 마세요.
- HR 포털이나 내부 사이트에서 브라우저를 사용하기 전에 동의를 구하세요.
3. 첫 실행
사용자에게 미리 알리세요: 첫 실행은 길며, 종종 한 시간 이상 소요되며, 각 단계 후에 저장되므로 중단했다가 재개할 수 있습니다.
모든 저장은 promotion-map.json과 promotion-map.md를 모두 작성하고, 해당 단계에서 작성된 모든 섹션에 대해 sections.<이름>.checked_at (오늘 날짜)과 sections.<이름>.sources를 설정합니다. checked_at이 없는 섹션은 오래된 것으로 간주됩니다. 1단계는 target, process 및 calendar를 작성합니다. 2단계는 rubric을 작성합니다. 3단계는 org, people 및 precedent를 작성합니다. 4단계는 packet_readiness 및 manager_questions를 작성합니다. 아무것도 찾지 못했더라도 각 섹션을 작성하세요 (빈 리스트 또는 객체와 checked_at 포함). 빈 섹션이 중단된 실행으로 오인되지 않도록 합니다.
1단계: 목표, 프로세스 및 일정
- 조사 전에 먼저 인터뷰하세요. 한 번에 한 가지 질문을 하세요:
- 현재 레벨과 목표 레벨.
- 트랙: 개인 기여자 또는 관리자.
- 목표로 하는 주기 (4단계 후에, 일정을 알게 되면 다시 돌아와서 하나를 제안합니다).
- 왜 원하는지, 더 많이 하고 싶은 업무는 무엇인지, 덜 하고 싶은 업무는 무엇인지.
- 목표 레벨에 대한 두 가지 사실을 조회하세요: 이 회사에서 최종 레벨인지 (그 이상의 승진이 예상되지 않음), 현재 레벨에서 예상되는 기간대는 얼마인지. 둘 다 인용하세요.
- "이유"가 무엇을 바꾸는지 설명하세요. 최종 목표 레벨에 "마음의 평화"라는 이유가 결합되면 목표가 종착점이 됩니다. "돈" 또는 "범위"라는 이유는 그 이후를 계획해야 함을 의미합니다. 이를 맵의 섹션 1에 작성하세요.
- 연결된 모든 소스에서 프로세스, 일정 및 패킷 템플릿을 찾으세요: 위키, 문서, 채팅 공지, 회의 노트, HR 포털 (동의 필요). 또한 제품 결정이 어떻게 이루어지는지도 찾으세요: 의사 결정 문서와 일반적으로 누가 주도하는지. 기회 스캔에 필요합니다.
또한 리더십이 측정하는 것을 찾으세요: 회사의 테마 또는 전략 문서, OKR 및 계획 문서, 그리고 계획 회의와 전체 회의에서 언급된 내용 (연결된 경우 Granola와 같은 회의 노트에서). 사용자 영역에 중요한 각 지표를
priorities에 기록하세요: 테마, 지표, 기준선 및 목표(각각 출처가 있는 사실), 이를 소유한 팀,user_lever: 사용자의 자리가 지표의 주요 입력을 소유하면owner, 시스템이 이를 공급하면input, 다른 팀에 레버가 있으면none. 기회 스캔은 이 목록에 대해 제안의 순위를 매깁니다. 회의 노트에서 우선순위를 가져오고, 사람에 대한 인용은 사용하지 마세요. target,process,calendar및sections항목이 채워진 맵(JSON 및 마크다운)을 저장하세요.
2단계: 평가 기준 격차
- 관리자가 평가하는 기준이 되는 아티팩트 (레더 스프레드시트, 체크인 워크북)를 찾으세요. 이에 대해 작성된 설명이 아닙니다. 사용자에게 관리자가 체크인 워크북을 사용하는지 물어보세요. 설명과 아티팩트가 일치하지 않으면 아티팩트를 사용하고
rubric.prose_mismatches에 불일치를 기록하세요. - 행동별로 하나의
rubric.rows항목을 만드세요: 현재 레벨 텍스트, 목표 레벨 텍스트, 안정적인 ID (<영역>.<짧은-슬러그>), 그리고label(2~4개의 평이한 단어로 된 행동, 예: "문제 찾기", "인정받는 리뷰어"). 보드와 다이제스트는 ID 대신 이 레이블을 표시합니다. - 각 행을
done,partial또는not_started로 표시하고,career_state.py contributions의 증거, 사용자에게 준 인정 (인정 도구가 설정된 경우, 아래 "인정" 참조: 각 보너스는 링크와 함께 증거이며, 태그된 회사 가치는 핵심 가치 행동을 가리킴), 사용자의 리뷰 및 업무, 그리고 사용자가 공유한 이전 리뷰 노트를 기반으로 합니다. - 저장하세요.
3단계: 조직 및 사용자의 업무를 아는 사람
- 조직: 사용자의 체인, 사용자가 배치될 수 있는 각 팀 위에 있는 사람, 그리고 예정된 변경 사항 (회의 노트 및 공지사항에서의 퇴사, 새 리더, 개편). 모든 사람은 출처와 상태를 가집니다.
- 사용자의 업무를 아는 사람, 증거 먼저, 그 다음 사용자:
- 사용자 자신의 상호 작용 (준 리뷰 및 받은 리뷰, 공유 스레드, 공유 회의, 사용자에게 인정을 준 모든 사람)에서 사람을 제안하고, 각각 증거 링크를 제공합니다. 사용자를 인정한 사람은 사용자의 업무를 직접 보았습니다. 그 중 승진 위원회에 있는 사람이 있으면 표시하세요.
- 사용자에게 확인 및 수정을 요청하고, 도구가 볼 수 없는 것 (예: 이전 관리자 또는 해커톤 팀)을 추가하도록 요청하세요.
seen_your_work및confirmed_by_user를 설정하세요.
- 보정 회의에 참석하는 사람: 프로세스 문서에서 추론하고, 문장을 인용하며,
inferred로 표시하세요. 사용자의 업무를 보지 못한 회의실에 있는 사람들을 나열하세요. - 선례: 최근 승진 공지사항에서 무엇이 인정받았는지 읽고, 맵에 "공지사항은 내러티브이지 감사(audit)가 아닙니다"라고 작성하세요. 심층 계층은 사용자가 요청하는 경우에만 제공하세요: 코드, 문서 및 티켓에서 누가 실제로 업무를 시작했는지 교차 확인합니다. 비용이 많이 들고 기본적으로 꺼져 있습니다.
- 저장하세요.
4단계: 계획
- 마감일: 패킷 마감일로
deadlines.py를 실행하세요. 이번 주기의 날짜가 게시되었으면 이를 사용하고--published를 전달하세요. 그렇지 않으면 작년 날짜를 이번 주기에 투영하고 (같은 월과 일, 1년 후)inferred로 남겨둡니다. 사용자에게 휴일이나 휴가 기간 중 사용자에게 데드 타임(dead time)이 있는지 물어보고--dead로 전달하세요. "X까지는 편안함, Y까지는 절대"를 상태와 함께 기록하세요. 상태가past이면 명확히 말하고 다음 주기를 이름을 지정하세요. - 열려 있는 각 행에 대한 하나의 다음 단계:
done이 아닌 모든 행에 대해next_step을 작성하세요: 증거를 추가할 수 있는 가장 간단하고 구체적인 실행 가능한 단계로, 회사에 대해 찾은 내용에 맞게 조정됩니다 ("리크루팅 채널에 /interview 입력", "파트너 대시보드에서 페어링 세션 한 번 제공", "공동 소유할 로드맵 일부를 관리자에게 요청"). 보드는 가장 큰 세 가지 격차와 이러한 단계를 나열하므로, 각 단계는 목표가 아닌 일주일 안에 수행할 수 있어야 합니다. - 패킷 준비 상태:
python3 <플러그인 루트>/lib/career/coordinator.py readiness --home "$HOME" --today <날짜>를 실행하여 각 평가 기준 행의 증거 수 (행으로 태그된 로그 항목과 행 자체의 증거)를 확인한 다음, 각 템플릿 섹션을 해당 행에서 가져온 증거에 따라strong,thin또는empty로 표시하세요. - 동료 피드백 선택:
recognition.py summary에서 사용자를 가장 많이 인정한 사람과 그 이유가 작성된 사례의 동료 피드백 (3~5명)의 첫 번째 후보입니다. 이를 동료 피드백 노트에 추가하세요. - 관리자 질문: 아직 알려지지 않은 모든 것, 그리고 준비 상태 질문 ("<주기>가 현실적이며, 무엇이 부족한가요?").
map_schema.py check를 실행하세요. 오류를 수정한 다음 저장하세요.- 사용자에게 간단한 요약을 보여주세요: 목표, 두 대화 날짜, 아직 보여주지 않은 시니어 행동 (레이블별), 여전히 사용자의 업무를 봐야 하는 사람, 관리자를 위한 질문.
promotion-map.md를 가리키세요.
4. 갱신
map_schema.py check를 실행하고,career/flags.json이 있으면 읽으세요 (다른 스킬이 개편, 퇴사, 일정 게시와 같은 신선도 저하 신호를 기록합니다). 인정 도구가 설정된 경우python3 <플러그인 루트>/lib/career/recognition.py fetch --home "$HOME" --today <YYYY-MM-DD>로 인정을 갱신하세요 (계획된career/recognition.json쓰기를 Write 도구로 적용하고, 네트워크가 필요합니다).- 오래되었거나 플래그가 지정된 섹션만 다시 조사하세요. 다른 모든 섹션은 그대로 유지하세요.
- 사용자에게 "변경된 사항 있나요?"라고 물어보며, 목표, 관리자, 팀, 사용자의 업무를 본 사람을 다루세요.
- 일정 섹션이 다시 확인되었거나, 플래그가 일정이 게시되었음을 나타내면
deadlines.py를 다시 실행하고calendar.manager_conversation을 업데이트하세요. - 열려 있는 각 행의 증거가 변경된 경우
next_step을 갱신하고 (완료되었거나 더 이상 가장 저렴하지 않은 단계는 교체), 누락된label을 추가하세요. - 다시 확인한 각 섹션의
checked_at을 업데이트하고, 처리한 플래그를 지운 후 저장하세요.
인정
사용자 회사가 동료 인정 도구 (현재는 Bonusly)를 사용하는 경우, 그 감사 인사는 사용자가 직접 기록할 필요가 없는 증거입니다. 설정: 사용자는 도구에서 개인 API 토큰을 생성하고 ~/.config/flagrare/bonusly-token (또는 config.json의 skills.career.recognition.token_file에 지정된 파일)에 저장합니다. 토큰을 config.json이나 저장소에 저장하지 말고 채팅에 붙여넣지 마세요. 그런 다음 python3 <플러그인 루트>/lib/career/recognition.py fetch --home "$HOME" --today <YYYY-MM-DD>를 실행하세요 (계획된 career/recognition.json 쓰기를 Write 도구로 적용하고, 네트워크가 필요합니다). recognition.py summary는 합계, 회사 가치, 사용자를 가장 많이 인정한 사람을 제공합니다. 도구의 자동 계정 (생일, 기념일, 환영)의 감사 인사는 별도로 계산되며 사람이나 증거로 취급되지 않습니다. 사용자에 대해 언급된 내용만 인용하세요. 도구를 통해 전송되는 것은 없습니다.
5. 패킷 모드 (/flagrare:promotion packet)
패킷 마감일이 다가오거나 사용자가 요청하면:
- 맵을 로드합니다. 맵이 없으면 먼저 첫 실행을 수행합니다. 마지막 승진 날짜 (또는 입사 날짜) 이후의 증거를 수집합니다: 최대 한 달 기간은
/flagrare:brag-doc을, 더 긴 기간은/flagrare:impact-timeline을 사용하세요. - 회사 템플릿으로 패킷 초안을 작성합니다.
process.packet_template에서 가져옵니다 (템플릿을 알 수 없는 경우 이 일반적인 형태를 사용하고 대체 템플릿임을 명시합니다: 헤더 필드, 2-3개의 프로젝트 (역할, 추정...)