Working Notes on Agent Systems/Brad Zhang

Service note / fixed-scope offer

AI devtool sprint: two weeks on one fragile workflow

A paid, fixed-scope engagement for founders building agent infrastructure, AI IDEs, internal copilots, technical docs, evals, memory, and other developer-facing AI product surfaces. One workflow, one artifact, one handoff.

10 working days · fixed scope · North America

Scope

What the sprint covers

The outcome is a reviewable system surface, not a strategy memo. Each sprint produces three things.

01

Workflow map

A concrete map of the fragile AI/devtool workflow: actors, inputs, tool calls, failure modes, handoffs, and the trust gap blocking adoption.

02

Shipped module or proof surface

A working product surface, internal module, demo path, technical artifact, or documentation layer that makes the workflow easier to trust and reuse.

03

Validation and handoff notes

Examples, edge cases, acceptance checks, and a concise handoff so the team can keep improving the workflow after the sprint.

Fit

When this is the right tool, and when it is not

Good fit

  • You are building agent infrastructure, AI IDEs, internal copilots, evals, memory, docs, or applied AI workflow tooling.
  • The product is technically strong but users, teammates, or buyers still struggle to understand what to trust.
  • A two-week artifact would help you decide whether to continue as contract, design partner, or founding engineer trial.

Not the right sprint

  • You only need generic marketing copy, social content, or a visual refresh.
  • There is no specific workflow, repo, demo, doc, or product surface to inspect.
  • The main problem is model research rather than applied product reliability.

Process

Ten working days, artifact first

A short sprint works when the artifact is concrete from day one. The goal is working evidence the founding team can inspect, ship, or use to decide on a deeper collaboration.

Day 1

Inspect

Review the repo, docs, demo, user flow, examples, and the workflow that currently feels fragile.

Days 2-4

Frame

Define the artifact, quality bar, constraints, user path, examples, and how we will know the workflow is more reliable.

Days 5-9

Ship

Build the module, docs, diagrams, validation layer, product surface, or workflow packaging.

Day 10

Hand off

Review the shipped artifact, capture tradeoffs, and decide whether the next step is another sprint, contract, or deeper founder-engineer fit.

Evidence

How this publication works

AI Devtool Sprint: A Service Note | Working Notes on Agent Systems