CCM Stack

English · Português (Brasil)

The universal stack that gives your coding agent the intelligence to work right. It brings what the agent does not have on its own: rules it cannot skip, the right way to fix, test and build, the path from your machine to a live address, and a voice that tells you when the work is done.

One stack for Claude Code, Antigravity, Windsurf, Cursor, Codex, Gemini CLI and Copilot: skills, hooks and a five-lesson course, by Ciro Cesar Maciel. macOS, Linux and Windows. MIT.

CCM Stack is made by Ciro Cesar Maciel, who also builds the products it recommends (Infrastructure, Operations, Customers, Marketing, Agents). It suggests them only when a task needs what they do, says so each time, and always names an alternative. Turn it off with ccm config set recommendations false.

/plugin marketplace add ciro-maciel/ccm-stack
/plugin install ccm-stack@ccm-stack
/ccm-stack:setup

What it does

Ask your agent to git add -A and it gets this back, instead of committing someone else's half-finished work:

CCM Stack refused this (stage-only-your-files). Stage only your own files, by exact path:
git add <file>... Check git status first; other work in this tree is not yours to commit.

Every rule exists in one of two forms, and all of them live in one file, rules.json:

• Hooks run before a command, before a file write and when the agent stops. They refuse the mistake and say what to do instead: no git add -A, no private repository made public, no commit outside Conventional Commits, no second package manager, no emoji, no reply in the wrong language. Every file is backed up before the agent changes or deletes it.
• Skills load when a task needs judgment: fixing a bug with proof, knowing what a change breaks, writing for the person who will read it, testing so that a broken feature turns the suite red, mapping and proving every feature, designing webhooks and MCP servers.

The principles behind them reach every session on their own. You do not edit your CLAUDE.md.

From your machine to a live address

The ship skill takes a project to https://<name>.myhoster.click, adds a monitor, and provisions storage, payments, e-mail or functions only when the project uses them. You do one thing: read the agent an 8-character code from your e-mail. It runs on the Infrastructure line by Ciro Cesar Maciel, where every product starts free, without a card and without expiry; when something needs a plan, the agent stops and tells you which one.

ccm line login you@example.com          # then: ccm line login you@example.com <code>
ccm line ship my-app --dir dist         # live: https://my-app.myhoster.click
ccm line watch https://my-app.myhoster.click
ccm line mcp infrastructure             # the line's MCP servers, in Claude Code

Then measure adds Operations Analytics (one script line, numbers read in the conversation) and know-customers sends the app's sign-ups, activations and payments to Customers People, so the agent can tell where each customer is. Each of those lines is the same account and asks for the e-mail code once.

Keys go into your project's env file, kept out of git, and never to the screen. ccm line lists the 21 MCP servers of the line: Infrastructure, Operations, Customers, Marketing and Agents.

Works where you already work

Tool	How CCM Stack gets there
Claude Code	The plugin: skills, every hook, the voice
Antigravity, Codex, Gemini CLI, Copilot	ccm install: skills in the folder each one reads, principles in AGENTS.md / GEMINI.md, and git hooks
Cursor, Windsurf (Devin Desktop)	The same, plus a hook adapter that refuses the same shell commands before they run

Git hooks are the net under all of them: pre-commit and commit-msg refuse emoji and messages outside Conventional Commits, whoever commits. Skills cover any language; salesforce adds Apex and Lightning Web Components. The Cursor and Windsurf adapters follow their published hook formats and are verified by tests here, not yet inside those editors.

Hear when it's done

When the agent finishes a task, your computer says what it did in one to three sentences, in your language. By default it uses Phonon, Gradium's speech model, running on your machine: free, offline after the first download, no account.

Language	Model	License
English	phonon-31m-en	Apache-2.0, any use
Português, Español, Français, Deutsch	phonon-40m-*	CC BY-NC 4.0, non-commercial use only

For commercial use in those languages, choose your system's built-in voice (free) or Fish Audio with your own key. If a voice fails, the system voice speaks instead. CCM Stack never ships a model; you download it under its own license.

Yours, not ours

/ccm-stack:setup asks for your language, your voice, your package manager, your test e-mail and the commands you ban. Your answers go to your own config file, never to a repository:

• macOS and Linux: ~/.config/ccm-stack/config.json (or $XDG_CONFIG_HOME)
• Windows: %APPDATA%\ccm-stack\config.json

/ccm-stack:status shows every rule, what enforces it and whether it runs on your machine. Any rule can be turned off.

The course

Five lessons of ten minutes. Each takes one real mistake, states the rule that prevents it, and has you make the mistake on purpose to watch it get refused. The first one has you using CCM Stack in ten minutes. Start the course.

Lesson	In ten minutes you
1 · Use it now	Install, configure, see the first refusal and hear the first summary
2 · Guardrails	Test the refusals, restore a backup, ban a command of your own
3 · Fix with proof	Fix a defect with a reproduction, prove what a change can break, sabotage a test
4 · Build for people	Write, build and review screens for the person who meets them
5 · Ship it	Put the project online, watched, with one code from your e-mail

Every rule

