디자인 시스템 → AI 에이전트 하네스 이해 확장하기

Design System을 먼저 적용하고 Agent Harness로 넘어가는 효과

DESIGN.md → Design System의 확장은

Prompt → Agent Harness의 확장과 구조적으로 비슷하다.

디자인 시스템은 결과물이 눈에 보인다.
- 색상, 폰트, 레이아웃, 카드, 버튼, 페이지 일관성을 확인할 수 있다.
AI Agent Harness는 결과물이 덜 눈에 보인다.
- 규칙, 절차, 도구 호출, 역할 분담, 검증 기준이 내부에서 작동한다.
그래서 Design System은 Agent Harness를 이해하기 위한 좋은 사전 훈련이다.

Agent Harness는 프롬프트 모음이다?

아니다. 프롬프트는 Harness의 일부일 뿐이다.

프롬프트: 이번 작업의 지시
룰셋: 프로젝트 전체의 고정 규칙
스킬: 반복 작업을 수행하는 절차와 리소스
도구: 실제 행동을 수행하는 수단
워크플로우: 어떤 순서로 누구에게 넘길지 정하는 흐름
가드레일: 실행권한과 위험을 제어하는 경계
평가: 결과가 좋은지 판단하는 기준

나쁜 예:
이 프로젝트를 좋은 품질로 개선해줘.

좋은 예:
1. AGENTS.md의 프로젝트 규칙을 먼저 읽어.
2. DESIGN.md의 레이아웃/색상/컴포넌트 원칙을 확인해.
3. content-review skill로 문장 구조를 점검해.
4. ui-consistency skill로 디자인 시스템 위반 여부를 점검해.
5. 수정안은 실제 반영 전 diff와 QA 체크리스트를 함께 제출해.
6. 배포나 외부 게시 작업은 사용자 승인 전 실행하지 마.

Design System과 Agent Harness의 대응 관계

Design System	AI Agent Harness	시스템적 도출을 위한 핵심 질문
`DESIGN.md`	`AGENTS.md`, `CLAUDE.md`, `HARNESS.md`	AI가 따라야 할 전체 방향성은 무엇인가?
Design Token (의사결정)	Decision Token / Policy Token
(ADR, Arch Decision Record)	반복되는 판단 기준은 무엇인가?
Component	Skill / Tool / Subagent	반복 가능한 작업 단위는 무엇인가?
Asset / Resource	Data Source / Knowledge Base	작업할 때 참고해야 할 자료는 어디에 있는가?
Storybook	Scenario Book / Eval Suite	여러 상황에서 일관되게 동작하는지 어떻게 확인할 것인가?
Accessibility / QA Rule	Guardrail / Human Approval	하면 안 되는 행동과 승인 조건은 무엇인가?
Figma → Code	Prompt → Workflow → Tool Execution	명세가 실제 실행으로 이어지는 경로는 무엇인가?
Component Library	Skill Library	팀이 재사용할 수 있는 작업 단위는 무엇인가?

A) 내가 원하는 디자인 체계를 “재현 가능하게” 적용하기 → 디자인 시스템

B) 내가 원하는 작업 방식을 “재현 가능하게” 적용하기 → Agent 하네스

Design System을 먼저 적용하고 Agent Harness로 넘어가는 효과

Agent Harness는 프롬프트 모음이다?

Design System과 Agent Harness의 대응 관계

A) 내가 원하는 디자인 체계를 “재현 가능하게” 적용하기 → 디자인 시스템

일회성 프롬프트 기반 작업 지시