Pro Workflow는 Claude Code 같은 코딩 에이전트가 사용자의 교정과 작업 흔적을 축적해 다음 세션에서 더 잘 동작하도록 만드는 워크플로 스택이다. 스킬, 에이전트, 명령어, 훅, SQLite 기반 지식 평면, 병렬 worktree 패턴을 하나로 묶는다.
해결하려는 문제
AI 코딩 도구는 한 세션 안에서는 빠르게 개선되지만, 세션이 끝나면 같은 실수를 반복하기 쉽다. Pro Workflow는 이 문제를 자기교정 메모리와 작업 절차의 파일화로 다룬다.
주요 구성
| 구성 | 역할 |
|---|---|
| 스킬 | 반복 가능한 작업 절차와 품질 기준 |
| 에이전트 | 역할별 작업자 구성 |
| 명령어 | /develop 같은 고정 워크플로 엔트리포인트 |
| 훅 | 테스트, 린트, 보안 체크, 알림 같은 이벤트 기반 자동화 |
| 지식 평면 | SQLite, BM25, 벡터 검색으로 세션 간 지식 검색 |
| 병렬 worktree | 여러 에이전트가 충돌을 줄이며 독립 작업 수행 |
핵심 패턴
Pro Workflow의 핵심은 “프롬프트를 더 길게 쓰기”가 아니라 교정을 자산으로 남기는 것이다. 사용자가 한 번 지적한 포맷 오류, 테스트 누락, 설계 기준을 스킬이나 훅으로 옮기면 이후 세션에서 같은 실수를 줄일 수 있다.
또한 멀티 에이전트 작업을 단순 병렬 실행이 아니라 write scope와 검증 루프를 가진 작업 단위로 쪼개려 한다. 이는 agent-harness에서 말하는 하네스 엔지니어링과 같은 방향이다.
사용 대상
- Claude Code 파워 유저: 반복 세션에서 같은 지시를 줄이고 싶은 사용자
- 팀 리드: 팀 표준 워크플로와 품질 기준을 에이전트가 따르게 만들려는 경우
- 에이전트 도구 제작자: 메모리·훅·스킬·검색을 묶은 하네스 구조를 참고하려는 경우
관련 문서
- claude-code — 터미널에서 동작하는 Anthropic AI 코딩 에이전트
- agent-harness — 에이전트 성능을 결정하는 하네스 설계
- agentic-memory — AI 에이전트가 경험을 기억하고 활용하는 지식 계층
- superpowers — AI 코딩 에이전트를 위한 스킬 기반 개발 방법론
- gstack — Claude Code를 가상 엔지니어링 팀으로 운용하는 스킬셋
참고 자료
- rohitg00/pro-workflow — GitHub 공식 저장소