rara/agent-ops/skills/common/router.md

공통 스킬 라우터

라우팅 원칙:

• 최우선 방향은 검증 게이트 최소화다. skill routing은 workflow를 연결하는 허가 체인이 아니며 기존 자동 연쇄 게이트도 만들거나 복원하지 않는다.
• 사용자가 요청한 산출물이나 동작에 직접 대응하는 skill 하나를 선택한다.
• project skill을 선택했고 같은 이름의 private skill이 있으면 private skill을 우선한다. private skill 디렉터리 전체를 탐색하지 않는다.
• skill은 다른 skill을 자동 선행 게이트로 호출하지 않는다. 추가 skill은 사용자가 함께 요청했거나 현재 산출물을 만드는 데 직접 필요한 경우에만 사용한다.
• SDD, spec, plan, review, test context, workstate sync는 서로 독립적인 선택적 workflow다.
• Milestone의 상태·구현 잠금·SDD 상태·evidence 형식 때문에 plan이나 구현을 자동 차단하지 않는다. 현재 구현에 꼭 필요한 사용자 결정이나 명시적 외부 의존성만 해당 작업을 보류한다.
• 정합성 확인은 사용자가 요청했을 때 read-only로 수행한다. 확인 결과를 이유로 다른 sync/update workflow를 자동 연쇄 실행하지 않는다.
• 완료 이벤트의 milestone-task나 Roadmap Completion은 정확한 대상 매칭을 돕는 힌트이며, 특정 형식이 없다는 이유만으로 실제 완료 반영을 막지 않는다.

