소개
스터디장님에게 받은 파이프라인 인터뷰를 해봤는데
자동화설계 인터뷰 결과가 생각보다 얕게 나왔고, 왜 그런지 알 수 없었습니다.
호기심을 해결하는 과정에서
자동화의 성능을 위해 일하는 방식과 설계 기준에 대해서 생각해보게 되었습니다. 😄
사용한 도구
Claude Code, Antigravity, Chat GPT
작업 과정
1. 자동화는 도구가 아니라 “작업공간 설계”에서 시작된다
AI 워크플로우 자동화를 설계하면서, 예상보다 결과물이 얕 게 나오는 경험을 했습니다.
파이프라인도 있었고, 스킬도 준비되어 있었지만 결과는 단순한 수준에 머물렀습니다.
처음에는 입력정보가 부족한 문제라고 생각했습니다.
하지만 원인은 전혀 다른 곳에 있었습니다.
자동화를 “실행”으로 접근했지
“작업공간”으로 설계하지 않았다는 것
그래서 이 작업을 실행용 프롬프트로 준비했어요.
Q. 프로젝트에서 Claude 표준 구조로 맞추는 작업을 진행하려고 해. 사용자가 수동으로 하는게 아니라, 알아서 진행할 수 있도록 프롬프트 지침을 작성해줘.너는 AI Workflow Architect이자 Claude Skill 구조 리팩토링 전문가다.
목표:
현재 프로젝트의 SKILL 기반 워크스페이스를 Claude 표준 구조로 자동 변환하고,
경로, 참조, 연결 구조까지 일관성 있게 수정하라.
[Step 1. 프로젝트 구조 분석]
현재 작업 디렉토리의 파일 및 폴더 구조를 분석하라
다음 요소를 반드시 식별하라:
SKILL.md 위치
templates 폴더
references 폴더
scripts 폴더
절대경로 사용 여부
분석 결과를 구조 트리 형태로 출력하라
---
이하 생략최종 디렉토리 구조
이 작업을 하고나서 스킬을 다시 실행했더니 worksheet 퀄리티가 달라졌습니다.
기존 : 초보자도 따라 할 수 있도록 단계별 실행 방법과 툴 사용법 등 절차적 상세함에 집중.
신규 : 비즈니스 로직, 데이터 구조(RAG), 자동화 전략 등 구조적 설계와 전문성에 집중.
👉 워크스페이스 설계 기준
- 스킬은 표준 경로에 위치해야 한다
- 프로젝트는 구조 기준으로 정렬한다
- 실행 전에 환경을 먼저 맞춘다2. 문서가 늘어날수록 혼란이 생김
작업이 진행되면서 문서가 빠르게 늘어났습니다.
실행계획.md , workflow_prototype.md , worksheet.md , task.md
todo.md 가 어떤 문서를 기준으로 구현을 해야하지? 😢
문제는 문서의 양이 아니라 “구분 기준”이었습니다.
문서 간에 역할이 겹치고
어디까지가 설계인지, 실행인지 모호하다면
이 상태에서는 자동화가 아니라, 관리가 일이 됩니다.
Q. 각 문서 역할 차이가 뭐야?- 실행계획: 무엇을 할지 (전략)
- 워크시트: 어떤 기준으로 할지 (운영 규칙)
- 워크플로우 프로토타입: 어떻게 만들지 (기술 설계)
- 태스크: 지금 무엇을 할지 (실행)
정리된 흐름은, 실행계획 → 워크시트 → 프로토타입 → 태스크👉 문서는 역할 기준으로! 작업흐름을 명확하게 함.
실행계획으로 방향을 잡고,
워크시트로 규칙을 정한 뒤,
프로토타입으로 기술 구조를 만들고,
태스크로 하나씩 실행합니다.3. 워크플로우를 시각화로 검증하기
AI 는 텍스트로는 그럴듯하게 대답을 잘 하기 때문에
AI 가 이해하고 진행하는 내용과 사용자가 의도한 내용이 일치하는지 확인 과정이 필요합니다.
Q. 이 프로젝트의 워크플로우를 머메이드 다이어그램으로 시각화 해줘.
[ 예시 ]
👉 시각화의 장점!
- 텍스트 설명과 시각화 결과를 비교 검증.
- 빠진 부분이나 개선하고 싶은 부분에 대한 설계 오류를 빠르게 확인하고, 개선 요청할 수 있음.
- 워크플로우 레이어 구조가 명확해짐. 이 과정이 왜 필요한지 설명 가능해짐.4. 예상치 못한 수확: 스킬 재사용 제안
작업 중 흥미로운 경험이 있었습니다.
기존에 등록한 global 스킬을 자동으로 인식
내가 요청하지 않았는데, 자동화 특정 단계에서 활용 가능하다고 먼저 제안함
👉 나만의 “스킬 키트”를 관리하자. 재사용 자산으로 활용할 수 있다.5. 결과와 배운 점 : 워크플로우 설계에서 얻은 핵심 원칙 👍
✔️ 기존의 방식은, PRD 기반으로 기능 단위 순차 개발이었다면
- 이번 경험은 구조, 흐름, 관계를 설계하는데 비중을 두어서 프로젝트를 입체적 관리하는 느낌
✔️ 연결 비용을 줄여야 한다
- 호출/연결이 많아질수록 복잡도 증가하므로 처음부터 구조화해야 효율이 살아남
✔️ 확장보다 경계가 중요하다
- 기능을 계속 추가하면 관리 불가능하므로 어디서 나눌지 기준이 필요
✔️ 역할 분리가 모든 것을 결정한다
- 스킬 역할 분리 정의가 필수. 관리 / 종료 / 품질 통제가 가능해짐
도움 받은 글 (옵션)
스터디장님이 제공한 워크스페이스와 스킬
