Skip to content

GitHub 에이전트용 공통 지침 연결 및 AGENTS.md 추가 #67

Closed

Description

@yong5eon

배경

GitHub에서 할당된 에이전트는 이슈가 속한 저장소를 작업 대상으로 삼으므로, 로컬 작업 환경의 외부 링크나 Instructions 저장소를 자동으로 읽는다고 가정할 수 없습니다. 공통 작업 지침과 이 저장소별 지침이 에이전트에 실제 전달되도록 해야 합니다.

목표

DefStream 저장소에 Codex와 Copilot의 GitHub 에이전트가 공통 지침을 읽고 적용할 수 있는 루트 AGENTS.md와 저장소 내 공통 지침 사본을 제공합니다. 원본은 yong5eon/Instructions이며 GIT.COMMIT.MESSAGE.instructions.md는 제외합니다. 기존 프로젝트별 instructions/ 지침도 함께 적용합니다.

요구사항

  • 루트 AGENTS.md에서 작업 시작 전 공통 지침과 프로젝트별 지침을 확인하고, 요청 범위·권한·이슈 절차·작업 근거 기록·검증 원칙을 따르도록 안내합니다.
  • GitHub 에이전트가 외부 로컬 링크나 외부 저장소 clone에 의존하지 않도록 공통 지침 원문을 저장소 내 추적되는 위치에 둡니다.
  • 공통 지침은 원본과 구분 가능하게 보관하며, 커밋 메시지 전용 지침은 포함하지 않습니다.
  • 프로젝트별 지침의 범위와 예외를 보존하고 공통 지침과 충돌하는 경우 임의로 우선순위를 정하지 않도록 합니다.
  • 이슈 작업의 PR 준비 전 issues/{branch}/CHANGELOG.md가 존재하고 비어 있지 않은지 확인합니다. 문서·내부 변경으로 고객 영향이 없으면 해당 지침에 맞춰 이를 명시합니다. CI의 changelog 요구를 확인하고 빠뜨리지 않습니다.
  • 이슈와 브랜치, 기록 경로는 저장소의 기존 절차에 따르며 기존 파일이나 로컬 지침 링크를 덮어쓰지 않습니다.

완료 기준

  • 에이전트가 루트 AGENTS.md에서 필요한 지침 파일을 찾고 읽을 수 있습니다.
  • 안내된 모든 공통 지침 파일과 프로젝트별 지침의 경로가 저장소 내 실제 파일과 일치합니다.
  • CHANGELOG.md 필수 여부·위치를 PR 전에 검증하도록 안내되어 있고, 이 저장소 CI와 일치합니다.
  • 기존 기능 코드에는 불필요한 변경을 하지 않습니다.

Metadata

Metadata

Assignees

Labels

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions