ClaudeCode 바이브코딩 강의for CNLab
전체 강의Joohyung Chunv4.1.0

1. 초급

요청을 구체적으로 쓰고, 결과를 확인하고, 안전하게 수정합니다.

83개 항목

요청 쓰기

핵심 6 · 중요 9 · 참고 2
중요도키워드뜻이렇게 요청해 봅니다
핵심프롬프트(요청문)promptAI에게 보내는 지시 글입니다.

다음 요청문을 읽고 빠진 조건이 있으면 먼저 질문해 줘.

AI가 요청을 그대로 실행하지 않고 빠진 조건을 먼저 묻습니다.

핵심구조화 요청structured prompt사용자·기능·목적·제외 범위 등 항목으로 나눠 쓰는 요청입니다. 프롬프트 엔지니어링의 한 방법이며 조건을 비교·점검하기 쉽게 합니다.

사용자·기능·목적·제외 범위 네 항목으로 요청을 다시 정리해 보여 줘.

항목별로 정리된 요청문이 나와 서로 이해가 같은지 확인할 수 있습니다.

핵심요구사항requirements만들 것의 조건 목록으로, 요구사항.txt 같은 파일에 기록합니다.

지금까지 말한 조건을 requirements.md에 요구사항 목록으로 정리해 줘.

번호가 붙은 조건 목록 파일이 생기고 이후 작업의 기준이 됩니다.

핵심명세spec / specification만들 것을 글로 정확히 적은 것으로, PRD·spec.md 등이 해당합니다.

코드를 쓰기 전에 spec.md로 명세 초안을 작성해 줘. 구현은 내 확인을 기다린 뒤 시작해 줘.

무엇을 만들지 적은 문서가 먼저 나오고, 구현은 확인 뒤에 시작합니다.

핵심완료 기준(인수 기준)acceptance criteria끝났다고 판단할 수 있는 관찰 가능한 조건입니다. 요청에 적으면 AI가 스스로 확인하고 보고합니다.

완료 기준을 CSV 100행 모두 처리·오류 0건·결과 파일 생성 세 가지로 정해 줘. 충족 여부를 확인하고 모두 통과했을 때 완료로 보고해 줘.

AI가 세 조건을 확인한 뒤에만 완료를 보고합니다.

핵심수정 범위 제한scoped change고칠 파일·열·기능을 구체적으로 정하는 요청 방식입니다. 변경 내용과 실제 권한 설정을 함께 확인해 범위 이탈을 점검합니다.

C열 출처 표기만 고치고 나머지 파일과 열은 그대로 유지해 줘.

수정 전후의 차이로 지정한 부분과 범위 밖 변경 여부를 확인합니다.

중요기술 지정tech stack"Python으로" 또는 "엑셀 수식으로"처럼 사용할 도구를 요청문에 적는 것으로, 지정하지 않으면 AI가 선택합니다.

프레임워크 없이 HTML·JavaScript만으로 만들어 줘. Python은 사용하지 않게 해 줘.

지정한 도구로만 결과가 만들어집니다. 지정하지 않으면 AI가 선택합니다.

중요시안draft / variant같은 요청으로 만든 서로 다른 버전 2~3개 중에서 고를 수 있도록 제시하는 초안입니다.

첫 화면 문구 시안을 서로 다른 방향으로 3개 만들어 비교표로 보여 줘.

3가지 초안과 차이점 표가 나와 고를 수 있습니다.

중요메타 프롬프트(먼저 묻기)meta prompt상세설명 →"PRD 만들려면 내가 뭘 알려줘야 해?"처럼 요청을 준비하는 방법을 한 단계 위에서 묻는 요청입니다.

이 일을 잘 부탁하려면 내가 무엇을 먼저 알려 줘야 하는지 질문 목록으로 알려 줘.

AI가 필요한 정보를 질문 목록으로 돌려줍니다.

중요선택지 답하기choose an optionAI가 A/B 선택지를 물으면 번호로 답하거나 '추천대로'라고 답하는 방식입니다. 조건을 덧붙일 수 있습니다.

2번으로 진행하고 원본 파일은 그대로 보존해 줘.

AI가 제시한 선택지 중 하나로 진행하며 추가 조건을 함께 반영합니다.

중요결과 파일output file작업 폴더에 생긴 파일로, 답변과 구별되는 실제 작업 결과입니다.

답변으로 설명만 하지 말고 결과를 output/요약.md 파일로 저장해 줘.

작업 폴더에 실제 파일이 생기고 경로가 보고됩니다.

중요출력 폴더output folderAI가 만든 파일을 모아 두기로 정한 폴더입니다. 요청에 적으면 결과 위치를 예측할 수 있습니다.

결과는 output/ 폴더에만 저장하고 다른 폴더에는 아무것도 만들지 말아 줘.

결과물이 한 폴더에 모이고 원본 폴더는 깨끗하게 유지됩니다.

중요변경 이력change log언제 무엇을 왜 바꿨는지 적은 기록입니다.

오늘 바꾼 내용을 CHANGELOG.md에 날짜·무엇을·왜 형식으로 추가해 줘.

변경 기록이 쌓여 나중에 되돌리거나 설명할 때 근거가 됩니다.

중요작업 요약 보고summary report작업이 끝났을 때 받는 짧은 정리입니다. 바꾼 것과 못 한 것을 구분해 달라고 하면 검수가 빨라집니다.

