규칙

AGENTS.md 파일을 생성하여 dropstone에 사용자 정의 지침을 제공할 수 있습니다. 이는 Cursor의 규칙과 유사합니다. LLM의 컨텍스트에 포함되어 특정 프로젝트에 맞게 동작을 사용자 정의하는 지침을 포함합니다.

초기화

새로운 AGENTS.md 파일을 생성하려면 dropstone에서 /init 명령을 실행할 수 있습니다.

/init은 리포지토리의 중요한 파일을 스캔하고, 코드베이스에서 답변할 수 없을 때 몇 가지 대상화된 질문을 할 수 있으며, 그 후 간결한 프로젝트별 지침으로 AGENTS.md를 생성하거나 업데이트합니다.

향후 에이전트 세션에서 가장 필요할 가능성이 높은 사항에 중점을 둡니다:

• 빌드, 린트 및 테스트 명령
• 명령 순서 및 중요할 때 집중된 검증 단계
• 파일명만으로는 명확하지 않은 아키텍처 및 리포지토리 구조
• 프로젝트별 규칙, 설정 특이사항 및 운영 주의사항
• Cursor 또는 Copilot 규칙과 같은 기존 지침 소스에 대한 참조

이미 AGENTS.md가 있다면 /init은 무작정 교체하는 대신 제자리에서 개선합니다.

예제

이 파일을 수동으로 생성할 수도 있습니다. 다음은 AGENTS.md 파일에 포함할 수 있는 항목의 예입니다.

# SST v3 모노레포 프로젝트

이는 TypeScript를 사용하는 SST v3 모노레포입니다. 프로젝트는 패키지 관리를 위해 bun 워크스페이스를 사용합니다.

## 프로젝트 구조

- `packages/` - 모든 워크스페이스 패키지 포함 (functions, core, web 등)
- `infra/` - 서비스별로 분할된 인프라 정의 (storage.ts, api.ts, web.ts)
- `sst.config.ts` - 동적 임포트가 있는 주요 SST 구성

## 코드 표준

- 엄격한 모드가 활성화된 TypeScript 사용
- 공유 코드는 `packages/core/`에 적절한 내보내기 구성과 함께 배치
- 함수는 `packages/functions/`에 배치
- 인프라는 `infra/`의 논리적 파일로 분할

## 모노레포 규칙

- 워크스페이스 이름을 사용하여 공유 모듈 임포트: `@my-app/core/example`

여기에 프로젝트별 지침을 추가하고 있으며 이는 팀 전체에서 공유됩니다.

유형

dropstone은 여러 위치에서 AGENTS.md 파일을 읽을 수도 있습니다. 이는 다양한 목적으로 사용됩니다.

프로젝트

프로젝트별 규칙을 위해 프로젝트 루트에 AGENTS.md를 배치합니다. 이는 이 디렉토리 또는 하위 디렉토리에서 작업할 때만 적용됩니다.

전역

~/.config/dropstone/AGENTS.md 파일에 전역 규칙을 포함할 수도 있습니다. 이는 모든 dropstone 세션에 적용됩니다.

이는 Git에 커밋되거나 팀과 공유되지 않으므로 LLM이 따라야 할 개인 규칙을 지정하는 데 사용하는 것을 권장합니다.

Claude Code 호환성

Claude Code에서 마이그레이션하는 사용자를 위해 Dropstone은 Claude Code의 파일 규칙을 폴백으로 읽습니다:

• 프로젝트 규칙: 프로젝트 디렉토리의 CLAUDE.md (AGENTS.md가 없는 경우 사용)
• 전역 규칙: ~/.claude/CLAUDE.md (~/.config/dropstone/AGENTS.md가 없는 경우 사용)
• 스킬: ~/.claude/skills/ (스킬 참조)

Dropstone이 Claude Code 위치를 읽지 않도록 하려면 해당 파일을 제거하거나 이름을 바꾸거나 (또는 동등한 내용을 AGENTS.md에 커밋하여 프로젝트가 우선순위를 갖도록 합니다).

우선순위

Dropstone이 시작될 때 다음 순서로 규칙 파일을 찾습니다:

1. 로컬 파일 - 현재 디렉토리에서 위로 순회 (AGENTS.md, CLAUDE.md)
2. 전역 파일 - ~/.config/dropstone/AGENTS.md
3. Claude Code 파일 - ~/.claude/CLAUDE.md (위의 두 파일이 없는 경우)

각 카테고리에서 첫 번째 일치 파일이 우선합니다. 예를 들어 AGENTS.md와 CLAUDE.md가 모두 있으면 AGENTS.md만 사용됩니다. 마찬가지로 ~/.config/dropstone/AGENTS.md는 ~/.claude/CLAUDE.md보다 우선합니다.

사용자 정의 지침

dropstone.json 또는 전역 ~/.config/dropstone/dropstone.json에서 사용자 정의 지침 파일을 지정할 수 있습니다. 이를 통해 AGENTS.md에 복제할 필요 없이 기존 규칙을 재사용할 수 있습니다.

예제:

{
  "$schema": "https://dropstone.io/schema/config.json",
  "instructions": ["CONTRIBUTING.md", "docs/guidelines.md", ".cursor/rules/*.md"]
}

원격 URL을 사용하여 웹에서 지침을 로드할 수도 있습니다.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "instructions": ["https://raw.githubusercontent.com/my-org/shared-rules/main/style.md"]
}

원격 지침은 5초 타임아웃으로 가져옵니다.

모든 지침 파일은 AGENTS.md 파일과 결합됩니다.

외부 파일 참조

dropstone은 AGENTS.md의 파일 참조를 자동으로 구문 분석하지 않지만 두 가지 방법으로 유사한 기능을 달성할 수 있습니다:

dropstone.json 사용

권장되는 방법은 dropstone.json의 instructions 필드를 사용하는 것입니다:

{
  "$schema": "https://dropstone.io/schema/config.json",
  "instructions": ["docs/development-standards.md", "test/testing-guidelines.md", "packages/*/AGENTS.md"]
}

AGENTS.md의 수동 지침

AGENTS.md에서 명시적 지침을 제공하여 dropstone이 외부 파일을 읽도록 가르칠 수 있습니다. 다음은 실용적인 예입니다:

# TypeScript 프로젝트 규칙

## 외부 파일 로딩

중요: 파일 참조 (예: @rules/general.md)를 만날 때 Read 도구를 사용하여 필요에 따라 로드합니다. 이들은 특정 작업과 관련이 있습니다.

지침:

- 모든 참조를 미리 로드하지 마세요 - 실제 필요에 따라 지연 로딩 사용
- 로드되면 기본값을 재정의하는 필수 지침으로 콘텐츠 취급
- 필요할 때 참조를 재귀적으로 따릅니다

## 개발 지침

TypeScript 코드 스타일 및 모범 사례: @docs/typescript-guidelines.md
React 컴포넌트 아키텍처 및 훅 패턴: @docs/react-patterns.md
REST API 설계 및 오류 처리: @docs/api-standards.md
테스트 전략 및 커버리지 요구사항: @test/testing-guidelines.md

## 일반 지침

모든 워크플로우와 관련이 있으므로 즉시 다음 파일을 읽습니다: @rules/general-guidelines.md.

이 방법을 사용하면 다음을 수행할 수 있습니다:

• 모듈식, 재사용 가능한 규칙 파일 생성
• 심볼릭 링크 또는 git 서브모듈을 통해 프로젝트 간 규칙 공유
• AGENTS.md를 간결하게 유지하면서 상세한 지침 참조
• dropstone이 특정 작업에 필요할 때만 파일을 로드하도록 보장