에이전트에게 설정 맡기기

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

이 저장소는 코딩 에이전트가 읽을 수 있도록 작성되었습니다. 지도 파일(llms.txt), 규칙 파일(AGENTS.md), 단계별 런북(docs/agent-setup.md), 준비된 프롬프트(prompts/agent-setup.md)가 함께 제공됩니다. 각 설정 명령을 직접 배우는 대신, 프롬프트 하나를 붙여넣으면 에이전트가 컴퓨터에서 런북을 따릅니다.

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

정직한 한계가 하나 있습니다: 이 자동화된 경로는 웹 앱과 그 백엔드 — 계정과 데이터를 처리하는 서버 — 를 설정합니다. 프롬프트와 런북은 웹 저장소와 All Platforms 모노레포에 함께 제공됩니다. 모바일 전용·데스크톱 전용 체크아웃에는 대신 각 범위에 맞는 llms.txt와 플랫폼 설정 가이드가 들어 있습니다.

• 모바일 앱 로컬 설정
• 데스크톱 앱 실행

먼저 필요한 것

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

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

마지막으로 앱을 실행하는 두 가지 방법 중 하나가 필요합니다: 컴퓨터에 설치된 Node.js 22 이상 — 준비 가이드가 설정한 경로 — 또는 Docker나 Podman 같은 컨테이너 도구로, 앱을 컨테이너 안에서 실행하고 설치된 Node.js가 필요 없습니다. 프롬프트 안에서 하나를 고르면 에이전트가 따릅니다.

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

편집기에서 prompts/agent-setup.md를 여세요 — supastack 폴더 최상위의 prompts 폴더, llms.txt 옆에 있습니다. 전체 텍스트를 선택하고 복사하세요.

두 개의 자리 표시자에 선택이 필요합니다. <SETUP_PATH: docker | podman | host>를 docker, podman, host 중 하나로 바꾸세요 — host는 설치한 Node.js로 앱을 컴퓨터에서 직접 실행하고, docker나 podman은 컨테이너 안에서 실행합니다. <DEPLOY_TARGET: coolify | vps-docker | local-only>를 앱이 도달할 곳으로 바꾸세요 — local-only는 이 컴퓨터에서만 실행하고 아무것도 배포하지 않아 첫 살펴보기에 적합한 선택입니다.

편집한 텍스트를 에이전트 채팅에 붙여넣고 보내세요. 아래 채워진 첫 줄은 docker와 local-only를 고른 예시입니다. 그 줄 아래의 번호 매긴 단계들은 파일에 제공된 그대로 둡니다.

Stand up this supastack checkout end to end for **docker**
and deploy it to **local-only**.

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

프롬프트는 에이전트를 런북과 보안 규칙으로 향하게 한 다음, 순서대로 진행하고 각 단계를 증명하라고 지시합니다. 쉽게 말해 에이전트는:

• 아무것도 건드리기 전에 저장소 지도(llms.txt), 프로젝트 규칙(AGENTS.md), 자격 증명 취급 규칙(docs/agent-security.md)을 읽습니다.
• node scripts/setup-env.mjs로 .env 설정 파일을 만듭니다. 헬퍼는 .env.example에서만 복사하므로 에이전트가 설정 이름을 지어내지 않으며, 이미 있는 시크릿을 덮어쓰지 않고 보존합니다.
• Postgres — 앱이 계정과 레코드를 보관하는 데이터베이스 — 와 앱 자체를 시작합니다. docker나 podman 경로에서는 컨테이너로, host 경로에서는 컴퓨터의 명령으로.
• 첫 실제 로그인 전에 데이터베이스 마이그레이션 — 앱의 테이블을 만드는 명령 — 을 실행합니다. 테이블이 생기기 전에 만든 계정은 깨진 계정이기 때문입니다.
• 각 단계를 체크포인트에서 검증하고, 모든 검사에 PASS, FAIL, BLOCKED 또는 NOT RUN 표시와 그 근거가 되는 출력을 담은 리포트로 마칩니다.

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

좋은 리포트는 주장이 아니라 증거를 보여줍니다. 각 PASS 뒤의 실제 헬스 응답과 명령 출력을 찾으세요 — '모든 것이 작동합니다' 같은 문장이 아니라.

프롬프트는 같은 단계가 두 번 실패하면 멈추고 보고하라고 — 실패를 우회하지 말고 — 에이전트에게 지시하고, 데이터베이스 초기화 같은 파괴적인 일 전에는 물어보라고 합니다. 에이전트가 반복된 실패 후에도 계속 임기응변한다면 멈추고 첫 오류를 문제 해결 가이드로 가져가세요.

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

데모와 실제 로그인을 머릿속에서 구분하세요. /dashboard 데모의 로컬 레퍼런스 플로는 데이터베이스가 필요 없어서 단독으로 통과할 수 있습니다. /auth에서 계정 생성은 마이그레이션이 실행된 후에만 작동합니다. '데모가 됐다'가 아직 '계정이 된다'는 아닙니다.

직접 하고 싶다면

위의 모든 단계는 클릭별 튜토리얼로도 존재합니다. 첫 데모는 5분 웹 가이드를, 실제 데이터베이스를 갖춘 완전한 로컬 환경은 웹 로컬 설정을 실행하세요.

설치를 에이전트가 하지 않았더라도 설정 후에도 에이전트는 유용합니다 — 에이전트 워크플로 가이드는 새 화면, 리스타일링, 리뷰 같은 일상 작업을 다룹니다.