Files
claude-harness/scripts/new-project.sh
T
DongHyeonka 73da7065b0 feat(template): 새 프로젝트 뼈대와 new-project.sh를 더한다
문제: 새 프로젝트마다 루트 지침, Claude Code 설정, 검증 진입점, 비전·
문제 정의 양식, 장부를 손으로 다시 만든다. 플러그인으로는 루트 문서와
권한 deny를 나눠 줄 수 없다(플러그인 CLAUDE.md·권한은 읽히지 않는다).

고른 방법: 공통 동작은 플러그인, 프로젝트 파일은 template/ 복사로
나눈다(결정 Q15). scripts/new-project.sh가 template/을 빈 폴더에 복사하고
이름·설명·마켓 주소를 바꾼 뒤 git init까지 한다. 커밋은 하지 않는다.
- AGENTS.md 양식(40줄 이하, 결정 Q2)과 CLAUDE.md(@AGENTS.md)
- .claude/settings.json: .env deny, 마켓과 harness 플러그인 켜기.
  Agent deny는 넣지 않는다(결정 Q5)
- scripts/verify.sh: 단계(docs·unit·pr·app) 뼈대와 --on <호스트> 운반부.
  작업 트리를 패치로 옮겨 기준 커밋의 새 worktree에 적용하고 트리 해시를
  맞춘 뒤 잠금 아래에서 돌린다. push하지 않는다(설계 6.1절)
- 빈 양식: docs/vision.md, docs/problem-statement.md, docs/adr/0000-template.md
- docs/ledger/: 빈 장부와 형식 설명, .gitattributes merge=union(결정 Q11)
repo 자신의 AGENTS.md·README·docs/README.md(설계와 다르게 정한 것)와
scripts/check.sh도 같이 둔다.
버린 대안: 템플릿만(공통 훅 수정이 모든 repo 손작업), 플러그인만(루트
문서·deny를 못 준다).

위험: verify.sh의 원격 운반부는 가짜 ssh(같은 기계)로만 시험했다. 실제
desktop에서는 아직 돌리지 않았다. unit·pr·app 단계 본문은 비어 있다
(종료 코드 3).

검증: scripts/check.sh 통과(플러그인 17, 템플릿 10, validate --strict).
템플릿 시험은 이름 바꾸기, 남은 {{…}} 없음, AGENTS.md 40줄 이하,
settings의 플러그인·deny, 빈 폴더가 아니면 멈춤, verify docs, 가짜 ssh로
패치 적용·트리 해시·worktree 정리와 원격 실패(종료 코드 4)를 본다.
scratchpad에 만든 시험 프로젝트에서 같은 것을 손으로 확인했다.
2026-11-08 00:02:33 +09:00

88 lines
3.5 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-harness)과 플러그인을 믿을지 묻는다. 승인한다.
확인: scripts/verify.sh docs
EOF