Skip to content
Fabrica

Changelog

See every update made to the book.

  1. New

    Added a page on verifying the agent's work

    Verification now has its own stage in delivery, between building and validating.

    • Chapter 3: The dev lifecycle3.3.3 VerifyCovers how an agent checks its own work before you see it, with end-to-end tests, property-based tests, fast feedback loops, and letting the agent drive your app.
    • Chapter 2: Foundations2.3 The environmentNow outlines where agents run, locally or in the cloud, moved from Build.
    • Chapter 3: The dev lifecycle3.3.2 BuildNow focuses on telling the agent how to build with Syllabus, formerly Code Rules, and hands verification to Verify.
    • 3.3.1 PlanNow starts a checklist of what's must review, such as layers, data flows, schemas, and vocabulary, and what's nice to review, and shows a layer diagram for planning and PR reviews.
    • 3.3.4 ValidateNow covers checks by something other than the implementing agent, such as you or a fresh reviewer agent, where Verify covers the agent checking itself, and reviewing decisions that departed from the design tree.
    • Appendix A: ToolboxOverviewNow lists tools I need, starting with a test visualizer for reviewing the tests an agent proposes.
    21 commits
    1. List a PR design explainer under tools I need in the Toolboxc8d6395 ·
    2. Show a layer diagram in Plan, and list a layer diff viewer in the Toolbox8eab39a ·
    3. Reorder Build's steps, and add removing the agent's needless asksd6c9b8f ·
    4. Link Plan and Verify from Build, and prioritize by bottleneck216b001 ·
    5. Mark Build as a draft, and limit the agent by readying your codebase5260e05 ·
    6. Move where agents run from Build to The environment, and outline Build's goalc6dbacd ·
    7. List a plan conformance checker under tools I need in the Toolboxd577e9b ·
    8. Outline a review checklist in Plan, and departed decisions in Validate7bb86e2 ·
    9. List a design tree visualizer under tools I need in the Toolbox8b8dafc ·
    10. Give each Verify guideline its own top-level heading2f52361 ·
    11. List a test visualizer under tools I need in the Toolboxf60b0f6 ·
    12. Remove the list of common properties from Verifybec6b7a ·
    13. Add Rapid for Go to Verify's property-based testing tools4c9b63c ·
    14. Present Verify's techniques as guidelines for verifying wellf5858df ·
    15. Remove "Write the check first" from Verify1dd8e99 ·
    16. Tell Verify from Validate by who does the checking8ace9c5 ·
    17. Credit Lauren Tan's pstack guide alongside Osmani in Verify5735c35 ·
    18. Lead Verify with the agent looping longer without youe2b4a6a ·
    19. Tighten Verify to its essentials33e39d9 ·
    20. Hand verification from Build to Verify, and point Validate at ite0faba5 ·
    21. Add Verify to Deliver, between Build and Validate55f81aa ·

  2. Updated Orchestration patterns with the chief of staff and factories

    • Chapter 5: Orchestration5.3 Orchestration patternsNow outlines kicking off any work through a chief of staff, who captures it as a ticket to prioritize later or as work to start right away, and managing different work at once in factories, each defined as code.
    1 commit
    1. Outline the chief of staff and factories in Orchestration patterns0fe85fb ·

  3. Updated the hierarchy of bottlenecks with capacity and cognitive load

    • Chapter 1: Introduction1.5 The hierarchy of bottlenecksNow has six bottlenecks, adding capacity, for when your machines and budget can't run more agents, and calling attention cognitive load. It retells The Goal more fully, adds a software example, and spells out the kinds of confidence verification needs.
    • Chapter 3: The dev lifecycle3.1 SparkNow lists tools for turning an idea into a prototype.
    • 3.3.2 BuildNow outlines building efficiently, doing verification well, and where agents run.
    1 commit
    1. Rework the hierarchy of bottlenecks around six, and outline Build and Spark0bfd45c ·

  4. Added the book's license and reuse guidance

    • Appendix C: FAQsOverviewExplains CC BY-NC-SA 4.0, commercial reuse of diagrams and excerpts, noncommercial sharing of whole-book PDFs, attribution, ShareAlike, and when separate permission is needed.
    1 commit
    1. License the book and permit commercial reuse of excerpts (#1)d0e6db4 ·
  5. New

    Published the first draft of the book

    The book is live and written in public. Most pages are still outlines; these are drafted so far.

    • Chapter 1: Introduction1.4 PrinciplesThe ideas that run through the whole book, starting with introspecting every agent session.
    • 1.5 The hierarchy of bottlenecksThe order bottlenecks show up in, and why only the current one matters.
    • 1.7 AttributionWhere the book's ideas come from, and how to flag one that needs credit.
    • Chapter 3: The dev lifecycleOverviewThe stages everything you ship goes through, and which ones you can skip.
    • 3.2 ShapeWorking out what to build and how, with real software instead of sketches.
    • 3.2.2 DesignGetting in sync with your agent by letting it interview you.
    • 3.3 DeliverTaking each slice of work from plan to production.
    • Chapter 5: OrchestrationOverviewRunning many agents at once, and choosing when to look at them.
    • 5.2 Human attention is the bottleneckWhy your one focus token limits how many agents you can run.
    2 commits
    1. List the drafted pages in the first update, not the unwritten introductionc6deade ·
    2. Start the changelog: published the first draft of the book61b68d8 ·