나중에 남에게 넘길 수 있게 만들기

내용

📌 언제 필요해지나
• 만든 게 잘 돼서 사람이 늘 때
• 결제나 로그인을 붙여야 할 때
• 내가 손 놓아야 할 때

그때 개발자가 처음 묻는 게 "이거 뭐로 만들었어요? 자료는 어디 있어요?" 입니다.
대답을 못 하면 처음부터 다시 만드는 게 싸집니다.

[ 지금 만들어두면 되는 문서 ]
이 프로젝트를 나중에 다른 사람이 이어받을 수 있게 문서를 만들어줘.

① 무엇을 하는 프로그램인지, 누가 쓰는지
② 무엇으로 만들었는지 — 언어·도구·붙여 쓴 서비스
③ 자료가 어디에 저장되는지
④ 돌리려면 무엇이 필요한지 — 설치할 것, 필요한 계정, 설정할 것
⑤ 폴더와 파일이 각각 무슨 역할인지
⑥ 알면서 대충 만든 부분과 그 이유
⑦ 손대면 위험한 곳
⑧ 지금 안 되는 것 · 하다 만 것

⑥과 ⑧을 솔직하게 써줘. 이어받는 사람이 제일 알고 싶어 하는 게 그거야.
비밀키나 비밀번호는 문서에 적지 말고 "어디에 있다"만 써줘.

{{INPUT}}

💡 이 문서를 프로젝트 폴더에 README 로 두세요
AI 도 이 파일을 먼저 읽습니다. 다음에 이어서 작업할 때 훨씬 잘 알아듣습니다.
사람에게도 AI 에게도 같은 문서가 쓰입니다.

💡 지금 만드는 게 가장 쌉니다
다 만들고 몇 달 지나서 쓰려면 나도 기억이 안 납니다.
한 덩어리 끝날 때마다 갱신하세요.

샘플 입력

(가상의 상황입니다)
만든 것: 동네 스터디 모임 출석 체크 페이지
- 만든 방식: AI 에게 시켜서 만들었고 코드는 거의 안 읽었습니다
- 파일: index.html, app.js, style.css, data.json 정도가 있는 것 같습니다
- 저장: 잘 모르겠는데 브라우저에 저장되는 것 같습니다. 다른 기기에서는 기록이 없습니다
- 붙인 것: 없는 것 같습니다
- 지금 안 되는 것: 지난달 기록을 볼 방법이 없고, 두 명이 동시에 체크하면 하나가 사라집니다

이런 모양이면 잘 나온 것

우리가 쓴 예시입니다. 실제 실행 결과가 아니고, 답변은 매번 조금씩 다릅니다.

① 무엇을 하는 프로그램인가 / 누가 쓰는가
   스터디 모임의 출석을 체크하고 보는 페이지. 모임 구성원이 사용합니다.

② 무엇으로 만들었나
   HTML · CSS · JavaScript (별도 서버 없음으로 보입니다) [확인 필요]

③ 자료가 어디에 저장되나
   브라우저 안에 저장되는 것으로 보입니다.
   → 그래서 다른 기기에서 기록이 안 보이고, 동시에 체크하면 하나가 사라집니다
   → 이 두 증상이 같은 원인에서 나옵니다

④ 돌리려면 필요한 것
   〈설치할 것 · 계정 · 설정〉 [확인 필요]

⑤ 파일별 역할
   index.html — 화면
   app.js     — 동작
   style.css  — 모양
   data.json  — 〈용도 확인 필요〉

⑥ 알면서 대충 만든 부분
   • 여러 사람이 동시에 쓰는 상황을 고려하지 않음
   • 지난 기록 보기 기능 없음

⑦ 손대면 위험한 곳
   • 저장 방식을 바꾸면 지금까지의 기록이 사라질 수 있습니다

⑧ 지금 안 되는 것 · 하다 만 것
   • 지난달 기록 조회
   • 동시 체크 시 기록 유실

⚠️ 비밀키나 비밀번호가 문서에 적혀 있으면 안 됩니다. 「어디에 있다」만 적으세요.
⚠️ 모르는 것을 아는 척 채웠다면 [확인 필요]로 바꾸세요.

받은 답 확인하기

• 비밀키·비밀번호를 문서에 적지 않고 「어디에 있다」만 썼는가
• 모르는 것을 지어내지 않고 [확인 필요]로 남겼는가
• ⑥ 대충 만든 부분과 ⑧ 안 되는 것을 솔직하게 썼는가
• 증상들을 나열만 하지 않고 같은 원인에서 나온 것을 묶어줬는가
• README 로 저장할 수 있는 형태인가

잘못 나왔을 때 이어서 보낼 말

모르는 것은 아는 척하지 말고 [확인 필요]로 남겨줘.
비밀키나 비밀번호는 적지 말고 어디에 있는지만 써줘.
대충 만든 부분과 지금 안 되는 것을 더 솔직하게 써줘. 그게 제일 필요한 정보야.