CLAUDE.md · AGENTS.md · MEMORY.md

AI는 매 세션마다 기억을 잃습니다. 같은 폴더에 세 파일을 두면, 출근할 때마다 자동으로 읽고 어제처럼 일합니다.

진입점이 본문을 가리키고, 이력은 따로 쌓입니다

CLAUDE.md는 책상에 붙여둔 안내판입니다. 출근한 AI가 처음 보고 "아, 진짜 매뉴얼은 옆 폴더에 있구나"를 알게 합니다.

# CLAUDE.md

이 프로젝트의 모든 작업 지침은 [AGENTS.md](AGENTS.md)에 있다.
변경 이력과 표준화 상태는 [MEMORY.md](MEMORY.md)에 있다.

앞으로 규약을 추가하거나 고칠 때는 [AGENTS.md](AGENTS.md)만 수정한다.
이 파일은 진입점 역할만 한다.

이 웹사이트 CLAUDE.md · 전문

• 3번 줄: 진짜 규칙은 AGENTS.md에 있다고 명시합니다. AI는 이 줄을 보고 바로 AGENTS.md를 함께 읽습니다.
• 4번 줄: 변경 이력은 MEMORY.md에 있다고 안내합니다. AI가 과거 작업을 참고할 때 어디를 봐야 하는지 알려줍니다.
• 6번 줄: "규약을 고칠 때는 AGENTS.md만 수정해라"라는 운영 원칙입니다. 규칙이 두 파일에 흩어지는 사고를 막습니다.
• 7번 줄: "이 파일은 진입점 역할만 한다"고 못 박습니다. CLAUDE.md를 안내판 이상으로 키우지 않겠다는 선언입니다.

CLAUDE.md가 안내판이라면, AGENTS.md는 업무 매뉴얼 한 권입니다. 정체성, 디자인 시스템, 코딩 규약, 글쓰기 원칙, 페이지 인벤토리가 모두 한 파일 안에 있습니다.

# AGENTS.md: AI ROASTING · Claude 완전 정복

이 파일은 이 프로젝트에서 AI가 일할 때 따라야 할 모든 작업 지침을 담는다.
코드 규약, 디자인 시스템, 한국어 작성 원칙, 페이지 인벤토리가 모두 여기에 있다.
변경 이력은 [MEMORY.md](MEMORY.md)에 따로 둔다.

새 규약을 추가하거나 기존 규약을 고칠 때는 이 파일만 수정한다.

## 한 줄 원칙 (글쓰기)

> 자연스러운 한국어로, 주술 구조 맞추어서, 이해하기 쉽게,
> 번역투 거두어내고 em dash는 절대 쓰지 마.

이 한 줄이 모든 한국어 문장의 뿌리다. 이 문서, 콘텐츠 페이지의 본문,
commit 메시지, AI 응답까지 모두 같은 기준으로 쓴다.

## 1. 프로젝트 정체성

- 이름: AI ROASTING · Claude 완전 정복
- URL: https://airoasting.github.io/claude_guide/
- 타깃: 비즈니스 리더와 지식 노동자 (비개발자 포함)
- 포맷: 단일 폴더 정적 HTML, GitHub Pages 호스팅
- 디자인: 뉴모피즘, Pretendard Variable, 오렌지 액센트
- 분류: Core Asset (계속 키워야 할 대표 자산)

## 2. 페이지 인벤토리 (29개)
...
## 3. 디자인 시스템과 코딩 규약
...
## 4. 한국어 작성 원칙 (8가지)
...

이 웹사이트 AGENTS.md · 전체 455줄 중 일부

• 한 줄 원칙: 전체를 관통하는 단 한 줄. 모든 판단의 뿌리입니다.
• 프로젝트 정체성: 이름, URL, 타깃, 포맷, 분류 한 묶음. AI가 "이 프로젝트가 뭔지" 한 번에 알게 합니다.
• 인벤토리: 페이지·파일·기능 목록. AI가 "어디를 건드리면 되는지" 바로 찾게 합니다.
• 디자인 시스템과 코딩 규약: 색, 폰트, 간격, 명명 규칙. 결과물이 매번 같은 결로 나오게 합니다.
• 한국어 작성 원칙: em dash 금지, 주술 구조, 번역투 거두기 같은 톤 규칙. 콘텐츠 페이지의 문장까지 한 결로 묶습니다.

MEMORY.md는 작업의 자취입니다. AGENTS.md가 "지금 지켜야 할 규칙"이라면, MEMORY.md는 "왜 그렇게 됐는가의 흔적"입니다.

# MEMORY.md: 변경 로그와 표준화 상태

이 파일은 페이지별 변경 이력과 표준화 진행 상황을 기록한다.
모든 작업 지침은 [AGENTS.md](AGENTS.md)에 있다.

## 최근 세션 변경 로그

### 2026-05-17 (현재 세션)

| # | 명령                                     | 범위                  | 결과                                |
|---|------------------------------------------|-----------------------|-------------------------------------|
| 1 | 3-menu 페이지를 ai-fluency.html과 통일   | 11개 파일             | max-width 700px, 버튼 224px         |
| 2 | 2-menu 페이지를 claude-orientation 통일  | 3개 파일              | max-width 490px, 버튼 238px         |
| 3 | ai-levels.html 헤더 배지 제거            | 1개 파일              | h1, hero-sub, header-pages만 남김   |
| 4 | 운영 문서 체계 정착                      | CLAUDE/AGENTS/MEMORY  | 작업 지침을 AGENTS.md 한 곳에 통합  |
| 5 | 한국어 작성 원칙 8가지 명문화            | AGENTS.md 4절         | em dash 금지, 종결체 통일 등        |

