The drawing set — index
FN-6 · FIELD NOTE · THE MACHINE · ~8 MIN

Anatomy of EVC.

EVC — THE MACHINE, LAYER BY LAYER
N6.a — The full console, dimensioned: 42 commands, 8 chains, 6 hooks, MIT licensed, three production deployments. Detail B →

Every few weeks someone asks me what EVC "really" is, usually with the polite skepticism of a person who has seen too many AI marketing tools that turn out to be a prompt taped to a subscription. Fair. So here is the unglamorous, complete answer. EVC — Everything Vibe Code — is an open-source agent workspace for Claude Code: forty-two production commands, eight workflow chains, six quality hooks, MIT licensed, currently running three production deployments. There is no app. There is no dashboard with a gradient. It is bash, markdown, and JSON in a folder, and that's not a confession — it's the whole design philosophy. This essay is the anatomy lesson: what each part does, why it exists, and what it means that I give it away.

§1Why it exists: I was the bottleneck

EVC was never a product idea. It was a survival response. I was running multiple client engagements concurrently — each with its own brand voice, its own banned phrases, its own channels — and I noticed the same loops repeating across all of them: scan for what's relevant this week, plan content against it, draft, check it against brand rules, ship, log what happened. Every loop was manual, every loop leaked quality when I was tired, and every loop scaled linearly with my hours. So I started encoding the loops. Each command earned its place by replacing a manual process I was actually running that week — no roadmap, no speculative features, just commits whenever the friction got annoying enough. By the time it was load-bearing across three live deployments, open-sourcing it was the obvious move. More on why later.

The thing that distinguishes an operator framework from a demo is that distinction right there: every piece exists because real work demanded it. Forty-two commands sounds like a feature list until you understand it's actually a fossil record of two years of marketing operations.

§2The anatomy, layer by layer

HUMAN GATES NEVER AUTOMATED QUALITY HOOKS ×6 CANON · SLOP · AUDIT CONTENT ENGINE — 6 STAGES THE PRODUCTION LINE BRAND CANON — THE BASE PLATE SINGLE SOURCE OF TRUTH ① FIRST ASSEMBLY ORDER: CANON BEFORE EVERYTHING — AN ENGINE WITHOUT A CANON IS AN AMPLIFIER WITHOUT AN INPUT
FIG. FN-6 — EVC, EXPLODED VIEWFOUR PLATES · ONE AXIS · CANON FIRST

Commands are markdown files. Each one — /intel-scan, /content-plan, /blog-qa, /client-onboard — is a markdown document describing a procedure: what to load, what to produce, what done looks like. Drop a new file into .claude/commands/ and it exists; no registration, no compile step. This matters more than it sounds. Because commands are plain text, a client's marketing lead can read every single one and understand exactly what the agent will do before it does it. Try auditing a SaaS tool's behavior that way.

Chains are commands composed into pipelines. The eight production chains cover the recurring shapes of marketing work — content production, community ops, BD support, weekly reporting. A chain is just a sequence with defined handoffs: the output of one command is the input contract of the next. The flagship is the content engine, which runs the loop I used to do by hand:

/intel-scan → /content-plan → [HUMAN GATE: you review the plan] → /content-draft → /content-qa → ship
auto · auto · ⊳⊲ stop · auto · auto · out the door

N6.b — Hooks are shell scripts that halt the chain: canon guardrail before tool use, stop-slop after generation. Detail B →

Hooks are the immune system. This is the part most agent setups skip, and it's the part that makes EVC trustworthy enough to run on real brands. Six quality hooks fire on Claude Code's lifecycle events. The canon guardrail runs before tool use and blocks any step that violates the brand rules. The stop-slop hook runs after generation and pattern-matches the signatures of AI writing — the "delve"s, the corporate hedging, the em-dash addiction — and forces a rewrite when it finds them. The crucial property: hooks are not suggestions to the model. They're shell scripts that halt the chain. The model doesn't get to argue. When a check fails, work stops, and that hard stop is the difference between "AI-assisted" and "AI-flavored slop with your logo on it."

