agent-company AGENTS.md

AGENTS.md

이 저장소에서 작업하는 모든 AI 코딩 에이전트를 위한 지침입니다. Claude Code, Codex, Cursor, Gemini CLI 등 어떤 도구로 들어오든 여기서 시작하세요.

Claude Code 전용 지침은 CLAUDE.md 에 있습니다 (내용은 대부분 동일합니다).

---

먼저 읽을 것

세션 시작 시 자동 로드가 없는 도구를 쓰고 있다면 직접 실행하세요:

bash scripts/load-context.sh      # 또는: pnpm context

코어 하드 룰, 현재 적용된 템플릿과 그 템플릿의 하드 룰, wiki 인덱스, 장기 메모리, 최근 단기 메모리, 로스터, git 상태를 한 번에 출력합니다.

현재 회사가 무엇인지 먼저 확인하세요. 이 저장소는 템플릿을 갈아끼울 수 있고, 무엇을 만드는 프로젝트인지에 따라 규칙과 검사 항목이 달라집니다.

pnpm template current

---

프로젝트

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

── 코어 (항상 있음) ──────────────────────────────
.claude/          훅(SessionStart · PreToolUse) · 슬래시 커맨드
wiki/             프로젝트 지식 + 장/단기 메모리 + ADR
agents/           로스터 (registry.yaml + <id>/AGENT.md + skills/)
scripts/          결정적 셸 스크립트
CLAUDE.md         Claude Code 지침
AGENTS.md         모든 AI 코딩 에이전트 공통 지침

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

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

---

코어 하드 룰

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

1. 이미지 생성 경로는 하나다. 정책은 코어, 명령은 템플릿이 줍니다 (blog 는 pnpm imagegen --slug <slug> --prompt "<설명>"). 템플릿에 이미지 명령이 없으면 이미지 없이 진행하는 것이 정답입니다. 다른 이미지 모델이나 API 를 호출하지 않습니다. SVG 로 대체하지 않습니다. Codex 부재 시 폴백: ① 이미지 없이 진행 ② 사용자에게 첨부 요청 ③ 웹 검색(라이선스 기록). → ADR-0002

2. 출고 버튼은 사람이 누른다. 에이전트는 검수 대기(in_review)까지만 올립니다. status: published 로 쓰지 않습니다.

3. 진실은 저장소 파일이다. 결과물도 결정도 코드와 같은 저장소에서 버전 관리합니다. DB 를 붙여도 원본은 파일 쪽입니다 → ADR-0001

4. 게이트는 결정적이다. 검수 함수에 LLM 호출을 넣지 않습니다. 사람과 에이전트가 같은 판정을 봐야 합니다.

5. 컨텍스트는 스스로 올라온다. 훅이 하는 일을 손으로 다시 하지 마세요.

이 회사의 하드 룰

도메인 규칙은 templates/<id>/template.yaml 의 rule: 에 있고, 세션 시작 시 위 다섯 개 위에 얹혀서 주입됩니다. 없다고 느껴지면 pnpm context 로 확인하세요.