## 표준화 상태

### 헤더 메뉴 폭 (메뉴 개수별)

| 메뉴 수 | 기준 페이지               | 통일 완료     | 상태   |
|---------|---------------------------|---------------|--------|
| 2개     | claude-orientation.html   | 4개 페이지    | ✅ 4/4  |
| 3개     | ai-fluency.html           | 13개 페이지   | ✅ 13/13|
| 5개     | 미정                      | 없음          | ⏸ 미착수|

## 다음 액션 (Open Items)

1. 현재 세션 변경 분 commit 여부 결정
2. 5-menu / 7-menu 페이지의 헤더 폭 기준 페이지 선정
3. 다른 페이지에서 헤더 배지 중복 노출 있는지 점검
...

이 웹사이트 MEMORY.md · 전체 101줄 중 일부

• 최근 세션 변경 로그: 날짜별, 작업별로 표 형식. "언제, 무엇을, 어떤 범위로 바꿨는지"가 한눈에 보입니다.
• 표준화 상태: 통일 작업이 어디까지 진행됐는지 진행률 표. 미완 항목이 그대로 보입니다.
• 페이지별 특이사항: "이 페이지는 다른 페이지와 이런 점이 다르다"는 메모. AI가 실수로 균질화하는 사고를 막습니다.
• 다음 액션 (Open Items): 아직 안 끝난 일 목록. 다음 세션에서 바로 이어 들어갑니다.

처음 시작하는 분은 아래 순서대로 따라가세요. 비어 있는 골격에서 시작해서, 작업하면서 채우는 게 가장 빠릅니다.

# CLAUDE.md

이 프로젝트의 모든 작업 지침은 [AGENTS.md](AGENTS.md)에 있다.
변경 이력은 [MEMORY.md](MEMORY.md)에 있다.

앞으로 규약을 추가하거나 고칠 때는 [AGENTS.md](AGENTS.md)만 수정한다.
이 파일은 진입점 역할만 한다.

# AGENTS.md: [프로젝트 이름]

이 파일은 이 프로젝트에서 AI가 일할 때 따라야 할 모든 작업 지침을 담는다.
변경 이력은 [MEMORY.md](MEMORY.md)에 따로 둔다.

## 한 줄 원칙

> [이 프로젝트를 한 줄로 관통하는 원칙. 예: 모든 답변은 한국어로,
>  코드 변경은 이유와 함께, .env는 절대 건드리지 마.]

## 1. 프로젝트 정체성

- 이름: [프로젝트 이름]
- 목적: [한 줄 설명]
- 타깃: [누가 쓰는가]
- 포맷: [기술 스택 또는 산출물 형태]

## 2. 핵심 규칙

- 모든 답변과 주석은 한국어로 작성할 것
- 코드를 수정했다면 왜 바꿨는지 한 줄로 설명할 것
- 데이터베이스 구조 변경 전 반드시 사용자 확인 받을 것
- .env 파일은 절대 수정하지 말 것
- 기존 코드 스타일과 동일한 패턴을 유지할 것

## 3. 절대 하지 마세요

- [프로젝트별 금지 사항]
- [예: 결제 관련 코드 임의 수정 금지]

## 4. 자주 쓰는 명령어

- `[개발 서버 실행 명령어]`
- `[빌드 명령어]`
- `[테스트 명령어]`

# MEMORY.md: 변경 로그와 표준화 상태

이 파일은 변경 이력과 진행 상황을 기록한다.
모든 작업 지침은 [AGENTS.md](AGENTS.md)에 있다.

## 최근 세션 변경 로그

### [YYYY-MM-DD]

| # | 명령 | 범위 | 결과 |
|---|------|------|------|
| 1 |      |      |      |

## 다음 액션 (Open Items)

1.
2.

• 규칙은 구체적으로 적습니다. "코드 정리해줘"보다 "함수마다 설명 주석을 추가해줘"가 결과가 일정합니다.
• 자주 하는 실수를 콕 짚어둡니다. .env를 건드린 적이 있다면 ".env 절대 수정 금지"를 명시적으로 적어둡니다.
• AGENTS.md는 300줄 안팎으로 유지합니다. 길어지면 AI가 핵심을 놓치고 매 세션 토큰도 낭비됩니다.
• 300줄을 넘으면 파일을 쪼갭니다. AGENTS.md에서 @docs/tone-guide.md 같은 식으로 다른 파일을 끌어와 한 장처럼 쓸 수 있습니다.
• .claudeignore 파일로 AI가 읽지 않을 폴더를 지정할 수 있습니다. node_modules, backup/ 같은 폴더를 빼두면 매 세션이 빨라집니다.
• 새 규칙이 필요하면 AI에게 바로 요청하세요. "AGENTS.md에 다음 규칙 추가해줘"라고 말하면 AI가 직접 파일을 고칩니다.

세 파일로 ① 메모리 계층을 잡았습니다. 같은 사이트의 다른 페이지가 나머지 계층을 다룹니다.