끝나면 바꾼 파일·추가한 것·확인하지 못한 것을 표로 요약해 줘.

긴 로그 대신 표 형식의 요약을 받아 검수가 쉬워집니다.

중요모호하면 질문하기ask before actingAI가 추측으로 채우지 않고 멈춰서 묻게 하는 요청입니다. 환각과 범위 이탈을 줄입니다.

확실하지 않은 부분이 있으면 추측해서 진행하지 말고 먼저 질문해 줘.

AI가 가정을 세우는 대신 질문으로 멈춥니다.

참고페르소나persona사용자를 대표하는 한 사람의 설정으로, 퍼즐을 좋아하는 통근자 등이 예시입니다.

사용자는 '엑셀을 처음 배우는 신입 직원'이라고 가정하고 안내 문구를 써 줘.

가정한 사용자 수준에 맞춘 문구가 나옵니다.

참고유지보수maintenance만든 것을 다음 달에도 고치는 일로, 지속적인 수정을 위해 문서가 필요합니다.

다음 달에 다른 사람이 고칠 수 있도록 README에 실행 방법과 구조를 적어 줘.

유지보수용 문서가 생깁니다.

자료 주기(컨텍스트)

핵심 4 · 중요 6 · 참고 1
중요도키워드뜻이렇게 요청해 봅니다
핵심@ 파일 참조@file폴더 안 파일을 요청에 넣는 기호로, 입력하면 파일 목록이 표시됩니다.

@열정의.md와 @data/설문.csv를 읽고 열 이름이 열 정의와 다른 곳을 찾아 줘.

지정한 파일을 참조해 비교합니다. @ 참조 자체가 다른 파일 읽기를 금지하지는 않으므로 자료 범위와 권한을 따로 확인합니다.

핵심컨텍스트(작업 기억)context상세설명 →AI가 지금 답하고 작업하기 위해 참고하는 대화·읽은 파일·지침·도구 결과 등의 정보입니다. 참고할 수 있는 양에는 한도가 있으며, /context·/compact·/clear로 확인하고 정리합니다.

현재 참고한 파일과 중요한 결정을 요약해 줘. 기억 관리 조작이 필요하면 /context·/compact·/clear 중 어떤 것을 직접 선택할지 알려 줘.

현재 확인 가능한 맥락과 요약을 보고합니다. 파일 목록 보고가 전체 내부 컨텍스트의 완전한 조회를 뜻하지는 않습니다.

핵심토큰tokenAI가 입력·출력을 나눠 처리하는 단위로, 글자 수와 고정된 비율로 대응하지 않습니다.

이 폴더 전체를 읽으면 토큰이 얼마나 들지 먼저 추산하고, 필요한 파일만 골라 줘.

읽을 범위와 대략의 사용량 추산이 나옵니다.

핵심규칙 파일(CLAUDE.md)CLAUDE.md프로젝트의 CLAUDE.md 또는 개인 공통 지침 ~/.claude/CLAUDE.md에 작업 규칙을 적습니다. 적용 경로와 로드 여부를 확인하고 비밀값은 넣지 않습니다.

원본 불변·결과는 output/·표는 CSV라는 규칙을 CLAUDE.md에 추가해 줘.

해당 경로에서 로드되는 규칙 파일을 갱신하고 다음 대화에서 적용 여부를 확인합니다.

중요자동 압축auto-compact작업 기억이 차면 AI가 대화를 자동으로 요약하는 기능입니다. 요약되면서 세부가 빠질 수 있으므로 중요한 결정은 파일로 남깁니다.

압축되기 전에 정한 규칙과 남은 일을 progress.md에 기록해 줘.

압축 후에도 파일에서 규칙과 진행 상황을 다시 읽을 수 있습니다.

중요자료 범위 좁히기scope요청에 필요한 파일과 부분을 구체적으로 고르는 방식입니다. 읽는 범위를 좁히고 비용·정확도는 사용량과 검수로 확인합니다.

폴더 전체 말고 @정리규칙.txt와 2024년 파일 3개만 보고 판단해 줘.

지정한 자료에 집중해 읽는 범위를 줄입니다. 비용과 정확도는 실제 사용량과 검수 결과로 확인합니다.

중요노력 수준effort모델의 추론 노력을 조절하는 설정입니다. 지원 모델·값을 확인하며 실제 effort 설정과 요청문의 표현을 구분합니다.

현재 모델이 지원하는 effort 설정과 실제 값을 확인해 줘. 표 정리와 설계 검토에 맞는 값을 제안하고 내 확인 뒤 지원되는 설정 방법으로 바꿔 줘.

지원되는 모델·설정에서 실제 effort 값을 확인합니다. 자연어로 높은 노력을 요청하는 것만으로 설정 변경을 보장하지는 않습니다.

중요세션(이어서 하기)session저장·재개하거나 백그라운드로 이어갈 수 있는 대화 단위입니다.

어제 세션에서 정한 규칙을 이어서 적용해 줘. 기억이 없으면 progress.md를 읽어 줘.

이전 대화를 재개하거나 파일 기록으로 맥락을 복원합니다.

중요사용 한도usage limit일부 구독에 적용되는 시간대별 사용 한도입니다. /usage로 남은 양과 재설정 시각을 확인합니다.

