문제: 템플릿 프로젝트를 비대화형(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 한 칸 말고 내용이 같았다.
91 lines
3.7 KiB
Bash
Executable File
91 lines
3.7 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
# template/을 새 프로젝트 폴더로 복사하고 이름을 바꾼다.
|
|
#
|
|
# scripts/new-project.sh <새 폴더> [--name <이름>] [--description "<한 문장>"] [--no-git]
|
|
#
|
|
# 1. 새 폴더가 없거나 비어 있는지 본다(아니면 멈춘다. 있는 프로젝트를 덮지 않는다).
|
|
# 2. template/을 숨김 파일까지 복사한다.
|
|
# 3. {{PROJECT_NAME}}·{{PROJECT_DESCRIPTION}}·{{HARNESS_GIT_URL}}을 바꾸고, 남은 {{…}}가 있으면 멈춘다.
|
|
# 4. git init -b main(--no-git이면 건너뛴다). 커밋은 하지 않는다.
|
|
# 하네스 마켓 주소는 $HARNESS_GIT_URL, 없으면 이 repo의 origin, 그것도 없으면 아래 기본값이다.
|
|
# 있는 프로젝트에 붙일 때는 이 스크립트 대신 README 「있는 프로젝트에 붙이기」를 따른다.
|
|
set -euo pipefail
|
|
|
|
HERE=$(cd "$(dirname "$0")/.." && pwd)
|
|
DEFAULT_URL=https://git.learn.hyeonworks.com/donghyeon.kang/claude-harness.git
|
|
|
|
usage() {
|
|
sed -n '2,11p' "$0" | sed 's/^# \{0,1\}//' >&2
|
|
exit 2
|
|
}
|
|
|
|
target="" name="" description="" git_init=1
|
|
while [ $# -gt 0 ]; do
|
|
case "$1" in
|
|
--name) name=${2:?--name 뒤에 이름}; shift 2 ;;
|
|
--description) description=${2:?--description 뒤에 한 문장}; shift 2 ;;
|
|
--no-git) git_init=0; shift ;;
|
|
-h | --help) usage ;;
|
|
-*) usage ;;
|
|
*) [ -z "$target" ] || usage; target=$1; shift ;;
|
|
esac
|
|
done
|
|
[ -n "$target" ] || usage
|
|
|
|
if [ -e "$target" ] && [ -n "$(ls -A "$target" 2>/dev/null)" ]; then
|
|
echo "new-project: $target가 비어 있지 않다. 있는 프로젝트를 덮지 않는다." >&2
|
|
exit 1
|
|
fi
|
|
mkdir -p "$target"
|
|
target=$(cd "$target" && pwd)
|
|
name=${name:-$(basename "$target")}
|
|
description=${description:-"(채울 것: 이 프로젝트가 무엇이고 누가 쓰는지 한 문장)"}
|
|
url=${HARNESS_GIT_URL:-$(git -C "$HERE" remote get-url origin 2>/dev/null || true)}
|
|
case "$url" in https://*) ;; *) url=$DEFAULT_URL ;; esac
|
|
|
|
cp -R "$HERE/template/." "$target/"
|
|
|
|
python3 - "$target" "$name" "$description" "$url" <<'EOF'
|
|
import os, sys
|
|
root, name, description, url = sys.argv[1:]
|
|
values = {"{{PROJECT_NAME}}": name, "{{PROJECT_DESCRIPTION}}": description, "{{HARNESS_GIT_URL}}": url}
|
|
left = []
|
|
for folder, _, files in os.walk(root):
|
|
if os.sep + ".git" in folder:
|
|
continue
|
|
for f in files:
|
|
path = os.path.join(folder, f)
|
|
try:
|
|
text = open(path, encoding="utf-8").read()
|
|
except UnicodeDecodeError:
|
|
continue
|
|
new = text
|
|
for key, value in values.items():
|
|
new = new.replace(key, value)
|
|
if new != text:
|
|
open(path, "w", encoding="utf-8").write(new)
|
|
if "{{" in new and "}}" in new:
|
|
left.append(os.path.relpath(path, root))
|
|
if left:
|
|
sys.exit("new-project: 바꾸지 못한 {{…}}가 남았다: " + ", ".join(sorted(left)))
|
|
EOF
|
|
|
|
chmod +x "$target/scripts/verify.sh"
|
|
if [ "$git_init" = 1 ] && [ ! -d "$target/.git" ]; then
|
|
git -C "$target" init -q -b main
|
|
fi
|
|
|
|
cat <<EOF
|
|
새 프로젝트를 만들었다: $target (이름 $name)
|
|
|
|
다음 할 일
|
|
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 -p)으로 쓰면 이 폴더에서 한 번 돌린다(설정 파일은 이미 맞다):
|
|
claude plugin marketplace add $url --scope project
|
|
claude plugin install harness@claude-harness --scope project
|
|
확인: scripts/verify.sh docs, claude plugin list
|
|
EOF
|