The Product Architect

A digital field book by Joost van der Zwan

Designing Software Behavior in the Age of AI

Learn to specify what an AI-assisted product notices, suggests, acts on, explains, remembers, and hands back.

Joost van der Zwan, photographed against a painted brick wall
Joost van der ZwanAuthor and product builderAbout Joost

One framework from the book

Negotiated Software Loop

Describes the new contract between user and machine in probabilistic systems: intent, interpretation, suggestion, review, correction, adaptation.

  • Observed
  • Interpretation
  • Proposal
  • Human decision
  • Completed
The loop runs intent, interpretation, suggestion, review, correction, adaptation, and then returns to intent. Review and correction are the reader's own decisions; adaptation is what the system changes as a result.

Open the framework

What the screen hides

Surface → behavior

What the user sees

Interface

Copy, layout, buttons, forms, feedback, and the visible promise of the product.

What the product decides

08 hidden decisions
  1. 01State

    What changed, and what stays true now?

  2. 02Memory

    What should the product remember or forget?

  3. 03Permissions

    Who can act, see, approve, or override?

  4. 04Timing

    When should the system interrupt, wait, or hand back?

  5. 05Confidence

    How certain is the system before it acts?

  6. 06Orchestration

    Which tools, people, and steps are coordinated?

  7. 07Recovery

    What happens when the system is wrong?

  8. 08Visibility

    What must be explained instead of hidden?

The book teaches you to design the behavioral system behind the interface.

One behavior

An invoice can look clean before the product has earned that claim.

The extracted fields look plausible. The purchase order names a different supplier. New bank details cross company policy. The product still has to decide whether to prepare, route, hold back, or act.

The short experiment separates evidence quality, measured reliability, permission, consequence, and recovery—the decisions a polished summary can hide.

Inspect the invoice review experiment

The reader mirror

This is for the builder who reads the system through the screen.

  1. You can see the product decision inside a workflow before anyone names it.

  2. You care about what the system should notice, remember, refuse, and recover from.

  3. You care about the screen because it reveals what the system permits.

The arc

Six stages. Fourteen chapters. A path the reader earns one stage at a time.

The book is built as an emotional arc, not a flat list. Each stage earns the next. Land in the stage you’re standing in, or read from recognition through commitment.

The journey

A complete reading path, with a private record of what changes as you move through it.

Read linearly when you want the full argument. Return through the Workbook for the reflections you have saved. Carry the Field Kit when the work moves outside the chapter.

Author and practice

The work connects product judgment to the system a team can build.

If you are shaping workflow-heavy B2B software and the hard question is how the product should behave, write to Joost or inspect the evidence behind this project.