My Deployment Pipeline: Claude Code → GitHub → Vercel

Dec 1, 2025

aidevworkflow

I use a fully AI-assisted publishing workflow to run this site. Here’s how a thought goes from my head to production in under a minute.

The Stack

Claude Code → GitHub → Vercel → ai.cccx.ch

How It Works

1. Claude Code (Writing & Development)

I use Claude Code, Anthropic’s CLI for Claude, as my primary interface. When I have an idea:

I describe what I want to write about
Claude creates the markdown file with proper frontmatter
It handles the git workflow: staging, committing, pushing

No text editor needed. No manual git commands. I just talk to Claude and it does the rest.

2. GitHub (Version Control)

Claude pushes commits to a GitHub repository. This serves as:

Source of truth for all content
Version history for every change
Trigger for automated deployments

Every push to the main branch kicks off the next step automatically.

3. Vercel (Build & Deploy)

Vercel watches the GitHub repo. When new commits arrive:

Vercel pulls the latest code
Runs npm run build (Astro compiles markdown to static HTML)
Deploys to the CDN edge network
Updates ai.cccx.ch globally

The whole build takes ~30 seconds. Zero configuration needed after initial setup.

Why This Works

Speed: Idea to published post in under a minute. No context switching between apps.

Simplicity: I don’t maintain servers, databases, or CMS dashboards. Just markdown files in a git repo.

AI-native: Claude understands the project structure (via CLAUDE.md), follows conventions automatically, and handles all the ceremony I’d rather skip.

Reversible: Everything is in git. Bad post? Revert. Typo? Quick fix and push again.

The Mental Model

Think of Claude Code as a developer who:

Knows my project inside out
Writes exactly what I describe
Handles all the git/deployment plumbing
Never complains about “just one more small change”

I provide the ideas. Claude provides the execution. Vercel provides the infrastructure. The result: a frictionless path from thought to published content.