oh-my-agent의 CLI는 7일 동안 v15.10.0에서 v20.0.0까지 총 5개의 메이저 버전을 출시했습니다. 대부분의 버전 업그레이드는 의도적인 파괴적 변경(breaking change)을 포함하며, 호환성 심볼(compatibility shim)을 남기지 않고 이전 경로를 삭제했습니다. 주요 변경 사항과 필요한 대응 방안을 정리합니다.
-
oma-security가 oma-deepsec을 대체: /security가 /deepsec을 대체했습니다. 호환 에이앨리어스(alias)는 없습니다. 소스, 스킬, MCP, 범위를 제한한 웹 런타임 작업을 타겟별 엔진으로 분배하고, 엔진의 증거를 유지합니다. finding을 확정하거나 CI 게이트를 적용할 때는 독립적인 검증이 필수입니다. 소스 스캔의 기본 엔진은 계속 Deepsec입니다. 스킬에는 11개의 리소스 파일이 포함되어 있으며, 그중 하나는 408줄의 finding 계약서입니다.
-
글로벌 데이터 홈 통합: OMA_HOME으로 글로벌 데이터 홈(기본값: ~/.oma)을 지정합니다. 정의(definition), 상태(state), 스케줄(schedule), 백업은 여기에 저장됩니다. 마이그레이션은 복사 우선(copy-first) 방식으로 진행되며, 충돌 검사 및 활성 런타임 검사를 수행합니다. 이전 경로는 런타임의 폴백(fallback)으로 읽어오지 않습니다.
-
AgentMemory 분리: 쓰기(write), 리콜(recall), 재시도(retry), 가져오기(import) 작업은 원래 프로젝트와 프로파일 범위로 제한됩니다. 공유 서버의 응답은 소유자별로 필터링합니다. 설치 및 업데이트 시에는, 프로젝트가 옵트아웃했거나 다른 제공업체를 사용하는 경우를 제외하고 기본 AgentMemory 제공업체가 준비됩니다.
-
에이전트의 판단을 상태 이벤트로 기록 및 검증하도록 변경되었습니다 (b4d76a71). 실행별 선택 사항을 나중에 확인할 수 있습니다.
-
커밋 메시지용 사용자 후크: 관리 대상인 commit-msg 후크는 먼저 .githooks/commit-msg.d/ 내의 모든 실행 파일을 이름 순서로 실행합니다. 종료 코드가 0이 아니면 커밋은 거부됩니다. oma는 이 디렉토리에 쓰지 않기 때문에, commitlint 호출은 oma update 이후에도 남아 있습니다.
-
oma-dev-workflow 튜링 프로파일: Python, JS/TS, Dart/Flutter, Dockerfile, 로컬 commitlint를 지원합니다. 프로젝트 검증 작업을 재사용하기 위한 가이드라인도 추가되었습니다.
-
oma retro --json은 JSON 앞에 배너와 스피너를 출력했습니다. 이제 빈 기간을 포함하여 유효한 JSON 문서만 하나 출력하게 되었습니다.
-
도움말에서 --older-than의 기본값이 90ds로 표시되었으나, 단위는 숫자만 있는 기본값에 한정되었습니다.
-
schedule sync가 필수 필드가 누락된 매니페스트 라인으로 인해 충돌하고 모든 정상 작업이 오래된 상태로 남아있었습니다. 이제 잘못된 라인은 제외하여 보고하며, schedule list에도 해당 라인을 표시합니다.
-
고립된 작업(isolated job) 정리가 AgentMemory나 Serena의 유지보수 같은 내부 서비스에 영향을 미치지 않게 되었습니다. 대상은 에이전트 스케줄 네임스페이스로 제한됩니다.
-
후크의 동시 중복 제거 과정에서, 충돌하는 퍼블리셔가 방금 획득한 클레임을 만료된 것으로 간주하는 경우가 있었습니다. 이제 읽기 후에 시간을 재확인하며, 시계 되감기는 TTL(Time To Live) 범위 내에서만 허용됩니다.
-
독립형 스킬 설치가 참조하는 공유 가이드를 포함하게 되었습니다 (클로즈 #866).
-
고정된 로컬 Serena 브리지를 수정했습니다. 사용자 환경 변수와 서버 옵션은 유지됩니다.
-
design 워크플로우의 라우팅에서 시각적 타겟을 필수화했습니다.
도움말에서 숨겨져 있지만, 실행은 가능합니다. 설명이 없던 25개의 커맨드 그룹에 설명을 추가했습니다. skills matrix는 oma skill matrix로 변경되었으며, 복수형은 거부됩니다. - 문서를 소스에서 생성: CLI 레지스트리는 oma describe에서, 스킬 카탈로그는 SKILL.md의 프런트매터에서 생성합니다. 둘 다 --check 모드에서 오래된 블록을 감지할 수 있습니다. - 문서 사이트에 라우팅(routing), ultrawork, ralph, 설정 해결에 대한 mermaid 다이어그램, 판단표, 용어집이 추가되었습니다. 11개 로케일과 12개의 README 번역도 동기화되었습니다.
- 기술 설명 수정: ralph judge의 설명을 '독립'에서 '프롬프트 기반'으로 변경했습니다. spawn을 검증하는 메커니즘이 없기 때문입니다. 이벤트 로그의 참조처는 고정 경로가 아닌
oma state list를 안내합니다.
이번 주에 840개 파일에 대한 81개의 커밋(+70,280 / -32,120)이 들어왔습니다. 메모리 관련 수정만으로 1,095건의 테스트로 검증했습니다.
- 프로젝트 로컬 상태를 옮기려면
oma state migrate --runtime을 실행해 주세요. 런타임 리더는 더 이상 프로젝트 로컬 상태를 읽어오지 않습니다. - 스크립트나 일상 작업에서 사용하던 /deepsec을 /security로 바꿔주세요.
oma skills matrix를 oma skill matrix로 바꿔주세요.
# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/first-fluke/oh-my-agent/main/cli/install.sh | bash
# Windows (PowerShell)
irm https://raw.githubusercontent.com/first-fluke/oh-my-agent/main/cli/install.ps1 | iex
oh-my-agent는 프롬프트를 작성하는 것 이상으로 오케스트레이션을 수행하는 팀을 위한 것입니다. 다음으로는 ralph judge의 강화가 이루어져, spawn을 프롬프트로 지시할 뿐만 아니라 검증할 수 있게 됩니다.
