AI Coding Workflow·Rules·Skills 완전 해설 (예제 포함)

같은 요구사항인데 매번 「ORM 안 씀」「커밋에 티켓 필수」를 설명하는 사람과 「프로젝트 workflow 따라」 한 마디면 되는 사람이 있다——차이는 모델 지능이 아니라 Workflow·Rules·Skills가 계층화·버전 관리되었는지에 있다. 2026년 주류 AI 코딩 도구는 「상주 제약 + 온디맨드 Runbook + 오케스트레이션 가능 플로」를 지원하지만, 많은 팀은 여전히 거대한 system prompt에 뭉개 넣는다. 컨텍스트가 부풀고 트리거가 흔들리며, 모델은 diff 대신 정책을 재독한다. 각 계층의 책임, 조합법, 오늘 복사해 쓸 예시를 검증한다. 비대칭 결론: 분수령은 진입점과 실행 경계——Claude가 GPT보다 몇 점 뛰어난지가 아니다.

Cursor, Claude Code, GitHub Copilot 등 AI 코딩 사용자 대상. Workflow(명령/자동화/Agent 모드), Rules(.cursor/rules, AGENTS.md, 사용자 규칙), Skills(SKILL.md, 온디맨드 로드)를 다룬다. 통합 비교표, 시나리오 매트릭스, 추천 스택, 오해 목록, 7단계 도입, Xcode/CI Workflow가 macOS 실행 노드에 속하는 이유를 설명한다.

1. AI 코딩에 Workflow·Rules·Skills 계층이 필요한 이유

AI 코딩 어시스턴트는 도구 호출이 있는 Agent다: 저장소를 읽고, 파일을 수정하고, 터미널을 실행한다. 약점도 분명——새 채팅마다 기억 상실, 팀 규범을 prompt에 다시 넣지 않으면. 더 나쁜 것은 코드 스타일·Git 규약·릴리스 checklist·장애 Runbook을 한 User Rule에 몰아넣는 것. 각 메시지가 수천 token 정책을 짊어져 diff와 로그 공간을 잡아먹는다.

2026년 모범 사례는 제약과 절차를 3계층으로 나눈다:

Workflow: AI 작업 시작 방법——슬래시 명령, Plan/Agent 모드, CI 트리거, 원격 Agent 오케스트레이션.
Rules: 항상 성립하는 것——언어 스타일, 편집 금지 디렉터리, 테스트 요구, 보안 red line.
Skills: 온디맨드 실행——code review checklist, Xcode 릴리스, 마이그레이션 Runbook. 보통 SKILL.md.

이는 Agent 개발 모드 선정과 같은 논리: 진입점이 행동 경계를 정하고, 모델 파라미터 표가 아니다. Skills 오픈 표준은 Agent Skills Specification; Cursor Rules는 공식 문서 참조.

계층화는 리뷰 가능성도 높인다. Rule 한 줄 변경이 이후 모든 대화에 영향——신중한 PR이 필요하다. Skill 업데이트는 해당 Skill 호출 시에만 컨텍스트 비용이 든다. Workflow 변경은 명령 doc이나 CI job만 수정하면 된다.

2. Workflow / Rules / Skills 분류 (What)

2.1 Workflow — 작업 시작과 오케스트레이션

Workflow는 누가 언제 Agent를 끌어올리는가에 답한다. Cursor /generate-blog류 커스텀 명령, Plan/Agent 모드 전환, Claude Code /loop와 배치, GitHub Actions에서 AI가 CI 수정, OpenClaw류 게이트웨이가 Telegram/cron을 원격 Mac에 연결. Workflow는 트리거, 상태기, 산출물 경로를 다루며 한 줄 포맷 규약이 아니다.

2.2 Rules — 상시 유효 제약층

