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:
@@ -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`를 붙여 한 번 돌린다. 설정 파일 내용은 바뀌지 않는다.
|
||||
|
||||
## 새 프로젝트
|
||||
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -15,8 +15,7 @@
|
||||
"claude-harness": {
|
||||
"source": {
|
||||
"source": "git",
|
||||
"url": "{{HARNESS_GIT_URL}}",
|
||||
"ref": "main"
|
||||
"url": "{{HARNESS_GIT_URL}}"
|
||||
}
|
||||
}
|
||||
},
|
||||
|
||||
Reference in New Issue
Block a user