co-agent 명령

5개의 슬래시 명령으로 패널 설정, AI 컨텍스트 동기화, 자율 구현 파이프라인, 패널 준비도 확인을 지원합니다.

/co-agent:configure

push_gate · pr_autofix (설정 추가분)

/co-agent:configure set push_gate enabled on     # 기본 off — 푸시 전 3-렌즈 패널 리뷰
/co-agent:configure set push_gate block warning  # BLOCK 판정 임계
/co-agent:configure set push_gate timeout 300
/co-agent:configure set pr_autofix max_iterations 5   # pr-autofix 루프 상한 (기본 5)

push_gate.enabled는 동의 게이팅 설정입니다 — 켜는 순간 푸시될 diff가 패널 AI CLI로 전송되므로 기본값은 off이고, 커밋된 .claude/co-agent.local.json의 값은 무시됩니다 (pr_gate.enabled도 동일). 판정은 BLOCK한 렌즈 수 기준입니다: 2개 이상이면 BLOCKED, 정확히 1개면 CHAIR JUDGMENT REQUIRED. 게이트가 서술할 수 없는 푸시 형태 (--all/--tags/--mirror, 명시적 refspec, 다른 repo/워크트리 리다이렉트, ref 삭제, 선행 cd/git commit)는 fail-open으로 SKIP되며, kiro의 review.on_push와 같은 스킵 규칙을 공유합니다. 한 번만 우회할 때는 인라인 CO_AGENT_PUSH_GATE=off git push ....

호스트 인지형 멀티-AI 패널을 설정합니다. 설정은 co-agent.defaults.json(커밋) ← ~/.claude/co-agent.user.json(유저 스코프) ← .claude/co-agent.local.json(레포 로컬, gitignore) 레이어로 병합됩니다.

/co-agent:configure show                             # 현재 설정 보기
/co-agent:configure set codex model gpt-5-codex
/co-agent:configure set codex effort high             # effort는 Codex 전용
/co-agent:configure set kiro-cli model claude-opus-4.8
/co-agent:configure set agy enabled false             # 패널에서 제외
/co-agent:configure set timeout 300                   # CLI별 타임아웃(초)
/co-agent:configure set codex context_limit 400000    # 모델 컨텍스트 윈도 조정
/co-agent:configure set autosync on                   # CLAUDE.md 변경 시 자동 sync-context
/co-agent:configure set codex model openai.gpt-5.6-sol --scope user  # 모든 레포에 적용

CLI가 헤드리스로 실제 받는 옵션만 노출합니다(죽은 설정 없음): model, effort(Codex 전용), enabled, timeout, context_limit, 글로벌 autosync. --host codex로 호스트가 Codex일 때의 패널 구성(Kiro/Claude/Agy)도 설정할 수 있습니다.

/co-agent:sync-context

CLAUDE.md를 한 번만 증류해 AGENTS.md를 생성하고, Kiro 스티어링을 이 같은 파일에 연결합니다. Agy는 자동로드가 없어 fan-out 시점에 컨텍스트로 fold-in됩니다.

/co-agent:sync-context

생성 마커(claude-md-sha)로 staleness를 추적하고, 마커 없는 수기 파일(AGENTS.override.md 포함)은 절대 덮어쓰지 않습니다. check_ai_context.py가 마커·크기 캡(~32 KiB)·staleness·시크릿 스캔을 검증합니다.

/co-agent:consensus

cross-family 멀티모델 합의 게이트가 걸린 자율 doc→plan→구현 파이프라인. host(Claude/Codex) 자신이 TDD로 구현하고 패널은 리뷰만 합니다.

/co-agent:consensus plan <doc...>       # P0–P2: 입력 감지 → plan 로드/생성 → 패널 게이트
/co-agent:consensus review [diff base]  # 팬아웃 리뷰 게이트만 단독 실행
/co-agent:consensus implement <plan>    # P3: 리뷰된 plan을 자율 구현(TDD 루프, 멀티모델 게이트)
/co-agent:consensus                     # 기본값: 전체 P0→P5 파이프라인, resumable

플래그: --deep(각 AI의 전체 모델 리스트로 게이트 실행), --trust-plan(plan이 이미 리뷰됐다면 P2 게이트 스킵). 라운드/호출 한도는 consensus.max_rounds/consensus.max_calls 설정을 따릅니다.

로컬 커밋만 수행(push/reset/rebase 없음). non-degraded — gate-eligible peer가 0이면 solo로 강등하지 않고 멈춰서 /co-agent:setup을 안내합니다.

/co-agent:harness

host-designs / peer-implements / panel-reviews 오케스트레이터. host가 설계·실패 테스트·검증을 담당하고 모든 커밋의 유일한 주체입니다. 크로스벤더 peer(Codex 또는 Agy)가 격리된 git worktree 안에서만 코드를 작성합니다.

/co-agent:harness <adr|spec|plan|task>  [--implementer codex|agy]

신뢰 경계: host는 peer worktree에서 git add -A && git diff --cached로 캡처한 diff만 적용 — worktree 밖 쓰기는 절대 메인 트리에 반영되지 않습니다. 캡처된 각 경로는 scope_guard.py로 plan 범위를 벗어나지 않는지 검증됩니다. Opt-in, 로컬 커밋만.

consensus vs harness: 둘 다 같은 패널 게이트를 재사용하지만 누가 코드를 쓰는가가 다릅니다. consensus는 host 자신이 메인 트리에 직접 쓰고 패널은 리뷰만; harness는 크로스벤더 peer가 격리 worktree에서 쓰고 host는 검증된 diff만 적용합니다.

/co-agent:setup

패널 준비도 preflight. 각 peer의 접근경로를 plugin → raw CLI → none 순으로 감지하고, 접근 가능한 peer는 실제로 짧은 프롬프트를 보내 헤드리스 usability를 프로브합니다.

/co-agent:setup

결과(READY / AUTH / NO_INGEST / TIMEOUT / ERROR / ABSENT)를 .claude/co-agent-panel.local.json에 기록합니다. review/decide/adr은 이 결과가 없어도 solo로 강등되지만, /co-agent:consensus·/co-agent:harness는 gate-eligible peer(status==READY and raw CLI 보유)가 0이면 이 명령을 먼저 실행하도록 안내합니다. 인증 문제는 가이드만 제공하며 자동으로 로그인을 시도하지 않습니다.

/co-agent:pr-autofix

PR 생성 후 AI 리뷰와 사람 리뷰 피드백을 자동으로 읽고 코드를 수정합니다. 반복 상한은 /co-agent:configure set pr_autofix max_iterations <n> 설정값(기본 5)입니다.

/co-agent:pr-autofix

워크플로우:

현재 브랜치의 PR을 자동 감지
AI 리뷰 코멘트()와 사람 리뷰(CHANGES_REQUESTED) 동시 polling
이슈 발견 시 CRITICAL → MAJOR → MINOR 순으로 수정
빌드 검증 후 커밋 & push
설정된 반복 상한에 도달해도 통과 못하면 사용자에게 수동 리뷰 요청

제약:

.github/workflows/* 파일 수정 금지
리뷰에서 언급된 이슈만 수정 (추가 리팩토링 금지)
AI 리뷰를 사용하려면 프로젝트에 pr-review.yml CI 워크플로우 설정 필요

/co-agent:configure​

push_gate · pr_autofix (설정 추가분)​

/co-agent:sync-context​

/co-agent:consensus​

/co-agent:harness​

/co-agent:setup​

/co-agent:pr-autofix​