GitHub Copilot 인스트럭션 생성기
.github/copilot-instructions.md를 스택 기반으로 자동 생성해 Copilot이 저장소 컨텍스트를 정확히 이해하게 하세요.
GitHub Copilot은 .github/copilot-instructions.md를 자동으로 인식하여 코드 제안에 반영합니다. 6대 핵심 섹션과 Boundaries 3-tier로 구조화된 인스트럭션을 작성합니다.
주요 특징
공식 위치
.github/copilot-instructions.md 표준 경로 자동 적용
구조화된 섹션
Commands, Testing, Code Style, Git Workflow, Boundaries 자동 구성
Boundaries 3-tier
Always do / Ask first / Never do로 명확한 경계 정의
팀 컨벤션 반영
Additional Notes로 팀 고유 규칙을 자유롭게 추가
생성되는 파일 예시
# Repository Custom Instructions
These instructions guide GitHub Copilot for this repository.
## Code Style
- Never use the `any` type in TypeScript. Prefer `unknown` with type narrowing.
- Use named exports for React components, not default exports.
## Testing
- All tests must pass locally before opening a pull request.
- Every new feature or bug fix must include corresponding tests.
## Boundaries
### ⚠️ Ask first
- Ask before adding any new npm dependency.
자주 묻는 질문
-
Copilot 인스트럭션 파일은 어디에 두어야 하나요?
.github/copilot-instructions.md 한 위치가 GitHub 공식 표준 경로입니다. 저장소 루트의 .github 디렉토리에 두면 GitHub Copilot이 자동으로 인식해 코드 제안에 반영합니다. -
이 파일을 인식하려면 별도 설정이 필요한가요?
기본적으로 별도 설정 없이 인식됩니다. 단, 조직 정책에 따라 'Use Instructions Files' 설정이 비활성화돼 있을 수 있으니 GitHub Copilot 설정에서 인스트럭션 파일 사용이 켜져 있는지 확인하세요. -
Path-specific instructions(.github/instructions/*.instructions.md)와는 어떻게 다른가요?
copilot-instructions.md는 저장소 전체에 적용되는 기본 인스트럭션이고, .github/instructions/*.instructions.md는 frontmatter의 applyTo glob 패턴으로 특정 파일에만 적용되는 세분화된 규칙입니다. ConfigDeck은 Phase A에서 단일 파일 형식을 출력하며, path-specific 분리는 Phase B에서 지원할 예정입니다. -
Boundaries 3-tier는 왜 필요한가요?
AI가 항상 해야 할 것 / 먼저 물어볼 것 / 절대 하지 말 것을 명시적으로 분리하면, 같은 의도를 자유 텍스트로 적었을 때보다 Copilot의 행동이 일관됩니다. 특히 보안/배포 관련 'Never do' 항목은 사고를 줄이는 데 효과적입니다. -
팀 고유 규칙은 어디에 추가하나요?
ConfigDeck의 Additional Notes 입력란에 자연어로 추가한 내용은 출력 파일 하단에 그대로 삽입됩니다. 팀 컨벤션, 도메인 용어, 자주 쓰는 라이브러리 사용 패턴 등 카탈로그에 없는 규칙을 보완할 때 사용합니다.