부록 G · 내 결과물을 포트폴리오로

이 부록으로 하는 일

이미 만든 여섯 결과물 가운데 하나를 골라, 다른 사람이 열었을 때 무엇을 만든 것인지 바로 읽히게 정리합니다. 새로 만드는 것은 없습니다. 보이게 하는 것이 전부입니다.

보는 사람이 알고 싶은 것은 네 가지입니다. 어떤 문제를 해결하려 했나, AI와 어떻게 만들었나, 자신은 어떤 판단을 했나, 결과를 어떻게 확인하고 개선했나. 아래 골격의 절 제목이 그 네 가지입니다.

프롬프트

prompts.md에 이 부록에서 Claude Code에 입력하는 문장이 책의 순서대로 있습니다.

순서대로 합니다

1. 대표 프로젝트 하나를 고릅니다. 내 분야나 지원하려는 자리의 반복 업무와 가장 가까운 하나를 고릅니다. 나머지는 「같은 방법으로 만든 것」에 한 줄씩만 연결합니다. 내 소재로 다시 만드는 일은 필수가 아니며, 원하면 prompts.md의 첫 요청문으로 시작합니다.

2. README를 완성합니다. templates/project-readme.md를 고른 저장소의 README.md에 붙이고 〈 〉를 채웁니다. 결과 화면과 실제로 열리는 주소를 준비·실행보다 먼저 둡니다. templates/prompts.md에는 처음 시킨 것, 원인을 찾게 시킨 것, 검사를 만들게 시킨 것 세 개만 옮깁니다. 당시 원문을 찾지 못해 다시 적었다면 「나중에 재구성한 요약」이라고 표시합니다.

3. 검증 기록을 만들고 공개 전 검사를 합니다. templates/verification.md를 docs/verification.md로 가져가 실제로 돌린 검사와 결과만 적습니다. 이어 prompts.md의 공개 전 요청문으로 현재 파일뿐 아니라 지난 Commit의 API Key·환경변수·개인정보·사용 조건도 검사합니다. 한 번이라도 노출된 Key는 파일에서 지우는 것으로 끝내지 않고 폐기한 뒤 새로 발급받습니다.

4. 저장소를 공개하고 목록에서 보이게 합니다. 공개 전 검사를 통과한 뒤에만 GitHub 저장소의 공개 상태를 바꿉니다. About의 Description·Website와 Topics를 채우고 대표 저장소 하나를 Pin합니다. 프로필 README와 Social preview는 선택 단계이며 guides/github-profile.md에 모았습니다.

가져다 쓰는 것

세 파일 모두 〈 〉만 채우면 됩니다. 채우지 못한 자리는 지어내지 않고 비워둡니다.

함께 보는 곳

• 저자가 같은 것을 어떻게 남겼는지는 verification/에서 볼 수 있습니다.
• 발급받은 Key를 폐기하고 새로 받는 순서는 appendix-d/에 있습니다.
• Markdown 표기가 낯설면 Markdown 여덟 형식을 봅니다.
• 대표 프로젝트를 GitHub 목록과 프로필에 보이게 하는 선택 절차는 GitHub 프로필 가이드에 있습니다.

이 부록의 프롬프트는 모두 Claude Code에 입력합니다.

책에 나오는 순서대로 담았습니다. 책을 읽으면서 그 자리에 왔을 때 사용하세요. 직접 타이핑해도 되고 복사해서 붙여넣어도 됩니다.

고른 하나의 저장소가 열려 있는 상태에서 사용합니다.

여섯 개를 다 내세우지 않고 하나를 고릅니다

내 분야의 문제로 다시 만들고 싶어. 〈여기에 내가 다루려는 것을 적는다〉
〈N〉장에서 만든 것과 같은 방법으로 만들어줘.
무엇이면 제대로 된 결과인지 완료 조건을 먼저 정하고, 그것을 확인하는 Test까지 같이 만들어줘.

이 부록을 끝낸 다음의 한 걸음입니다. 지금 하지 않아도 됩니다.

저장소를 열면 3초 안에 무엇인지 보이게 합니다

README를 첫 화면 기준으로 다시 정리해줘.
맨 위에 한 줄 소개와 결과 화면, 열어보는 주소를 두고 준비와 실행은 그 아래로 내려줘.
그 아래에 「어떤 문제를 해결하려 했나」, 「AI와 어떻게 만들었나」, 「내가 판단한 것」,
「어떻게 확인하고 개선했나」 네 절을 이 순서로 만들어줘.
지금 저장소에 실제로 있는 것만 적고, 없는 것은 〈 〉로 비워둬.
설치·실행·Test 명령과 인증값 파일 이름은 이 저장소에서 직접 확인해 채워줘.

templates/project-readme.md를 붙여넣은 다음에 사용합니다.

내가 무엇을 판단했는지 남깁니다

이 프로젝트에서 내가 판단한 것을 README의 「내가 판단한 것」 절에 정리해줘.
무엇을 만들기로 했는지, 무엇이면 완료로 볼지, 무엇을 하지 않게 막았는지,
어디에서 사람이 확인하고 넘어가게 했는지를 각각 한 줄로 적어줘.
기록에 없는 것은 지어내지 말고 비워둬.

사람이 무엇을 정했는지 보이게 할 때 사용합니다.

확인하고 개선한 기록을 문서로 남깁니다

docs/verification.md를 만들어줘.
검사를 지금 한 번 돌리고, 완료 조건과 그것을 확인하는 검사, 방금 나온 결과,
데이터 기준일과 돌린 날짜를 표로 적어줘.
만드는 동안 실패했다가 고친 것이 있으면 무엇을 고쳤는지도 한 줄씩 적어줘.
결과에는 실제로 돌려서 나온 값만 적어줘. 실행하지 못한 검사는
별도의 「확인하지 못한 범위」에 이름과 이유를 적어줘.

templates/verification.md를 가져간 다음에 사용합니다.

공개하기 전에 확인합니다

이 저장소를 공개해도 되는 상태인지 확인해줘.
API Key나 환경변수 파일, 개인정보, 사용 조건이 불확실한 자료가 들어 있으면 먼저 알려줘.
지금 파일만 보지 말고 지난 Commit에 들어간 적이 있는지도 확인해줘.

저장소를 다른 사람이 볼 수 있게 바꾸기 전에 사용합니다.