Professional Agentic Product Engineering

Chapter

All tips — the complete index

Every tip in the guide — all 60, grouped by tier and numbered T.N (tier · index). Each links to its full Instead → Prefer pair on the tier page.

T1 — Professional Prompting

  • Tip 1.1 — Hand over the outcome, not a file list
  • Tip 1.2 — Be specific — vagueness is now taken literally
  • Tip 1.3 — Say what to do, not what to avoid
  • Tip 1.4 — Give the reason; motivation makes it generalize
  • Tip 1.5 — Specify the output shape, not just the goal
  • Tip 1.6 — Show examples instead of describing style
  • Tip 1.7 — Follow the house style, don't invent one
  • Tip 1.8 — Show, don't tell — use the input channels
  • Tip 1.9 — Invite uncertainty instead of forcing an answer
  • Tip 1.10 — Paste raw errors, don't paraphrase them
  • Tip 1.11 — Constrain scope — over-engineering is a frontier-model failure mode
  • Tip 1.12 — Narrow the edit surface — a small diff is a reviewable diff
  • Tip 1.13 — Dial effort; don't beg for thoroughness
  • Tip 1.14 — Front-load turn 1 instead of hand-holding across many

T2 — Shaping & Slicing

  • Tip 2.1 — Investigate before you edit — a wrong mental model wrecks the diff
  • Tip 2.2 — Plan the uncertain; skip the plan for the trivial
  • Tip 2.3 — Force an approval checkpoint and see what it will touch — nothing irreversible runs unseen
  • Tip 2.4 — Ask for options, not the first idea
  • Tip 2.5 — Slice vertically — thin end-to-end increments, not horizontal layers
  • Tip 2.6 — Turn big features into a spec, then a fresh session
  • Tip 2.7 — Plan with the smart model, build with the cheap one
  • Tip 2.8 — Have one agent draft the spec and a different one critique it — before any code

T3 — Context Management

  • Tip 3.1 — Feed high-signal context, not the whole repo
  • Tip 3.2 — Keep secrets out of git and out of context — set this up first
  • Tip 3.3 — /clear between tasks; reset after repeated failure
  • Tip 3.4 — Steer compaction, don't run it blind
  • Tip 3.5 — CLAUDE.md = gotchas + conventions, not an encyclopedia
  • Tip 3.6 — Put occasional knowledge in Skills — loaded only when the task matches
  • Tip 3.7 — Add the right MCP servers; keep the surface small
  • Tip 3.8 — Use external memory for multi-session work — compaction won't carry decisions across sessions

T4 — Loop Until Done

  • Tip 4.1 — Make your Definition of Done executable — a command is what the loop converges to
  • Tip 4.2 — Do TDD — the unit-level check
  • Tip 4.3 — Use BDD — the behavior-level check
  • Tip 4.4 — Test the UI for real with Playwright MCP — don't eyeball it
  • Tip 4.5 — Demand evidence, not a claim of success
  • Tip 4.6 — Ask for all findings, not a conservative review
  • Tip 4.7 — Review with fresh eyes, not the context that wrote it
  • Tip 4.8 — Run a pre-mortem; treat it like a teammate
  • Tip 4.9 — Iterate UI visually when there's no spec to assert

T5 — Checkpointing & Hardening

  • Tip 5.1 — Commit every working step — checkpoints are what make a loop safe
  • Tip 5.2 — Let Claude drive gh — the collaboration layer is harness too
  • Tip 5.3 — Use worktrees for parallel agents — separate dirs, no clobbering
  • Tip 5.4 — Replace "remember to run tests" with a hook
  • Tip 5.5 — Move repetitive engineering into CI / headless — run it without you in the seat

T6 — Orchestration

  • Tip 6.1 — Let it self-orchestrate big, parallel work — it fans out faster than you can by hand
  • Tip 6.2 — Use subagents to isolate context
  • Tip 6.3 — Race several agents on the same task; keep the winner
  • Tip 6.4 — Decompose complex builds into specialist roles — narrow context per role beats one big pass
  • Tip 6.5 — Engineer the long-horizon hand-off — so the next session doesn't guess
  • Tip 6.6 — Steer long runs mid-flight instead of restarting them
  • Tip 6.7 — Engineer the environment, not the wording

T7 — Fleet Ops

  • Tip 7.1 — Manage parallel agents in an agent-aware terminal — so you see which one is blocked
  • Tip 7.2 — Isolate parallel agents with worktrees + one session each
  • Tip 7.3 — Host long runs on a box that doesn't sleep; persist with tmux
  • Tip 7.4 — Drive the fleet from your phone — clear blockers from anywhere
  • Tip 7.5 — Secure the agent server like production

T8 — Agent Execution Layer

  • Tip 8.1 — Sandbox the loop; never run autonomous agents on a dev box or prod
  • Tip 8.2 — Gate the plan, not every keystroke
  • Tip 8.3 — Cap the strikes — a stuck agent shouldn't burn tokens forever
  • Tip 8.4 — Make the tracker the state machine — the agent forgets; the board remembers