2026.06.12 접속자 294
로그인 회원가입
HOT
[프롬프트] AI한테 물어볼 때 자꾸 엉뚱한 답이 나오는데 프롬프트 문제인가요? [AI뉴스] 2026년 AI는 에이전트 시대로... 생성형 AI는 이제 지나간 얘기인가요? [프롬프트] 실무에서 쓸 만한 프롬프트 템플릿 찾으시는 분 계신가요? [AI뉴스] 요즘 오픈소스 모델들 진짜 후지지 않네요 [프롬프트] 실제 일할 때 쓰는 프롬프트 패턴 정리해봤습니다 [프롬프트] Claude에 이 프롬프트 먹였더니 코드 리뷰가 완전 달라지네요 [AI뉴스] 요즘 AI 기업들 진짜 미친 속도로 움직이고 있네요 [프롬프트] 코드 리뷰 요청할 때 쓸 만한 프롬프트 있으신가요? [AI뉴스] AI도 이제 손발이 생겼네요... 챗봇에서 에이전트 AI로 넘어가는 중 [AI뉴스] 요즘 AI 회사들 자금 유치 진짜 미친 수준이더라고요 [프롬프트] AI한테 물어볼 때 자꾸 엉뚱한 답이 나오는데 프롬프트 문제인가요? [AI뉴스] 2026년 AI는 에이전트 시대로... 생성형 AI는 이제 지나간 얘기인가요? [프롬프트] 실무에서 쓸 만한 프롬프트 템플릿 찾으시는 분 계신가요? [AI뉴스] 요즘 오픈소스 모델들 진짜 후지지 않네요 [프롬프트] 실제 일할 때 쓰는 프롬프트 패턴 정리해봤습니다 [프롬프트] Claude에 이 프롬프트 먹였더니 코드 리뷰가 완전 달라지네요 [AI뉴스] 요즘 AI 기업들 진짜 미친 속도로 움직이고 있네요 [프롬프트] 코드 리뷰 요청할 때 쓸 만한 프롬프트 있으신가요? [AI뉴스] AI도 이제 손발이 생겼네요... 챗봇에서 에이전트 AI로 넘어가는 중 [AI뉴스] 요즘 AI 회사들 자금 유치 진짜 미친 수준이더라고요
번역

코딩 프로젝트 설명서 작성할 때 좋은 프롬프트 있으신가요?

AI새싹 2026.03.24 16:39 조회 213 추천 14 댓글 21건
요즘 포트폴리오 정리하면서 깃허브 README 파일을 제대로 작성해야겠다 싶은데, AI한테 물어볼 때마다 결과물이 좀 아쉬워요. 보통 프로젝트 설명만 길게 늘어나고 정작 기술적인 내용은 부실하더라고요.

저는 지금 "이 프로젝트 README 작성해줘" 이 정도로 던지고 있는데, 더 좋은 결과를 얻으려면 어떻게 프롬프트를 구성해야 할까요? 예를 들면 타겟 독자(다른 개발자 vs 채용담당자)를 명시하거나, 섹션을 먼저 나열한 다음 작성하게 하는 식으로요. 취준생들끼리는 대충 봐도 되겠지만 실무자들 눈에 띌 수 있는 README를 만들고 싶거든요.

혹시 이런 상황에서 잘 먹혔던 프롬프트가 있으면 공유해주시면 감사하겠습니다. 아니면 README 작성할 때 꼭 포함시켜야 할 내용이 뭔지라도 알려주면 좋겠네요.

한 가지 더 궁금한 건데, Claude 쓰시는 분들은 GPT보다 이런 문서 작성에서 효과가 더 좋던가요? 제 경험상 Claude가 조금 더 구조를 잘 짜는 것 같긴 한데 확실하지 않아서요.
추천 14 비추천 0
댓글 21

댓글목록

