모든 AI는 프로젝트 작업을 시작하기 전에 AGENTS.md를 먼저 읽는다.

Purpose

다음 질문에 답한다.

어떤 문서를 읽어야 하는가?

어떤 순서로 읽어야 하는가?

무엇을 구현할 수 있는가?

무엇을 구현하면 안 되는가?

AGENTS.md는 프로젝트 운영 규칙을 정의한다.

Inputs

일반적으로 다음 정보를 기반으로 작성한다.

• PRODUCT_SPEC.md
• ARCHITECTURE.md
• FRAMEWORK.md
• TASKS.md
• 프로젝트 운영 정책

Outputs

다음 내용을 정의한다.

• 문서 읽기 순서
• 권한 범위
• 구현 규칙
• 작업 절차
• 중단 조건
• 변경 규칙

Lifecycle

프로젝트 초기 단계에 생성한다.

운영 규칙이 변경될 때만 수정한다.

일반적인 기능 개발로는 수정하지 않는다.

Relationship

PRODUCT_SPEC.md
↓
ARCHITECTURE.md
↓
FRAMEWORK.md
↓
TASKS.md
↓
AGENTS.md
↓
AI Execution

AGENTS.md는 다른 문서를 대체하지 않는다.

AGENTS.md는 어떤 문서를 어떻게 사용해야 하는지 설명한다.

AI Usage

모든 AI가 반드시 읽어야 하는 문서다.

프로젝트 작업의 시작점은 AGENTS.md다.

새로운 세션에서도 AGENTS.md부터 읽는다.

새로운 모델에서도 AGENTS.md부터 읽는다.

Common Responsibilities

일반적으로 다음 내용을 포함한다.

Document Order

Source of Truth

Scope Control

Implementation Rules

Task Execution Rules

Architecture Update Rules

Success Criteria

Generate With

AGENTS.md는 ReplWorks 에서 표준 AGENTS.md를 제공한다.

프로젝트 운영 방식이 바뀔 때만 수정한다.

조직 또는 개인은 재사용 가능한 AGENTS.md 템플릿을 구축할 수 있다.

Example

실제 REPL Works Compatible 프로젝트 예시를 통해 AGENTS.md 작성 방식을 확인할 수 있다.

→ Example AGENTS.md

예시는 다음 내용을 포함한다.

• 문서 우선순위
• 작업 범위 제어
• 구현 규칙
• 완료 기준

Key Principle

좋은 AGENTS.md는 기능을 설명하지 않는다.

좋은 AGENTS.md는 AI가 어떻게 작업해야 하는지 설명한다.

Why It Matters

AI는 프로젝트의 전체 맥락을 알지 못한다.

AGENTS.md는 AI를 올바른 문서로 안내한다.

PRODUCT_SPEC.md가 무엇을 만들지 정의한다면,

ARCHITECTURE.md는 어떻게 구성할지 정의한다.

FRAMEWORK.md는 어떻게 구현할지 정의한다.

TASKS.md는 무엇을 해야 하는지 정의한다.

AGENTS.md는 무엇을 먼저 읽어야 하는지 정의한다.