나이트마켓 아키텍처 계약서

무엇을 해주나

이 스킬은 claude-night-market 저장소를 지탱하는 "아키텍처 계약"을 문서화합니다.

• 핵심 설계 결정 6가지: 플러그인은 독립 배포 단위여야 함(공용 라이브러리 금지), 훅은 호스트 Python 3.9 호환이어야 함, 버전은 marketplace.json 하나가 진실의 원천, 스킬 description은 160자 제한, 집단 기억은 GitHub Discussions, 스킬 역할 3종 분류.
• 불변식 표: 각 불변식이 무엇으로 강제되는지(CI 워크플로, 래칫 스크립트, 가드 테스트)와 어길 때 무엇이 깨지는지를 명시.
• 알려진 약점 5가지: 스킬 디스커버리 오버플로가 무음 실패라는 점, mdbook 버전 미고정, 문서 파일이 매 사이클 덮어써진다는 점 등.
• ADR 17건 요약표와 사실 재검증용 셸 명령 모음.

모든 주장에 ADR 번호, 커밋 해시, 강제 파일 경로가 인용되어 있어 그대로 검증할 수 있습니다.

이런 분께 추천

• claude-night-market 저장소에 기여하거나 포크해 운영하는 분
• 다중 플러그인 모노레포에서 "어디까지 공유하고 어디부터 복제할지"를 문서로 못 박고 싶은 분
• Claude Code 훅/스킬 생태계의 실패 사례에서 교훈을 얻고 싶은 분

활용 예시

1. 세 플러그인에 중복된 유틸을 루트 공용 모듈로 뽑으려 할 때 → 스킬이 ADR-0001과 되돌려진 커밋 054e2679/29961cd2를 근거로 거절 이유를 제시.
2. 새 Stop 훅을 추가할 때 → stdin JSON 페이로드 읽기, 상대경로 금지, 서브프로세스 타임아웃을 hooks.json 예산보다 작게 두기 등 5개 규칙을 체크.
3. 버전을 1.9.16으로 올릴 때 → 손으로 파일을 고치지 말고 update_versions.py를 쓰라고 안내하고 동기화 대상 매니페스트를 열거.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/athola/claude-night-market/HEAD/.claude/skills/night-market-architecture-contract/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 athola/claude-night-market 의 .claude/skills/night-market-architecture-contract 폴더를 내 ~/.claude/skills/night-market-architecture-contract/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.