AI IDE 툴로 올바르게 프로그래밍하려면 일련의 사양 문서와 세부 요구 사항 명세서를 작성해야 합니다.

똑똑하지만 코드 모범 사례를 이해하지 못하는 아이처럼 말입니다.

AI에게 원하는 바를 명확하게 전달해야 합니다:

• 웹 애플리케이션인가요?
• 어떤 기능이 필요하나요?
• 구조는 무엇인가요?
  기타 등등.

AI를 풀스택 개발자로 만드는 방법은 다음과 같습니다:

컨텍스트가 중요합니다!

AI에는 강력한 컨텍스트 장벽이 필요합니다.

목표: AI가 어떤 가정도 하지 않도록 하세요. 모든 정보는 사용자가 제공해야 합니다.

이러한 방식으로 AI는 사용자와 협력하는 것이 아니라 사용자와 함께 일하게 됩니다.

다음에서는 최대한의 컨텍스트 지원을 제공하기 위해 첨부해야 하는 문서에 대해 설명합니다.

1. 프로젝트 요구 사항 문서

이 문서는 프로젝트 전체에 대한 개요를 설명합니다:

• 프로젝트 프로필
• 문제 설명
• 처방전
• 대상 사용자
• 기술 스택
• 핵심 기능
• 업무 범위

이 문서는 프로젝트에 대한 간략한 설명입니다.

다음으로 각 단계를 안내하는 보다 구체적인 문서를 추가하여 AI를 안내하세요.

2. 신청 절차 및 기능 문서

친구에게 앱을 설명한다고 상상해 보세요:

"사용자가 등록하면 대시보드로 이동합니다. 대시보드에는 메트릭 섹션, 애널리틱스 섹션 등 4개의 섹션이 있습니다."

이 문서는 애플리케이션의 전체 엔드투엔드 런타임 흐름을 제공합니다.

STH에 주목하세요.AI가 문서에 포함하도록 요청됨 총알을 사용하지 마십시오..

이 문서는 각 페이지의 실행을 계획하기 위한 다이어그램/청사진을 AI에 제공하기 때문에 중요합니다.

3. 기술 스택 및 종속성 패키지 문서

이제 AI의 기술적 배경을 제공합니다.

프로젝트에서 Python을 사용하시나요? 아니면 Nextjs를 사용하시나요? 백엔드로는 Supabase 또는 Firebase를 사용하시나요?

이 문서에서는 AI가 애플리케이션을 구축하는 데 필요한 기술 스택에 대해 자세히 설명합니다.

다음과 같은 이유로 일반적으로 사용되는 기술 스택을 선택해야 합니다. Claude 와 같은 LLM은 주로 널리 사용되는 프레임워크를 기반으로 학습됩니다.

프론트엔드에는 Nextjs 14, 탈리윈드CSS, shadcnUI 및 radixUI를, 백엔드에는 Supabase를 사용하고 있습니다.

다음 플랫폼은 모두 이 기술 스택을 선호합니다:

• v0.dev
• 볼트
• Claude
• 커서
• Replit

Python은 최신 UI가 필요하지 않은 고성능 애플리케이션에도 적합합니다.

4. 문서 구조에 대한 문서화

지속적인 오류의 악순환에 빠지지 않으려면 이 문서가 필수입니다.

AI가 중복 파일을 생성하거나 잘못된 위치에 파일을 저장하거나 완성된 코드를 삭제할 수도 있습니다.

이 문제를 해결하려면 문서 구조를 미리 제공해 주세요.

STH에 주목하세요.: AI가 파일 구조를 ASCII 형식으로 생성하는 데 필요한지 확인합니다.

스크린샷을 찍어 파일 구조를 저장하고 문서에 첨부합니다.

5. API 문서

AI는 기본적으로 어떤 플랫폼의 API가 어떻게 구성되어 있는지 알지 못합니다.

애플리케이션에 사용될 모든 API에 대한 설명서를 첨부해야 합니다.

예를 들어 OpenAI API, Claude API 문서, Supabase 문서 등이 있습니다.

웹사이트의 지침을 복사하여 문서에 붙여넣은 다음 해당 문서를 AI에 첨부하세요.

6. 백엔드 아키텍처 설계 문서

아키텍처는 기본적으로 백엔드 청사진입니다.

여기에는 생성해야 하는 모든 데이터베이스 테이블, 스토리지 버킷 및 사용자 정보 테이블(인증)이 포함되어 있습니다.

제가 Supabase를 사용하는 이유는 AI가 몇 초 만에 Supabase에서 직접 실행할 수 있는 SQL 쿼리를 생성할 수 있기 때문입니다.

이렇게 하면 데이터베이스를 생성하고 1시간 이내에 프런트엔드에 연결할 수 있습니다.

밝은 지점Claude는 백엔드 아키텍처 설계에 능숙하며, 올바른 문서를 작성하면 AI가 쉽게 지침을 따를 수 있습니다.

7. .cursorrules 파일

많은 사람들이 이 도구를 사용하지 않습니다. 이 도구는 다음과 유사합니다. ChatGPT 사용자 지정 명령의

.cursorrules 파일은 일반적인 "AI 규칙" 프롬프트가 아닌 프로젝트별 파일이어야 합니다.

기술 스택 및 프로젝트 요구 사항에 따라 AI는 .cursorrules 파일을 생성하도록 요청받습니다.

이 문서는 각 문서의 위치를 AI에게 알려줍니다(커서의 내비게이션 맵).

이 파일로 AI가 더 효율적으로 탐색할 수 있도록 도와주세요.

8. UI 레이아웃 문서

이 문서는 프런트엔드 인터페이스를 더욱 미적으로 아름답게 만들어 줍니다. v0과 함께 사용하면 일관된 스타일의 프런트엔드 컴포넌트를 만들 수 있습니다.

대부분의 사람들은 깔끔한 사용자 인터페이스(UI)의 힘을 과소평가합니다.

"첫인상이 중요합니다."

이 문서에는 사용된 UI 패키지, 글꼴, 색 구성표, 아이콘, 효과 등의 정보가 포함되어야 합니다.

9. 시스템 신호

AI에게 v0, 볼트 또는 사용자가 사용할 수 있는 모든 도구에 대한 프로젝트별 시스템 프롬프트 단어를 생성하도록 요청할 수 있습니다.

이렇게 하면 도구와 소통하는 데 도움이 되며 매번 긴 문맥을 제공할 필요가 없습니다.

Claude가 API를 사용하는 것보다 플랫폼에서 더 나은 성과를 내는 이유를 알고 계신가요? 그것은 바로 시스템 단서가 뛰어나기 때문입니다.

프로젝트에도 똑같이 적용하면 AI와 더 좋은 친구가 될 수 있습니다.

저는 개발 시간 중 80%를 문서 작성에 투자했고, 나머지 20% 동안 큰 성과를 거두었습니다.

소개: codeguide.dev

AI에 첨부할 모든 중요한 문서를 브레인스토밍하고 작성하는 데 도움이 되는 앱입니다.

✅ 시스템 경고 단어
✅ PRD 문서
✅ 아키텍처 설계
✅ 신청 절차 문서
✅ UI 레이아웃 문서
잠깐만요!

링크(웹사이트)::http://codeguide.dev