Files
claude-harness/template/docs/adr/0000-template.md
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

36 lines
1.2 KiB
Markdown

<!-- 머리 블록: 이 블록을 빼면 원문이다. 새 결정 기록은 이 파일을 복사해 NNNN-<짧은-이름>.md로 만든다 -->
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
- 상태: 제안
- 작성일: YYYY-MM-DD
- 요약: 무엇을 정했는지 한국어 한 문장
- 현재 정본: 지금 동작을 설명하는 살아 있는 문서의 경로. 없으면 「없음 — 이유」
<!-- 머리 블록 끝 -->
# NNNN. (결정 제목: 무엇을 정했나)
## 맥락
무엇이 문제였고, 무엇이 결정을 강요했나. 숫자와 사건으로 쓴다.
## 결정
정한 것을 한두 문장으로. 누가 정했는지(소유자·팀·에이전트 판단)를 밝힌다.
## 고른 이유와 버린 대안
| 안 | 장점 | 단점 | 고름 |
|---|---|---|---|
| A | | | 예 |
| B | | | 아니요 — 이유 |
## 결과
- 좋아지는 것:
- 치르는 값:
- 다시 볼 때: (어떤 숫자나 사건이 생기면 이 결정을 다시 보나)
## 틀렸다면 어디서 드러나나
이 결정의 가정이 틀렸다면 무엇을 보면 알 수 있나. 잴 수 있게 쓴다.