Notes

One note a day. Read in five minutes, use the same day.

Thirty days of practical notes while the channel launches — from prompting to agents, skills, verification, MCP and production. New note every morning at 07:30 GMT. Examples mostly use Claude Code; the patterns apply to Cursor, Codex, Copilot and any agent that edits your repo.

20 September
Putting it together

Is AI actually helping your team?

Perceived speed is unreliable; baseline lead time, review time, defect escape rate, and rework rate before rollout, then compare, not guess.

4 min →
19 September
Putting it together

Automate one weekly task end to end: a worked example

Pick one recurring task, build it as a pipeline with two verification points, and measure the time it actually saves before trusting it.

5 min →
18 September
MCP and production

Agents that browse and pay: what changes for builders

Agent-specific browser runtimes and the x402 payment protocol let an agent complete a purchase itself — decide up front where a human still has to approve.

5 min →
17 September
MCP and production

Multi-agent patterns that converge (and ones that don't)

Fan-out into a verify gate and a synthesis node converges; two agents revising each other with no stop rule loops forever.

5 min →
16 September
MCP and production

Audit trails for agent actions

Log every tool call, diff, and approval as it happens so an agent session is reviewable later without replaying or trusting memory.

5 min →
15 September
MCP and production

Secrets and agents: what should never reach the prompt

Keep credentials out of prompts and CLAUDE.md; inject short-lived scoped tokens at runtime and deny the agent read access to secret files.

5 min →
14 September
MCP and production

MCP security: tool poisoning and prompt injection

A tool's description and its results reach the model as plain text — validate both, or an untrusted server can quietly redirect an agent's actions.

4 min →
13 September
MCP and production

Build a minimal MCP server in Python

Wrap one existing FastAPI endpoint as an MCP tool in about ten lines using the current mcp package, then register it with claude mcp add.

4 min →
12 September
MCP and production

MCP in plain English

MCP is one protocol so a tool you build once works from Claude Code, Cursor, and Codex without three separate integrations.

4 min →
11 September
Verification is the bottleneck

Keep a mistake log

Every agent failure should become a CLAUDE.md line, a hook, or a test — the classification decides which, and none of the three is optional forever.

4 min →
10 September
Verification is the bottleneck

What an agent should never be allowed to do

Sort agent actions into always, ask, and never rings by blast radius, not by how often they happen — and contain the rest in a sandbox.

4 min →
9 September
Verification is the bottleneck

Reading the bill: the economics of one agent task

One hour of Claude Opus 5 agent work on the same tokens runs $0.71 uncached or $0.53 cached — caching shrinks the input line, not the output.

4 min →
8 September
Verification is the bottleneck

Bounded autonomy: loops with stop criteria

A run-until-green loop needs three exits, not one — done, out of budget, and out of iterations — or it will eventually run past all three unnoticed.

5 min →
7 September
Verification is the bottleneck

The strict reviewer: a prompt that finds real issues

A code-review prompt that asks for severity, a failing input, and a fix produces findings you can act on; one that asks for feedback produces compliments.

5 min →
6 September
Verification is the bottleneck

Tests an agent cannot game

An agent under pressure to go green will edit the test before it fixes the bug unless the test is built so that editing it doesn't help.

4 min →
5 September
Verification is the bottleneck

Verification is the bottleneck, not generation

Agents made writing code fast; they didn't make checking it fast, so that's where your time and process now need to go.

4 min →
4 September
Skills beat prompts

Onboard the agent like a senior hire

The questions you'd answer for a new engineer on day one map directly to files an agent reads — write them down once instead of repeating them in every prompt.

5 min →
3 September
Skills beat prompts

Why long agent sessions degrade, and what to do about it

Context doesn't get smarter as it fills up: stale output crowds out live instructions, so split tasks and reset sessions instead of pushing through.

5 min →
2 September
Skills beat prompts

Sharing and versioning skills across repos

Skills live at personal, project, or enterprise level; share them across repos with a plugin marketplace, pin versions, and review changes like code.

4 min →
1 September
Skills beat prompts

Five skills every backend team should have by Friday

Five short SKILL.md files — review, test, explain, release, migrate — cover most of a backend team's recurring judgment calls.

4 min →
31 August
Skills beat prompts

Prompt, skill, hook, or MCP server?

Match the mechanism to the need: one-off gets a prompt, repeatable judgment gets a skill, must-always-happen gets a hook, external access gets MCP.

5 min →
30 August
Skills beat prompts

Anatomy of a SKILL.md

A SKILL.md is two required fields, a body of procedural instructions, and optional files loaded only when the agent actually needs them.

4 min →
29 August
Skills beat prompts

Prompts are disposable. Skills compound.

A prompt in chat history dies with the conversation; a skill saved to the repo gets better every time someone edits it.

4 min →
28 August
From prompting to agents

How to read an agentic benchmark

Chat benchmarks score one answer; agentic benchmarks score a whole trajectory of tool calls and recoveries — read them differently.

5 min →
27 August
From prompting to agents

Which model for which job: a routing rule that cuts the bill

Route by task shape, not habit: cheap-tier for mechanical work, daily-tier for most coding, frontier-tier only for hard judgment calls.

5 min →
26 August
From prompting to agents

One does, one checks: subagents as a reviewer

Give a second, fresh-context agent only the diff and a checklist — it catches what the builder agent is too invested to see.

4 min →
25 August
From prompting to agents

Fix the root cause, not the test: a definition of done

"Make the tests pass" and "fix the bug" are different instructions — write stop criteria that make the difference explicit.

5 min →
24 August
From prompting to agents

Hooks: verification as a loop, not a step

A PostToolUse hook that runs tests after every edit turns verification into something that happens automatically, not something you remember to ask for.

4 min →
23 August
From prompting to agents

Write a CLAUDE.md the agent actually uses

Put in what code can't say — commands, done criteria, and never-do rules. Leave out anything the agent can read for itself.

4 min →
22 August
From prompting to agents

What an AI agent actually is (and what it isn't)

An agent is chat plus three properties: it knows your project, checks its own work, and keeps going without you.

5 min →