프로젝트 지침 및 메모리 project-instructions

경험 현대화 에이전트는 현재 대화와 프로젝트의 파일에 있는 내용만 알고 있습니다. 모든 대화에서 프로젝트의 규칙을 따르도록 하려면 Git 저장소의 Markdown 파일에 기록합니다. 이 문서에서는 에이전트가 이러한 파일을 사용하는 방법과 이를 효율적으로 작동하도록 구성하는 방법에 대해 설명합니다.

새 대화 시작까지의 모든 내용이 모든 프로젝트에 적용됩니다. 사용자 지정 기술은(는) 대부분의 프로젝트에 필요하지 않은 고급 옵션입니다.

에이전트가 기억하는 내용 memory

에이전트는 기본 설정 또는 이전 대화에 대한 별도의 메모리를 보관하지 않습니다. 모든 대화에서 알아야 할 모든 내용은 읽은 파일에 있어야 합니다. 파일은 Git 저장소에 있으므로 프로젝트에 있는 다른 개발자와 이 파일과 함께 사용하는 다른 AI 도구에도 도움이 됩니다.

AGENTS.md를 진입점으로 사용 agents-md

AGENTS.md은(는) 저장소의 루트에 있는 Markdown 파일입니다. 많은 AI 코딩 에이전트가 읽는 공개 형식을 따릅니다.

에이전트는 현재 클라우드 모델을 사용하며, 이 모델은 모든 대화가 시작될 때 저장소 루트에서 이름이 CLAUDE.md인 파일을 로드합니다. AEM 보일러판이(가) 따르는 모범 사례는 이 한 줄이 있는 CLAUDE.md 파일입니다.

see @AGENTS.md

@ 참조를 사용하면 에이전트가 CLAUDE.md과(와) 함께 AGENTS.md을(를) 로드하고 작동하는 동안 해당 컨텍스트에 보관합니다. AGENTS.md에 프로젝트 지침을 쓰고 CLAUDE.md을(를) 한 줄로 남겨둡니다. 그런 다음 지침은 다른 AI 도구에서도 읽은 개방형 형식을 유지하며 에이전트 뒤에 있는 모델이 변경되면 설정이 계속 작동합니다. 해당 모델은 구현 세부 사항이므로 이에 따라 지침을 작성하지 마십시오.

문서 기반 콘텐츠 또는 Experience Manager 작성을 위해 현재 AEM 템플릿에서 만든 프로젝트에는 두 파일이 모두 포함되어 있으며 AGENTS.md에 일반 Edge Delivery Services 코딩 규칙이 포함되어 있습니다. 두 파일을 모두 유지합니다. 보일러판에 포함되기 전에 프로젝트가 생성된 경우 에이전트에 현재 보일러판에서 추가하도록 요청합니다. 로드된 내용을 확인하려면 새 대화를 시작하고 프로젝트에 있는 지침을 확인하십시오.

AGENTS.md에 프로젝트에 대한 짧은 섹션 추가:

AGENTS.md을(를) 짧게 유지하십시오. 상담원은 모든 대화에서 모든 것을 수행하므로 모든 줄은 작업에 사용할 수 있는 공간을 차지합니다. 일반 텍스트가 길면 에이전트에서 중요한 규칙을 구별하기가 더 어려워집니다.

추가 지침 파일 구성 organize

세부 정보가 여러 개 있는 경우 폴더에 그룹화된 개별 파일에 세부 정보를 넣습니다. 예:

AGENTS.md                    Entry point: project summary and an index of the files below
project/
  blocks.md                  Blocks, their variants, and how authors fill them
  sections-and-templates.md  Section styles and page template conventions
  design.md                  Design tokens, typography, spacing, and brand rules
  content.md                 Content, naming, URL, and asset conventions
  decisions.md               Agreed decisions, with dates and reasons

AGENTS.md에서 각 파일을 참조합니다. 이 에이전트는 작업이 필요할 때 참조된 파일을 열므로 모든 프롬프트에서 파일 이름을 지정할 필요가 없습니다.

## Project Instructions

This project migrates the WKND sample site to Edge Delivery Services. Content is document-based and edited in Experience Workspace.

Read these files when the task needs them:

