The Quick Picture
What it is: A plugin for Coco CLI that adds lifecycle structure, specialist agents, persistent memory, safety protection, and continuous learning to your Snowflake development workflow.
What it runs on: Four Coco-native pillars — Rules, Agents, Skills, Hooks — and a file-based state store in .cocoplus/. No external services.
What it believes: Structure enables speed. Specialists outperform generalists. Hard gates protect irreversible operations. Institutional memory compounds. Token economics are architecture.
How to install: npx skills add https://github.com/Snowflake-Labs/cocoplus
How to start: /pod init in your project directory. Then /cocoplus on. Then /spec to begin work.
Documentation
Start Here
Getting Started
From zero to a fully initialized CocoPlus project in under ten minutes. Prerequisites,
/pod init, /cocoplus on, and your first /spec.If You're a Data Engineer
Data Context
Why data projects need different orchestration than software projects. How CocoPlus specifically extends Coco. The ideology of deterministic execution in a probabilistic domain.
Mental Models
Core Concepts
Seven foundational ideas — the lifecycle, CocoFlow, the persona system, three-layer memory, the Safety Gate, CocoCupper and CocoGrove, token economics, and CocoPod.
How It's Built
Architecture
Four pillars, one coherent system. Rules, Agents, Skills, and Hooks working together through a shared file-based state store. Includes a complete lifecycle walkthrough.
What It Does
All 19 Features
Every feature in plain language — what it does, what commands it exposes, why it exists, and when to use it. Includes SecondEye, the multi-model plan critic.
Real-World Usage
Workflows
Nine scenarios showing how someone with professional intent uses CocoPlus — full lifecycle builds, parallel CocoHarvest runs, SecondEye critique, safety gate handling, and more.
Every Command
Command Reference
Complete reference for all CocoPlus commands organized by feature — flags, behavior, and expected output. Includes the hooks reference table.
The Philosophy
Design Principles
Twelve design principles with the reasoning behind each. Not rules to memorize — a compass for making decisions that aren't in the documentation.
The Why
Manifesto
Why CocoPlus exists. The problem it solves. What it believes. The central argument that AI-assisted development fails not from AI incapability, but from lack of structure.
Feature Overview
| # | Name | Purpose | Key Commands |
|---|---|---|---|
| 1 | CocoBrew | Lifecycle engine (Spec→Plan→Build→Test→Review→Ship) | /spec /plan /build /ship |
| 2 | CocoSpark | Optional divergent brainstorm mode | /spark /spark-off |
| 3 | CocoHarvest | Task decomposition and parallel agent spawner | Auto + $<persona> |
| 4 | Personas | 8 specialist agents with locked domains and tools | $de $ae $ds $cdo … |
| 5 | CocoPod | Project bundle and persistent state store | /pod init /pod status /pod resume |
| 6 | Execution Engine | CocoFlow pipeline executor | /flow run /flow status |
| 7 | Memory Engine | Cross-session three-layer persistence | /memory on /memory off |
| 8 | Environment Inspector | Pre-action Snowflake schema scan | /inspect /inspector on |
| 9 | Safety Gate | Hard + soft protection for destructive operations | /safety strict /safety normal |
| 10 | Code Quality Advisor | Snowflake-specific anti-pattern review | /quality run /quality on |
| 11 | Prompt Studio | Structured Cortex AI prompt engineering | /prompt new /prompt compare |
| 12 | CocoGrove | Curated pattern library and skill promoter | /patterns view /patterns promote |
| 13 | Doc Engine | Auto-documentation from code artifacts | /doc run |
| 14 | Context Mode | Narrated transparency of system actions | /context on /context off |
| 15 | CocoMeter | Token tracking and pre-flight cost estimation | /meter /meter estimate |
| 16 | CocoCupper | Post-execution background intelligence analyst | /cup /cup history |
| 17 | Assist Mode | Master toggle for all mode-based features | /cocoplus on /cocoplus off |
| 18 | CocoFleet | Multi-process OS-level Coco orchestration | /fleet init /fleet run |
| 19 | SecondEye | Multi-model plan critic — parallel Haiku/Sonnet/Opus critique | /secondeye /secondeye acknowledge |