현재 확인 가능한 사용 한도와 재설정 시각을 알려 줘. 보이지 않는 값은 추측하지 말고 /usage에서 내가 확인할 항목을 안내해 줘.

계정에서 확인 가능한 한도 정보를 보고하고 미확인 값은 구분합니다.

중요화면 캡처·이미지 첨부screenshot상세설명 →화면을 이미지로 저장해 AI에게 전달합니다. 로컬은 붙여넣기·파일 첨부, SSH는 원격 컴퓨터로 파일을 옮긴 뒤 경로를 전달하는 방법을 구분합니다.

개인정보·비밀값을 가린 캡처 화면에서 오류를 읽고 원인 후보와 확인 방법을 설명해 줘.

AI가 이미지 속 글자·화면을 읽어 답합니다.

참고구독 vs APISubscription vs Application Programming Interface응용 프로그램 인터페이스(Application Programming Interface)의 줄임말인 API의 종량 과금과 정액 구독의 포함 이용량을 구별하는 개념입니다. 추가 사용료 조건은 별도로 확인합니다.

이 자동화를 API 키로 돌리면 월 비용이 얼마쯤 되는지 토큰 기준으로 추산해 줘.

정액 구독과 종량 API의 비용 차이를 비교한 추산이 나옵니다.

결과 확인·검수

핵심 7 · 중요 5
중요도키워드뜻이렇게 요청해 봅니다
핵심환각hallucination그럴듯하지만 사실이 아닌 내용으로, 출처·날짜·수치 등을 원문과 대조해야 합니다.

출처는 실제로 확인한 것만 적고, 확인하지 못한 것은 '미확인'으로 표시해 줘.

지어낸 출처가 줄고 미확인 항목이 구분됩니다.

핵심근거·출처evidence / source정보·수치가 어느 파일의 어느 문장에서 왔는지 적는 것입니다. 요청에 넣으면 환각을 가장 쉽게 잡아냅니다.

각 항목에 근거가 된 파일 이름과 문장을 함께 붙여 줘. 근거가 없으면 '근거 없음'으로 적어 줘.

모든 주장에 출처가 붙어 원문 대조가 가능해집니다.

핵심에러와 버그error / bug에러는 실행·처리 문제이고 버그는 기대 동작과 다른 결함으로, 색이나 멈춤 여부만으로 구분하지 않습니다.

지금 난 것이 실행 에러인지 기대와 다른 동작(버그)인지 구분해 설명해 줘.

문제의 종류가 구분되어 다음 조치가 정해집니다.

핵심재현 단계(오류 그대로 전달)reproduction steps오류 메시지 전문과 '무엇을 했더니 났는지' 순서를 함께 전달하는 방식입니다. 비밀값·개인정보는 먼저 가립니다.

비밀값과 개인정보를 가린 오류 메시지 전문과 실행 순서를 바탕으로 재현 단계를 정리하고 원인 후보를 찾아 줘.

AI가 같은 상황을 재현해 원인을 좁힙니다.

핵심변경 내용(diff)diff수정 전후의 차이입니다. AI 보고와 Git에서 '+/-' 줄로 표시되며, 요청한 범위 밖의 변경을 잡아내는 도구입니다.

수정이 끝나면 어떤 파일의 어느 줄이 바뀌었는지 변경 내용(diff)을 보여 줘.

바뀐 줄이 전후 비교로 표시되어 관련 없는 변경을 찾을 수 있습니다.

핵심원본 불변keep originals원본 파일은 읽기만 하고 정리본은 새로 만드는 원칙입니다.

원본 폴더는 읽기만 하고 정리본은 output/에 새 파일로 만들어 줘.

원본이 그대로 남고 결과는 별도 파일로 생깁니다.

핵심테스트test기능이 기대대로 동작하는지 확인하는 코드·절차입니다. 요청에 검사할 입력과 기대 결과를 함께 적습니다.

합계 계산 함수가 맞는지 확인하는 테스트를 만들고 실행 결과를 보여 줘.

기대값과 실제값을 비교한 테스트 결과(통과/실패)가 나옵니다.

중요확률적 동작probabilistic같은 요청에도 결과가 조금씩 달라지는 성질입니다. 계산기처럼 항상 같지 않으므로 숫자는 코드로 재계산합니다.

같은 입력으로 두 번 실행해 결과가 달라지는 부분이 있는지 비교해 줘.

결과가 흔들리는 부분을 알게 되어 검수 지점을 정할 수 있습니다.

중요대조 검수(숫자·날짜·이름·단위·근거)verification숫자·날짜·이름·단위·근거 다섯 가지를 원문과 대조하는 검수 기준입니다. 숫자는 코드로 다시 세어 비교합니다.

보고서의 숫자·날짜·이름·단위·근거를 원문과 하나씩 대조해 불일치 목록을 만들어 줘.

다섯 축의 불일치 목록이 나옵니다.

중요검수표review sheet항목·대조한 원문·결과·확인자·날짜를 기록하는 표입니다.

항목·대조한 원문·결과·확인자·날짜 열로 검수표.md를 만들어 줘.

검수 기록 파일이 생겨 누가 무엇을 확인했는지 남습니다.

중요처리 로그processing log제외한 행 수·이유·기준을 적은 기록입니다.

제외한 행 수와 이유, 적용한 기준을 처리로그.md에 남겨 줘.

