코드 짜기 전에 먼저 쓰는 파일

---
description: "코드를 짜기 전에 무엇을 왜 하는지 내 말 그대로 intent.md 한 장에 적어 두는 스킬. 사용자가 /intent, 인텐트, 또는 새 작업 요청(이거 만들어줘, 고쳐줘)을 던졌을 때 코드보다 먼저 사용. Anthropic AI-Native SDLC 플레이북 1단계(Plan, intent.md)를 그대로 옮긴 것."
---

## 지금 프로젝트 상태 (자동 수집)

폴더 구조:
!`git ls-files 2>/dev/null | head -60`

기존 intent.md (있으면):
!`cat intent.md 2>/dev/null | head -40`

## 원칙 한 줄

**승인된 intent.md 가 없으면 코드를 한 줄도 건드리지 않는다.**
(플레이북 원문: "Nothing is implemented without an accepted plan.")

## 1단계 — intent.md 쓰기

사용자의 요청을 **사용자가 쓴 말 그대로** 살려서 아래 5칸을 채운 `intent.md` 를 프로젝트 루트에 만든다.
형식 언어·전문 용어로 바꾸지 않는다. 모르는 칸은 지어내지 말고 `열린 질문`으로 내린다.

```
# intent — <요청 한 줄 그대로>

승인: 대기

## 문제
지금 무엇이 어떻게 잘못돼 있나. 사용자 말 그대로.

## 원하는 결과
끝났을 때 사용자가 보게 될 것. 한 문장.

## 영향받는 사람·시스템
- 누가 쓰는 화면인지, 어떤 파일/서비스가 얽혀 있는지 (위 폴더 구조에 실제로 있는 것만)

## 제약
- 하지 말아야 할 것, 지켜야 할 것 (예: 기존 로그인 방식 유지, 라이브러리 추가 금지)

## 열린 질문
1. 사용자만 답할 수 있는 것. 최대 2개. 없으면 "없음".
```

파일을 쓴 뒤 화면에는 **열린 질문만** 다시 보여 주고, 이렇게 끝낸다.
"답해 주시면 intent.md 에 반영할게요. 다 맞으면 **승인** 이라고 적어 주세요."

## 2단계 — 승인 도장

사용자가 "승인"(또는 "ㅇㅋ", "맞아", "진행")이라고 하면, **코드보다 먼저** intent.md 의
`승인: 대기` 를 `승인: YYYY-MM-DD` 로 바꾼다. 열린 질문에 답이 왔으면 해당 칸에 반영하고 질문은 지운다.

그 다음 `plan.md` 를 만든다 (플레이북 3단계 Build 의 입력).

```
# plan — <intent 제목>

## 건드릴 파일
- 경로 — 무엇을 바꾸나   (실제로 있는 파일만. 새 파일은 [새 파일])

## 순서
1. …
2. …

## 성공 확인
- 이 명령/화면이 이렇게 나오면 끝: …

## 위험
- 잘못되면 무엇이 깨지는지, 되돌리는 법
```

plan.md 를 보여 주고 "이 계획대로 갈까요?" 라고 묻는다. **여기서도 답을 받기 전엔 코드를 건드리지 않는다.**

## 규칙

- 사용자가 안 한 말을 지어내지 않는다. 모르면 열린 질문.
- intent.md 는 화면 한 장 — 5칸 합쳐 20줄 안쪽.
- 이미 승인된 intent.md 가 있고 같은 주제면 새로 만들지 않고 이어 간다.
- 승인 전에 "일단 고쳐 볼게요" 류의 선행 작업 금지. 읽기(파일 열어보기)는 허용.

# intent — 로그인 가끔 안 돼 고쳐줘

승인: 2026-09-07

## 문제
크롬에서 새로고침하면 로그인이 안 된다. 안 될 때 화면에 아무 반응이 없다.

## 원하는 결과
크롬에서 새로고침한 뒤에도 로그인이 항상 정상적으로 처리된다.

## 영향받는 사람·시스템
- 로그인 화면을 쓰는 사용자
- src/LoginForm.jsx (로그인 폼 화면)
- src/api/login.js (로그인 처리 API)

## 제약
- 열린 질문 참고 (아직 확인된 제약 없음)

## 열린 질문
없음