개발 효율성을 높이기 위한 프로젝트 문서 작성 및 관리 방법

"버그 수정" 프롬프트

Sonnet 3.5와 같은 AI 모델은 때때로 중요한 세부 사항을 놓칠 수 있으며, 이로 인해 일련의 오류 루프가 발생할 수 있습니다.

이 문제를 해결하려면 다음 팁을 참조하세요.

이렇게 하면 AI가 오류의 근본 원인을 분석한 다음 오류를 해결하기 위한 단계별 계획을 세우는 데 도움이 됩니다.

"새로운 소식" 알림

구성 요소를 성공적으로 실행한 후에는 설명서를 참조하여 다음 구성 요소의 작업 범위를 AI에 알려주어야 합니다.

다음 지침에 따라 실행 전에 AI가 구현 계획을 작성하도록 하세요.

관련 문서에 플래그를 지정하면 AI가 파일을 읽은 후 사용자에게 질문을 할 수 있습니다.

질문에 답하고 AI가 수행하도록 하세요.

이 단계를 거치면 각 컴포넌트의 일루전을 절반 정도 해결할 수 있습니다.

응답 구조

이 구조는 내가 진행 중인 작업이 완료되었으니 이제 다음 작업으로 넘어가야 한다는 것을 AI에게 알려줍니다.

1. 提供更新：


"이제 헤더 메뉴가 완벽하게 중앙에 정렬되어 있습니다."

2. 提供下一个任务：


"이제 로그인 및 등록 버튼이 필요합니다."

3. 标记正确文档：


"@(문서 이름)을 확인하고 이를 어떻게 달성할 수 있는지 설명하세요."

진행률 .md 파일

이 팁을 사용하여 모든 작업을 추적하세요. 이렇게 하면 AI에게 진행 상황에 대한 컨텍스트를 제공하고 중복 오류를 해결할 수 있습니다.

"완료된 각 단계가 끝나면 작업 내용을 진행 중 를 .md 파일에 추가합니다. 어떤 기능을 구현했나요? 어떤 오류가 발생했나요? 이러한 버그를 어떻게 수정했나요?

이 세 가지 질문에 단계별로 답하고 어떤 정보도 누락하지 마세요."

프로젝트 상태 .md 파일

AI는 우리가 중단한 부분을 이어받아야 합니다. 이 문서는 AI가 작업 기록을 보관하고 수행한 작업과 남은 작업을 파악하는 데 도움이 됩니다.

"세션이 끝나면 @프로젝트 상태 .md 파일에 작업 내용을 기록하세요.

이 세션에서 구현한 모든 기능에 대한 @ progress .md 파일을 살펴보는 것부터 시작하세요.

그런 다음 다음 작업 세션에 대한 자세한 맥락을 제공하기 위해 상세한 세션 보고서를 작성합니다."

커서 에이전트 해킹

커서 에이전트가 과도하게 처리되어 코드 기반이 중단될 수 있습니다.

"@(문서 이름)의 설명을 읽고 이 기능의 작업 범위를 이해하세요.

연쇄적 사고 추론을 사용하여 단계별 실현 계획을 세웁니다.

이 기능의 각 부분이 어떻게 작동하는지 설명하고 거시적인 수준의 세부 정보를 제공해야 합니다.

이러한 항목을 세부적인 번호가 매겨진 단계로 세분화하세요."

그러면 AI의 예정된 계획이 제공됩니다. 모든 것이 요청과 일치하는지 확인하고 승인할 수 있습니다.

이렇게 하면 커서 에이전트의 불필요한 편집 문제가 모두 해결됩니다.

추가 문서

문서 또는 노트 폴더를 만듭니다.

그런 다음 모든 핵심 문서를 해당 폴더에 첨부합니다.

• 프로젝트 요구 사항 문서(PRD)
• 신청 절차 문서
• 프런트엔드 가이드라인 문서
• 백엔드 아키텍처 문서
• 기술 스택 문서
• 문서 구조 문서화

01 모델을 사용할 수 있지만 올바른 프롬프트가 필요합니다(그렇지 않으면 불필요한 섹션과 중복 정보가 추가될 수 있음).

가장 좋은 해결책은 CodeGuidedev 이 문서를 작성하세요.이 도구는 이 과정을 자동화했습니다. 이 도구를 사용하면 20~30분 안에 필요한 모든 문서를 작성할 수 있습니다.

문서 작성을 위해 Sonnet 3.5, o1-preview 및 GPT4o를 혼합하여 사용합니다.

일반적으로 사용 ChatGPT 모든 문서를 준비하려면 7~8시간의 작업(각 문서를 읽고, 최적화하고, 반복하는 작업)이 필요합니다.