copilot-instructions
무엇인가
이 저장소는 GitHub Copilot과 유사 도구가 코드를 생성할 때 따를 규칙·절차·지식을 파일 묶음으로 배포한다. 규율 대상은 .NET 백엔드의 아키텍처 경계(DDD, Clean Architecture), CQRS 명령/쿼리 분리, Specification 패턴 기반 비즈니스 규칙, 단위·통합 테스트 전략, 커밋 규약, 문서 언어 정책이다.
어떻게 동작하나
구성은 계층별로 나뉜다. instructions/ 에는 파일 패턴별로 적용되는 .instructions.md 규칙이, skills/ 에는 SKILL.md와 번들 리소스를 포함한 자립형 능력이, agents/ 에는 .agent.md 커스텀 페르소나가, plugins/ 에는 관련 스킬·에이전트를 묶은 설치형 패키지가 들어간다. Copilot은 파일 패턴에 맞는 instructions를 자동 로드하고, TDD-first 워크플로는 copilot-instructions.md가, 후속 질문 강제 규칙은 코드 생성 전 확인 질문과 확신도 제시를 요구한다. Microsoft MCP 서버 연동으로 Microsoft 문서를 실시간 조회한다.
무엇과 다른가
매 작업마다 프롬프트를 직접 작성하는 방식과 달리, 규칙이 파일로 상주하며 패턴 매칭으로 자동 적용된다. 단일 CLAUDE.md·AGENTS.md 한 파일에 모두 넣는 방식과도 다르다. 규칙(instructions), 능력(skills), 페르소나(agents), 배포 단위(plugins)를 분리하고 awesome-copilot 구조와 관례를 따르며, collections/ 의 YAML은 APM(Agent Package Manager)이 소비하는 프리미티브 단위로 쓰인다.
어떻게 쓰나
사용은 저장소를 클론한 뒤 instructions/ 의 규칙을 확인하고 프로젝트에 복사하거나 Copilot 설정에 연결하는 순서다. plugins/csharp-clean-architecture-development/ 는 application-layer-testing, clean-architecture-dotnet 스킬을 묶은 C# 전용 패키지다. SKRAFT 플러그인은 /plugin marketplace add SebastienDegodez/skraft-plugin, /plugin install skraft로 설치하고 /skraft로 시작한다.
전제와 한계
전제는 규칙 파일을 읽는 AI 코딩 에이전트다. 본체는 Copilot을 겨냥하고, SKRAFT 파이프라인은 Claude Code·GitHub Copilot·Cursor를 지원한다. 내용은 .NET/C# 백엔드에 초점이 맞춰져 있어 다른 스택에는 그대로 적용되지 않는다. 규칙 파일은 에이전트가 읽어야 발동하며, 기계적 강제는 SKRAFT의 G1–G8 fail-closed 훅 범위에 한한다. README의 클론 URL은 플레이스홀더로 표기되어 있다.
유사 스킬
- agent-rules-books리팩터링·클린 아키텍처·DDD·DDIA 같은 고전 공학서의 설계 규칙을 SKILL.md로 주입해 에이전트의 추상화·의존성·일관성 판단을 규율하는 스킬 묶음이다.
- skills격리된 워크트리에서 시작해 서비스 계층으로 구현하고, 증거로 증명한 뒤 before/after 표와 Greptile 리뷰 루프로 마무리하는 4박자 워크플로를 SKILL.md 묶음으로 주입한다.
- nopua위협과 평가 압박 대신 신뢰를 전제로, 에이전트가 불확실성을 밝히고 완료 전 검증과 숨은 결함 탐색을 수행하도록 규칙을 주입하는 Claude Code용 프롬프트 팩이다.
- guard-skills코딩 에이전트가 만든 코드·테스트·문서를 커밋 전에 검토하는 가드 스킬 묶음이다. Skills CLI로 설치해 diff 단위로 적용한다.
- ECC에이전트에 계획→테스트→구현→리뷰→검증→기억→개선 절차와 훅·메모리·보안 스캔 규칙을 주입하는 Claude Code 플러그인형 스킬 팩이다.