문제: 새 프로젝트마다 루트 지침, 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에 만든 시험 프로젝트에서 같은 것을 손으로 확인했다.
88 lines
3.5 KiB
Bash
Executable File
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
|