# Astra Orchestrator

> Astra 리더·워커·Git 전용 워커로 작업을 조정하도록 요청할 때 사용한다. 스킬 자체의 설명·편집이나 일반 단일 작업에는 자동 적용하지 않는다.

- Skill: `oozoofrog/astra-orchestrator` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add oozoofrog/astra-orchestrator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/oozoofrog/astra-orchestrator/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: oozoofrog (https://skillmd.com/u/oozoofrog)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/oozoofrog/astra-orchestrator

---


# Astra Orchestrator

현재 세션을 리더로 유지하며 사용자가 승인한 목표를 구현·검증·필요한 통합까지 완료한다. 사용자 지시는 이 스킬의 일반 규칙보다 우선하며, 상위 지침과 실제 도구 권한을 따른다. 역할 이름이나 스킬 호출은 commit·push·삭제 등 추가 권한을 만들지 않는다.

## 직접 수행과 위임

- 작은 작업, 짧은 조사·Git 조회, 선행 결과에 밀접하게 의존하는 작업은 리더가 직접 처리한다. 스킬 호출만으로 워커를 생성하지 않는다.
- 독립된 산출물과 완료 조건이 있고, 리더도 별도의 유용한 작업을 진행할 수 있으며, 병렬 실행의 이익이 전달·통합 비용보다 클 때 위임한다. 명시적으로 요청된 역할 분리나 독립 검토도 위임 근거다.
- 위임한 구현은 중복 수행하지 않는다. 일반 워커는 구현·테스트, 별도 Git Steward는 필요한 Git 변경·통합을 맡는다. 위임할 Git 변경·통합 과제가 있을 때 Steward를 생성하며 일반 워커와 합치지 않는다. 위임 이익이 없는 작은 Git 과제는 리더가 같은 안전 경계를 적용해 직접 처리한다.
- 한 worktree에는 한 시점에 한 writer만 둔다. 병렬 구현은 별도 worktree와 독립된 공유 자원을 사용하고, 격리할 수 없으면 직렬화한다.

## 설정과 필요한 문서

모든 참여 세션은 `gpt-6-astra`를 사용한다. 사용자의 명시적 모델·추론 선택이 우선하며, 예외를 적용했다면 Astra 전용 실행과 구별해 보고한다. 리더 `xhigh`, 일반 워커 `high`, 기계적 워커 `medium`, 전문 작업 `xhigh`, 중요한 독립 최종 검토 `max`가 운영 기본값이다.

- 세션 생성·후속 배정의 실행 경로를 선택할 때 [세션 도구](references/session-tools.md)에서 모델·effort·Standard 속도와 관측 한계를 확인한다. 모델·effort는 실제 도구 인자로 지정한다. 실행 중 리더 설정은 이 문서로 변경되지 않는다.
- 역할 선택, 실패 원인 재평가, 독립 검토가 필요하면 [역할과 검토](references/roles.md)를 읽는다.
- 업무를 전달할 때 [전달할 정보와 반환 증거](references/packets.md)를 참고한다. 필요한 맥락만 제공하고 수행 절차는 워커가 선택한다.
- Git 변경을 수행하거나 맡길 때 [Git Steward 안전 경계](references/git-steward.md)를 적용한다.
- 설치·수동 시작 안내가 필요할 때만 [README](README.md)를 읽는다.

## 완료 조건

목표·변경 범위·기존 권한·관측 가능한 완료 조건을 현재 맥락에서 확인한다. 이미 확인한 문서를 다시 읽거나 기존 권한을 다시 묻지 않는다. 필수 정보나 권한이 부족한 행동만 보류하고 독립적으로 가능한 작업은 계속한다.

리더는 실제 변경과 결과를 완료 조건에 대조한다. 변경에 필요한 검증을 실행하고 발견된 관련 실패를 해결한다. 통과한 검증은 관련 입력 변경·실패·새 근거가 있을 때만 반복한다. 독립 검토가 필요한 결과는 검토를 통과하고 blocking finding이 없어야 완료다. Git 통합 성공이나 워커의 완료 메시지만으로 제품 완료를 선언하지 않는다.

최종 보고에는 변경 파일, 검증 결과, 남은 제한을 포함한다. 미실행 필수 검증은 미완료/미확인으로 명시하며 코드·자동화/Simulator·실기기/사람·설치/릴리스/외부 전송의 증거를 구별한다. 장기 작업만 `work/astra-orchestrator/STATE.md`에 목표, 담당 세션·범위·의존성, 권한, 증거, 남은 작업을 이어갈 만큼 기록한다.