퍼블리싱 가이드
하네스를 패키징하고, 검증하고, anpm 레지스트리에 퍼블리시하여 다른 사람들이 한 명령어로 설치할 수 있게 하는 방법.
이 가이드는 완성된 하네스에서 라이브 레지스트리 항목까지의 전체 퍼블리시 워크플로우를 안내합니다.
0 개요
anpm에 퍼블리싱하면 레지스트리에 버전별, 불변 항목이 생성됩니다. 각 퍼블리시는 매니페스트의 버전을 올리고 모든 하네스 파일을 업로드합니다. 설치하는 사람은 항상 요청한 정확한 버전을 받습니다.
Harnesses follow Anthropic's .claude standard. Managed agent deployment is also supported.
Full flow to publish:
- 1Install anpm CLI and log in
- 2Create harness directory structure
- 3Write
anpm.yamlmanifest - 4Test locally
- 5Publish with
anpm publish
1 사전 요구 사항
Before you start, make sure you have:
- ✓anpm CLI 설치됨 (npm i -g anpm)
- ✓anpm login을 통해 인증됨
- ✓하네스 루트에 유효한 anpm.yaml 매니페스트
- ✓필수 필드 존재 (name, version, description)
2 하네스 구조
anpm은 에이전트, 스킬, 룰, 명령어를 Claude Code에 자동으로 연결할 수 있도록 특정 폴더 레이아웃을 필요로 합니다.
Required Files
| File | Description |
|---|---|
anpm.yaml | Harness metadata, dependencies, and publish config |
skills/ | At least one skill file required |
README.md | Usage documentation (shown on the anpm registry page) |
3 매니페스트 참조
anpm.yaml 파일은 레지스트리에 하네스를 설명합니다. 필수 필드는 name, version, description입니다. 선택적 필드로는 keywords, homepage, license, access가 있습니다.
4 로컬 테스트
퍼블리싱 전에 하네스를 로컬에 설치하고 Claude Code에서 실행하여 모든 것이 예상대로 작동하는지 확인하세요.
Use anpm link to symlink your harness locally, then anpm run to test it in a live agent session before publishing.
5 퍼블리시
준비가 되면 하네스 루트에서 anpm publish를 실행하세요. CLI가 매니페스트를 검증하고, 파일을 번들링하고, 레지스트리에 업로드합니다.
Version Updates
After making changes, bump the version and republish in one step:
6 가시성
하네스를 찾고 설치할 수 있는 사람을 제어하세요.
| Visibility | Description | Use Case |
|---|---|---|
public | anpm 레지스트리에 등록되어 누구나 설치 가능합니다. | Open-source agents |
private | 공개적으로 등록되지 않습니다. 접근 코드가 있어야만 설치 가능합니다. | Paid or limited distribution |
internal | 조직 구성원에게만 표시됩니다. | Internal team agents |
비공개 harnesses require an access code at install time.anpm install my-harness --code ABC123
7 퍼블리싱 가이드라인
Public harnesses go through automated review. Your harness must meet these criteria:
- ✓시크릿이나 자격 증명이 포함된 하네스를 퍼블리시하지 마세요.
- ✓시맨틱 버전 관리(MAJOR.MINOR.PATCH)를 사용하세요.
- ✓사용자가 하네스가 무엇을 하는지 알 수 있도록 명확한 설명을 포함하세요.
- ✓퍼블리시 전에 하네스를 로컬에서 테스트하세요.
- ✓하네스는 단일 워크플로우 또는 작업에 집중하세요.
Reviews are automated and usually complete within minutes. If rejected, you'll receive specific feedback explaining what needs to be fixed.