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

무엇을 해주나

• claude-night-market 저장소를 지탱하는 6가지 "하중을 받는 설계 결정"을 ADR 번호와 커밋 해시로 근거를 붙여 제시합니다(플러그인 자립성, 훅의 Python 3.9 제약, 단일 버전 팬아웃, 스킬 디스커버리 예산, 외부 서비스 기반 집단 기억, 스킬 역할 분류).
• 각 불변식을 "무엇이 강제하는가 / 위반하면 무엇이 깨지는가" 표로 정리해, 검사 스크립트·CI 워크플로·가드 테스트 경로를 바로 찾을 수 있게 합니다.
• 이미 알려진 6가지 취약점(스킬 디스커버리 오버플로가 조용히 발생, mdbook 미고정, Stop 훅 재주입 의존 등)을 숨기지 않고 명시합니다.
• 23개 ADR 요약표와 "이 스킬 대신 써야 할 다른 스킬" 표, 그리고 사실 재검증용 rg/git/python3 명령 모음을 제공합니다.

이런 분께 추천

• claude-night-market 저장소에 기여하거나 포크해 운영하는 분.
• 다수 플러그인/스킬로 이루어진 대형 Claude Code 저장소의 설계 규칙 문서화 방식을 배우고 싶은 분.
• 아키텍처 결정 기록(ADR)과 CI 강제 장치를 연결하는 실전 예시를 찾는 테크 리드.

활용 예시

1. "세 플러그인에 중복된 tasks_manager.py를 공통 모듈로 빼자"는 제안이 올라왔을 때 → 이 스킬이 ADR-0001과 커밋 054e2679(도입) → 29961cd2(되돌림) → d89a55c7(플러그인별 사본 확정) 이력을 근거로 재제안을 차단합니다.

• 새 훅을 추가하기 전에 → 표준 입력(stdin) JSON으로 페이로드를 읽고, 상대 경로를 쓰지 않고, hooks.json 예산보다 짧은 서브프로세스 타임아웃을 두는 규칙을 확인합니다.
• 버전을 올릴 때 → 매니페스트를 손으로 고치지 않고 uv run python plugins/sanctum/scripts/update_versions.py <version>을 쓰도록 안내합니다.
• 새 스킬의 description을 쓸 때 → 160자 상한과 검증 훅 존재를 확인하고, 이름 반복 대신 트리거 문구에 글자 수를 쓰도록 합니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
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/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.