Codex를 위한 Ultracode: 스킬을 활용한 Claude 스타일의 동적 워크플로우 (Dynamic Workflows)

Claude Code에 동적 워크플로우 (Dynamic Workflows) 기능이 추가되었습니다.

동적 워크플로우 (Dynamic Workflows)는 더 큰 코딩 작업을 계획된 단계의 시퀀스로 실행하는 방법입니다. Claude Code는 작업을 분할하고, 독립적인 부분을 실행하며, 결과를 확인하고, 최종 답변을 통합할 수 있습니다.

작은 작업의 경우, 이는 불필요합니다. 하나의 에이전트 (Agent)가 직접 수정할 수 있기 때문입니다.

더 큰 작업의 경우, 시퀀스는 다음과 같습니다:

계획 (plan) -> 분할 (split) -> 독립적 작업 실행 (run independent work) -> 결과 확인 (check results) -> 통합 (integrate) -> 검증 (verify)

Anthropic은 또한 Claude Code를 위한 ultracode 설정을 설명합니다. 이는 더 높은 노력을 사용하며, 언제 작업을 동적 워크플로우 (Dynamic Workflow)로 전환할지 결정할 수 있습니다.

Codex에는 정확히 일치하는 기능은 없습니다.

하지만, Codex에는 이미 두 가지 관련 요소가 있습니다:

• SKILL.md에서 로드되는 스킬 (skills)
• 호스트 환경이 노출할 때 사용하는 하위 에이전트 (subagents)

Codex도 동일한 시퀀스를 따를 수 있지만, 동일한 네이티브 구현은 아닙니다.

요약:

Claude Code는 네이티브 동적 워크플로우 (Dynamic Workflows)를 갖추고 있습니다.
Codex는 스킬 (skill)을 통해 동일한 절차를 근사할 수 있습니다.

저장소 (Repo):

https://github.com/PabloNAX/ultracode-skill

Claude Code가 추가한 기능

동적 워크플로우 (Dynamic Workflows)는 단 한 번의 통과 (single pass)로 처리하기에 너무 큰 작업을 위한 것입니다.

예를 들어:

• 저장소 전체 버그 탐색 (repo-wide bug hunts)
• 마이그레이션 (migrations)
• 보안 감사 (security audits)
• 독립적인 검증이 필요한 작업
• 수정하기 전에 여러 파일이나 시스템을 이해해야 하는 작업

워크플로우는 다음과 같습니다:

오케스트레이션 (orchestration)은 하나의 일반적인 응답 내부에서 일어나지 않습니다.

일반적인 채팅 루프 (chat loop)에서는 모델이 하나의 스트림 (stream) 안에서 계속 계획하고, 수정하고, 확인하고, 요약해야 합니다. 이는 작은 작업에는 적합합니다. 하지만 작업이 커지면 복잡해집니다.

동적 워크플로우 (Dynamic Workflows)는 작업을 명시적으로 만듭니다:

• 먼저 계획 (plan)
• 그다음 분할 (split)
• 그다음 독립적인 부분 실행 (run independent parts)
• 그다음 확인 (check)
• 그다음 통합 (integrate)

비용 측면의 트레이드오프 (trade-off)가 존재합니다. Anthropic은 동적 워크플로우 (Dynamic Workflows)가 일반적인 Claude Code 세션보다 훨씬 더 많은 리소스를 사용할 수 있다고 경고하며, 첫 번째 워크플로우 트리거 시 확인을 요청합니다.

병렬 에이전트 (Parallel agents)는 사용량을 증가시킵니다.

Codex가 이미 보유한 것

Codex는 다릅니다.

Codex는 Claude Code의 동적 워크플로우 (Dynamic Workflows)를 네이티브 기능으로 노출하지 않습니다. 동일한 시스템을 자동으로 실행하는 공식적인 Codex ultracode 모드는 존재하지 않습니다.

하지만 Codex에는 스킬 (skills)이 있습니다.

스킬은 작은 지침 패키지 (instruction package)입니다. 이는 에이전트에게 특정 클래스의 작업에 대해 어떻게 행동해야 하는지를 가르칠 수 있습니다.

이 유스케이스 (use case)를 위해, 스킬은 다음을 정의합니다:

• 작업을 직접적으로(direct) 유지해야 할 때
• 계획을 세워야 할 때
• 작업을 분할해야 할 때
• 서브에이전트 (subagents)를 사용해야 할 때
• 부모 세션 (parent session)에 무엇을 남길지
• 최종 결과가 어떻게 확인되는지

Codex는 네이티브 Claude Code 구현 방식이 아닌, 운영 절차 (operating procedure)를 재현할 수 있습니다.

실질적인 매핑 (practical mapping)

Ultracode 스킬은 세 가지 모드를 사용합니다.

직접 모드 (Direct mode)는 작은 작업을 위한 것입니다.

오타 하나 수정하기. 파일 하나 읽기. 좁은 범위의 질문 하나에 답하기. 워크플로우 폴더가 필요하지 않습니다.

워크플로우 모드 (Workflow mode)는 계획은 필요하지만 병렬 에이전트 (parallel agents)는 필요하지 않은 사소하지 않은 작업을 위한 것입니다.

스킬은 간단한 로컬 아티팩트 (local artifacts)를 작성합니다:

.workflow/ultracode/<run-slug>/
  plan.md
  orchestration.md
...