어떤 자료가 왜 빠졌는지 기록으로 남습니다.

중요로그log실행 기록이며, “로그를 남기고 다시 실행해 보여 달라”고 요청할 때 사용합니다.

각 단계의 처리 건수·상태·소요 시간만 허용 필드로 로그에 남기고 다시 실행해 줘. 민감 본문과 비밀값은 제외해 줘.

실행 기록이 남아 어디서 잘못됐는지 추적할 수 있습니다.

안전·개인정보

핵심 7 · 중요 6
중요도키워드뜻이렇게 요청해 봅니다
핵심승인(허락 질문)permission prompt도구 실행 전에 사용자의 허락을 묻는 절차입니다. 질문 여부는 현재 권한 모드와 기존 규칙에 따라 달라집니다.

현재 권한 모드와 허용 규칙을 확인해 줘. 삭제·외부 전송 직전에 확인을 받도록 설정하고 실제로 멈추는지 안전한 예시로 시험해 줘.

현재 모드·기존 허용 규칙과 확인 시험 결과를 보고합니다. 요청문만으로 승인 질문을 보장하지 않습니다.

핵심되돌릴 수 없는 작업irreversible actions삭제·덮어쓰기·전송·설치·결제의 다섯 가지는 실행 전에 확인해야 하며, 복구 가능성은 각각 다릅니다.

삭제·덮어쓰기·전송·설치·결제가 필요하면 실행 전에 영향과 복구 가능성을 정리해 줘. 실행은 내 확인을 기다려 줘.

동작별 영향과 복구 가능성을 검토합니다. 실제 승인·권한 장치의 적용 여부는 따로 확인합니다.

핵심비밀값(API 키·비밀번호)Secrets (Application Programming Interface keys and passwords)응용 프로그램 인터페이스(Application Programming Interface)의 줄임말인 API의 인증 키와 비밀번호 같은 비밀정보를 뜻합니다. 비밀 관리 도구와 접근 권한으로 보호합니다.

프로그램이 실행 중에만 비밀값을 읽도록 구성해 줘. AI가 .env 원문을 읽지 않게 하고 로컬 검사에서 마스킹된 결과만 전달해 줘.

프로그램의 비밀값 사용과 AI에 전달하는 자료를 분리하고, 마스킹된 검사 결과로 노출 여부를 확인합니다.

핵심개인 식별 정보PII직접 또는 다른 정보와 결합해 개인을 알아볼 수 있는 자료입니다.

이름·전화번호·이메일을 찾는 로컬 검사 스크립트를 만들어 줘. 민감값은 출력하지 말고 마스킹된 파일 식별자·건수만 전달하게 해 줘.

로컬에서 확인한 건수와 마스킹된 식별자만 검토합니다. 원문을 AI에 전달하면 외부 처리 대상이 됩니다.

핵심읽기 전용read-onlyMCP·DB 연결에서 쓰기 권한을 주지 않는 방식으로, 말로만 지시하지 않고 실제 권한으로 변경을 막습니다.

읽기 전용으로 조회·보고만 해 줘. 실제 권한을 확인하고 파일 생성·수정은 제외해 줘.

조회·보고 범위와 실제 읽기 전용 권한의 적용 여부를 확인합니다.

핵심에이전트agent답변만 하지 않고 파일을 읽고 만들며 명령을 실행하는 AI입니다. Claude Code가 그렇습니다.

이번에는 에이전트처럼 파일을 고치지 말고 설명만 해 줘.

실행 없이 설명만 돌아옵니다.

핵심마스킹masking민감한 값의 일부 또는 전부를 가려 노출을 줄이는 처리입니다. 로그·AI 입력 전에 적용하며 원문 전체 제거와 구분합니다.

민감값을 AI에 보내기 전에 로컬에서 마스킹하는 스크립트를 만들어 줘. 이름·이메일·API 키가 남는지 가상 자료로 검사해 줘.

마스킹 처리와 가상 자료 검사 결과를 확인합니다. 남을 수 있는 식별 위험은 따로 점검합니다.

중요don't ask againdon't ask again같은 종류의 실행을 반복 허용하는 선택지입니다. 허용 범위와 현재 모드를 확인한 뒤 선택합니다.

다시 묻지 않기를 선택했을 때 허용되는 범위를 설명해 줘. 현재 모드·기존 규칙도 확인하고 필요한 작업은 실행 전에 묻게 설정해 줘.

반복 허용 범위와 현재 규칙을 확인합니다. 해당 선택지를 누르지 않아도 모드·기존 규칙에 따라 질문 없이 실행될 수 있습니다.

중요허용 범위allowed scopeAI가 읽고·쓰고·실행해도 되는 범위입니다. 요청에 적는 것부터 시작하고, 중급에서 권한 규칙으로 고정합니다.

수정은 src/로 제한하고 data/와 .env 원문은 읽지 않게 해 줘. 요청 범위와 실제 권한 설정을 나눠 점검하고 차단 시험 결과를 보여 줘.

요청 범위와 실제 권한 적용 범위를 구분해 보고합니다. 자연어만으로 접근을 차단하지는 않습니다.

중요.envdotenv프로그램이 실행할 때 읽는 설정 파일이며 비밀값이 들어갈 수 있습니다. AI에게 원문을 읽히지 않고 실제 값 없는 .env.example을 공유합니다.

