ONEDEV

maestro

sharpdeveye파일 141개

★ 589주당 +8조회 4

무엇인가

Maestro는 에이전트가 작업을 진행하는 절차 자체를 규율 대상으로 삼는 규칙 묶음이다. 프롬프트 구조, 컨텍스트 수집 범위, 도구 선택, 오류 처리, 다중 에이전트 적용 여부, 배포 전 평가 같은 워크플로 설계 결정을 명시적 규칙으로 고정한다.

어떻게 동작하나

구성은 핵심 스킬 하나와 그 아래 7개 도메인 참조 파일, 그리고 25개 명령 정의로 이루어진다. 명령은 슬래시 명령으로 발동하며, 실행 전에 `.maestro.md` 또는 `.maestro/context.md`에 정의된 컨텍스트 수집 프로토콜을 읽어 프로젝트 인식을 확보한다. `/capture`를 실행하면 `.maestro/` 디렉터리가 생성되고 `context.md`, `decisions.jsonl`, `audit.jsonl`, `sessions/` 아래 세션 요약이 누적된다. 모든 명령은 종료 시 다음에 실행할 명령을 권고한다.

무엇과 다른가

프롬프트를 직접 쓰거나 단일 `CLAUDE.md`에 규칙을 몰아넣는 방식과 달리, 분석·수정·확장·유틸리티 계층으로 명령이 분리되어 있고 읽기 전용 진단과 파일 변경 명령이 구분된다. 회피해야 할 패턴을 별도 항목으로 열거하고, 명령 호출마다 소요 시간·토큰·추정 비용을 감사 로그에 남긴다. 정적 파일 대신 MCP 서버로도 노출할 수 있다.

어떻게 쓰나

설치는 `npx skills add sharpdeveye/maestro`로 수행하고, 이후 에이전트에서 `/diagnose`, `/streamline`, `/fortify`, `/refine` 같은 명령을 호출한다. 명령 뒤에 영역 인자를 붙여 범위를 좁힐 수 있고, `/diagnose /calibrate /refine`처럼 여러 명령을 연속 지정해 하나의 흐름으로 실행할 수 있다. 자동 설치가 되지 않으면 `.claude/skills/` 또는 `.cursor/skills/` 디렉터리를 프로젝트 루트로 복사한다.

전제와 한계

Claude Code, Cursor, Gemini CLI, Copilot을 포함한 여러 도구에서 동작한다. 메모리 레이어는 기본 활성화가 아니며 `/capture`를 실행하거나 확장을 사용할 때만 `.maestro/`가 생성된다. 세션 데이터는 기본적으로 gitignore되고 컨텍스트 파일만 버전 관리된다. 비용 추정치는 오차 ±20% 수준으로 추세 파악용이며 청구 금액 산정에는 쓸 수 없다.

관련 논문 1

유사 스킬