코드 표준 — 변경 작업 워크플로
기능 구현·버그 수정·리팩터링 전에 '파악 → 베이스라인 → 최소 변경 → 테스트 → 검증 → 자기 리뷰' 순서를 강제하는 언어 무관 코드 작업 규율 스킬.
개발·코딩중급★ 177⑂ 6AI 점수 9/10마지막 업데이트: 2026. 8. 16.
무엇을 해주나
코드를 건드리기 전에 지켜야 할 실행 순서를 Claude에게 심어줍니다.
- 프로젝트 문서(README, CONTRIBUTING, AGENTS.md/CLAUDE.md, Makefile, package 스크립트)를 먼저 읽어 빌드·테스트·린트 명령을 파악
- 작업 시작 전 베이스라인 그린 확보(이미 깨져 있으면 그것이 첫 과제)
- 근본 원인에 대한 최소 변경, 주변 스타일 손으로 맞추기, 대량 자동 포매팅 금지
- 변경 없이는 실패하는 테스트 추가, 보안 게이트는 부정 단정 테스트(잘못된 토큰 → 거부, 상태 불변, 유출 없음)
- 빌드 + 린트 + 타입체크 + 테스트 전체 통과 후에야 "완료" 선언
- 자기 diff를 남의 PR처럼 셀프 리뷰, 문서 갱신과 conventional commit 메시지로 마무리
- 공개 인터페이스 변경, 의존성 추가, 인증/토큰/권한 수정, 비밀값 파일 기록, await 구간 락 보유 시 트립와이어로 멈춤
- 같은 실패가 두 번의 수정에도 남으면
[BLOCKED]표시 후 보고하는 무진행 가드
이런 분께 추천
- AI에게 코드를 맡길 때 지나치게 큰 diff나 대량 포매팅 때문에 리뷰가 힘들었던 분
- 언어·프레임워크와 무관하게 팀 공통의 작업 규율을 고정하고 싶은 분
- 인증·권한 같은 민감한 코드에 부정 테스트를 습관화하고 싶은 분
활용 예시
- "결제 실패 버그 고쳐줘" → 먼저 테스트를 그린으로 만들고, 재현 실패 테스트를 추가한 뒤 최소 수정, 전체 검증까지 진행.
- "API 응답 필드 이름 바꿔줘" → 트립와이어 발동, 모든 호출부를 확인하고 필드 삭제 대신 추가 방식(additive)을 제안.
- 리팩터링 중 같은 테스트가 두 번 연속 실패 → 무진행 가드로 멈추고 lessons 파일에 기록 후 사용자에게 보고.
· · · 설치 가이드 · · ·
설치 없이 지금 한 번 써보기
아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.
이 파일의 지시를 읽고 그대로 따라서 나를 도와줘: https://raw.githubusercontent.com/tamdogood/builder-essential-skills/HEAD/skills/code-standards/SKILL.md 내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)
Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.
↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 tamdogood/builder-essential-skills 의 skills/code-standards 폴더를 내 ~/.claude/skills/code-standards/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/tamdogood/builder-essential-skills.git && mkdir -p ~/.claude/skills && cp -r builder-essential-skills/skills/code-standards ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 엽니다.
- 저장소를 내려받습니다:
git clone https://github.com/tamdogood/builder-essential-skills.git - 스킬 폴더를 만듭니다:
mkdir -p ~/.claude/skills - 스킬을 복사합니다:
cp -r builder-essential-skills/skills/code-standards ~/.claude/skills/ ~/.claude/skills/code-standards/SKILL.md파일이 있는지 확인합니다.- Claude Code를 다시 실행하고 "이 버그 고쳐줘"처럼 코드 변경을 요청하면 스킬이 자동으로 적용됩니다.
- (권장) 프로젝트에
tasks/todo.md와tasks/lessons.md를 미리 만들어 두면 계획·교훈 기록 단계가 매끄럽게 동작합니다.
GitHub에서 원본 보기 ↗라이선스: MIT