Files
messaging-library/AGENTS.md
T
DongHyeonka f593229fda chore(harness): claude-harness 뼈대를 깐다
템플릿에서 옮긴 메시징 이력 위에 새 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절
2026-11-08 16:01:45 +09:00

2.0 KiB

AGENTS.md — messaging-library의 정본

템플릿 밖에서 버전으로 배포하는 브로커 중립 메시징 라이브러리(dev.cakit.messaging) 방향은 docs/vision.md, 풀 문제와 하지 않을 것은 docs/problem-statement.md다.

꼭 지킬 것 — 하나라도 어기면 동작해도 완료가 아니다

  1. 관련 검증(아래 「검증」) 없이, 또는 돌리지 못한 이유를 밝히지 않고 완료를 말한다.
  2. 요청 범위 밖의 큰 리팩터링, 사용자 변경 되돌리기, 요청 없는 파괴적 명령을 한다.
  3. 비밀 값(.env, 키, 토큰)을 읽거나 커밋한다.
  4. (채울 것: 이 프로젝트의 아키텍처 불변식. 예: 도메인 계층이 프레임워크·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 규칙: (채울 것: 규칙 문서 경로)