Field notes

How the work is actually done

No listicles, no career-change motivation. Each note takes one piece of the job, shows a finished artifact and says what a reviewer would object to.

Latest notes

Writing an Integration Requirement Without Designing the API

An integration requirement names the fact that crosses, the event, the owner and the failure. Eight crossings in one case, and the design words to strike.

Read →

BPMN for the Path Where Things Go Wrong

Every place a case waits needs an event that can move it. Six waits in a returns case, drawn in BPMN, and four answers the notation forced.

Read →

Business Analyst or Product Owner: Who Owns the Requirement

One requirement cut into lines, and who can change each. The product owner holds the order, the analyst the wording, the rule owners the numbers.

Read →

Discovery Deliverables That Decide Whether Build Starts

One published case read against two public discovery checklists. Which deliverables can stop a build, which only prepare one, and the gap that decides.

Read →

Splitting a User Story Without Losing the Value

One story from a published case, run through nine splitting patterns. Which slices keep the point, which lose it, and what each has to carry.

Read →

Use Case, Sequence, Activity: Which Diagram Answers Which Question

Eleven questions asked of one published case, routed to the UML diagram that can answer each. Seven go to no diagram at all.

Read →

Reading a Data Model to Find the Rules Nobody Wrote Down

The data model a requirements register forces, drawn and read back move by move: eight rules the register never wrote down, and where each one goes.

Read →

Elicitation When Nobody Has Time to Talk to You

A case built with zero stakeholder minutes: what public sources settled, and six open questions sorted by whether silence can answer them.

Read →

Turning Acceptance Criteria Into a UAT Script

A UAT script names who acts, what they do, the result they should see and the acceptance criterion each step proves. One scenario, filled in and blank.

Read →

BRD or SRS: What Changes When Rules Meet a System

BRD vs SRS as one test: swap the system out and see which sentences survive. Run on all 19 rule and criterion lines of one worked case.

Read →

A Requirements Workshop That Ends With a Document

A workshop agenda built backwards from the document cells it must fill, an invite list read off decision rights, and three bins for whatever leaves the room.

Read →

Requirements Governance: Who Approves What, and When

Nine items on a status ladder, four approval gates and ten changes I counted in the case, replayed against a change policy. Reviewed is a rung below approved.

Read →
Planned

Next in the queue: Before the Migration Starts: What the Analyst Must Settle · A Requirements Pattern Library Worth Reusing.