AgenticWorkflow: 범용 에이전틱 스킬 및 실행 툴체인
복잡한 작업을 결정론적이고 자체 검증 가능한 자율 워크플로우로 변환하는 다능성 줄기세포 프레임워크이자 다중 에이전트 실행 엔진입니다.
실행 불변성
$$\text{의도} \xrightarrow{\text{연구}} \text{계획 (SOT state.yaml)} \xrightarrow{\text{구현}} \text{4계층 품질 게이트} \xrightarrow{\text{pACS 델타}} \text{검증된 결과물}$$
⚡ 동적 모드 라우터
컨텍스트 또는 명시적 플래그에서 원하는 모드를 감지합니다:
| 모드 | 트리거 구문 | 핵심 실행 흐름 |
|---|---|---|
| 1. DESIGN | "design workflow", "new pipeline", "workflow.md" | 연구 → 계획 → 구현 3단계 청사진 생성 |
| 2. EXECUTE | "run workflow", "execute pipeline", "start step" | SOT 상태 머신 드라이버로 단계별 결과물 생성 |
| 3. AUTOPILOT | "autopilot", "fully automated", "hands-off" | (human) 체크포인트를 결정 로그와 함께 자동 승인; 안전 후크 적용 |
| 4. ULW | "ulw", "ultrawork", "maximum rigor" | 3가지 강화 장치: 시지프스 지속성, 필수 분해, 재시도 에스컬레이션 |
| 5. VERIFY | "verify step", "quality gates", "run pacs" | L0 스킵 방지 → L1 검증 → L1.5 pACS → L2 적대적 리뷰 |
| 6. OPTIMIZE | "optimize workflow", "reduce cycle time", "streamline" | 린 병목 분석, 자동화 점수, 사이클 타임 압축 |
3가지 절대 기준 (헌법적 규범)
이 스킬에 의해 생성되거나 관리되는 모든 워크플로우, 도구 및 하위 에이전트는 엄격히 3가지 절대 기준을 상속받습니다:
- 절대 기준 1: 최종 결과물의 품질
속도, 토큰 비용, 작업량 및 길이 제한은 완전히 무시됩니다. 모든 결정의 유일한 기준은 최종 결과물의 품질입니다.
- 절대 기준 2: 단일 파일 SOT + 계층형 메모리
모든 공유 상태는 단일 파일(
state.yaml)에 집중됩니다. SOT 쓰기 권한은 오직 조정자/팀 리드에게만 독점적으로 속합니다. 병렬 에이전트는 공유 파일을 동시에 변경하지 않습니다. - 절대 기준 3: 코드 변경 프로토콜 (CCP)
코드를 쓰거나, 수정하거나, 추가하거나, 삭제하기 전에 내부적으로 다음을 수행합니다: 1단계 (의도 이해) → 2단계 (파급 효과 분석) → 3단계 (변경 계획). 코딩 앵커 포인트(CAP-1~4)에 의해 관리됩니다.
4계층 품질 보증 스택
flowchart TD
StepStart["단계 실행"] --> L0["L0: 스킵 방지 물리적 가드 (파일 존재 및 >= 100 바이트)"]
L0 -->|통과| L1["L1: 검증 게이트 (100% 기능 목표 달성)"]
L0 -->|실패| Diag["귀납적 진단"]
L1 -->|통과| L15["L1.5: pACS 자체 평가 (F/C/L 사전 치명 평가 점수)"]
L1 -->|실패| Diag
L15 -->|빨강: <50| Diag
L15 -->|초록 / 노랑| L2["L2: 적대적 리뷰 (@reviewer + @fact-checker)"]
L2 -->|통과| SOT["SOT 진행 (current_step + 1)"]
L2 -->|실패| Diag
Diag --> Retry["대체 가설로 재시도 (최대 3회)"]
- L0 스킵 방지 가드: 결과물이 디스크에 존재하고 비어 있지 않은지(
MIN_OUTPUT_SIZE >= 100 바이트) 결정론적으로 확인합니다. - L1 검증 게이트: 모든 승인 기준이 100% 달성되었는지 의미론적으로 검증합니다.
- L1.5 pACS (예측 에이전트 신뢰 점수): 신뢰도(Faithfulness), 완전성(Completeness), 논리(Logic)에 대한 사전 치명 평가입니다. $pACS = \min(F, C, L)$.
초록 (>= 70): 자동 진행.노랑 (50 - 69): 결정 로그에 약한 차원을 표시하고 진행합니다.빨강 (< 50): 중단하고 재작업을 트리거합니다.
- L2 적대적 리뷰:
@reviewer와@fact-checker에 의한 독립적인 생성자-비판자 평가입니다.
워크플로우 최적화 엔진 (린 & 자동화)
워크플로우를 분석하거나 최적화할 때:
- 병목 현상 심각도: 병목 현상에 1에서 5까지 점수를 매깁니다.
- 자동화 가능성: 에이전트 위임을 위해 수동 작업을 정량화합니다.
- 오류 감소: 오류 전파가 발생하기 전에 근본 원인에 품질 게이트를 구현합니다.
- 사이클 타임 감소: 결과물 품질을 높이면서 최소 40%의 사이클 타임 감소를 목표로 합니다.
자율 자가 동력 엔진 및 회로 차단기
시스템은 내장된 에너지 관리 기능을 갖춘 종단 간 자율 엔진으로 작동합니다:
- 자가 동력 및 에너지 루프: 동적 토큰 및 컨텍스트 헤드룸 모니터링과 컨텍스트 소진 전 자동 RLM 상태 압축 및 재급유 체크포인트.
- Fable 회로 차단기: 상태 전환
닫힘→열림→반열림. 연속 실패 횟수($\ge 2$)일 때 추측성 스래싱을 자동으로 중단하고, 귀납적 진단(diagnose_context.py)을 통해 근본 원인을 격리하며, 구조화된 복구를 실행합니다. - 클린 코드 가드: 24가지 클린 코드 명령(작은 함수, 의도 드러내는 이름, 최대 4개 매개변수, 예외 삼키기 금지, 거짓 성공 목업 금지)을 확인하는 자동 AST 가드 패스.
- AI 엔지니어링 평가: 통합된 4/5 이질적 영향 테스트($\ge 0.80$), PSI 분포 드리프트 모니터링, 적대적 프롬프트 인젝션 살균 처리.
CLI 및 툴체인 통합
# 자체 동력 및 에너지 관리 기능을 갖춘 자동 종단 간 오토파일럿 워크플로우 실행
gentic-workflow autopilot --title "프로덕션 파이프라인" --goal "자율 전달"
# 클린 코드 가드 감사 실행 (SOLID, 24가지 명령, AI 실패 모드)
gentic-workflow guard [디렉토리]
# AI 엔지니어 공정성, 드리프트 및 프롬프트 인젝션 평가 게이트 실행
gentic-workflow eval
# 다중 에이전트 관찰 가능 추적 로그 및 스팬 조회
gentic-workflow traces
# 인프라, SOT 런타임 디렉토리 및 상태 확인 초기화
gentic-workflow init
# 워크플로우 스키마, SOT 무결성 및 pACS 로그 검증
gentic-workflow validate
# 라이브 워크플로우 대시보드 및 관찰 가능성 메트릭 확인
gentic-workflow status
# 전체 자동화 테스트 스위트 실행 (안전, 가드, MAS, 평가자)
gentic-workflow test
참조 맵
- 아키텍처 및 DNA:
soul.md,AGENTICWORKFLOW-ARCHITECTURE-AND-PHILOSOPHY.md - 운영 매뉴얼:
AGENTICWORKFLOW-USER-MANUAL.md - 공통 지시사항:
AGENTS.md,CLAUDE.md,GEMINI.md - 프로토콜:
docs/protocols/(autopilot-execution, quality-gates, ulw-mode, code-change-protocol, context-preservation-detail) - 하위 에이전트:
.claude/agents/(reviewer, fact-checker, translator) - 스크립트:
.claude/hooks/scripts/(context_guard, validate_pacs, validate_review, etc.)