Snowflake-Labs/cocoplus

CocoPlus is an Agentic Operating System for Snowflake Coco. It brings structured, multi-agent workflows to data engineering projects — covering everything from project initialization through spec, plan, build, test, review, and ship phases.

CocoPlus란 무엇인가요?

CocoPlus는 Snowflake의 Coco 플랫폼 위에 구축된 에이전트형 운영체제(Agentic Operating System) 입니다. 데이터 엔지니어링 프로젝트를 위한 풀스택, 멀티 에이전트 워크플로 엔진을 추가하여 초기 스펙부터 프로덕션 배포까지 프로젝트를 안내합니다. 이 시스템은 전적으로 Coco 네이티브 구성 요소인 Skills, Agents, Hooks, AGENTS.md 로 만들어져 있어 모든 것이 Snowflake 환경 내에서 실행됩니다.

핵심 아이디어

개념	쉬운 말로 설명하면
Agentic OS	하나의 스크립트가 모든 일을 하는 대신, 데이터 엔지니어링 작업의 일부를 수행하는 여러 특화된 봇(에이전트)을 조정하는 작은 “운영체제”라고 생각하면 됩니다.
구조화된 라이프사이클	모든 프로젝트는 익숙한 단계인 spec → plan → build → test → review → ship 을 따릅니다. 각 게이트에서 시스템은 다음 단계로 넘어가기 전에 적절한 증거, 비용 한도, 거버넌스 규칙이 충족되는지 확인합니다.
동적 페르소나	Data Engineer(`$de`), Data Scientist(`$ds`), Data Steward(`$dst`) 등과 같이 미리 정의된 역할을 즉석에서 인스턴스화할 수 있습니다. 각 페르소나는 자체 스킬 세트와 이력을 가지고 있어 각 하위 작업에 적합한 전문가가 처리합니다.
거버넌스 훅	내장된 안전 정책은 명시적인 허용 목록이 이를 재정의하지 않는 한 위험한 Snowflake 명령(예: 프로덕션에서 `DROP TABLE`)을 차단합니다.
CocoConsole	`$cocoplus console` 로 실행하는 읽기 전용 브라우저 기반 대시보드입니다. 플로우, 비용, 세션 정보, 정책 로그 및 기타 관측 데이터를 보여줍니다.
CocoPilot	선택적 자연어 제어 – `$pilot on`/`off` 로 켜고 끌 수 있으며, 평범한 영어로 높은 수준의 지시를 내릴 수 있습니다.
CocoForge / Leviathan / Ronin	에이전트 팀이 목표를 향해 자율적으로 함께 작업하거나, 진행 상황을 브리핑하는 “개인 비서” 스타일 루프를 실행할 수 있게 하는 상위 수준 오케스트레이션 모드입니다.
CocoWisdom	완료된 세션에서 교훈을 추출하고, 지식을 조회하거나 거부할 수 있게 하며, 에이전트가 학습한 내용을 검색 가능한 로그로 유지하는 메모리 시스템입니다.
CocoFlow	작업을 계획하고, 점수를 매기고, 디스패치하는 엔진입니다. 충돌 감지, 비용 예산 책정, 체크포인팅을 처리하며, 어느 단계에서든 사람의 승인을 위해 일시 중지할 수 있습니다.
CocoRoutine	완료된 플로우를 Snowflake TASK로 전환하여 일정에 따라 실행할 수 있게 합니다.

어떻게 사용하나요

Snowflake Coco CLI(cortex plugin install …)를 통해 플러그인을 설치합니다.
$pod init 로 새 프로젝트를 초기화합니다 – 필요한 폴더 구조와 AGENTS.md 파일이 생성됩니다.
시스템을 켭니다: $cocoplus on.
요구사항을 수집하기 위해 스펙 단계($spec)를 시작합니다. 시스템은 적절한 페르소나 에이전트(예: Data Product Manager)를 생성하여 명확화 질문을 합니다.
단계를 진행합니다($plan, $build, $test, $review, $ship). 각 게이트에서 콘솔은 비용, 증거, 정책 위반 사항을 보여줍니다.
선택적 자연어 오케스트레이션 – $pilot on 을 활성화하고 시스템에 “ETL 파이프라인을 비용에 맞게 최적화해”라고 말합니다. 기반 에이전트가 이를 구체적인 작업으로 변환합니다.
지혜를 검토 – 실행 후 $wisdom get <topic> 을 조회하여 에이전트가 학습한 내용을 확인하거나, $wisdom reject 로 잘못된 조언을 거부할 수 있습니다.
플로우를 주기적으로 실행해야 한다면 $routine 으로 반복 작업을 예약합니다.

누가 혜택을 받나요?

대상	중요한 이유
데이터 엔지니어링 팀	Snowflake 데이터 제품을 구축하고 배포하기 위한 반복 가능하고 감사 가능한 파이프라인을 제공하며, 내장된 비용 및 안전 검사를 갖추고 있습니다.
거버넌스 및 규정 준수 그룹	정책 훅이 위험한 작업을 자동으로 차단하고 모든 결정의 로그를 유지하여 감사를 더 쉽게 만듭니다.
ML/AI 플랫폼 팀	동일한 에이전트 프레임워크를 모델 학습 또는 피처 스토어 워크플로로 확장하여 동일한 안전 및 관측 스택을 재사용할 수 있습니다.
DevOps / SRE	스케줄링(`CocoRoutine`)과 모니터링(`CocoConsole`, `$meter` 명령)은 데이터 파이프라인 상태에 대한 익숙한 운영 관점을 제공합니다.

제한 사항 / 유의할 점

Coco 전용 – Snowflake의 Coco 환경 내에서 실행되므로 cortex CLI와 Coco 플러그인을 지원하는 Snowflake 계정이 필요합니다.
복잡성 – 시스템은 많은 명령($flow, $meter, $adversary, $diary 등)을 정의합니다. 팀이 전체 기능 세트를 도입하려면 학습 곡선이 필요합니다.
안전 정책은 선택 사항 – 기본적으로 자율 반영과 일부 거버넌스 훅은 비활성화되어 있으므로 의도적으로 활성화해야 합니다.
오픈 소스이며 Snowflake의 공식 지원을 받지 않음 – 버그나 누락된 기능은 Snowflake 자체가 아니라 커뮤니티에서 처리합니다.

빠른 시작 치트 시트

# 플러그인 설치
cortex plugin install Snowflake-Labs/cocoplus
cortex plugin enable cocoplus

# 새 프로젝트 생성
$ pod init
$ cocoplus on

# 관측 콘솔 열기(읽기 전용)
$ cocoplus console

# 라이프사이클 실행
$ spec          # 요구사항 수집
$ plan          # 계획 생성
$ build         # ETL / 모델 코드 실행
$ test          # 테스트, 비용 검사 실행
$ review        # 사람 또는 자동 검토
$ ship          # 프로덕션에 배포

# 선택적 자연어 제어
$ pilot on
# 이제 "야간 로드 비용을 20% 줄여줘"와 같은 것을 입력할 수 있습니다

# 반복 실행 예약
$ routine create my_daily_flow

라이선스 및 법적 고지

CocoPlus는 MIT 라이선스로 배포됩니다. 오픈 소스이며, 공식 Snowflake 제품이 아니고, 일반적인 “있는 그대로” 면책 조항이 적용됩니다.

위의 모든 정보는 저장소의 README에서 직접 가져온 것이며, 외부 가정은 추가되지 않았습니다.