실제 값 없이 필요한 키 이름만 담은 .env.example을 만들어 줘.

실제 비밀값이 없는 예시 파일을 만들고 키 이름만 포함됐는지 확인합니다.

중요비식별de-identification개인을 알아볼 가능성을 줄이는 처리입니다. 이름만 지워도 나이·학과·날짜 조합으로 드러날 수 있어 함께 처리합니다.

원문을 AI에 보내지 않는 로컬 비식별 처리 절차를 만들어 줘. 나이·학과·날짜 조합의 식별 위험을 점검하고 마스킹된 검증 결과만 전달해 줘.

로컬 처리 사본과 위험 점검 결과를 확인합니다. 비식별 처리가 익명성을 보장하지는 않습니다.

중요정보 최소화data minimization목적에 필요한 최소 자료만 처리하는 원칙입니다.

집계에 필요한 열(주문일·금액)만 추출한 사본으로 작업해 줘.

필요한 열만 남은 자료로 작업해 노출 범위가 줄어듭니다.

중요외부 전송data leaves the device요청에 넣은 자료는 외부 서버에서 처리될 수 있다는 전제입니다. 민감한 원본은 가상 자료로 바꾸거나 범위를 먼저 확인합니다.

외부 전송이 금지된 자료를 AI에 보내지 않는 로컬 처리 방법만 제안해 줘. 자료 원문은 읽지 않게 해 줘.

자료를 보내지 않는 대안이 제시됩니다.

계획·되돌리기·Git

핵심 8 · 중요 6
중요도키워드뜻이렇게 요청해 봅니다
핵심계획 모드(계획 먼저)plan mode구현 전에 조사·계획을 하는 권한 모드입니다. /plan 또는 Shift+Tab으로 전환하고 표시된 현재 모드를 확인합니다.

현재 계획 모드인지 먼저 확인해 줘. 구현은 하지 말고 변경할 파일과 검증 방법을 plan.md 초안으로 보여 주고 내 확인을 기다려 줘.

계획 초안을 확인합니다. 계획만 요청하는 문장과 /plan 또는 Shift+Tab으로 실제 계획 모드에 들어가는 조작은 구분합니다.

핵심GitGit파일 변경 이력을 남기는 도구입니다. 초기화·커밋·변경 비교 등을 AI에게 표준 용어로 요청합니다.

이 폴더를 Git으로 관리 시작하고 첫 커밋을 만들어 줘.

변경 이력을 남길 준비가 됩니다.

핵심커밋commit선택한 변경을 이력으로 남기는 저장 지점입니다. 커밋 대상을 확인하고 비밀값·요청 밖 변경을 제외합니다.

지금까지 바꾼 내용을 커밋해 줘.

되돌아갈 수 있는 저장 지점이 생깁니다.

핵심되돌리기revert / restore커밋을 취소하는 이력 추가와 파일 변경 취소를 구분해 선택하는 작업입니다.

취소할 파일과 변경 내용(diff)을 먼저 보여 줘. 다른 작업의 변경은 보존하고 백업과 복원 방법을 준비한 뒤 내 승인을 받아 지정한 부분만 되돌려 줘.

선택한 변경만 복원하고 나머지 작업을 보존했는지 차이로 확인합니다.

핵심체크포인트checkpoint사용자 턴 시작 시 생성되는 복구 지점입니다. /rewind에서 지점과 복구 대상을 직접 선택하며 Git 커밋·백업을 대신하지 않습니다.

복원할 후보와 변경 범위를 설명해 줘. 내가 /rewind에서 지점과 파일만 복구를 선택한 뒤 다른 작업과 셸 변경이 보존됐는지 확인해 줘.

선택한 지점의 추적된 파일 변경을 복원했는지 확인합니다. 셸 변경·일부 서브에이전트 변경·외부 효과는 복원 대상이 아닙니다.

핵심GitHubGitHubGit 저장소를 올려 두는 사이트이며, 교재에서는 비공개(private)로 사용합니다.

커밋할 파일과 민감정보를 먼저 점검해 줘. GitHub의 대상 저장소와 공개 범위를 보여 주고 내 확인 뒤 비공개 저장소에 반영해 줘.

전송 전 파일·민감정보·공개 범위를 확인하고 승인한 저장소의 실제 반영 결과를 점검합니다.

핵심푸시·풀push / pull각각 커밋을 전송하는 작업과 원격 변경을 가져와 통합하는 작업입니다.

푸시할 커밋·파일·민감정보 포함 여부와 저장소 공개 범위를 먼저 보여 줘. 내 확인 뒤에 GitHub에 푸시하고 원격 반영 결과도 확인해 줘.

전송 전 점검과 확인을 거친 커밋을 원격 저장소에 반영하고 결과를 확인합니다.

핵심백업·복원backup / restore커밋에 들어가지 않는 원본·설정까지 별도 사본으로 보존하고 필요할 때 복구하는 절차입니다.

수정 전 원본을 별도 위치에 백업해 줘. 백업 대상과 복원 방법을 기록하고 사본으로 복원 시험을 해 줘.

백업 사본과 대상·복원 절차가 생기고 시험한 범위의 복원 결과를 확인합니다.

중요단계별 진행step by step계획의 1~3단계만 수행하고 확인한 뒤 다음 단계로 진행하는 방식입니다.

