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