agy

maestro:agy

AGY CLI 호출의 canonical 단일 진입점입니다. /mst:gemini는 한 릴리스 동안 deprecated compatibility wrapper로만 유지합니다.

AGY Identity Protection Contract

• command_identity: mst:agy
• /mst:agy 호출은 path rules상 /mst:plan, /mst:request, built-in plan mode 후보로 재분류하지 않습니다.
• /mst:agy 구현, /mst:agy 수정, /mst:agy 계획 같은 구현/수정/계획형 입력도 mst:agy command identity를 유지합니다.
• model resolve는 provider agy의 configured default tier를 사용하되, AGY CLI argv에는 --model을 기본 전달하지 않습니다.
• trace label은 호출자가 전달한 --trace {REQ-ID}/{TASK-NUM}/{label} 값을 유지합니다.
• Codex parity baseline: DOD-003 context contract, forbidden marker contract, exit-code behavior, prompt-file path handling을 /mst:codex와 동등하게 유지합니다.

Delegation Failure and Fallback Contract

• context file path와 prompt-file path는 실행 전 직접 inspection 대상으로 남기고, output contract에는 worktree path, running log path, trace label, evidence path, evidence id를 포함합니다.
• verification criteria는 verify_cmd, expected_signal, final exit code, structured failure_kind를 함께 기록합니다.
• structured failure_kind 값은 rate_limit, timeout, empty_result, nonzero_exit로 구분합니다. 429/rate-limit/quota 신호는 rate_limit으로 분류합니다.
• Codex fallback 조건은 agy-dev -> codex fallback 정책에 맞춰 failure_kind, exit code, log/evidence path가 존재할 때만 충족됩니다.

DOD-003 Context Transfer Contract

이 entrypoint는 구현/분석 위임 시 prompt-file path와 context file path를 먼저 전달하는 wrapper-owned lifecycle boundary입니다. --prompt-file이 있으면 prompt-file path가 canonical prompt source이며, wrapper는 prompt source tracking과 함께 worktree path, task id, trace label, running log, exit code propagation을 공통 lifecycle evidence로 남깁니다.

실행 프로토콜

1. 프롬프트/옵션 파싱
2. --prompt-file 있으면 파일 우선, 없으면 인라인 prompt 사용
3. --dir 지정 시 디렉토리 존재 확인
4. --files 패턴으로 파일 목록 확인; 매칭 없으면 경고
5. --trace 모드 판별
6. 기본 모델 메타데이터:

   MODEL=$(python3 {PLUGIN_ROOT}/scripts/mst.py resolve-model agy default 2>/dev/null || echo "agy-default")
   

7. AGY CLI 실행:

   python3 {PLUGIN_ROOT}/scripts/mst.py run \
     --task-id "{task_id}" \
     --provider agy \
     --model "$MODEL" \
     --log-dir "{task_dir}" \
     --require-worktree \
     --worktree-dir "{working_dir}" \
     -- agy --print "$(cat {prompt_file})" --dangerously-skip-permissions --add-dir "{working_dir}"
   

8. --trace 모드에서는 traces/agy-{label}-{ts}.md 파일 생성을 기대하고, 부모 컨텍스트에는 요약과 exit code만 반환합니다.

이 스킬은 NEXT_ACTION, step=returned, [MST skill=...] 마커를 출력하지 않습니다.

옵션

• --prompt-file {path}: 파일에서 프롬프트 읽기
• --dir {path}: 작업 디렉토리 지정
• --files {pattern}: 컨텍스트에 포함할 파일 패턴
• -y: 자동 승인 모드
• --trace {REQ/TASK/label}: Trace 문서 자동 생성

예시

/mst:agy "전체 코드베이스 문서 생성해줘"
/mst:agy --prompt-file {prompt_path} --files src/**/*.ts --trace REQ-001/01/phase1-analysis

주의사항

• AGY CLI 필수 (agy --version)
• all-approve 동작은 --dangerously-skip-permissions로 고정합니다.
• AGY CLI help에 --model이 없으므로 모델 값은 lifecycle metadata로만 보존합니다.