KO
베타 번역
문서 / 게시하기

genpm.json 참조

완전한 소스 매니페스트 예시(저장소 루트의 genpm.json):

{
  "$": 1,
  "n": "@acme/billing",
  "v": "1.2.0",
  "s": { "en": "Stripe subscriptions with webhooks", "ko": "웹훅이 포함된 Stripe 구독" },
  "d": "src/lib/billing",
  "k": ["stripe", "billing", "subscriptions"],
  "g": { "@core/db": "^1.0.0" },
  "p": { "stripe": "^17.0.0" },
  "e": ["STRIPE_SECRET_KEY", "STRIPE_WEBHOOK_SECRET"],
  "m": [{ "n": "stripe", "c": "npx", "a": ["-y", "@stripe/mcp"], "e": ["STRIPE_SECRET_KEY"] }]
}

매니페스트가 토큰을 적게 쓰도록 키는 한 글자입니다. LLM에 매니페스트를 보여 주는 모든 곳에는 다음 범례가 함께 붙습니다.

genpm keys: n=name v=version s=summary r=repo t=git-ref c=commit-sha d=install-dir i=repo-subdir x=ai-rules-file l=license k=keywords g=genpm-deps p=npm-deps e=env-vars m=mcp-servers(n=name c=command a=args u=url e=env)
키 이름 필수 규칙
n 이름 예 @scope/name, 소문자.
v 버전 예 엄격한 SemVer. v 접두사와 빌드 메타데이터는 불가.
d 대상 예 사용자 프로젝트 안의 상대 POSIX 경로. ..와 절대 경로, .git/, node_modules/, .genpm/은 불가. 최대 8단계.
s 요약 권장 160자 이하, 한 줄. 문자열 또는 { "en": "…", "ko": "…" }(en 필수).
r 저장소 아니요 HTTPS Git URL. 기본값은 원격 origin.
t ref 아니요 태그 또는 40자리 16진수 SHA. 기본값은 v{v}. 브랜치는 불가.
i include 아니요 주입할 저장소 하위 디렉터리(기본값 .).
x 컨텍스트 아니요 i 기준 상대 경로의 AI 규칙 파일(기본값 AGENTS.md, 16 KB 이하).
l 라이선스 아니요 SPDX 표현식. GitHub가 감지한 라이선스가 우선합니다.
k 키워드 아니요 최대 10개, ^[a-z0-9-]{2,32}$.
g genpm 의존성 아니요 { "@core/db": "^1.0.0" }, 최대 10개. GenPM이 해석합니다.
p npm 의존성 아니요 사용자에게 제안만 하며, 동의 없이는 설치하지 않습니다.
e 환경 변수 아니요 변수 이름(^[A-Z][A-Z0-9_]{1,63}$). 값은 쓰지 않습니다.
m mcp 아니요 최대 5개 서버: "@stripe/mcp" 또는 { "n", "c", "a", "u", "e" }.
_* 확장 아니요 공식 도구는 무시합니다. 그 밖의 키는 오류입니다.

소스 매니페스트에는 c(자신의 커밋)를 넣으면 안 됩니다. 레지스트리가 해석할 때 r, t, c, i, x, l을 추가합니다.

.genpmignore(gitignore 문법, i 기준 상대 경로)로 파일을 제외하세요. .git/, .github/, node_modules/, genpm.json, .genpmignore, .env*는 항상 제외됩니다.

제한

항목 제한
패키지당 파일 수 2,000
패키지 크기 20 MB(설치 시 --max-size로 조정 가능)
단일 파일 1 MB
AI 규칙 파일 16 KB. 약 1,500토큰 권장, 4,000 초과 시 경고
경로 길이 / 깊이 200자 / 8단계
키워드 · genpm 의존성 · npm 의존성 · 환경 변수 · MCP 서버 10 · 10 · 30 · 30 · 5

genpm validate는 레지스트리와 같은 코드로 이 모든 것을 로컬에서 확인합니다.

JSON Schema: /schema/v1/genpm.json