Gajae-Code
Gajae-Codev0.9.1

Agents

번들된 네 가지 역할 에이전트 — executor, architect, planner, critic — 와 변경 경계, 그리고 작동 루프와의 매핑.

Gajae-Code는 경계가 분명한 역할 에이전트를 정확히 네 개 번들로 제공합니다. 워크플로 스킬이 아니라 위임용 작업 역할 에이전트입니다. 핵심 원칙은 하나입니다: 한 역할만 파일을 변경하고, 나머지 셋은 엄격하게 읽기 전용입니다.

네 가지 역할

에이전트역할변경?thinking
executor범위가 정해진 구현·수정·리팩터링.medium
architect읽기 전용 아키텍처 및 코드 리뷰 평가.아니오high
planner읽기 전용 순서 정리 및 수용 기준.아니오medium
critic읽기 전용 계획 비평 및 실행 가능성 검토.아니오high

읽기 전용 역할은 절대로 파일을 쓰거나 편집·포맷·커밋·푸시·변경하지 않습니다. 이들의 산출물은 판단 — 평가, 계획, 판정 — 입니다. 오직 executor만 파일을 바꾸며, 그것도 열린 범위가 아니라 계획 단계에서 정해진 범위 안에서 동작합니다.

루프와의 매핑

역할 에이전트는 워크플로 루프에 매핑됩니다:

  • plannerdeep-interview / ralplan 동안 의도를 명시적인 수용 기준이 있는 순서화된 계획으로 바꿉니다.
  • critic — 변경이 시작되기 전에 그 계획을 압박 테스트해 OKAY, ITERATE, REJECT 중 하나를 반환합니다.
  • executorultragoal 아래에서 승인된 작업을 수행하며, diff를 작게 유지하고 증거를 남깁니다.
  • architectralplan 루프 안의 고정된 합의 단계(planner → architect → critic)로 실행됩니다. 어떤 변경이 시작되기 전, 제안된 접근에 대한 읽기 전용 아키텍처·설계 평가(CLEAR / WATCH / BLOCKAPPROVE / COMMENT / REQUEST CHANGES)를 제공합니다. executor 이후 리뷰가 아닙니다.

이 역할들의 병렬 실행은 team으로 조율할 수 있습니다.

읽기 전용 vs 쓰기

읽기 전용과 쓰기를 분리하는 것이 핵심입니다.

  • 파일이 바뀌기 전에 계획이 압박 테스트됩니다.
  • 리뷰어가 "그냥 고쳐버리는" 일 없이 변경이 리뷰됩니다.

위임할 때는 들어맞는 가장 좁은 역할을 고르세요. 평가나 계획에는 읽기 전용 역할을, 실제로 무언가가 바뀌어야 할 때만 executor를 씁니다.

목차