템플릿에서 옮긴 메시징 이력 위에 새 repo의 작업 환경을 먼저 깐다.
claude-harness main 72078ca의 scripts/new-project.sh가 만든 파일을
그대로 복사했다: AGENTS.md·CLAUDE.md 양식, .claude/settings.json
(.env deny, 하네스 플러그인 harness@claude-harness 켜기),
scripts/verify.sh 뼈대, docs/vision.md·problem-statement.md·
adr/0000-template.md 양식, docs/ledger/ 빈 장부, .gitattributes,
.gitignore.
채울 자리(「(채울 것」)는 뒤 커밋에서 이 repo의 내용으로 채운다.
이 커밋 자체는 아직 빌드되지 않는다(Gradle 루트가 없다).
검증: new-project.sh 종료 코드 0, 남은 {{…}} 없음.
Refs: design-docs repo-structure/05-library-repos.md 14.2절
2.0 KiB
2.0 KiB
AGENTS.md — messaging-library의 정본
템플릿 밖에서 버전으로 배포하는 브로커 중립 메시징 라이브러리(dev.cakit.messaging) 방향은 docs/vision.md, 풀 문제와 하지 않을 것은 docs/problem-statement.md다.
꼭 지킬 것 — 하나라도 어기면 동작해도 완료가 아니다
- 관련 검증(아래 「검증」) 없이, 또는 돌리지 못한 이유를 밝히지 않고 완료를 말한다.
- 요청 범위 밖의 큰 리팩터링, 사용자 변경 되돌리기, 요청 없는 파괴적 명령을 한다.
- 비밀 값(
.env, 키, 토큰)을 읽거나 커밋한다. - (채울 것: 이 프로젝트의 아키텍처 불변식. 예: 도메인 계층이 프레임워크·DB를 import한다)
지도
- (채울 것: 최상위 폴더 → 하는 일. 개수·버전 숫자는 적지 않는다. 정본이 따로 있으면 그 파일을 가리킨다)
- 폴더마다의 규칙은 그 폴더의
AGENTS.md다. 작업 파일과 가장 가까운 것을 따른다. - 결정 기록은
docs/adr/(양식0000-template.md), 예측·실측 장부는docs/ledger/다.
맡은 일
- (채울 것: 일의 종류 → 먼저 읽을 문서. 예: 새 기능 →
docs/…) - brief가 있으면 brief의 범위·크기·완료 기준이 먼저다.
검증
- 진입점은 하나다:
scripts/verify.sh <단계>(docs · unit · pr · app). 사람·CI·에이전트가 같은 명령을 쓴다. - 무거운 실행을 다른 기계에서 돌릴 때는
scripts/verify.sh <단계> --on <호스트>(지금 작업 트리를 패치로 옮긴다).
헷갈리는 곳
- (채울 것: 코드만 보고는 알 수 없는 것. 없으면 이 절을 지운다)
일하는 방식
- 착수할 때 예측을, 끝날 때 실측을 장부에 남긴다(Claude Code는
estimate스킬). - 파일을 바꾸는 위임은 사람이 열어 보고 멈출 수 있는 하위 세션에, 결과만 받는 일(검색·구조 리뷰·실행 검증)은 서브에이전트에 맡긴다.
- 커밋 메시지·PR 규칙: (채울 것: 규칙 문서 경로)