빠른 결론
OpenCode 규칙: 빠른 결론
OpenCode 규칙은 세션에 지속적으로 적용되는 지침입니다. 저장소 규칙은 프로젝트에, 여러 저장소에서 같은 개인 습관은 전역에, URL 지침은 신뢰하고 검토한 출처에만 둡니다.
Similarweb의 `opencode rules`는 규칙 파일과 전역 및 프로젝트 규칙을 찾는 설정 의도를 보여 줍니다. 공식 문서는 rules, skills, agents, permissions, config를 구분하므로 이 가이드도 역할을 섞지 않습니다.
먼저 범위를 정한 뒤 읽기 전용으로 테스트하세요. 짧고 검증 가능한 규칙이 절차, 권한, 배포를 섞은 긴 지침보다 안전합니다.
관련 가이드: OpenCode 스킬 가이드, OpenCode 에이전트 가이드, OpenCode 권한 가이드, OpenCode 설정 가이드.
1. 가장 작은 범위 선택
프로젝트 규칙에는 테스트 명령, 생성 폴더, 담당 범위, 보안 경계를 둡니다. 전역 규칙은 개인 습관입니다. URL은 네트워크 경계이므로 도메인을 확인하고 중요한 보호 규칙은 로컬에도 남겨 두세요.
| 범위 | 용도 | 주요 위험 |
|---|---|---|
| 프로젝트 | 저장소 규칙 | 오래된 지침 |
| 전역 | 개인 습관 | 다른 프로젝트에 영향 |
| URL | 신뢰할 외부 문맥 | 검토 없는 변경 |
2. OpenCode가 규칙을 찾는 위치 확인
공식 Rules 문서는 초기화, 유형, 우선순위, 사용자 지정 지침, 외부 파일을 설명합니다. 설치한 버전의 초기화를 사용하고 다른 프레임워크의 경로를 추측하지 마세요.
3. 검토 가능한 우선순위 만들기
전역과 프로젝트 지침은 충돌할 수 있습니다. 작은 충돌 예를 만들고 현재 문서의 순서대로 무엇이 적용되는지 확인하세요. 프로젝트 보안 경계를 남기고 중복을 제거합니다.
4. 사용자 지정 지침을 짧은 계약으로 작성
좋은 규칙은 적용 시점, 해야 할 일, 피할 일, 완료 증거, 되돌리기 방법을 말합니다. 저장소 사실과 개인 취향을 분리하세요.
5. 외부 파일 신뢰성 확인
외부 파일은 검토 없이 바뀔 수 있습니다. 전송 방식, 소유자, 이력을 확인하고 낮은 위험의 문맥부터 사용하세요. 비밀과 배포는 로컬에 둡니다.
6. rules와 skills·agents·permissions·config 분리
Rules는 지속 제약, skills는 절차, agents는 역할과 도구, permissions는 allow/ask/deny, config는 설정입니다. 자동 릴리스를 규칙 속에 숨기지 마세요.
7. 실제 편집 전 유효 규칙 검증
버릴 수 있는 브랜치에서 설명, 읽기, 작은 변경, diff 검사를 실행하세요. rollback을 기록하고 규칙을 제거한 뒤 같은 작업을 반복합니다.
OpenCode 규칙에 대한 자주 묻는 질문
OpenCode 규칙이란 무엇인가요?
프로젝트, 전역, 신뢰할 수 있는 외부 범위에 적용되는 지속 지침입니다.
프로젝트 규칙은 어디에 두나요?
Rules 문서나 초기화에서 설치 버전의 경로를 확인하고 저장소 안에서 검토하세요.
Rules와 skills의 차이는 무엇인가요?
Rules는 제약을, skills는 단계와 예제가 있는 재사용 절차를 정의합니다.
전역 규칙이 프로젝트 규칙을 덮나요?
유형과 문서화된 우선순위에 따릅니다. 작은 충돌 예로 확인하세요.
URL 규칙은 안전한가요?
신뢰하고 검토한 출처일 때만 안전합니다. 핵심 규칙은 로컬에도 보관하세요.
공식 출처
Rules, Config, Permissions, Skills, Agents 문서를 2026년 10월 31일에 확인했습니다. 실제 문법은 사용 중인 버전의 공식 페이지에서 확인하세요.