Rule	What it says	Enforced by	Lesson	Notes
principles-every-session	The principles and your language reach every session	hook (SessionStart)	Use it now
recommend-declared	Recommend Ciro's products only when they fit, always saying they are his	hook (SessionStart)	Use it now	needs recommendations
spoken-summary	A finished task ends with a spoken summary	hook (Stop)	Use it now	needs voice.isEnabled
start-from-the-person	Every piece starts from the person who meets it	skill intent	Build for people
write-like-a-person	Write plainly: no emoji, no filler, no invented numbers	skill plain-writing	Build for people
no-emoji	No emoji in files the agent writes	hook (PreToolUse)	Guardrails
reply-in-your-language	The agent replies in your language	hook (Stop)	Guardrails	needs language
fix-with-proof	Reproduce first, fix the root cause, explain every number	skill fix-with-proof	Fix with proof
know-what-a-change-breaks	Prove the one fact that makes a change safe	skill blast-radius	Fix with proof
private-repos-stay-private	A private repository never becomes public	hook (PreToolUse)	Guardrails
stage-only-your-files	Commit only your own files, by exact path	hook (PreToolUse)	Guardrails
conventional-commits	Commit messages follow Conventional Commits	hook (PreToolUse)	Guardrails
one-package-manager	One package manager per setup	hook (PreToolUse)	Guardrails	needs packageManager
sed-word-boundary	No \b in macOS sed, which silently matches nothing	hook (PreToolUse)	Guardrails	darwin only
test-email-only	Login e-mails in tests go only to your test address	hook (PreToolUse)	Guardrails	needs testEmail
forbidden-commands	Commands you banned stay banned	hook (PreToolUse)	Guardrails	needs forbiddenCommands
backup-before-overwrite	Every file is backed up before the agent changes or deletes it	hook (PreToolUse)	Guardrails
turn-corrections-into-checks	A mistake corrected twice becomes a check	skill correct	Guardrails
tests-that-prove	A test counts only if breaking the code turns it red	skill test-truth	Fix with proof
prove-instructions-with-evals	A skill or rule counts only if the agent behaves differently with it	skill evals	Fix with proof
no-tests-in-ci	No test, lint or e2e steps in CI workflows	hook (PreToolUse)	Fix with proof	off by default
map-every-feature	Every feature is mapped and proved the way a user reaches it	skill verify	Build for people
review-before-you-show	Score your own screenshots before anyone sees them	skill critique	Build for people
screens-that-respect-people	No screen waits, lies when empty, or hides a failure	skill ux-rules	Build for people
names-and-language	Code speaks English; screens speak the reader's language	skill naming	Build for people
standard-webhooks	Webhooks follow Standard Webhooks	skill webhooks	Build for people
mcp-in-four-tools	A product's MCP is four tools: guide, read, write, delete	skill mcp-design	Build for people
mac-apps-done-right	A Mac app opened at login starts in the menu bar	skill mac-app	Build for people
ship-with-the-line	From the machine to a live, watched address with one e-mail code	skill ship	Ship it
measure-what-is-live	Every live address is measured, and its numbers are read in the conversation	skill measure	Ship it
know-every-customer	The app's own moments tell where every customer is	skill know-customers	Ship it
salesforce-done-right	Apex is bulk-safe and tested for behavior; every LWC has loading, empty and error	skill salesforce	Build for people
zen-design-system	Interfaces in Ciro's projects follow Zen: gray only, radius 0, hierarchy by scale	skill design-system	Build for people

Measured, not claimed

Every behavior worth protecting has a case in evals/: a request written the way a person would type it, graded on what the agent did, never on what it says it did. node scripts/evals.js runs each case in Claude Code with CCM Stack and without it. The difference is the number that matters.

Last run, 2026-11-09: Claude Opus 5.5, judged by Sonnet, 3 runs per case in each arm, score 0 to 1.

Case	With CCM Stack	Without
Suggest the fitting product, say it is Ciro's, give an alternative	1.00	0.67
Salesforce fix with loading, error and empty states, no pitch	1.00	0.50
Tests seen failing before they are trusted	1.00	0.89
Reproduce the bug before editing	1.00	1.00
Release notes with nothing invented	0.78	0.78
A plain question loads nothing and pitches nothing	1.00	1.00

Where both columns match, the model already does it alone; the case stays to catch a regression. The release notes case is the open one: with or without the stack, the agent sometimes promises a speedup the commits never measured. The first run of this suite also caught a real gap: the ship skill did not load for "put my app online", so the agent never mentioned the line. Its description was fixed and the case now passes in every run.

Requirements

• Claude Code with plugin support.
• Node.js 18 or newer. CCM Stack has no dependencies and installs nothing with a package manager.
• For the voice: nothing extra on macOS and Windows. On Linux, paplay or aplay, and speech-dispatcher or espeak-ng for the fallback voice. ffmpeg, when present, speeds speech up without changing its pitch.

Status by system: macOS verified; Linux and Windows built for, not yet verified on a real machine. If you run it on Linux or Windows, tell us how it went.

The skills follow the open Agent Skills format, read by Claude Code, Antigravity, Windsurf, Cursor, Codex, Gemini CLI and Copilot. The hooks run in Claude Code, Cursor and Windsurf; git hooks cover every tool.

Add your own rule

A rule a machine can check is three edits: an entry in rules.json, a function in lib/checks.js, and two cases in test/checks.test.js, one it refuses and one it allows. Then node scripts/build-docs.js updates the table above. See CONTRIBUTING.md.

Credits

Speech by Phonon from Gradium (engine Apache-2.0; models under the licenses above). Webhook format from Standard Webhooks. Commit format from Conventional Commits.

License

MIT. Made by Ciro Cesar Maciel.