릴리스 및 게시 워크플로우
공개 저장소 메타데이터
- 공개 저장소의 경우, 에이전트는 GitHub 설명(Description), 토픽(Topics), 홈페이지(Homepage) 필드를 설정해야 합니다.
- 공개 저장소에는 다음이 포함되어야 합니다:
.github/workflows/ci.yml, 이슈 템플릿, PR 템플릿,SECURITY.md,CONTRIBUTING.md,CODE_OF_CONDUCT.md,CHANGELOG.md. - CI는 저장소의 표준 린트(lint), 테스트, 빌드 명령을 실행해야 합니다.
버저닝 및 릴리스 흐름
- 에이전트는 릴리스 내용이 변경될 때 버전 메타데이터를 업데이트해야 하며, 패키지 버전과 Git 태그가 일관되도록 유지해야 합니다.
- 버전 선택을 요청받으면, 에이전트는 스스로 결정해야 합니다.
- 버전을 올릴 때, 에이전트는 동일한 업데이트에서 GitHub 릴리스를 생성하고 패키지를 게시해야 합니다.
- metyatech 소유 패키지의 npm 게시의 경우, 에이전트는 직접
npm publish를 실행해야 합니다. 자동화 토큰이 구성되어 있습니다. - 다른 패키지의 경우, 에이전트는 사용자에게
npm publish를 실행하도록 요청해야 합니다. - 게시 전에, 에이전트는 필수 준비 명령(
npm install,npm test,npm pack --dry-run등)을 실행해야 하며, 준비가 완료된 경우에만 진행해야 합니다. - 게시 중 인증에 실패하면, 에이전트는 사용자에게 게시 단계를 완료하도록 요청해야 합니다.
- 에이전트는 릴리스 전에 종속성 보안 검사를 실행해야 하며, 심각한 문제를 해결하고 결과를 보고해야 합니다.
게시 후 검증
게시 후, 에이전트는 로컬에 설치된 복사본을 새로 게시된 릴리스로 업데이트하고, 확인된 버전을 검증해야 합니다. 이 검증이 완료되거나 사용자가 명시적으로 거부할 때까지 에이전트는 "완료"되었다고 보고해서는 안 됩니다.
에이전트는 검증을 명시적인 수용 기준과 결과(PASS / FAIL / N/A) 및 증거로 표현해야 합니다:
- AC1 (레지스트리) — 게시된 버전이 레지스트리에 존재하는지 확인합니다 (예:
npm view <pkg> version). - AC2 (신규 설치) — 최신 패키지가 제대로 해석되고 실행되는지 확인합니다 (예:
npx <pkg>@latest --version). - AC3 (전역 업데이트, 해당되는 경우) — 패키지가 전역에 설치된 경우, 게시된 버전으로 업데이트하고 확인합니다 (예:
npm ls -g <pkg> --depth=0,npm i -g <pkg>@latest, 그 다음<cmd> --version). AC3가 적용되지 않는 경우, 에이전트는 N/A로 표시하고 그 이유를 명시적으로 밝혀야 합니다.
npm CLI의 경우:
- 전역에 설치된 경우:
npm ls -g <pkg> --depth=0확인,npm i -g <pkg>@latest로 업데이트, 그 다음<pkg> --version으로 확인. - 전역에 설치되지 않은 경우: 전역 업데이트를 건너뛰고
npx <pkg>@latest --version(또는 생태계에 맞는 방식)으로 가용성을 확인합니다.
표준 저장소 토픽
에이전트는 아래 표준 세트에서 토픽을 할당해야 합니다. 적용 가능한 경우 모든 저장소에는 최소한 하나의 표준 토픽이 있어야 합니다. 어떤 표준 토픽에도 해당하지 않는 저장소는 해당 도메인과 관련된 설명 토픽을 사용해야 합니다.
agent-skill— 저장소에SKILL.md가 포함됨 (설치 가능한 에이전트 스킬).agent-tool— 에이전트가 사용하는 CLI 도구 또는 MCP 서버 (예: task-tracker, agents-mcp, compose-agentsmd).agent-rule— 규칙 소스 또는 규칙 집합 저장소 (예: agent-rules).unreal-engine— Unreal Engine 플러그인 또는 샘플 프로젝트.qti— QTI 평가 생태계 도구 또는 라이브러리.education— 강의 콘텐츠, 교육 자료 또는 학생 대상 플랫폼.docusaurus— Docusaurus 플러그인 또는 확장.
추가 설명 토픽 (언어, 프레임워크, 도메인 키워드)은 표준 토픽과 함께 자유롭게 추가할 수 있습니다. 저장소 환경이 실질적으로 변경될 때 에이전트는 표준 토픽 집합을 검토하고 업데이트해야 합니다. 에이전트는 새 저장소 규정 준수 게이트의 일부로 토픽이 설정되었는지 확인해야 합니다.
게시된 아티팩트 요구 사항
- 에이전트는 패키지 메타데이터(이름, 설명, 저장소, 이슈, 홈페이지, 엔진)를 채워야 합니다.
- 에이전트는 실행 가능한 진입점과 필요한 셔뱅(shebangs)을 검증하여 설치된 명령이 작동하도록 해야 합니다.
- 저장소가 단일 도구나 제품을 나타내는 경우, 에이전트는 단일 패키지를 게시해야 합니다 (관련 스크립트를 번들링).