Documentation Index
Fetch the complete documentation index at: https://docs.replit.com/llms.txt
Use this file to discover all available pages before exploring further.
시작하기
Replit은 어떤 프레임워크나 스택도 작성하고 실행할 수 있는 클라우드 개발 환경입니다. 커스텀 템플릿을 빌드하는 데는 두 가지 권장 경로가 있습니다:- Git 제공자에서 가져오기 — GitHub, GitLab, 또는 Bitbucket에서 기존 스타터 스택(또는 원하는 스택)을 가져옵니다.
- Blank 템플릿 포크 — Blank 템플릿을 포크하여 완전히 빈 개발 환경에서 처음부터 시작합니다.
커스텀 템플릿은 Enterprise 플랜에서만 사용할 수 있습니다. 조직 관리자만 템플릿을 고정하고 관리할 수 있습니다.
커스텀 템플릿의 작동 방식
커스텀 템플릿은 Agent 입력 상자에 고정된 조직 내 표준 Replit App입니다. 빌더가 선택하면:- Agent가 템플릿을 포크하여 새 앱을 생성합니다 (모든 파일이 복사됨)
- Agent가 계획 단계를 건너뛰고 바로 빌드로 진행합니다
- 템플릿의
custom_instruction/instructions.md파일이 Agent의 컨텍스트에 주입됩니다 .agents/skills/의 커스텀 스킬이 발견되어 사용 가능해집니다replit.md파일이 지속적인 프로젝트 컨텍스트를 제공합니다
템플릿 파일 구조
커스텀 템플릿의 권장 레이아웃은 다음과 같습니다:커스텀 템플릿 설정
기본 앱 만들기
조직에서 새 Replit App을 만듭니다. 빌더가 시작점으로 필요한 모든 파일, 종속성 및 구성으로 프로젝트를 설정합니다. 여기에는 다음이 포함됩니다:- 소스 코드 스캐폴딩 (컴포넌트, 유틸리티, 구성 파일)
- 사전 설치된 종속성 (
package.json,requirements.txt등) .replit파일의 환경 구성
공유 시크릿 구성
템플릿이 API 키, 토큰 또는 기타 자격 증명에 의존하는 경우, 고정하기 전에 템플릿의 Secrets(도구 패널 아래)에 추가하세요. 빌더가 템플릿에서 새 앱을 만들면 모든 시크릿이 새 앱에 자동으로 복사되므로, 빌더는 자격 증명을 직접 구성하지 않고도 작업을 시작할 수 있습니다.custom_instruction/instructions.md(또는 전용 스킬)에 모든 시크릿을 문서화하여 빌더가 무엇이 있는지, 각 키가 무엇에 사용되는지 알 수 있도록 하세요.
커스텀 지침 작성
프로젝트 루트의custom_instruction/instructions.md에 파일을 만듭니다. 이것은 템플릿에서 가장 중요한 파일로, 조직이 소프트웨어를 빌드하는 방식을 Agent에게 알려줍니다.
Agent는 이 파일을 회사가 제공한 지침으로 프레이밍하는 서문과 함께 시스템 프롬프트에 직접 주입합니다. Markdown으로 작성하고 다음을 포함하세요:
- 아키텍처 패턴: 앱의 구조화 방식
- 코딩 표준: 명명 규칙, 파일 구성 규칙, 린팅 기대치
- 컴포넌트 사용: 사용할 (그리고 피해야 할) 라이브러리와 컴포넌트
- API 패턴: 백엔드 서비스 호출, 인증 처리, 오류 관리 방법
- 테스트 요구 사항: 기대되는 테스트와 실행 방법
- 배포 지침: 환경별 구성 및 배포 워크플로
instructions.md에 유지하는 대신 상세한 참조 자료를 .agents/skills/의 스킬로 이동하세요. 스킬은 관련 있을 때 필요 시 로드되므로 지침 크기 제한에 포함되지 않으며 주요 지침을 고수준 규칙에 집중되게 유지합니다.
커스텀 스킬 추가
Agent가 따라야 할 특수 워크플로를 위해.agents/skills/ 디렉터리에 스킬을 만듭니다. 각 스킬은 YAML 프론트매터가 있는 SKILL.md 파일을 포함하는 디렉터리입니다.
SKILL.md에는 프론트매터에 name과 description이 필요합니다:
| 필드 | 필수 여부 | 세부 사항 |
|---|---|---|
name | 예 | 최대 64자. 소문자, 숫자, 하이픈만 가능합니다. |
description | 예 | 최대 1,024자. 스킬이 무엇을 하는지, 언제 사용하는지 설명합니다. |
enabled | 아니오 | 기본값은 true입니다. 삭제하지 않고 비활성화하려면 false로 설정합니다. |
name과 description만 봅니다. 스킬이 현재 작업과 관련 있을 때 필요 시 전체 SKILL.md 콘텐츠를 읽습니다. 즉, description이 매우 중요합니다. Agent가 스킬을 사용해야 하는 시나리오와 일치하도록 작성하세요.
스킬은 SKILL.md와 함께 지원 파일도 포함할 수 있습니다:
replit.md 구성
프로젝트 루트의replit.md에 템플릿의 아키텍처 개요를 사전에 채워 넣습니다. 이 파일은 항상 Agent의 컨텍스트에 로드되며 지속적인 프로젝트 메모리 역할을 합니다.
파일에는 다음 네 섹션이 있어야 합니다:
replit.md를 업데이트합니다. 파일이 약 4,000 토큰을 초과하면 Agent가 자동으로 요약하여 집중적이고 유용하게 유지합니다.
자세한 내용은 replit.md를 참조하세요.
조직에 템플릿 고정
템플릿이 준비되면:- 조직의 템플릿 앱으로 이동합니다
- 앱의 작업 메뉴(점 세 개 메뉴)를 엽니다
- Agent 입력 상자에 고정을 선택합니다