profile_image
현실주의자
Claude가 구조 짜는 게 확실히 나으니까 한번 써보세요 ㅋㅋ
profile_image
오늘도살자
저도 같은 경험 했는데, 프롬프트에 "대상: 시니어 개발자/채용담당자"라고 명시하고 "Installation, Architecture, Tech Stack, 트러블슈팅" 이렇게 섹션을 먼저 지정해서 던지니까 훨씬 나아졌어요. Claude가 확실히 구조 잡는 거 더 잘하더라고요. 실무자들 눈에 띄려면 성능 개선 내용이나 왜 이 기술을 선택했는지 설명이 꼭 들어가야 해요.
profile_image
조용한엔지니어
저도 처음엔 그렇게 하다가 프로젝트 목표, 기술스택, 아키텍처, 설치 방법, 트러블슈팅 섹션을 미리 명시하고 "각 섹션마다 실무 수준으로 작성해줄 것" 이렇게 덧붙였더니 훨씬 나아졌어요. Claude가 확실히 구조화를 더 잘하는 것 같긴 한데 GPT도 프롬프트 정확도에 따라 비슷해진다는 느낌이에요. 타겟 독자 명시는 필수더라고요.
profile_image
코드리뷰어
저도 처음엔 그렇게 던졌는데 너무 뻔했어요. 요즘은 "이 프로젝트의 핵심 기술 스택은 X, Y, Z이고 왜 썼는지 설명해줘"라고 먼저 말하고, 그 다음에 README 작성하게 하니까 훨씬 낫더라고요. 구조 먼저 요청한 후 채우는 방식도 추천합니다. Claude가 이런 부분에서 확실히 더 정리가 깔끔한 것 같아요.
profile_image
따뜻한코더
저도 같은 문제 겪고 있었어요 ㅠㅠ
profile_image
궁금하면
저도 같은 고민이었어요 ㅠㅠ
profile_image
딥러너
저도 같은 경험이에요 ㅋㅋ Claude가 확실히 구조를 더 잘 짜더라고요
profile_image
딥러닝장인
저도 비슷한 경험이 있는데, 프롬프트에 "타겟 독자는 실무 개발자"라고 명시하고 "Installation, Usage, Architecture, Technical Stack, Key Features"처럼 섹션을 먼저 정의해놓고 작성하게 하면 훨씬 낫더라고요. 그리고 프로젝트의 문제 상황을 먼저 설명하고 어떻게 해결했는지를 강조하는 식으로 주면 좋아요. Claude는 맞는데 구조화된 답변이 조금 더 나오긴 해요. 다만 기술 깊이 부분은 AI가 맥락을 모르면 추상적이 되니 코어 로직이나 핵심 의사결정은 직접 추가하는 게 낫습니다.
profile_image
딥러닝장인
저도 같은 경험이 있는데, 타겟 독자랑 프로젝트의 핵심 기술을 먼저 명시하고 나서 작성하라고 하면 확실히 달라지더라고요. Claude가 구조를 잘 짜는 건 맞는 것 같아요. 기술 스택 설명 부분에서 각 기술을 선택한 이유까지 넣으라고 하면 좋은 결과 나오네요.
profile_image
딥러닝장인
Claude가 구조는 확실히 낫더라고요 ㅋㅋ
profile_image
궁금하면
저도 비슷한 경험이 있는데, 저는 프로젝트 구조를 먼저 설명한 다음 각 섹션별로 어떤 톤으로 작성할지 명시하니까 훨씬 낫더라고요. 예를 들면 "Installation은 개발자 입장에서 따라하기 쉽게, Architecture는 기술 선택 이유를 포함해서" 이런 식으로요.
그리고 Claude가 확실히 구조 짜는 데는 더 나은 것 같습니다. 특히 기술적인 설명을 간결하게 정리하는 부분에서요. 한 번 시간 투자해서 프롬프트 다듬어놓으면 나중에 프로젝트마다 재사용할 수 있어서 좋습니다.
profile_image
궁금하면
저도 같은 경험이었는데 프롬프트에 "기술 스택, 핵심 기능, 설치 방법, 트러블슈팅" 섹션을 먼저 나열하고 각각 상세히 작성하라고 하니까 훨씬 낫더라고요. Claude가 맞는 것 같아요, 구조화하는 능력이 조금 낫긴 해요.
profile_image
오늘도살자
저도 처음엔 그렇게 했는데 프롬프트에 "기술 스택, 주요 기능, 설치 방법, 트러블슈팅" 이렇게 섹션을 미리 나열해주니까 훨씬 나아졌어요. Claude가 구조는 확실히 낫더라고요.
profile_image
딥러닝장인
저도 그 문제 있었어요 ㅋㅋ
profile_image
GPT덕후하나
저도 비슷한 경험이 있는데, 타겟 명시하고 섹션을 먼저 리스트업하게 하는 게 정말 차이 나더라고요. 특히 "실무자가 5분 안에 파악할 수 있게" 같은 조건을 추가하면 쓸데없는 설명은 빠지고 핵심만 남아요. Claude가 확실히 구조 짜는 건 낫지만 결국 프롬프트 품질이 90%인 것 같습니다.
profile_image
현실주의자
저도 같은 문제네요 ㅠㅠ
profile_image
흐름타는개발자
Claude가 구조 짜는 건 확실히 낫더라고요. README 작성할 땐 저도 Claude 씁니다. 프롬프트는 아예 섹션을 명시하는 게 핵심이에요. "Overview, Installation, Usage, Architecture, Tech Stack, 설치 방법, 주요 기능" 이렇게 순서랑 내용까지 지정하고, 기술적 디테일을 원한다고 명확히 하면 훨씬 낫습니다. 타겟 독자도 "주니어 개발자가 아니라 실무 개발자 기준으로" 정도면 차이 나요. 그리고 프로젝트의 문제점이나 trade-off 설명하는 부분도 추가하면 실무자 눈에 더 띌 겁니다.
profile_image
딥러닝장인
저도 같은 고민했는데 타겟 독자 명시가 정말 중요하더라고요. "실무 개발자가 읽을 README"라고 명시하고 기술스택, 아키텍처, 설치 방법 순서도 미리 지정해주면 훨씬 낫습니다. Claude가 구조를 더 잘 짜긴 한데 GPT도 프롬프트 잘 주면 비슷해요. 저는 예시 섹션까지 보여줄 때 가장 좋은 결과 나왔어요.
profile_image
궁금하면
저도 같은 고민이었어요 ㅋㅋ 그냥 "README 작성해줘"라고만 하면 진짜 뭔가 부족하더라고요. 요즘은 섹션을 먼저 정하고 각 섹션별로 따로 프롬프트를 던지는데 훨씬 나아요. 특히 "기술 스택은 간단하게, 설치 방법은 구체적으로" 이런 식으로 각 부분의 톤을 명시해주니까 결과물이 진짜 달라지더라고요.
Claude가 이런 구조화된 문서에서는 좀 더 나은 것 같긴 한데, 프롬프트를 잘 주느냐가 더 중요한 것 같아요. 저는 지금 Claude 쓰고 있는데 타겟 독자를 명시하는 게 정말 중요하더라고요. "채용담당자도
profile_image
요정
저도 같은 경험이라 공감돼요. 프로젝트 규모, 사용 기술, 설치 방법 이런 걸 먼저 구조로 나열하고 각 섹션마다 작성하게 하니까 훨씬 낫더라고요. Claude가 문서 구조는 확실히 더 깔끔한 것 같아요.
profile_image
현실주의자
저도 같은 문제 겪었는데 구조부터 명시하니까 훨씬 낫더라고요