Rules는 상주 컨텍스트. Cursor에서 .cursor/rules/*.mdc(프로젝트), Settings Rules, 루트 AGENTS.md가 일반적. 최소 diff, 건드리면 안 되는 디렉터리, 커밋 규약, 응답 언어, 테스트 필수 조건. Rules는 짧고, 단단하고, 실행 가능하게. 30단계 릴리스 절차는 Rule이 아니라 Skill로.

2.3 Skills — 온디맨드 Runbook

Skills는 온디맨드 로드 워크플로 패키지. Claude Code는 .claude/skills/<name>/SKILL.md; Cursor는 .cursor/skills/<name>/SKILL.md. Agent는 frontmatter description을 먼저 읽고 매치 시 본문 로드. 심화는 Claude Code Skills 10 프레임워크 가이드 참조.

한 줄 암기

Workflow = 어떻게 시작; Rules = 무엇을 절대/항상; Skills = 특정 작업 유형의 방법.

3. 핵심 비교표

Workflow vs Rules vs Skills 통합 필드 비교
유형	진입	실행 능력	컨텍스트 점유	적합 대상
Workflow	명령, 모드 전환, CI/Webhook	다단 Agent 오케스트레이션, 배치, 원격 노드	트리거 시에만 플로 설명 주입	Tech Lead, DevOps, 자동화 담당
Rules	프로젝트 열면 로드	편집 행동·형식·금지 구역 제약	상주, 간결하게	전체 개발자, 리뷰어
Skills	`/skill-name` 또는 description 자동 매치	구체 Runbook(review, 릴리스, 마이그레이션)	온디맨드, references/ 가능	버전화 SOP가 필요한 팀
Commands(보충)	명시적 `/command`	단발 prompt 템플릿	호출 시에만	개인 단축어
Hooks(보충)	저장, 커밋 전 등	lint/감사 스크립트 자동 실행	모델 경유 없음 또는 극단	품질 게이트, 컴플라이언스

3.1 Rules vs Skills 분담速查

Runbook을 Rules에 쓰지 마라
비교 항목	Rules상주	Skills온디맨드
전형 내용	force push 금지, 최소 diff, 테스트 요구	7단계 릴리스, 보안 감사 checklist
버전 관리	`.cursor/rules` Git 커밋	`SKILL.md` 동창 or ~/.cursor/skills
트리거	자동	수동 /slash 또는 의미 매치
분량	짧을수록 좋음(수백 자급)	길어도 됨, 상세는 references/

4. 시나리오별 선택

시나리오	우선 설정(순서)	비고
개인 side project	User Rules 3개 → Commands 2개 → commit Skill 1개	행동 제약 먼저, 3번째 반복은 Skill화
10인 전후 팀	프로젝트 Rules → PR Skill → CI Workflow	Rules는 code review; Skill에 릴리스 Runbook
iOS / macOS 팀	xcode-release Skill → Rules(signing 변경 금지) → 클라우드 Mac Workflow	Archive는 macOS 필수. 클라우드 Mac 개발 시나리오 참조
OSS 메인테이너	CONTRIBUTING Rules → docs-sync Skill → security-review Skill	고위험 Skill: `disable-model-invocation: true`
스타트업 풀스택	Agent Mode Workflow → ci-fix Skill → 간결 Rules	인원 적을수록 자동화; Rules는 red line만

5. 추천 스택

스택 A — 최소 구성(반나절)

User Rules 3개: 최소 diff, 임의 commit 금지, 편집 후 lint
프로젝트 .cursor/rules/blog-writing.mdc는 해당 저장소 고유만
개인 Skill commit: staged diff에서 Conventional Commits

스택 B — 팀 규범

Rules: testing.mdc + security.mdc(각 80줄 미만)
Skills: code-review, security-review(수동 트리거)
Workflow: PR 템플릿에 「머지 전 /security-review」

스택 C — iOS 딜리버리

Skill xcode-release(disable-model-invocation: true)
Rules: 명시 요청 외 *.xcodeproj 수정 금지
실행 노드: 로컬 M4 또는 Hashvps 클라우드 Mac. GitHub Actions macOS 빌드 동향과 병행, 무거운 컴파일은 원격

스택 D — 콘텐츠/문서 공정

Workflow: /generate-blog류(brief → zh → i18n 게이트)
Rules: blog-standard-spec-v1.mdc
Skills: translate-to, seo-optimize 온디맨드

6. 흔한 오해

~~「전부 User Rules가 제일 편」~~ → 상주 prompt 팽창; Runbook은 Skills로.
~~「Skills 많을수록 좋다」~~ → description 충돌; 10개 이내, 경계 명확.
~~「Workflow가 CI 대체」~~ → AI는 개발 보조; 게이트는 GitHub Actions / Xcode Cloud에 하드코딩.
~~「Rules와 Skills 한 파일 OK」~~ → 리뷰·로드 메커니즘 다름; Rules 한 줄이 매 대화에 영향.
~~「Mac 없이 xcode-release Skill」~~ → codesign은 macOS 필요. 로컬 or 클라우드 Mac.
~~「Plan Mode = Workflow」~~ → Plan은 대화 모드; Workflow는 재현 가능·스크립트화 트리거와 산출물 약속.

7. 7단계 도입: 복사 예시

반복 prompt 감사: 지난주 같은 review checklist 3번? → Skill 후보.
Rules 3개: 「항상 참」red line만, 각 1화면.
Skill 디렉터리: mkdir -p .cursor/skills/code-review(Cursor) 또는 .claude/skills/code-review(Claude Code).
SKILL.md frontmatter: description은 「동사 + 시나리오」; 고위험은 disable-model-invocation: true.
Workflow 정의: 「brief OK → i18n」게이트를 .cursor/commands/*.md에.
Git 커밋: Rules·프로젝트 Skills를 코드와 동일 PR.
실행 노드 연결: shell/Xcode Workflow는 macOS 호스트(로컬 or 클라우드 Mac).

예시 1: 프로젝트급 Cursor Rule(간결)

# .cursor/rules/core.mdc
---
description: Core engineering constraints for this repo
globs: "**/*"
---
- Minimize diff scope; do not refactor unrelated code.
- Never commit unless the user explicitly asks.
- Run tests for touched packages before claiming done.

