fix(template): 마켓 주소를 CLI가 쓰는 모양으로 두고 수동 설치 두 줄을 안내한다

문제: 템플릿 프로젝트를 비대화형(claude -p)으로 열면 .claude/settings.json에
적힌 마켓과 플러그인을 설치하지도 묻지도 않는다(2026-11-08 시험 프로젝트에서
확인). 또 claude plugin install --scope project가 settings.json을 다시 쓰면서
마켓 source의 "ref": "main"을 빼서, 템플릿과 설치 뒤 파일이 달라진다.

고른 방법: 템플릿의 마켓 source에서 ref를 뺀다(기본 브랜치 main과 같은 뜻).
new-project.sh 끝 안내와 README에 그 폴더에서 한 번 돌릴 두 줄
(marketplace add, install --scope project)을 적는다.
버린 대안: new-project.sh가 claude plugin을 직접 부르기. 스크립트가 사용자의
~/.claude/plugins 상태를 바꾸게 된다.

위험: 대화형 앱이 폴더를 믿을 때 설치를 묻는지는 공식 문서 설명이고 직접
보지 않았다(README에 그렇게 적음).

검증: scripts/check.sh 통과. 시험 프로젝트에서 두 줄을 돌린 뒤 claude plugin
list가 harness@claude-harness 0.1.0 project 범위 enabled를 보였고,
settings.json은 ref 한 칸 말고 내용이 같았다.
This commit is contained in:
DongHyeonka
2026-11-08 10:42:02 +09:00
parent 73da7065b0
commit e762248c4e
3 changed files with 9 additions and 5 deletions
+3 -1
View File
@@ -42,7 +42,9 @@ claude plugin marketplace add https://git.learn.hyeonworks.com/donghyeon.kang/cl
claude plugin install harness@claude-harness
```
새 세션부터 훅과 스킬이 돈다. 갱신은 `plugin.json`의 `version`이 오른 뒤 `claude plugin marketplace update claude-harness`와 `claude plugin update harness@claude-harness`다. 템플릿으로 만든 프로젝트는 `.claude/settings.json`이 마켓과 플러그인을 이미 적어 두어서, 그 폴더를 처음 열 때 Claude Code가 설치를 묻는다.
새 세션부터 훅과 스킬이 돈다. 공개 repo라 인증 없이 받는다. 갱신은 `plugin.json`의 `version`이 오른 뒤 `claude plugin marketplace update claude-harness`와 `claude plugin update harness@claude-harness`다.
템플릿으로 만든 프로젝트는 `.claude/settings.json`이 마켓과 플러그인을 이미 적어 둔다. 대화형 Claude Code는 그 폴더를 처음 믿을 때 설치를 묻는다(공식 문서의 설명이고, 이 repo에서 직접 보지는 않았다). 비대화형(`claude -p`)은 묻지도 설치하지도 않는다(2026-11-08 확인). 그때는 그 폴더에서 위 두 명령에 `--scope project`를 붙여 한 번 돌린다. 설정 파일 내용은 바뀌지 않는다.
## 새 프로젝트
+5 -2
View File
@@ -82,6 +82,9 @@ cat <<EOF
1. docs/vision.md를 소유자가 세 문장으로 쓴다(AI에게 맡기지 않는다).
2. docs/problem-statement.md와 AGENTS.md의 「(채울 것」 자리를 채운다. AGENTS.md는 40줄 이하로 둔다.
3. scripts/verify.sh의 run_unit·run_pr·run_app을 이 프로젝트의 명령으로 채운다.
4. 이 폴더에서 Claude Code를 처음 열면 하네스 마켓(claude-harness)과 플러그인을 믿을지 묻는다. 승인한다.
확인: scripts/verify.sh docs
4. 하네스 플러그인을 받는다. 대화형 Claude Code는 이 폴더를 처음 믿을 때 설치를 묻는다.
묻지 않거나 비대화형(claude -p)으로 쓰면 이 폴더에서 한 번 돌린다(설정 파일은 이미 맞다):
claude plugin marketplace add $url --scope project
claude plugin install harness@claude-harness --scope project
확인: scripts/verify.sh docs, claude plugin list
EOF
+1 -2
View File
@@ -15,8 +15,7 @@
"claude-harness": {
"source": {
"source": "git",
"url": "{{HARNESS_GIT_URL}}",
"ref": "main"
"url": "{{HARNESS_GIT_URL}}"
}
}
},