The class logbook
The Latest
Everything published on the site, day by day, newest first: guides, analysis, essays and quick thoughts in one running log. The shelves for browsing are elsewhere; this is where you see what is new.
The log
Entries 41–60 of 74
1 entry
1 entry
Test the Build Your Customer Will Receive
A development server passing its tests does not establish that a production bundle behaves the same way.Quick thoughtclaude-codeverification1 entry
Trace One Failed Request Through the Logs
A page can fail after three services have each logged something that looks successful. Start with one request identifier, not the loudest error message.Quick thoughtclaude-codedebugging1 entry
Preview Every Rename Before Moving Files
Renaming two hundred client documents is easy to request and surprisingly hard to undo when two names collapse into one.Quick thoughtclaude-codefile-operations1 entry
Give Claude a Broken Example Before a Fix
A useful bug report contains an input that fails and the result you expected. That gives Claude Code something firmer than “the report looks wrong.” Suppose a…Quick thoughtclaude-codetesting1 entry
Make Claude Preserve the Meaning of a CSV
A customer number such as 00127 is an identifier. Turning it into 127 can break a perfectly tidy spreadsheet export.Quick thoughtclaude-codedata-quality1 entry
Give the Agent an Inspectable Check
You ask if it's done. It says yes. You check, and it isn't. A completion claim needs evidence you can inspect.Quick thoughtclaude-codeverification1 entry
After Repeated Corrections, Rebuild the Task Context
The agent repeats the wrong approach after two corrections. My rule of thumb is to stop adding conversational patches and restate the task from the evidence.Quick thoughtclaude-codecontext1 entry
Test Whether a Shorter CLAUDE.md Helps
Three hundred lines of instructions and it still breaks your conventions. So you add more rules. It gets worse.Quick thoughtclaude-codecontext1 entry
Delegate Discovery With an Evidence Handoff
An authentication investigation can touch dozens of files before identifying the two interfaces that matter.Quick thoughtclaude-codecontext1 entry
Know What Rewind Can Restore
Before a refactor, decide what you would need to restore. Claude Code's rewind can recover tracked edits and conversation state; it cannot undo every effect…Quick thoughtclaude-codepractice1 entry
Use an Interview to Expose Gaps in the Brief
The stakeholder asks for a useful assistant. Before choosing a framework, find out which result they would accept and which mistake they cannot tolerate.Quick thoughtclaude-codepractice1 entry
Put Repeatable Checks in Command Hooks
Your acceptance criteria say the linter must run after an edit. Putting that sentence in the agent's instructions still leaves execution to the model.Quick thoughtclaude-codeverification1 entry
Make Completion Checks Explicit, and Test Their Limits
The session says the feature is complete, but the build is red. A defined completion check gives you better evidence than that summary.Quick thoughtclaude-codeverification1 entry
Give the Reviewer a Fresh View of the Change
The session that wrote your rate limiter has already seen the argument for its design. For a useful second look, give a fresh session the diff, acceptance…Quick thoughtclaude-codeverification1 entry
Triage Review Findings Against the Requirement
A review returns twelve plausible findings. Fixing all twelve can add more complexity than the original feature, especially when some describe states the…Quick thoughtclaude-codeverification1 entry
Budget the Coordination Before Adding a Team
A team is useful when separate investigations or implementations can proceed at the same time. A long dependency chain does not become parallel because you…Quick thoughtclaude-codeeconomics1 entry
Bound Each Run Before Scaling a Migration
A migration across two hundred files needs a task inventory and a way to check every result. One headless run per bounded change can make failures easier to…Quick thoughtclaude-codepractice1 entry
Parameterize the Brief, Verify the Execution
You keep asking for the same issue workflow: read the requirements, locate the change, implement it and run the relevant checks.Quick thoughtclaude-codepractice1 entry
Choose the Subagent Model Against the Task
Finding a filename and explaining a token-refresh failure are different tasks, even if both start by searching the same repository.Quick thoughtclaude-codeeconomicsContinued on the next page.
To browse rather than follow: topics, all articles and all thoughts. To learn in order: courses and the book.