The canon is the constitution. Brand rules live in brand/canon-rules.json: USPs, voice rules, banned phrases, tone parameters. Every agent loads it at runtime; the guardrail hook enforces it on every step. Edit the JSON and the entire system updates instantly — every command, every chain, every future draft. This is the load-bearing connection between EVC and the Brand OS methodology I've written about before: the canon isn't documentation that describes the system, it's configuration that is the system. When a client decides a phrase is dead, it dies everywhere, permanently, in one commit.

Human gates are non-negotiable. Every chain has at least one point where the machinery stops and waits for a person. In the content engine, that gate sits between planning and drafting — the human approves what gets made before anything gets made, which is exactly where editorial judgment is cheapest to apply and most expensive to skip. I want to be precise about this, because "human-in-the-loop" has become a checkbox phrase: the gates aren't there because the output is bad. The hooks handle bad output. The gates are there because taste, timing, and strategic judgment are the operator's actual job, and a framework that automates judgment isn't an operator framework — it's a liability with a cron schedule.

The hooks block slop. The gates protect judgment. Confuse the two and you've either built a babysitting job or a liability with a cron schedule.

And the plumbing. Three context modes — content, build, research — switch what tools and references the agent reaches for. An MCP gateway connects to whatever the client already runs: Notion, Slack, Linear, X, GitHub. Persistent memory carries project state and decisions across sessions, so Monday's agent remembers Friday's call. And the whole thing installs from a tracked _templates/ directory through one setup.sh — your local canon merges with new defaults on update, no clobbering. config.env plus token substitution means one setup command and no per-user runtimes. The boring infrastructure is the point: every dependency you don't have is a failure mode you don't debug at 2am before a launch.

§3Why give it away?

EVC is MIT licensed. Fork it, audit it, run it without me, forever. People assume this is either naivety or a funnel trick. It's neither — it's an honest reading of where the value actually sits. The framework is the easy part. Anyone with enough sessions in Claude Code could eventually converge on something similar; the architecture isn't secret, it's just earned. What can't be forked from a repo: the design of your canon — the interviews and judgment calls that turn a brand's instincts into enforceable rules. The custom commands engineered for your team's specific motion. The hook tuning that catches your particular failure modes. The handoff that leaves your team running the system without me. That's the engagement. The repo is the proof that the engagement is real.

Gating the code would slow adoption while protecting nothing that matters. Opening it did the opposite: the framework now lives in Anthropic's Claude Code community, where it gets public review and a feedback loop with a hundred and forty thousand builders. Closed tools get marketing claims; open tools get audits. I know which one I'd rather sell against.

§4What it means that it ships with every engagement

Here's the practical consequence, and the reason this essay belongs on a portfolio site rather than a changelog. When an engagement with me ends, the client keeps a running system: their canon in version control, their commands documented in plain text, their hooks enforcing their rules on every future piece of content — whether or not I'm in the room. The deliverable isn't a strategy document about how content should be made. It's the machine that makes it, with the strategy compiled in.

N6.c — The Fortune 500 decade behind the files: FIAT Chrysler, Nike, Amex, Coca-Cola, GM. See Sheet A4 →

I've been a CMO five times — Autonomys, Telos, Univers, advisory at Oracles Investment Group, after a Fortune 500 agency decade across FIAT Chrysler, Nike, Amex, Coca-Cola, and GM — and the recurring tragedy of marketing leadership is that everything you build walks out the door with you. The calendar decays. The voice drifts. The discipline was in your head, so it leaves with your head. EVC is my answer to that: discipline as files. Files survive personnel. Files can be diffed, audited, reverted, and improved by whoever comes next. If the next era of marketing is operators running systems instead of headcount running tasks — and everything I've shipped in the last two years says it is — then the operators worth hiring are the ones who can show you their system. Mine's at github.com/SaigonXIII/evc. Read the source.

FN-6 · FILED 2026 · P.N. MARGINS HOLD THE CROSS-REFERENCES — BRING THE LIGHT
Back — FN-5
Brand OS, Not Brand Deck
Next — R-1
The Record Room — the operator, on record
Field note
FN-6 — THE MACHINE
Drawing №
PN-2026-FN6
Series
6 OF 6
Status
FILED
© 2026 Peter Nguyen Do not scale — verify metrics on site Master sheet · Book a call