2.7 KiB
2.7 KiB
협업 규칙
코드 & 분석
- 주석과 변수명, 함수명을 맹신하지 말기
- 수정은 무조건 승인받기
- 코드 수정 시 한글이 안 깨지도록 수정할 것
문서화
.md파일의 내용은 200줄 이상 넘지 않도록 작성- CLAUDE.md에는 주제별
.md를@경로로 임포트해 라이브러리처럼 사용 (@import 경로는 Claude Code 문법이 아니며 조용히 실패한다) - 작업을 완료할 시
.md에 필요한 부분이라고 생각되면 물어보고.md파일 갱신하기
커뮤니케이션
- 대답은 한국어로 간결하게 해주고 내가 상세히 설명해달라고 할 때 자세한 내용을 알려주기
- 질문에 대해 궁금한 사항이나 알아둬야 정확하게 해결할 수 있는 문제가 있으면 나에게 물어보기
- 모르는 문제가 있으면 말을 지어내지말고 모른다고 말하기
- 10분 이상 걸리는 작업은 중간에 어떤 부분을 하고 있는지 명시
출력 형식
- 출력 문구 중에 수정할 내역의 줄은 초록 화살표(→)로 표시
- 줄이 아닌 단어라면 주황색으로 표시
- 기존 수정안하는 부분은 기본 색상(흰색)으로 표시
규칙 관리
- 이 규칙들은 rules.md로 하여 CLAUDE.md에 import할 것
검증·표기
- 추론한 내용은 코드로 검증한 뒤 보고하기 — 확인된 사실과 섞어 단정하지 말 것
- 검증이 불가능하거나 검증 전에 보고할 때는 해당 문장 앞에
[추론]을 붙일 것
표기는 아래 축으로 구분한다. [추론]은 나머지를 대체하지 않으며, 필요하면 병기한다
(예: [추론] 런타임 산출로 보이며 현재 미측정이다).
| 상황 | 표기 |
|---|---|
| 코드·실행으로 확인함 | 파일:라인 근거 병기 (표기어 없음) |
| 확인을 시도했으나 값이 없음·측정 못 함 | 미측정 · 불명확 — 확인 필요 · 미검증 · 미확인 |
| 확인 전에 말해야 함 · 검증이 불가능함 | 문장 앞 [추론] (구 (추정) 표기를 대체한다) |
| 진실원 자체가 없음 | (제안) · 미정 — 확인 필요 |
검색 시
\[추론\]로 이스케이프한다. 대괄호는 정규식 문자클래스라[추론]으로 찾으면추·론한 글자만 있어도 걸려 무관한 줄까지 잡힌다(실측 확인).
조항 번호는
rules.md #N형태로 하네스 전반에서 인용된다. 기존 번호를 바꾸지 말고 신규 조항은 뒤에 덧붙인다. 조항을 추가했으면 하네스 바인딩도 함께 갱신한다 — 역인덱스는docs/harness-ptop.md의 "규칙 ↔ 바인딩" 표를 본다.