Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Roles: Architect, Author, Reviewer

An agent-assisted workflow has three roles, and the agent only fills one of them:

RoleWhoMain artifact
ArchitectYouTypes, signatures, module boundaries, the spec
AuthorThe agentFunction bodies, boilerplate, first-draft tests
ReviewerYouThe verdict, and the next prompt

Two things fall out of that:

  • Design happens before generation, in types. You specify the architecture in structs, enums, function signatures, and trait signatures, and the compiler enforces it while the agent fills in bodies. A review can catch problems in the bodies, but it can’t add a design that was never made.
  • A review finding is complete when it becomes a prompt. “This is wrong” isn’t actionable on its own. “This violates principle P, regenerate with instruction Q” can actually be acted on. The course teaches each pattern in that form: smell, then principle, then prompt.

Rust is a good fit for this workflow because the architect’s intent gets machine-checked. Put an ownership decision, a state machine, or an error contract into types, and it stops being a convention the agent can drift from. Generated code that ignores it doesn’t compile.