예시 2: 온디맨드 Skill(code-review)

# .cursor/skills/code-review/SKILL.md
---
name: code-review
description: Review staged git diff for bugs, security, and test gaps. Use when user asks for review or before PR.
---
1. Run `git diff --staged` (or compare branch to main).
2. Output: Critical / Warning / Suggestion in three sections.
3. Do not auto-fix unless user asks.

예시 3: Workflow 게이트(명령 doc 발췌)

# .cursor/commands/release-ios.md
## Workflow
1. User confirms brief / scope on main branch.
2. Agent runs /test-runner Skill on changed targets.
3. Manual /xcode-release only after CI green.
4. Post changelog; never skip codesign on shared runner.

8. 요약

2026년 AI 코딩 경쟁력은 단일 모델 점수보다 워크플로 엔지니어링에 달렸다. Workflow는 작업 시작 방식, Rules는 항상 성립하는底线, Skills는 시니어 checklist를 버전화·공유 가능한 Runbook으로. 먼저 계층화, 그다음 비싼 구독.

비대칭 결론: 모델 능력이 분수령이 아니다. 진입점과 실행 경계가 분수령이다. Cursor Rules · Claude Code Skills · Agent Skills 표준

FAQ

Workflow·Rules·Skills 최대 차이는?

Workflow는 작업 시작·오케스트레이션, Rules는 상주 제약, Skills는 특정 작업 SOP. Workflow=流水线 버튼, Rules=가규, Skills=표준 작업서.

Cursor Rules와 Claude Code Skills 혼용 가능?

개념은 유사하나 경로 다름. Cursor는 .cursor/rules·.cursor/skills; Claude Code는 .claude/skills. SKILL.md 본문 동기화 후 frontmatter만 각 문서에 맞게.

Rules 적정 길이는?

파일당 수백 자, 1화면. 5단계 초과 절차는 Skill 또는 Workflow doc으로.

Plan Mode vs Workflow?

Plan Mode는 단발 복잡 탐색·합의. Workflow는 팀 반복, 게이트·산출물 경로 필요(릴리스, 블로그 i18n, CI 수정).

프로젝트 설정 Git 커밋?

해야 함. .cursor/rules, .cursor/skills, .claude/skills, .cursor/commands를 코드와 동창, clone 후 동일 AI 공정 설정.

Xcode Workflow에 클라우드 Mac 추천 이유?

Archive·codesign·xcodebuild는 네이티브 macOS 필요. 클라우드 Mac은 7×24 노드로 SSH에서 Workflow/Skills 안정 실행, 노트북 밤새 켤 필요 없음.