Imported from leegh5999-wq/llm-coding-playbook (templates/AGENTS.md). Install upstream with npx skills add leegh5999-wq/llm-coding-playbook --skill templates. Copyright stays with the author.

프로젝트 작업 규칙

이 파일은 프로젝트를 함께 수정하는 LLM 코딩 에이전트가 따라야 할 공통 규칙입니다. 대괄호 안의 문장은 프로젝트에 맞게 바꿉니다.

프로젝트 목적

• 이 프로젝트는 [누가] 사용하는 [무엇을 하는 앱]입니다.
• 현재 가장 중요한 목표는 [이번에 완성할 작은 결과]입니다.
• 이번 범위에 포함하지 않는 것은 [나중에 할 기능]입니다.

사용자와 소통하는 방법

• 사용자는 비개발자이므로 결과와 영향을 먼저 쉬운 한국어로 설명합니다.
• 기술 용어가 필요하면 처음 나올 때 한 문장으로 뜻을 설명합니다.
• 결과를 바꾸는 질문이 필요하면 한 번에 하나만 묻습니다.
• 오류 로그나 명령만 제시하지 말고 원인, 사용자 영향, 다음 행동을 함께 설명합니다.

작업 순서

1. 수정 전에 현재 파일과 관련 코드를 읽습니다.
2. 사용자에게 보일 변화와 확인 방법을 포함한 짧은 계획을 제시합니다.
3. 한 번에 한 가지 작은 변경만 합니다.
4. 가장 관련 있는 검사를 실행합니다.
5. 실제 화면 작업은 브라우저에서도 확인합니다.
6. 변경 내용, 사용자가 보게 될 결과, 검사 결과, 남은 불확실성을 보고합니다.

실행과 검증

• 개발 실행 명령은 [예: node server.js]입니다.
• 자동 검사 명령은 [프로젝트에 맞는 명령 또는 아직 없음]입니다.
• 수동 확인 항목은 [사용자가 실제 화면에서 확인할 동작]입니다.
• 검사를 실행하지 못했다면 완료했다고 말하지 않고 이유를 밝힙니다.
• 기존에 실패하던 검사나 범위 밖의 문제는 임의로 고치지 않고 따로 알립니다.

변경 범위

• 요청받은 문제를 해결하는 데 필요한 파일만 수정합니다.
• 요청하지 않은 기능, 패키지, 설정, 리팩터링을 추가하지 않습니다.
• 예상하지 못한 기존 파일이나 사용자 변경을 삭제하거나 덮어쓰지 않습니다.
• 진단만 요청받았다면 원인을 설명하고 승인 없이 구현하지 않습니다.

Git 규칙

• 작업 전후에 git status와 관련 변경 내용을 확인합니다.
• 사용자의 명시적 요청 없이 파일을 스테이징하거나 커밋하거나 업로드하지 않습니다.
• 커밋 요청을 받으면 이번 작업에 해당하는 파일만 포함합니다.
• 저장하지 않은 여러 변경을 한꺼번에 버리는 명령은 사용하지 않습니다.

안전과 비용

• 비밀번호, API 키, 인증 토큰, 개인정보를 코드, 로그, 프롬프트, 커밋에 넣지 않습니다.
• 패키지 설치, 외부 서비스, 배포, 데이터베이스, 권한 변경, 비용 발생 가능 작업은 영향과 대안을 먼저 설명하고 확인받습니다.
• 데이터 삭제, 운영 환경 변경, 접근 권한 변경은 정확한 대상을 설명하고 명시적 승인을 받습니다.
• Full access나 승인 절차를 건너뛰는 위험한 모드를 사용하지 않습니다.