Review Document Content #40

src/content.config.ts

@@ -31,6 +31,13 @@ export const collections = {
     }),
     schema: baseCollectionSchema,
   }),
+  frameworks: defineCollection({
+    loader: glob({
+      base: './src/content/frameworks',
+      pattern: '**/*.{md,mdx}',
+    }),
+    schema: baseCollectionSchema,
+  }),
   tools: defineCollection({
     loader: glob({
       base: './src/content/tools',

src/content/documents/agents.mdx

@@ -1,31 +1,196 @@
 ---
 title: 'AGENTS.md'
 version: 'v1'
-description: 'Project entrypoint and operating rules for AI collaborators.'
+description: 'AGENTS.md는 AI를 위한 프로젝트 진입점이다.'
 publishedAt: '2026-06-12T00:00:00Z'
 ---
 
-## Purpose
+모든 AI는 프로젝트 작업을 시작하기 전에 AGENTS.md를 먼저 읽는다.
 
-Define the authoritative reading order, scope boundaries, and implementation rules.
+---
+
+# Purpose
+
+다음 질문에 답한다.
+
+```text
+어떤 문서를 읽어야 하는가?
+
+어떤 순서로 읽어야 하는가?
+
+무엇을 구현할 수 있는가?
+
+무엇을 구현하면 안 되는가?
+```
+
+---
+
+AGENTS.md는 프로젝트 운영 규칙을 정의한다.
+
+---
+
+# Inputs
+
+일반적으로 다음 정보를 기반으로 작성한다.
+
+- PRODUCT_SPEC.md
+- ARCHITECTURE.md
+- FRAMEWORK.md
+- TASKS.md
+- 프로젝트 운영 정책
+
+---
+
+# Outputs
+
+다음 내용을 정의한다.
+
+- 문서 읽기 순서
+- 권한 범위
+- 구현 규칙
+- 작업 절차
+- 중단 조건
+- 변경 규칙
+
+---
+
+# Lifecycle
+
+프로젝트 초기 단계에 생성한다.
+
+---
+
+운영 규칙이 변경될 때만 수정한다.
+
+---
+
+일반적인 기능 개발로는 수정하지 않는다.
+
+---
+
+# Relationship
+
+```text
+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
+
+일반적으로 다음 내용을 포함한다.
+
+```text
+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](/documents/example-agents)
+
+---
+
+예시는 다음 내용을 포함한다.
+
+- 문서 우선순위
+- 작업 범위 제어
+- 구현 규칙
+- 완료 기준
+
+---
+
+# Key Principle
+
+좋은 AGENTS.md는 기능을 설명하지 않는다.
+
+좋은 AGENTS.md는 AI가 어떻게 작업해야 하는지 설명한다.
+
+---
 
-## Inputs
+# Why It Matters
 
-- repository context
-- product specification
-- architecture
-- tasks
+AI는 프로젝트의 전체 맥락을 알지 못한다.
 
-## Outputs
+---
+
+AGENTS.md는 AI를 올바른 문서로 안내한다.
+
+---
+
+PRODUCT_SPEC.md가 무엇을 만들지 정의한다면,
 
-- collaboration rules
-- task execution order
-- scope limits
+ARCHITECTURE.md는 어떻게 구성할지 정의한다.
 
-## Lifecycle
+FRAMEWORK.md는 어떻게 구현할지 정의한다.
 
-Reviewed first, then updated only when operating rules or authoritative sources change.
+TASKS.md는 무엇을 해야 하는지 정의한다.
 
-## Relationships
+---
 
-Depends on `PRODUCT_SPEC.md`, `ARCHITECTURE.md`, and `TASKS.md`.
+AGENTS.md는 무엇을 먼저 읽어야 하는지 정의한다.