| File | Read when |
|---|---|
| `project/blocks.md` | Creating, changing, or using a block |
| `project/sections-and-templates.md` | Building or styling sections or page templates |
| `project/design.md` | Changing colors, typography, spacing, or other styles |
| `project/content.md` | Importing, writing, or restructuring content |
| `project/decisions.md` | Before changing an agreed convention |

When we agree on a new convention, update the matching file in the same change.

다음 지침을 따르십시오.

Edge Delivery Services은 저장소에 커밋된 파일을 제공합니다. 단, .hlxignore 파일에서 제외되어 있습니다. AEM 상용구 .hlxignore은(는) Markdown 파일과 이름이 점으로 시작하는 파일을 제외합니다. 제외된 상태로 유지되도록 Markdown으로 지침 파일을 작성하십시오. 그렇지 않으면 사이트의 URL에서 JSON 또는 일반 텍스트와 같은 다른 형식의 파일을 요청할 수 있습니다. 콘솔에 .hlxignore이(가) 표시되지 않으므로 변경해야 하는 경우 GitHub 또는 로컬 클론에서 편집하십시오.

문서 컨텐트 규칙 content-conventions

작성자는 추가 필드 없이 제목, 일부 텍스트, 이미지 및 링크와 같은 린 콘텐츠 구조를 사용하여 가장 잘 작업합니다. 컨텐츠를 단순하게 유지하기 위해 구현은 선택 사항인 컨텐츠 또는 요소의 위치가 그 역할을 변경하는 방법 등의 규칙에 의존합니다. 작성자, 개발자 및 에이전트는 이러한 규칙이 기록되어 있을 경우에만 해당 규칙을 따를 수 있습니다. David의 모델은(는) 이러한 구조에 대한 일반적인 규칙을 설명합니다. 콘텐츠 규칙에서 참조하고 프로젝트 자체 결정만 기록하십시오.

문서화할 가치가 있는 규칙은 다음과 같습니다.

한 블록에 대한 항목은 다음과 같이 짧을 수 있습니다.

### Teaser

Promotes one page or offer.

| Content | Required | Convention |
|---|---|---|
| Image | No | Without an image, the text spans the full width. |
| Eyebrow | No | A short paragraph before the heading becomes the eyebrow. |
| Title | Yes | Heading 2 for the standard size, Heading 3 for a compact teaser. |
| Text | No | One or two short paragraphs. |
| Links | No | A bold link becomes a primary button, an italic link a secondary button. |

Variants: `dark` (light text on a dark background).
Works in sections: default, `dark`, and `narrow`.

마이그레이션이 블록을 만들 때 에이전트는 개발자용 README 파일과 작성자용 작성 안내서도 작성합니다. 에이전트가 블록에 제공하는 항목을 참조하세요. 이러한 파일을 반복하지 않고 인덱스에서 참조합니다.

에이전트의 답변 방식 변경 reply-style

에이전트가 답변을 작성하는 방식은 다른 규칙과 같으므로 AGENTS.md에서 설정할 수 있습니다. 예를 들어 다음 단계를 제안하여 각 답변을 종료하지 않으려는 경우 또는 보다 짧은 답변을 원하는 경우 다음과 같이 하십시오.

## How to answer
- Keep answers short: what you changed, where, and anything that needs my decision.
- Don't suggest next steps unless I ask for them.
- Answer in German. Keep code, file names, and commit messages in English.

이러한 지침은 에이전트의 답변 텍스트를 형성합니다. 콘솔이 다음 단계​에 표시하는 제안은 별도로 생성되므로 계속 표시되며 무시할 수 있습니다.

각 요청에 대한 기록 남기기 trace

Git 기록 및 콘텐츠의 버전 기록은 에이전트가 수행한 작업의 기록입니다. 에이전트가 수행한 작업 추적을 참조하십시오. 해당 레코드를 쉽게 따르려면 각 요청이 자체 커밋 및 콘텐츠 업로드를 유지하도록 AGENTS.md에 기본 규칙을 추가하십시오.

## After Each Request

- Commit your changes with a message that summarizes my request.
- Push the commit to the `develop` branch. Never push to `main`.
- If pages changed, list them and ask whether to upload them to Experience Workspace.

