목적

REPL Works는 AI 시대를 위한 Project Memory System이다. 이 문서는 REPL Works를 구성하는 최소 규칙을 정의한다.

• Workflow는 구현체다.
• Specification은 표준이다.

핵심 원칙

AI의 기억은 일시적입니다. 프로젝트의 기억은 외부화되어야 합니다.

Models forget. Projects must not.

규칙 1. Git 우선

모든 프로젝트는 Git Repository로 시작해야 한다.

git init

프로젝트 기억은 Git에 저장된다.

규칙 2. 리포지토리는 기억 시스템이다

프로젝트에 필요한 기억은 모델 내부가 아닌 Repository 내부에 존재해야 한다.

프로젝트는 특정 모델에 의존해서는 안 된다.

규칙 3. AGENTS.md는 헌법이다

모든 프로젝트는 AGENTS.md를 가져야 한다. AGENTS.md는 프로젝트 헌법이다.

AGENTS.md는 최소한 다음 내용을 포함해야 한다

• 프로젝트 규칙
• 개발 규칙
• 테스트 규칙
• 문서 위치
• 논리적 에이전트 정의 위치

모든 AI 작업은 AGENTS.md를 기준으로 수행된다.

규칙 4. 아키텍처는 필수이다

모든 프로젝트는 ARCHITECTURE.md를 가져야 한다.

ARCHITECTURE.md는 다음을 정의한다

• 시스템 구조
• 폴더 구조
• 데이터 흐름
• 모듈 책임
• 기술 스택

Architecture가 비대해질 경우 분리 가능하다.

architecture/
├── frontend.md
├── backend.md
├── database.md
└── deployment.md

ARCHITECTURE.md는 진입점 역할을 수행한다.

규칙 5. 태스크는 필수이다

모든 프로젝트는 TASKS.md를 가져야 한다.

TASKS.md는 TODO 목록이다.

태스크는 반드시 Phase 단위로 관리한다.

Phase 1

[ ] Authentication
[ ] Database Setup

Phase 2

[ ] Dashboard

• Architecture는 목적지다.
• Tasks는 현재 위치다.

규칙 6. 계획과 실행은 분리되어야 한다

계획 수립과 구현은 서로 다른 런타임에서 수행한다.

Planning Runtime

• IDEAS.md
• PITCHING_SCRIPT.md
• ARCHITECTURE.md
• TASKS.md

Execution Runtime

• 구현
• 테스트
• 리팩토링

동일 컨텍스트에서 장기간 혼합하는 것을 권장하지 않는다.

규칙 7. 문서는 AI 인프라다

README.md를 제외한 대부분 문서는 AI를 위한 문서다.

• 문서는 설명서가 아니다.
• 문서는 프로젝트 기억 장치다.

규칙 8. 모든 기능에는 테스트가 필요하다

모든 기능은 테스트를 포함해야 한다.

• 테스트 없는 구현은 완료된 구현으로 간주하지 않는다.
• Unit Test는 AI 환각을 줄이는 기본 안전장치다.

규칙 9. 아키텍처와 태스크는 일관성을 유지해야 한다

TASKS.md 변경이 Architecture에 영향을 준다면 ARCHITECTURE.md도 함께 수정되어야 한다.

• Architecture와 Tasks는 독립적으로 진화해서는 안 된다.

규칙 10. 모델은 교체 가능해야 한다

REPL Works는 특정 모델에 의존하지 않는다.

예:

• GPT
• Claude
• Gemini
• Codex
• Cursor

모델은 교체 가능해야 한다. 프로젝트의 가치는 Git에 저장된 지식에 있다.

규칙 11. 세션 기억은 선택적이다

프로젝트 기억과 세션 기억은 다르다.

프로젝트 기억

• Git
• AGENTS.md
• ARCHITECTURE.md
• TASKS.md

세션 기억

• LONG_CONTEXT.md

LONG_CONTEXT.md는 프로젝트 문서가 아니다. 세션 복구 문서다.

• AI는 LONG_CONTEXT.md를 자동 참조해서는 안 된다.
• 사람이 필요할 때 수동으로 제공한다.

준수

프로젝트가 REPL Works Compatible이려면 최소한 다음을 만족해야 한다.

• Git Repository
• AGENTS.md
• ARCHITECTURE.md
• TASKS.md
• Test Coverage

이 다섯 가지는 REPL Works의 최소 요구사항이다.