에이전트에게 설정 맡기기

번거로운 부분은 맡길 수 있습니다

이 리포지토리는 코딩 에이전트가 읽을 수 있도록 작성되었습니다. 맵 파일(llms.txt), 규칙 파일(AGENTS.md), 파일별 메모리 노트(.ai/), 태스크 스킬(.agents/skills/)이 함께 제공됩니다. 독립형 Mobile 체크아웃에는 prompts/ 폴더가 포함되지 않으므로 준비된 프롬프트가 이 가이드에 인쇄되어 있습니다 — 파일을 여는 대신 아래에서 복사하십시오.

타이핑을 맡긴다고 검사를 건너뛰는 것은 아닙니다. 에이전트는 저장소의 복사본 안에서 작업하며 무엇을 했는지 증거와 함께 보고해야 합니다. 아래 섹션은 좋은 리포트가 어떤 모습인지 보여주므로 결과를 계속 통제할 수 있습니다.

이 경로는 Expo 앱과 Web 백엔드(계정과 데이터를 처리하는 서버)에 대한 연결을 설정합니다. 체크아웃에 apps/web도 포함된 경우 에이전트가 해당 백엔드를 로컬에서 실행할 수 있고, Mobile 전용 체크아웃에는 제공받은 접근 가능한 백엔드 주소가 필요합니다.

• 대신 수동으로 Mobile 앱 실행

먼저 필요한 것

먼저 준비 가이드를 완료하세요: Node.js, Git, 편집기 설치, GitHub 초대 수락, supastack 폴더를 컴퓨터에 다운로드. 에이전트는 그 폴더 안에서 작업하므로 시작하기 전에의 모든 내용이 계속 적용됩니다.

코딩 에이전트 역할을 할 수 있는 도구도 필요합니다 — AI 코딩 에이전트가 내장된 편집기(AI IDE) 또는 터미널에서 실행되는 에이전트(에이전트 CLI). 현재 에이전트 기능이 있는 도구라면 무엇이든 됩니다. 프롬프트에 무엇을 읽고 실행해야 하는지 이미 적혀 있으므로 지시를 직접 쓸 필요가 없습니다.

마지막으로 프롬프트가 요구하는 두 가지를 결정합니다: 기기가 도달할 수 있는 백엔드 주소 — 로컬 백엔드용 컴퓨터 LAN 주소 또는 제공된 HTTPS 주소 — 와 앱을 볼 위치 — 전화기의 Expo Go, Mac의 iOS 시뮬레이터 또는 Android 에뮬레이터.

프롬프트 복사, 두 곳 채우기, 붙여넣기

프롬프트는 아래의 코드 블록입니다 — 전체 블록을 선택하고 복사합니다.

두 개의 플레이스홀더에 선택이 필요합니다. <API_URL>을 기기가 도달할 수 있는 백엔드 주소로 바꿉니다 — 같은 Wi-Fi의 로컬 백엔드에는 컴퓨터 LAN 주소에 포트 3000, 또는 제공된 HTTPS 주소를 사용합니다. <DEVICE: expo-go | simulator>를 실물 전화기면 expo-go로, 설치된 iOS/Android 시뮬레이터면 simulator로 바꿉니다. 번호가 매겨진 단계는 작성된 그대로 유지합니다.

Set up this supastack Mobile checkout end to end and open the Expo app on **<DEVICE: expo-go | simulator>** against the backend at **<API_URL>**.
1. Read llms.txt, AGENTS.md and docs/agent-security.md before changing anything.
2. Run corepack pnpm install.
3. Create apps/mobile/.env.local from the names in .env.example: EXPO_PUBLIC_API_URL=<API_URL>, EXPO_PUBLIC_APP_SCHEME=supastack and EXPO_PUBLIC_MOBILE_PURCHASES_PROVIDER=off. Never invent a variable absent from .env.example.
4. If apps/web exists in this checkout, start it in a second terminal; otherwise verify <API_URL> answers from this computer and report its status.
5. Start Expo with corepack pnpm --filter @supastack/mobile start and report the QR preview or simulator launch with the real output.
6. Stop after any step fails twice and report the failing command and first error. Ask before deleting anything.

에이전트가 프롬프트로 하는 일

프롬프트는 에이전트에게 맵, 규칙, 보안 체크리스트를 가리키고 설정을 순서대로 진행하며 각 단계를 증명하도록 지시합니다. 쉽게 말해 에이전트는 다음을 수행합니다:

• 아무것도 건드리기 전에 저장소 지도(llms.txt), 프로젝트 규칙(AGENTS.md), 자격 증명 취급 규칙(docs/agent-security.md)을 읽습니다.
• .env.example의 이름만으로 apps/mobile/.env.local을 생성하고 제공한 API 주소와 스킴을 넣습니다 — 에이전트는 예제 파일에 없는 EXPO_PUBLIC_ 설정을 절대 만들지 않습니다.
• 백엔드가 지정한 주소에서 응답하는지 확인합니다 — 이 체크아웃에 apps/web 폴더가 있는 경우에만 스스로 시작합니다 — 없는 서버를 가정하지 않습니다.
• 종속성을 설치하고 Expo 개발 서버를 시작한 다음 QR 미리 보기 또는 시뮬레이터 실행을 실제 출력과 함께 보고합니다.
• 같은 단계가 두 번 실패하면 중지하고 보고합니다 — 실패를 우회하거나 묻지 않고 무언가를 삭제하지 않습니다.

에이전트의 리포트에서 확인할 것

좋은 보고서는 주장이 아닌 증거를 보여줍니다. 각 PASS 뒤에 응답하는 백엔드 URL, 완료된 종속성 설치, Expo 서버 출력이 있는지 확인하십시오 — '모든 것이 작동한다'는 문장이 아닙니다.

프롬프트는 에이전트에게 같은 단계가 두 번 실패하면 중지하고 보고하라고 — 실패를 우회하지 말고 — 파괴적인 작업 전에 물어보라고 지시합니다. 에이전트가 반복된 실패 후에도 계속 즉흥적으로 진행하면 중지하고 첫 번째 오류를 문제 해결 가이드로 가져가십시오.

절대 나타나서는 안 되는 두 가지가 있습니다: 오류를 없애려고 꺼버린 보안 기능과, 채팅이나 리포트에 출력된 비밀번호나 키 같은 시크릿 값. 둘 중 하나라도 보이면 그 실행은 실패로 간주하세요.

미리 보기와 실제 로그인을 마음속으로 구분하십시오. 성공적인 QR 미리 보기는 화면만 보여줍니다 — 실제 계정에는 백엔드의 데이터베이스가 필요하고, 실제 구매에는 EAS 개발 빌드가 필요합니다. '미리 보기가 열렸다'는 아직 '계정이 작동한다'가 아닙니다.

직접 하고 싶다면

에이전트가 수행하는 모든 단계는 아래의 수동 가이드에 나와 있습니다 — 같은 명령, 같은 확인, 자신의 속도로.

• 5분 만에 Mobile 앱 실행
• 전체 로컬 설정 읽기
• 설정 실패 수정