계획의 1~2단계만 진행하고 멈춰서 결과를 보여 줘.

작은 단위로 멈춰 확인할 수 있습니다.

중요커밋 메시지commit message무엇을 왜 바꿨는지 한 줄로 적은 설명입니다.

커밋 메시지는 무엇을 왜 바꿨는지 한국어 한 줄로 써 줘.

이력만 봐도 변경 이유를 알 수 있습니다.

중요.gitignoregitignoreGit이 아직 추적하지 않는 파일을 제외하는 규칙 파일입니다. 이미 추적 중인 파일과 과거 커밋에는 소급 적용되지 않습니다.

공유하지 않을 .env와 원본 자료 경로를 .gitignore에 추가해 줘. 이미 추적 중인 파일과 과거 커밋도 별도로 점검하고 푸시 전에 결과를 보여 줘.

새로 추적할 파일의 제외 규칙을 설정합니다. 이미 추적 중인 파일·과거 커밋의 민감정보는 따로 조치합니다.

중요저장소repositoryGit이 관리하는 폴더 한 개를 뜻합니다.

이 저장소의 구조와 최근 커밋 5개를 요약해 줘.

저장소 개요가 나옵니다.

중요비공개 저장소private repositoryGitHub에서 초대한 사람만 볼 수 있는 저장소입니다. 내부 업무 자료·코드는 공개 범위를 확인해 관리합니다.

푸시하기 전에 저장소가 비공개(private)인지 확인하고 공개면 멈춰 줘.

푸시 전에 저장소 공개 범위를 확인하고 조건이 맞지 않으면 중단합니다.

중요드라이런(미리보기)dry run파일·서비스를 실제 변경하지 않고 예정된 동작과 영향을 확인하는 시험입니다. 도구가 미리보기를 지원하는지 확인합니다.

실제 변경 없이 드라이런으로 바뀔 파일과 영향을 보여 줘. 미리보기를 지원하지 않으면 실행하지 말고 계획만 설명해 줘.

지원되는 미리보기 결과 또는 실행 계획을 확인합니다. 드라이런 지원 여부와 남은 위험을 구분합니다.

함께 쓰는 도구

중요 3
중요도키워드뜻이렇게 요청해 봅니다
중요ccstatusline(상태 표시줄)ccstatusline상세설명 →Claude Code 아래에 모델·작업 폴더·문맥 사용량 등을 모아 보여 주는 상태 표시줄 도구입니다.

ccstatusline으로 모델·컨텍스트 사용률이 보이게 상태 표시줄을 설정해 줘. 실제 표시되는 항목도 확인해 줘.

모델·컨텍스트 사용량 등 지원되는 표시 항목과 설정 결과를 확인합니다.

중요OrcaOrca상세설명 →Claude Code·Codex 같은 코딩 에이전트의 작업 공간을 분리해 관리하고 결과를 비교·검토하는 데 사용하는 데스크톱 앱입니다. 선택한 제품과 작업 공간을 구분합니다.

Orca에서 작업 공간을 열고 작업별로 분리해 쓰는 순서를 안내해 줘. Claude Code와 Codex 중 선택한 도구를 구분해서 설명해 줘.

선택한 도구와 작업 공간을 구분하고 열기·작업·결과 확인 순서를 안내합니다.

중요Node.jsNode.jsJavaScript를 컴퓨터에서 실행하는 프로그램입니다. Claude Code의 권장 네이티브 설치에는 필요 없고, ccstatusline처럼 npx로 실행하는 도구를 쓸 때 설치합니다.

ccstatusline 실행에 Node.js가 필요한지 확인하고 현재 설치 상태와 필요한 준비 순서를 알려 줘. 설치가 필요하면 먼저 이유와 방법을 보여 줘.

도구별 Node.js 필요 여부와 설치 상태·준비 절차를 확인합니다.

목적별 요청 방법

9가지

작업 내용을 GitHub에 올리기

언제 · 오늘 바꾼 것을 저장·공유하고 되돌릴 지점을 남길 때 사용합니다.

지금까지 바꾼 내용을 커밋하고 GitHub에 푸시해 줘. 먼저 전송할 커밋·파일·민감정보와 저장소 공개 범위를 보여 주고 내 확인을 기다려 줘.

커밋 메시지는 무엇을 왜 바꿨는지 한 줄로 써 줘. .env와 원본 자료는 제외하고 이미 추적 중인 파일·과거 커밋도 별도로 점검해 줘.

→ 전송 전 점검과 사용자 확인 뒤 커밋을 원격에 반영하고 실제 반영 결과를 확인합니다.

확인할 점

  • 푸시 전에 커밋·파일·민감정보·저장소 공개 범위를 확인합니다.
  • .gitignore는 기존 추적 파일과 과거 커밋을 제외하지 않습니다.

관련 키워드 커밋 · 푸시·풀 · GitHub · 커밋 메시지 · .gitignore · 비밀값(API 키·비밀번호) · 비공개 저장소

원하는 것을 정확히 요청하기

언제 · 새 일을 시작할 때 사용합니다.

회원 명단 관리 웹페이지를 만들려면 내가 무엇을 먼저 알려 줘야 하는지 질문해 줘.

내 답을 바탕으로 요구사항을 requirements.md에 정리하고 눈으로 확인할 완료 기준을 적어 줘.