조직 관리자(
system_admins 역할의 구성원)만 템플릿을 고정하거나 고정 해제할 수 있습니다.
템플릿 접근 제어
고정하면 템플릿이 모든 조직 구성원에게 표시됩니다. 보다 타겟팅된 배포를 위해 템플릿 앱의 초대 버튼을 사용하여 특정 그룹 또는 개별 사용자와 공유합니다. 이를 통해 조직 전체 입력 상자에 고정하지 않고도 어떤 팀이나 사람이 템플릿을 보고 포크할 수 있는지 제한할 수 있습니다.빌더가 템플릿을 선택하면 어떻게 되는가

- 포크: 모든 파일이 포함된 템플릿의 복사본으로 새 앱이 생성됩니다
- 계획 건너뛰기: Agent가 초기 계획 대화를 건너뛰고 빌드 모드로 직접 진행합니다
- 지침 로드:
custom_instruction/instructions.md가 읽혀 회사 제공 지침으로 Agent의 시스템 프롬프트에 주입됩니다 - 스킬 발견:
.agents/skills/의 스킬이 식별되어 필요 시 로드를 위해 Agent의 컨텍스트에 나열됩니다 - 프로젝트 컨텍스트 로드:
replit.md가 읽혀 Agent의 컨텍스트에 주입됩니다 (없으면 자동 생성됨) - 구성 상속:
.replit파일, 종속성, 모든 템플릿 파일이 새 앱으로 이어집니다
파일이 함께 작동하는 방식
각 구성 파일은 고유한 역할을 수행합니다:| 파일 | 목적 | Agent가 읽는 시점 | Agent가 수정 가능 여부 |
|---|---|---|---|
custom_instruction/instructions.md | 조직 표준 및 규칙 | 항상 (시스템 프롬프트에 주입) | 아니오 |
.agents/skills/*/SKILL.md | 특수 워크플로 및 패턴 | 필요 시 (관련 있을 때) | 예 (Agent도 스킬을 만들 수 있음) |
replit.md | 프로젝트 개요 및 기본 설정 | 항상 (시스템 프롬프트에 주입) | 예 (Agent가 시간이 지남에 따라 업데이트) |
.replit | 런타임 구성 | 앱 구성 시 | 예 |
custom_instruction/instructions.md는 조직 표준을 위한 정적이고 권위 있는 소스입니다. replit.md는 프로젝트가 발전함에 따라 Agent가 유지 관리하는 살아있는 문서입니다. 스킬은 특정 워크플로를 위한 필요 시 참조 자료입니다.
모범 사례
지침을 집중되게 유지
가장 중요한 패턴을 위해custom_instruction/instructions.md를 작성합니다. 다음에 집중하세요:
- 되돌리기 어려운 결정 (아키텍처, 데이터 모델)
- 일관되어야 하는 패턴 (컴포넌트 사용, API 규칙)
- 빌더가 모를 수 있는 표준 (내부 라이브러리, 팀 규칙)
발견 가능한 스킬 설명 작성
SKILL.md 프론트매터의 description 필드는 Agent가 스킬을 로드할 시점을 결정하는 데 사용하는 것입니다. 스킬이 관련 있는 작업과 일치하는 설명을 작성하세요:
워크플로별로 스킬 구성
기술적 카테고리가 아닌 워크플로를 중심으로 스킬을 그룹화합니다:| 접근 방식 | 예시 |
|---|---|
| 워크플로별 | build-a-form, connect-to-api, add-auth |
| 기술 영역별 | react-utils, api-helpers, auth-config |
템플릿을 반복 개선
템플릿은 사용하면서 개선됩니다. 팀이 템플릿으로 빌드를 시작한 후:- Agent가 잘못 처리하는 패턴을 확인하고
instructions.md에 추가합니다 - Agent가 문제를 잘 해결할 때 새 스킬을 만들어 해결책을 캡처합니다
- 스택이 발전함에 따라 기본 종속성과 구성을 업데이트합니다
- 템플릿에서 새 앱을 만들어 변경 사항을 테스트하여 경험을 확인합니다
템플릿 업데이트와 기존 앱
템플릿 앱에 대한 변경 사항은 새로 만들어지는 앱에 반영됩니다. 템플릿에서 이전에 포크된 기존 앱은 독립적인 복사본이며 업데이트를 받지 않습니다.관련 리소스
- Agent Skills — 스킬의 작동 방식과 만드는 방법 알아보기
- 스킬 사용 — 스킬 사용 및 빌드에 관한 실습 가이드
- replit.md — 프로젝트 수준 컨텍스트로 Agent의 동작 커스텀화
- 디자인 시스템 — Agent를 위한 조직의 디자인 시스템 설정
- 앱 구성 —
.replit파일 구성 - 개발자 프레임워크 — 커뮤니티 템플릿 및 게시 방법
- Enterprise 개요 — Enterprise 기능 알아보기