agent-company: Instructions file for Claude Code

CLAUDE.md

Claude Code 가 이 저장소에서 작업할 때 따르는 지침입니다.

세션 시작 시 SessionStart 훅이 scripts/load-context.sh 를 실행해 코어 하드 룰, 현재 템플릿, wiki 인덱스, 메모리를 자동으로 주입합니다. 이 문서는 그 위에 얹히는 행동 규칙입니다.

---

프로젝트

Agent Company — AI 팀이 굴리는 모노레포 템플릿. 두 층입니다.

── 코어 (항상 있음) ──────────────────────────────
.claude/          훅(SessionStart · PreToolUse) · 슬래시 커맨드
wiki/             프로젝트 지식 + 장/단기 메모리 + ADR
agents/           로스터 (registry.yaml + <id>/AGENT.md + skills/)
scripts/          결정적 셸 스크립트
templates/        고를 수 있는 회사들

── 템플릿 (골라서 펼침) ──────────────────────────
templates/<id>/template.yaml   매니페스트 (스크립트 · 검사 · 하드 룰 · 다음 단계)
templates/<id>/files/          레포 루트 기준 경로 그대로 (apps/ · packages/ · agents/ …)

코어는 어느 회사에서나 같습니다. 무엇을 만들고 누구를 뽑는지는 템플릿이 정합니다. 전체 구조는 wiki/01-architecture.md.

작업을 시작하기 전에 현재 회사가 무엇인지 확인하세요.

pnpm template current

---

코어 하드 룰

위반하면 작업을 중단하고 사용자에게 보고하세요. 우회로를 찾지 마세요. 템플릿과 무관하게 항상 참이고, 바꾸려면 wiki/decisions/ 에 ADR 을 먼저 써야 합니다.

1. 이미지 생성 경로는 하나다

당신은 이미지를 생성하지 않습니다. 예외 없습니다.

정책은 코어이고 실행 명령은 템플릿이 줍니다 (blog 는 pnpm imagegen). 템플릿에 이미지 명령이 없으면 이미지 없이 진행하는 것이 정답입니다.

pnpm imagegen --slug <slug> --prompt "<장면 설명>"    # blog

금지되는 것:

• 당신이 이미지를 직접 생성 · 합성하는 것
• 다른 이미지 생성 모델/API 호출 (DALL·E, Stable Diffusion, Imagen, Midjourney 등)
• SVG 를 코드로 그려 이미지를 대신하는 것
• 실제 Codex 생성이 아닌 이미지에 source: codex-imagegen 표기

Codex 를 쓸 수 없으면 이 순서로 폴백합니다:

1. 이미지 없이 진행 (기본값 — 커버는 출고 필수 요소가 아님)
2. 사용자에게 직접 첨부 요청 (source: user-upload)
3. 웹 검색 — 라이선스 확인 필수 (source: web-search + license 기록)

강제 수단: ImageSource 타입에 claude 가 없음 · PreToolUse 훅 차단 · 감사 error. 근거: wiki/decisions/ADR-0002-codex-only-image-generation.md

업로드는 생성이 아닙니다. 사람이 첨부한 이미지는 이 룰과 무관합니다. 금지되는 것은 생성입니다.

2. 출고는 사람만

status 를 published 로 바꾸지 않습니다. 에이전트는 in_review 까지만 올립니다. 출고는 사용자가 검수 화면에서 수행하는 행위입니다.

3. 진실은 저장소 파일

결과물도 결정도 코드와 같은 저장소에서 버전 관리합니다. DB 를 붙여도 원본은 파일 쪽입니다. 근거: wiki/decisions/ADR-0001-file-based-content.md