Notes from the workflow

The Branchpost blog

Posts on developer publishing, AI-assisted content, the GitHub-as-CMS workflow, and what we're learning while building Branchpost.

7 posts tagged “ai
/content *.mdx
monorepo/blog
·Product

Why blog posts belong in your monorepo, not a SaaS dashboard

Content is code-adjacent. It ships with releases, needs review, and benefits from version history. Here's why the dashboard is the wrong surface for AI writing tools, and what changes when drafts arrive as pull requests instead.

BA
Beka A.
6 min read
--- yaml
contract.mdx
·Engineering

Frontmatter as a contract between AI and your CMS

Why the YAML block at the top of every MDX file is the most important interface in an AI content pipeline, and what breaks when you treat it as decoration.

BA
Beka A.
5 min read
diff +/-
review/draft.mdx
·Workflow

How to review an AI-generated draft before you merge it

A code-review mental model, ported to prose. What to read for, what to ignore, and where AI drafts most often fail in ways line-by-line review misses.

BA
Beka A.
6 min read
$ / 1k
tokens.log
·Engineering

The cost shape of an AI content pipeline

Where tokens actually go in a Branchpost generation run, why retries dominate the bill more than people expect, and how prompt caching changes the math.

BA
Beka A.
6 min read
{ repo }
prompt.ctx
·Engineering

Writing prompts that produce code-aware blog drafts

How Branchpost turns repo signals into prompt inputs so drafts reference real files, real commits, and real decisions instead of generic AI filler.

BA
Beka A.
5 min read
{ tone }
style.json
·Product

Publication context: the missing input for AI writing tools

Why 'site type, audience, tone, claims to avoid' matters more than any prompt-engineering trick.

BA
Beka A.
3 min read
∴ slop
field-notes
·Field notes

Notes against AI slop in developer blogs

A practical taxonomy of the patterns we filter out — and the ones that need a human to catch.

BA
Beka A.
3 min read

One post per week. Zero AI slop.

New posts on developer publishing, AI-assisted content, and the GitHub-as-CMS workflow. Unsubscribe with a single click.