# 구현지침서 샘플 (초보자용)

AI 개발도구(Codex, Claude Code 등)는 "무엇을 만들어줘"보다
"이런 구조로, 이런 조건으로 만들어줘"라고 정리된 문서를 줄 때 훨씬 정확하게 만들어요.
아래는 실제로 쓸 수 있는 구현지침서 뼈대예요. 대괄호 부분만 내 프로젝트에 맞게 바꿔보세요.

---

## 1. 프로젝트 개요

- 프로젝트명: [예: 우리동네 공방 소개 홈페이지]
- 목적: [한 문장으로]
- 기술 스택: PHP 8.2 / Laravel 12 / MariaDB / Tailwind CSS / Alpine.js

## 2. 화면(메뉴) 구조

| 화면 | 경로 | 권한 |
|---|---|---|
| 메인페이지 | / | 전체 공개 |
| [화면명] | [/경로] | [비로그인 / 로그인 / 관리자] |

## 3. 데이터 모델 (표로 정리하면 AI가 바로 마이그레이션을 만들어요)

### [테이블명, 예: posts]

| 필드 | 타입 | 설명 |
|---|---|---|
| id | bigint | 기본키 |
| title | string | 제목 |
| content | text | 본문 |
| user_id | foreignId | 작성자 |
| created_at / updated_at | timestamp | |

## 4. 권한 정책

- 비로그인 사용자: [예: 목록/상세 열람만 가능]
- 로그인 사용자: [예: 글쓰기, 댓글 작성 가능]
- 관리자: [예: 모든 글 삭제, 회원 관리 가능]

## 5. 예외/보안 처리 기준

- [예: 본인 글이 아니면 수정/삭제 버튼이 보이지 않아야 한다]
- [예: 로그인하지 않고 글쓰기 페이지에 직접 접근하면 로그인 페이지로 이동한다]

## 6. 완료 기준 (Acceptance Criteria)

- [ ] [예: 회원가입 후 이메일 인증 없이 바로 로그인이 된다]
- [ ] [예: 목록 페이지에서 페이지네이션이 동작한다]

---

## 이 문서를 AI에게 전달하는 예시 프롬프트

> "아래는 내가 만들고 싶은 기능의 구현지침서야. 이 내용을 참고해서 먼저 필요한 마이그레이션 파일과 모델을 만들어줘. 화면(Blade)은 다음 단계에서 따로 요청할게. 지침서에 없는 내용은 임의로 추가하지 말고, 애매한 부분이 있으면 먼저 질문해줘."

이렇게 단계를 나눠서 요청하면 AI가 한 번에 너무 많은 걸 만들다가 꼬이는 걸 막을 수 있어요.