→ 질문 → 요구사항 파일 → 완료 기준 순서로 기준이 생깁니다.

확인할 점

  • 완료 기준이 눈으로 확인 가능한 조건인지 확인합니다.

관련 키워드 메타 프롬프트(먼저 묻기) · 구조화 요청 · 요구사항 · 완료 기준(인수 기준) · 기술 지정

바꾸기 전에 계획 먼저 보기

언제 · 여러 파일이 바뀔 것 같을 때 사용합니다.

현재 계획 모드를 확인해 줘. 코드는 고치지 말고 plan.md에 쓸 계획 초안을 먼저 보여 줘.

내가 확인한 계획의 1~2단계만 진행하고 멈춰서 변경 내용을 보여 줘.

→ 계획 초안과 확인한 단계의 변경 내용을 검토합니다. 실제 모드 전환은 /plan 또는 Shift+Tab으로 확인합니다.

확인할 점

  • 현재 모드·기존 허용 규칙과 계획의 변경 파일·검증 방법을 확인합니다.
  • 계획 요청문과 실제 모드 전환을 구분합니다.

관련 키워드 계획 모드(계획 먼저) · 단계별 진행 · 변경 내용(diff) · 수정 범위 제한

자료를 주고 그 안에서만 답하게 하기

언제 · 정리·요약·검색 요청에 사용합니다.

민감값이 없는 @열정의.md의 열 정의를 기준으로 @data/설문.csv를 요약해 줘. 파일에 없는 내용은 없음으로 적어 줘.

각 항목에 근거 파일과 문장을 붙이고 지정한 자료 밖을 읽어야 하면 먼저 이유를 알려 줘.

→ 지정 자료를 근거로 한 요약을 확인합니다. @ 참조 자체가 다른 자료 읽기를 금지하지는 않습니다.

확인할 점

  • 자료에 민감값이 없는지 확인하고 근거 없는 문장·요청 범위 밖 읽기 여부를 점검합니다.

관련 키워드 @ 파일 참조 · 자료 범위 좁히기 · 근거·출처 · 환각

결과 검수하기

언제 · 표·보고서를 받은 직후 사용합니다.

보고서의 숫자를 원본 CSV에서 코드로 다시 계산해 비교표를 만들어 줘.

검수표.md에 항목·대조한 원문·결과·확인자·날짜를 기록해 줘.

→ 재계산 비교표와 검수 기록이 생깁니다.

확인할 점

  • 숫자·날짜·이름·단위·근거 다섯 축이 모두 대조됐는지 확인합니다.

관련 키워드 대조 검수(숫자·날짜·이름·단위·근거) · 검수표 · 처리 로그 · 확률적 동작 · 테스트

오류·버그 해결 요청하기

언제 · 실행이 멈추거나 결과가 기대와 다를 때 사용합니다.

비밀값·개인정보를 가린 오류 메시지 전문과 실행 순서를 바탕으로 재현 단계를 정리하고 원인 후보를 찾아 줘.

고치기 전에 원인 후보의 근거와 수정 범위를 먼저 알려 줘.

→ 재현 여부·원인 후보·수정 범위와 미확인 사항을 확인합니다.

확인할 점

  • 오류 전문을 붙였는지, 개인정보·키를 가렸는지 확인합니다.

관련 키워드 재현 단계(오류 그대로 전달) · 에러와 버그 · 로그 · 화면 캡처·이미지 첨부 · 수정 범위 제한

잘못됐을 때 되돌리기

언제 · 수정 결과가 마음에 들지 않을 때 사용합니다.

되돌릴 파일과 변경 내용(diff)을 먼저 보여 줘. 다른 작업의 변경은 보존하고 백업·복원 절차를 준비한 뒤 내 확인을 받아 지정한 부분만 되돌려 줘.

체크포인트 복원은 내가 /rewind에서 지점과 파일만 복구를 선택하도록 안내해 줘. 선택 후 복원된 범위를 확인해 줘.

→ 선택한 파일·변경의 복원 결과와 다른 작업의 보존 여부를 확인합니다.

확인할 점

  • 미커밋 변경과 백업을 먼저 확인합니다.
  • 셸 변경·일부 서브에이전트 변경·외부 전송은 체크포인트 복원 대상이 아닙니다.

관련 키워드 체크포인트 · 되돌리기 · 커밋 · 되돌릴 수 없는 작업 · 백업·복원 · 드라이런(미리보기)

개인정보·비밀값 지키기

언제 · 개인정보·계정 정보가 있는 폴더에서 일할 때 사용합니다.

민감값을 출력하지 않는 로컬 검사 스크립트를 만들어 줘. AI에는 원문 대신 마스킹된 식별자·유형·건수만 전달하게 해 줘.

이름·연락처를 가리는 마스킹 절차를 만들어 줘. 가상 자료로 먼저 시험하고 실제 원문은 로컬에 보관해 AI에 보내지 않게 해 줘.

→ 로컬 검사·마스킹 절차와 민감값을 가린 검증 결과를 확인합니다. 원문을 AI에 전달하면 외부 처리 대상이 됩니다.

확인할 점

  • 원본·.env 원문이 AI 입력이나 로그에 포함되지 않았는지 확인합니다.
  • 마스킹 뒤에도 주변 정보로 개인을 알아볼 수 있는지 점검합니다.

