Imported from dealicious-inc/ssm-mobile-ios-design-system (
AGENTS.md). Install upstream withnpx skills add dealicious-inc/ssm-mobile-ios-design-system. Copyright stays with the author.
AGENTS.md
목적
이 문서는 ssm-mobile-ios-design-system에서 Cursor, Claude, Codex를 포함한 모든 AI가 공통으로 먼저 읽는 라우터다.
상세 규칙은 docs/ai/** 정본 문서에 둔다.
AI는 모든 문서를 미리 읽지 않는다. 먼저 이 문서로 작업 종류를 판단하고, 필요한 문서만 추가로 읽는다.
우선순위
AGENTS.md는 전역 entrypoint이자 문서 라우팅 기준이다.- 상세 판단은 라우팅된
docs/ai/**정본 문서를 따른다. CLAUDE.md는 얇은 어댑터이며,AGENTS.md또는docs/ai/**와 충돌하면 정본 문서를 따른다.- 어댑터만 수정하고 정본 문서를 그대로 두지 않는다.
문서 로딩 전략
- Always: 먼저
AGENTS.md만 읽고 작업 종류를 판단한다. - Skill Entry: 사용자가
codeReview를 요청하면docs/ai/skills/code-review/SKILL.md를 시작점으로 읽는다. - Triggered: 라우팅 테이블의 조건에 맞는 문서만 추가로 읽는다.
- Stop: 문서와 실제 코드가 충돌하면 임의로 진행하지 않고 사용자 확인을 요청한다.
응답 헤더 규칙
- AI는 사용자에게 직접 응답할 때 기본 호칭으로
대장을 사용한다. - 사용자에게 직접 답변할 때는 기본적으로 존댓말을 사용한다.
- skill entrypoint를 사용한 작업의 최종 응답 최상단에는
🤖 사용한 Skill: <skill-name>을 적는다. - skill을 사용하지 않은 일반 작업에는 이 헤더를 생략할 수 있다.
작업 라우팅
| 요청/작업 | 먼저 읽을 문서 | 필요할 때 추가로 읽을 문서 |
|---|---|---|
| 일반 코드 질문, 파일 설명 | 현재 대상 파일 | docs/ai/reference/swift-style.md |
| 컴포넌트 추가/수정 | 현재 대상 파일, 기존 유사 컴포넌트 | docs/ai/reference/swift-style.md, docs/ai/reference/project-workflow.md |
| 단순 버그 수정, 빌드/테스트 오류 수정 | 현재 대상 파일과 에러 로그 | docs/ai/reference/swift-style.md |
| codeReview, PR/로컬 diff 리뷰 | docs/ai/skills/code-review/SKILL.md, docs/ai/playbooks/code-review-playbook.md |
- |
| Swift 파일 헤더, 설명 주석, 네이밍 판단 | docs/ai/reference/swift-style.md |
기존 유사 Swift 파일 |
| 브랜치, PR, 빌드, 의존성 관리 판단 | docs/ai/reference/project-workflow.md |
실제 Package.swift |
| 신규 skill 작성 | docs/ai/skills/new-skill/SKILL.md |
AGENTS.md |
도구별 Skill 어댑터
- Claude codeReview project skill:
.claude/skills/code-review/SKILL.md - Claude codeReview slash command:
.claude/commands/review.md
공통 금지 항목
아래 항목은 모든 작업에 기본 적용한다.
DealiImageGenerated,DealiIconGenerated계열 파일 직접 수정 금지.- generated Swift 파일 직접 수정 금지.
- 승인 없는 구조 개편 금지.
- 문자열, 이미지, 아이콘 리소스 임의 추가 금지.
- 사용자 명시 승인 없는
git commit,git push, PR 생성, merge 금지.
최소 종료 규칙
- 최종 응답에는
AI 문서 영향 없음,AI 문서 업데이트 필요, 또는AI 문서 업데이트 반영됨중 하나를 남긴다.