2. Replit.md Agent 동작 메뉴얼 작성하기

Thu, 17 Jul 2025 06:26:40 GMT

replit.md프로젝트에서 Agent의 동작을 사용자 지정하는 특수 파일입니다. Agent가 원하는 대로 빌드할 수 있도록 환경 설정, 코딩 스타일 및 프로젝트 컨텍스트를 정의하세요.

Agent는 검증된 모범 사례를 사용하여 프로젝트의 루트 디렉터리에 이 파일을 자동으로 생성합니다. Agent는 사용자의 선호도, 프로젝트 구조 및 코딩 스타일을 파악하기 위해 해당 파일의 내용을 컨텍스트에 포함합니다.

![Image](https://upload.cafenono.com/image/slashpagePost/20250717/145905_vqaOTJS5T306rFvrxd?q=80&s=1280x180&t=outside&f=webp)

## replit.md작동 방식

에이전트는 먼저 replit.md검증된 모범 사례를 사용하여 프로젝트의 루트 디렉터리에 파일을 만듭니다. 이 파일에는 다음이 포함됩니다.

- 기본 프로젝트 정보

- 권장되는 코딩 패턴

- 프로젝트 유형에 대한 일반적인 기본 설정

[https://youtu.be/kYv525W-vaU](https://youtu.be/kYv525W-vaU)

에이전트가 귀하의 요청을 처리할 때 자동으로 귀하의 replit.md파일을 읽고 해당 내용을 다음 용도로 사용합니다.

- 프로젝트의 아키텍처와 규칙을 이해하세요

- 선호하는 코딩 패턴과 스타일을 따르세요

- 지정된 패키지 관리자와 종속성을 사용하세요
-

replit.md에이전트는 프로젝트에 대해 더 많이 알아가고 신청서를 변경하면서 파일을 업데이트할 수도 있습니다 .

## replit.md 설정

### 자동 생성

Agent를 사용하여 새 프로젝트를 생성하면 replit.md검증된 모범 사례를 기반으로 파일이 자동으로 생성됩니다. 이 파일은 프로젝트의 루트 디렉터리에 저장되며 다음 내용을 포함합니다.

- 기본 프로젝트 정보

- 권장되는 코딩 패턴

- 프로젝트 유형에 대한 일반적인 기본 설정
- ​

### 수동 생성

프로젝트 루트 디렉터리에 replit.md새 파일을 추가하여 직접 파일을 만들 수 있습니다 . 에이전트는 이 파일을 자동으로 감지하여 향후 대화에 사용합니다.replit.md

### 재생성

replit.md파일이 손상되었거나 처음부터 다시 시작하려는 경우 :

- replit.md프로젝트 루트에서 기존 파일을 삭제하세요

- 에이전트와 새로운 대화를 시작하세요

- replit.md에이전트는 현재 프로젝트를 기반으로 자동으로 새 파일을 생성합니다.
- ​

## 모범 사례

### 구체적이고 명확하게 말하세요

에이전트가 귀하가 원하는 것이 정확히 무엇인지 이해할 수 있도록 명확하고 구체적인 지침을 작성하세요.

```
## Coding Style

- Use TypeScript for all new JavaScript files
- Prefer functional components with hooks over class components
- Use Tailwind CSS for styling, avoid inline styles
- Always include TypeScript types for function parameters and return values
```

### 예를 사용하세요

예시는 추상적인 설명보다 상담원이 사용자의 선호사항을 더 잘 이해하는 데 도움이 됩니다.

```
## API Error Handling

When creating API endpoints, always use this error handling pattern:

```javascript
app.get('/api/users', async (req, res) => {
try {
const users = await getUsersFromDatabase();
res.json({ success: true, data: users });
} catch (error) {
console.error('Error fetching users:', error);
res.status(500).json({
success: false,
error: 'Failed to fetch users'
});
}
});
```

### 통신 환경 설정 정의

상담원에게 정보 및 업데이트를 어떤 방식으로 받고 싶은지 알려주세요.

```
## Communication Style

- Before implementing changes, explain what you're going to do and why
- Break down complex tasks into clear steps
- Ask for clarification if requirements are unclear
- Provide brief explanations for technical decisions
```

### 프로젝트 컨텍스트 지정

에이전트가 귀하의 프로젝트의 목적과 제약 사항을 이해하도록 도와주세요.

```
## Project Context

This is a social media app for book lovers where users can:
- Create reading lists and share book recommendations
- Follow other readers and see their updates
- Rate and review books they've read

Target audience: Casual readers aged 25-45
Tech stack: React frontend, Node.js backend, PostgreSQL database
```

## 구성 예

### 웹 애플리케이션 프로젝트

```
# MyApp Project Guidelines

## Project Overview
A task management web application built with React and Express.js.

## Technology Preferences
- Frontend: React with TypeScript, Tailwind CSS
- Backend: Express.js with TypeScript
- Database: Neon PostgreSQL with Drizzle ORM
- Package Manager: npm (not yarn or pnpm)

## Coding Standards
- Use functional components with hooks
- Implement proper error boundaries
- Follow REST API conventions for endpoints
- Use descriptive variable and function names

## Communication Style
- Explain your approach before making changes
- Provide code comments for complex logic
- Ask questions if requirements are ambiguous
```

### 데이터 분석 프로젝트

```
# Data Analysis Project Guidelines

## Project Context
Analyzing customer behavior data to identify trends and insights.

## Technology Preferences
- Python with Streamlit for interactive web applications
- pandas, numpy, and matplotlib for data analysis

## Analysis Standards
- Include clear documentation for all analysis steps
- Create interactive visualizations with Streamlit components
- Validate data quality before analysis
- Export results to CSV format and display in Streamlit tables

## Communication Style
- Explain statistical methods and assumptions
- Provide context for findings and recommendations
- Use clear, non-technical language for business insights
- Create interactive dashboards for stakeholder presentations
```

### API 개발 프로젝트

```
# API Development Guidelines

## Project Overview
Building a RESTful API for a mobile app backend.

## Technology Stack
- Node.js with Express.js
- MongoDB with Mongoose
- JWT for authentication
- Package manager: npm

## API Standards
- Use semantic HTTP status codes
- Implement proper input validation
- Include rate limiting on public endpoints
- Follow OpenAPI specification for documentation

## Security Requirements
- Validate all user inputs
- Use environment variables for sensitive data
- Implement proper CORS policies
- Include request logging for debugging

## Testing Approach
- Write unit tests for all endpoints
- Include integration tests for critical flows
- Use Jest as the testing framework
```

## 고급 사용법

### 역동적인 프로젝트 안내

replit.md프로젝트가 진행됨에 따라 파일을 업데이트하여 현재 상황을 제공하세요.

```
## Current Development Phase
The team is currently focused on implementing user authentication.
Priority features:
1. User registration and login
2. Password reset functionality
3. Email verification

## Recent Decisions
- Switched from local authentication to OAuth with Google
- Added Redux for state management
- Decided to use Material-UI for consistent styling
```

### 외부 도구와의 통합

외부 문서 및 도구를 참조하세요

```
## External Resources
- Design system: Follow the Figma design system at [link]
- API documentation: Reference our internal API docs
- Coding standards: Follow the team style guide in our wiki

## Deployment Process
- Test changes in development environment first
- Use the CI/CD pipeline for staging deployments
- Require code review before production releases
```

## 웹 검색과 결합

에이전트는 웹 검색을 통해 최신 정보, 라이브러리, 솔루션을 찾을 수 있습니다. 귀하의 replit.md파일과 결합하면 최신 지식과 프로젝트별 지침을 모두 얻을 수 있습니다.

​

### 웹 검색 통합을 위한 모범 사례

에이전트가 조사하기를 원하는 내용을 구체적으로 설명하세요.

```
## Research Preferences
- Always check for the latest versions of dependencies before suggesting updates
- Research current best practices for security implementations
- Look up recent performance optimization techniques for our tech stack
```

외부 지식을 적용하는 방법에 대한 가이드 에이전트

```
## External Research Guidelines
- When suggesting new libraries, ensure compatibility with our existing stack
- Adapt external examples to match our coding standards and project structure
- Verify that suggested solutions work with our deployment environment
```

두 가지를 모두 활용하는 요청 예: "최신 React 18 성능 최적화 기술을 조사하고 정의된 구성 요소 패턴에 따라 구현 replit.md"

이러한 접근 방식을 통해 최신이면서도 귀하의 특정 프로젝트 요구 사항에 맞는 솔루션을 얻을 수 있습니다.

## 제한 사항

### 파일 크기 및 콘텐츠 제한

에는 엄격한 문자 제한이 없지만 replit.md, 매우 큰 파일은 완전히 처리되지 않을 수 있습니다. replit.md최상의 결과를 얻으려면 간결하고 집중적으로 작성하세요.

### 루트 디렉토리 요구 사항

replit.md프로젝트의 루트 디렉터리에 있어야 합니다. 에이전트는 하위 디렉터리의 파일을 자동으로 감지하지 않습니다.

​

### 컨텍스트 범위

replit.md에이전트 대화에 대한 맥락을 제공하지만 Assistant와 같은 다른 AI 도구에는 자동으로 적용되지 않습니다.

​

## 다음 단계

귀하의 프로젝트에 맞게 Agent를 사용자 지정할 준비가 되셨나요?

1. 간단하게 시작하세요replit.md : 주요 선호 사항을 바탕으로 기본 사항을 만드세요

2. 반복하고 개선하세요 : replit.mdAgent를 사용하여 작업하면서 업데이트하세요.

3. 패턴 공유 : replit.md유사한 프로젝트에서 성공적인 구성을 사용합니다.

4. 효과성 모니터링 : 에이전트가 귀하의 지침을 얼마나 잘 따르는지 주의 깊게 살펴보고 그에 따라 조정하세요.