관련 키워드 개인 식별 정보 · 비식별 · 정보 최소화 · 읽기 전용 · 외부 전송 · 원본 불변 · 마스킹

범위를 정해 안전하게 수정하기

언제 · 기존 결과물을 조금만 고칠 때 사용합니다.

C열 출처 표기만 고치고 나머지는 유지해 줘. 끝나면 변경 내용(diff)을 보여 줘.

수정은 src/로 제한해 줘. 민감 원문은 읽지 말고 요청 범위와 실제 권한 적용 범위·차단 시험 결과를 따로 보고해 줘.

→ 변경 내용과 요청 범위·실제 권한 적용 범위를 비교합니다. 자연어 지시만으로 접근을 차단하지는 않습니다.

확인할 점

  • diff에 요청하지 않은 파일이 있는지 확인합니다.

관련 키워드 수정 범위 제한 · 허용 범위 · 변경 내용(diff) · 승인(허락 질문) · 작업 요약 보고

직접 조작

13개 · 핵심 5 · 중요 8

말로 요청하지 않고 직접 입력하거나 누르는 조작입니다.

중요도조작하는 일Mac / Windows
핵심/clear현재 대화 맥락을 비우고 새로 시작합니다. 규칙 파일은 유지하지만 필요한 결정·진행 기록은 먼저 파일로 남깁니다.

다른 작업으로 넘어가기 전에 필요한 기록을 저장한 뒤 사용합니다.

같음
핵심/compact대화를 요약해 컨텍스트 공간을 확보합니다. 요약에서 세부 정보가 빠질 수 있습니다.

같은 작업을 이어가면서 컨텍스트 공간을 확보할 때 사용합니다.

같음
핵심/rewind복구 지점과 파일·대화 복구 대상을 직접 선택합니다. 사용자 턴 시작 시 생성된 지점의 추적된 변경만 대상으로 하며 셸 변경·일부 서브에이전트 변경·외부 효과는 제외합니다.

복구할 범위와 다른 작업의 변경을 확인하고 백업한 뒤 사용합니다. 파일만 복구를 선택하면 대화를 유지합니다.

같음 /rewind 또는 Esc Esc (빈 입력칸)
핵심@파일·폴더 경로 자동완성을 열어 요청에 참조를 추가합니다. 다른 파일의 접근을 금지하는 기능은 아닙니다.

민감정보를 제외한 참조 자료를 지정할 때 사용합니다.

같음
핵심/plan계획 모드로 진입하는 공식 명령입니다. 전환 후 표시된 모드와 허용 범위를 확인합니다.

구현 전에 조사·계획을 진행할 때 사용합니다. 계획만 요청하는 자연어와 실제 모드 전환을 구분합니다.

같음
중요/context컨텍스트 사용량과 구성 항목을 확인합니다.

컨텍스트 사용량과 큰 비중을 차지하는 항목을 확인할 때 사용합니다.

같음
중요/usage계정에서 제공하는 사용량·한도·재설정 정보를 확인합니다. 구독·API 계정에 따라 표시 내용이 다릅니다.

큰 작업을 시작하기 전에 현재 계정의 표시 가능한 한도 정보를 확인합니다.

같음
중요/model사용 가능한 모델을 선택합니다. 계정·환경별 제공 모델과 비용 조건을 확인합니다.

작업 난이도·품질·비용에 맞춰 모델을 선택할 때 사용합니다.

같음
중요/resume저장된 이전 대화를 선택해 재개합니다.

이전 대화의 작업을 이어갈 때 사용합니다.

같음
중요Shift+Tab현재 사용할 수 있는 권한 모드를 순환합니다. 고정된 순서보다 표시된 모드와 기존 허용 규칙을 확인합니다.

계획·편집 등 작업에 맞는 모드를 선택합니다. 권한 질문 화면에서는 같은 키의 동작이 다를 수 있어 표시된 선택지를 확인합니다.

MacShift+Tab
WinShift+Tab (작동하지 않으면 Alt+M)
중요!입력 맨 앞의 !로 셸 명령을 직접 실행하고 출력을 대화에 추가합니다. 출력 내용은 모델에 전달될 수 있습니다.

직접 실행할 내용을 이해한 확인 명령에 사용합니다. 비밀값·개인정보를 출력하는 명령은 사용하지 않습니다.

같음
중요줄바꿈요청을 전송하지 않고 줄을 바꿉니다. Shift+Enter는 iTerm2·Apple Terminal·Windows Terminal 등 지원 터미널에서 작동하며 다른 터미널은 설정이 필요할 수 있습니다. Ctrl+J 또는 백슬래시 뒤 Enter를 대체 조작으로 사용합니다.

여러 줄 요청을 작성할 때 사용하며 실제 터미널에서 전송 없이 줄이 바뀌는지 확인합니다.

같음 Shift+Enter (지원 터미널) 또는 Ctrl+J
중요이미지 붙여넣기준비한 이미지를 요청에 첨부합니다. WSL은 Ctrl+V도 지원하지만 터미널이 가로채면 Alt+V를 사용합니다.

오류 화면을 전달할 때 사용하며 첨부 전에 이미지의 개인정보·비밀값을 가립니다.

MacCtrl+V (iTerm2에서는 Cmd+V)
WinAlt+V (Windows·WSL)