에이전트가 파일을 유지 관리하도록 합니다. maintain

이 파일들은 일일이 손으로 쓸 필요가 없다. 에이전트에게 생성 및 업데이트를 요청한 후 코드를 검토하는 것처럼 검토하십시오.

새 대화 시작 new-conversation

에이전트가 AGENTS.md을(를) 자동으로 로드하므로 프로젝트 지침으로 새 대화가 시작되고 색인을 통해 다른 파일을 찾습니다. 대화가 길어졌거나 작업에서 흘러간 경우 채팅 지우기​로 새 대화를 시작하십시오. 지우기 전에 에이전트에게 중요한 내용을 저장하도록 요청하십시오.

채팅을 지우기 전에 이 대화에서 동의한 결정 및 규칙을 프로젝트 파일에 기록하고 변경 사항을 나열합니다.

지우면 이전 메시지가 제거되어 실행 취소할 수 없습니다. 대화를 유지하려면 먼저 채팅 다운로드​를 선택하세요.

다른 사람 또는 팀으로 전체 인계를 하려면 사람 및 에이전트에 대한 컨텍스트 유지를 참조하십시오.

고급: 사용자 정의 스킬 custom-skills

대부분의 프로젝트에는 사용자 지정 기술이 필요하지 않습니다. 에이전트의 기본 제공 기술은 마이그레이션, 디자인, 블록 개발 및 설명서를 포함하며 각 릴리스에 따라 개선됩니다. 릴리스 정보를 참조하세요.

스킬은 한 종류의 작업에 대한 지시의 집합으로, 종종 단계별로 이루어진다. AGENTS.md의 섹션처럼 작동하지만 한 가지 차이점이 있습니다. 상담원은 모든 대화에서 스킬을 전달하지 않고 해당 작업을 수행할 때만 스킬을 읽습니다. 다음과 같은 경우 사용자 정의 스킬을 고려하십시오.

사용자 정의 스킬을 추가하려면 다음을 수행합니다.

SKILL.md의 헤더는 다음과 같습니다.

---
name: gallery-images
description: Extract the images of the source site's photo galleries, which a script loads. Use when importing pages that contain a gallery.
---

AGENTS.md에 기술을 나열할 필요가 없습니다. 에이전트는 폴더의 모든 스킬에 대한 설명을 보고 태스크가 스킬과 일치하면 해당 스킬을 읽으므로 언제 사용해야 하는지 정확하게 설명합니다.

스킬을 작성하는 좋은 방법은 작업을 올바르게 완료한 직후 에이전트에게 해당 스킬을 요청하는 것입니다.

사용한 검사를 포함하여 갤러리 이미지를 추출한 방법을 캡처하는 스킬을 .claude/skills/gallery-images/SKILL.md에 작성하십시오. 그런 다음 커밋하고 푸시합니다.

사용자 정의 기술은 에이전트의 기본 제공 기술을 대체하거나 변경하지 않습니다. 새 릴리스가 기본적으로 작업을 처리할 때 해당 작업을 다루는 사용자 정의 기술을 제거합니다.

왜 .claude/skills인가 skills-location

현재 콘솔이 실행되는 에이전트와 같은 클라우드 기반 에이전트는 저장소 루트의 .claude/skills/ 폴더에서 자체적으로 기술을 검색합니다. 기본적으로 로드되는 스킬: 에이전트가 작업이 일치할 때까지 스킬의 짧은 설명만 보고 이름별로 요청을 할 수 있으며 사용할 수 있는 도구와 같은 설정을 스킬 헤더에서 적용합니다. 이 방법은 에이전트가 색인을 읽고 파일을 열어야 하는 AGENTS.md이(가) 색인하는 skills/과(와) 같은 표시 폴더보다 안정적으로 작동합니다.

폴더 이름은 점으로 시작하며 두 가지 효과가 있습니다.

프로젝트에 AGENTS.md개의 색인이 있는 표시되는 폴더에 이미 스킬이 있는 경우 계속 작동합니다. 기본적으로 로드하려면 에이전트에게 .claude/skills/(으)로 이동하여 헤더를 추가하고 인덱스 줄을 제거하도록 요청하십시오.