위임 모드 (Delegated mode)는 독립적인 확인 또는 편집으로 분할할 수 있는 작업을 위한 것입니다.

네이티브 서브에이전트 도구 (subagent tools)를 사용할 수 있는 경우, Codex는 독립적인 작업을 위해 spawn_agent를 사용할 수 있습니다.

실제로는 다음과 같이 작동합니다:

• explorer 에이전트는 코드를 조사하고 사실을 수집합니다.
• worker 에이전트는 쓰기 범위 (write scope)가 명확할 때만 편집합니다.
• 부모 세션 (parent session)이 결과를 통합합니다.
• 테스트, 빌드, 린터 (linters) 또는 브라우저 확인을 통해 최종 상태를 검증합니다.

부모 세션이 여전히 최종 답변에 대한 소유권을 가집니다.

서브에이전트 (Subagents)는 부분적인 결과물을 생성하며, 부모 세션이 이를 통합합니다.

공유 절차 (Shared procedure)

공유되는 동작 방식은 다음과 같습니다:

• 대규모 작업에 대한 계획을 수립합니다.
• 독립적인 작업들을 분리합니다.
• 독립적인 작업에 대해서만 병렬성 (Parallelism)을 사용합니다.
• 통합하기 전에 결과를 확인합니다.
• 마지막 단계에서 검증 (Verification)을 수행합니다.

이는 AI 코딩에서 흔히 발생하는 실패 모드 중 하나인 '근거 없는 매끄러운 최종 답변'을 방지합니다.

모델은 여전히 실수를 할 수 있습니다. 차이점은 워크플로우 (Workflow)가 계획, 분리된 결과물, 통합 노트, 그리고 검증 출력물과 같은 근거를 남긴다는 점입니다.

구현 차이점 (Implementation differences)

구현 방식은 다릅니다.

Claude Code의 동적 워크플로우 (Dynamic Workflows)는 Claude Code의 공식 기능입니다.

Claude Code의 ultracode 설정은 Claude Code의 동작과 결합되어 있습니다.

Codex에는 정확히 동일한 기능이 없습니다.

Codex 버전은 스킬 (Skill)입니다. 이는 Codex가 스킬, 서브에이전트 (Subagents), 로컬 아티팩트 (Local artifacts), 그리고 검증 명령 (Verification commands)을 어떻게 사용해야 하는지를 정의합니다.

쉽게 말해: Claude Code는 네이티브 기능을 소유하고 있습니다. Codex는 스킬을 통해 해당 절차를 따릅니다.

프롬프트 예시 (Prompt examples)

일반적인 작업의 경우:

Use $ultracode to implement this feature end to end and verify it.
($ultracode를 사용하여 이 기능을 엔드 투 엔드로 구현하고 검증하세요.)

병렬 작업이 도움이 될 수 있는 작업의 경우:

Use $ultracode. Use parallel agents when the task can be split, keep integration in the parent session, and verify the final patch.
($ultracode를 사용하세요. 작업을 나눌 수 있을 때는 병렬 에이전트 (Parallel agents)를 사용하고, 통합은 부모 세션 (Parent session)에서 유지하며, 최종 패치 (Patch)를 검증하세요.)

두 번째 문장이 위임 규칙 (Delegation rule)을 정의합니다.

스킬은 언제 위임할지를 기술할 수 있습니다. 현재의 호스트 환경 (Host environment)은 여전히 위임 가능 여부를 제어합니다.

설치 (Install)

Codex:

mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
cp -R ultracode "${CODEX_HOME:-$HOME/.codex}/skills/"

Claude Code:

mkdir -p "$HOME/.claude/skills"
cp -R ultracode "$HOME/.claude/skills/"

Antigravity 워크스페이스 설치:

mkdir -p .agents/skills
cp -R /path/to/ultracode .agents/skills/

설치 후에는 도구를 재시작하여 스킬 목록을 다시 불러오도록 하세요.

필수 Python 러너 (Python runner)가 없는 이유

일부 워크플로우 시스템은 헬퍼 스크립트 (Helper scripts)를 사용합니다. 이는 스캐폴딩 (Scaffolding)이나 검증 (Validation)에 도움이 될 수 있습니다.

하지만 이 스킬 (Skill)의 핵심은 러너 (Runner)가 아닙니다.

Codex에서는 서브에이전트 (Subagents)가 Codex에 의해 실행됩니다.

Claude Code에서는 동적 워크플로우 (Dynamic Workflows)가 Claude Code에 의해 실행됩니다.

이식 가능한 스킬 (Portable skill)은 오케스트레이션 (Orchestration)을 호스트 도구 (Host tool)에 맡겨야 합니다.

핵심 파일은 SKILL.md입니다.

사용 시점

적합한 경우:

• 레포지토리 전반에 걸친 감사 (Repo-wide audits)
• 마이그레이션 (Migrations)
• 탐색 및 테스트를 동반한 기능 작업 (Feature work with discovery and tests)
• 보안 검토 (Security review)
• 독립적인 확인이 필요한 위험한 변경 사항 (Risky changes)

부적합한 경우:

• 아주 작은 편집 (Tiny edits)
• 단일 파일 수정 (One-file fixes)
• 에이전트들이 동일한 검색을 중복해서 수행하게 될 작업
• 추가적인 확인보다 낮은 사용률(속도)이 우선시되는 작업

규칙:

작은 작업은 작게 유지되어야 합니다.

큰 작업은 증거 (Evidence)를 남겨야 합니다.