요청 키워드	SKILL.md
agent-ops 세팅해줘, scaffold 만들어줘, 초기화해줘	agent-ops/skills/common/init-agent-ops/SKILL.md
domain rule 만들어줘, rules.md 생성, 새 도메인 규칙	agent-ops/skills/common/create-domain-rule/SKILL.md
skill 만들어줘, SKILL.md 생성, 새 스킬 추가	agent-ops/skills/common/create-skill/SKILL.md
agent-ui 생성, UI 스캐폴드 생성, UI 정의 구조 생성, 화면 정의 구조 생성, agent-ui scaffold	agent-ops/skills/common/create-agent-ui/SKILL.md
agent-ui 갱신, agent-ui 업데이트, view 추가, component 추가, frame 추가, wireframe 추가, 화면 정의 갱신, 화면 정의서 갱신, 화면정의서 수정, 화면 정의서에 추가, 화면 정의서에서 제거, 와이어프레임 수정, 와이어프레임에 추가, wireframe 수정, wireframe에 추가, agent-ui USER_REVIEW 해결, UIR 결정 반영	agent-ops/skills/common/update-agent-ui/SKILL.md
agent-ui 검증, agent-ui validate, UI 정의 정합성 확인, wireframe 정합성 확인, 화면정의서와 wireframe 맞춰, 화면 정의서와 와이어프레임 정합성 확인, 화면정의서와 코드가 안 맞아, UI 스캐폴드 검사	agent-ops/skills/common/validate-agent-ui/SKILL.md
agent-ui와 코드 동기화, agent-ui와 코드 전체 동기화, 화면정의서대로 코드 반영, 화면 정의서 변경사항 구현, wireframe 변경사항 구현, agent-ui 코드 작업 준비, agent-ui 완료 정합화	agent-ops/skills/common/sync-agent-ui/SKILL.md
create-test, 테스트 룰 작성, 테스트 룰 생성, 테스트 규칙 작성, 테스트 규칙 생성, 테스트 환경 생성, 상황별 테스트 문서 생성, 도메인별 테스트 문서 생성, 검증 시나리오별 테스트 문서 생성, test rule 생성, agent-test 생성	agent-ops/skills/common/create-test/SKILL.md
update-test, 테스트 룰 수정, 테스트 룰 갱신, 테스트 규칙 수정, 테스트 규칙 갱신, 테스트 환경 수정, 상황별 테스트 문서 수정, 도메인별 테스트 문서 수정, 검증 시나리오별 테스트 문서 수정, test rule 수정, agent-test 수정, 테스트 컨텍스트 해석, Verification Context 생성	agent-ops/skills/common/update-test/SKILL.md
계약 생성해, 프로젝트 계약 생성해, 프로젝트 계약 생성, contract 생성, agent-contract 생성, 계약 문서 생성, inner 계약 생성, outer 계약 생성	agent-ops/skills/common/create-contract/SKILL.md
계약 업데이트해, 프로젝트 계약 업데이트해, 프로젝트 계약 업데이트, 계약 갱신해, 계약 갱신, 계약 수정, 계약 정리, contract update, agent-contract 갱신, inner 계약 갱신, outer 계약 갱신	agent-ops/skills/common/update-contract/SKILL.md
스펙 생성, 구현 스펙 생성, 현재 구현 문서화, agent-spec 생성, living spec 생성, 완료된 기능 스펙 작성	agent-ops/skills/common/create-spec/SKILL.md
스펙 업데이트, 스펙 갱신, 구현 스펙 갱신, 구현 스펙 업데이트, 완료 기능 스펙 반영, agent-spec 갱신, 스펙 동기화	agent-ops/skills/common/update-spec/SKILL.md
README 작성해줘, README 만들어줘, 프로젝트 설명 문서 만들어줘	agent-ops/skills/common/create-readme/SKILL.md
핸즈오프 남겨, handoff 작성, 인수인계 작성, 다른 세션에서 이어가게 정리, 작업을 이어받도록 기록	agent-ops/skills/common/create-handoff/SKILL.md
로드맵 만들어줘, roadmap 생성, 마일스톤 설계, goal/phase 구조 잡아줘	agent-ops/skills/common/create-roadmap/SKILL.md
현재 마일스톤 정합성 체크해, 특정 마일스톤 정합성 체크해, 마일스톤 시작 전 정합성 확인, plan 전 마일스톤 리프레시, 전체 프로젝트 작업현황과 마일스톤 정합성 확인	agent-ops/skills/common/sync-milestone-workstate/SKILL.md
현 마일스톤과 작업현황 동기화, 현재 마일스톤 작업현황 동기화, 마일스톤 작업현황 동기화, 마일스톤 완료내역 동기화, agent-task 완료를 마일스톤에 반영, complete.log 후보 스캔, milestone-task id별 evidence 집계, 누락된 Roadmap Completion 복구, 파일/git 기준 작업 상태 확인, 작은 작업 완료 반영, 마일스톤 체크박스 재동기화, 로드맵 작업 완료 상태 동기화	agent-ops/skills/common/sync-milestone-workstate/SKILL.md
마일스톤 완료해도 될지 검토해봐, 현 마일스톤 종료 검토, 현재 마일스톤 닫고 다음 마일스톤 지정, 마일스톤 종료해, 마일스톤 완료 검토, 종료 검토	agent-ops/skills/common/complete-milestone/SKILL.md
로드맵 업데이트, roadmap 갱신, 로드맵에 추가, 로드맵 작업 추가, 로드맵 기능 추가, 로드맵 Epic 추가, 로드맵 에픽 추가, 로드맵 Task 추가, 로드맵 태스크 추가, 로드맵 테스크 추가, 로드맵 TODO 추가, 마일스톤에 추가, 마일스톤 추가, 마일스톤 갱신, 마일스톤 아카이브, phase 추가, phase 변경, 페이즈 추가, 페이즈 변경, 현재 마일스톤 변경, 로드맵 한국어 전환, 로드맵 번역	agent-ops/skills/common/update-roadmap/SKILL.md
SDD 작성, SDD 생성, SDD 갱신, SDD 필요 여부, SDD gate 확인, SDD 사용자 리뷰, SDD 잠금 해제, SDD 승인 준비, SDD archive, spec gate, 설계 게이트	agent-ops/skills/common/roadmap-sdd/SKILL.md
이 마일스톤은 X가 끝나야 가능해, A 전까지 B 잠가둬, 잠금 해제 조건은 X야, X 프로젝트 작업 뒤에 현재 마일스톤 진행, 의존성 설정해, 외부 의존 잠금	agent-ops/skills/common/update-roadmap/SKILL.md
roadmap dependency 확인, locks.yaml 판별, 외부 의존 잠금 확인, unlock-ready 판별, 잠금 해제 조건 충족 여부 확인, roadmap-dependency-checker.sh	agent-ops/skills/common/check-roadmap-dependency/SKILL.md
지금 작업이 뭐지?, 현재 작업 분석, 어디까지 했지?, 로드맵상 현 위치, 현재 마일스톤 위치, current 기준 breadcrumb	agent-ops/skills/common/analyze-roadmap-position/SKILL.md
X에 Y 작업 준비해, X 위치에 Y 작업 준비해, 현 마일스톤에 N번째 에픽 작업 시작해, 현 마일스톤에 N번째 에픽까지 작업 시작해, Y 마일스톤에 1,2번째 에픽까지 작업 시작해, 현 마일스톤에 남은 에픽 작업들 시작해, Y 마일스톤에 남은 에픽 작업 시작해	agent-ops/skills/common/prepare-milestone-workspace/SKILL.md
현 마일스톤 Epic 작업 준비해, 마일스톤 Epic 작업 준비해, 이 Epic의 작은 작업은 바로 처리하고 큰 작업은 plan으로 작성해, Epic 작업을 작은 작업과 plan으로 나눠	agent-ops/skills/common/prepare-epic-work-items/SKILL.md
계획 세워줘, 계획 작성해, 계획 만들어줘, 구현 계획, PLAN.md, plan, plan 작성해, plan 만들어줘	agent-ops/skills/common/plan/SKILL.md
현재 plan들 세분화해, 현재 plan 세분화, 기존 plan 더 나눠, task 세분화해, plan 분리해	agent-ops/skills/common/refine-plans/SKILL.md
최종 라우팅, task routing, cloud/local 재평가, lane/G 판단, G 등급 재평가, routed filename 결정	agent-ops/skills/common/finalize-task-routing/SKILL.md
agent-task 작업 실행, agent-task 작업들 실행해, agent-task 무인 실행, task-group dry-run/live pass, blocked retry	agent-ops/skills/common/orchestrate-agent-task-loop/SKILL.md
코드 리뷰해줘, 리뷰 진행해, 리뷰해줘, code review, CODE_REVIEW.md, 리뷰 루프	agent-ops/skills/common/code-review/SKILL.md
커밋해줘, 푸시해줘, commit, push, 반영해줘	agent-ops/skills/common/commit-push/SKILL.md
agent-ops 싱크해, agent-ops 동기화해, agentic-framework에 올려줘, agent-ops를 [프로젝트]로 싱크해	agent-ops/skills/common/sync-push/SKILL.md
agent-ops pull해, agent-ops 가져와, agentic-framework에서 가져와, agent-ops 내려받아	agent-ops/skills/common/sync-pull/SKILL.md
도메인 업데이트, domain rule 갱신, 도메인 검토, domain 스캔	agent-ops/skills/common/update-domain-rule/SKILL.md

세부 라우팅:

• workspace와 Milestone 준비를 함께 요청하면 prepare-milestone-workspace, 한 Epic의 작업 분류를 요청하면 prepare-epic-work-items를 선택한다.
• 기존 plan 분할만 요청하면 refine-plans, 새 plan 작성이나 재작성은 plan, routing 판단만 요청하면 finalize-task-routing을 선택한다.
• 코드 리뷰 요청은 code-review를 선택한다. WARN/FAIL 결과가 나와도 후속 plan이나 routing은 자동 호출하지 않고 결과와 최소 수정 사항만 보고한다.