gen-z-developers.sgit.ai → The briefs → A website to finish the book

A website to finish the book: gen-z-developers.sgit.ai, where the released book lives in the repository, the working book lives in a vault, and agents help me review it at every altitude

Source: newsroom.sgit.ai/articles/a-website-to-finish-the-book.html, by Dinis Cruz, published 2026-10-18, article v1.0.0, part 5 of 6 of the series The Generation Z Developers book (tag gen-z-book). Captured verbatim on 2026-10-18 for this repository; the site chrome, the series list and the LinkedIn and subscribe notes are left out. Links to other newsroom articles are made absolute.

Abstract: To make the second edition of Generation Z Developers, I want a website for it, consolidating the best of everything we have built so far into the most productive environment I can have for reviewing a book. The rule that organises it: the repository holds the official versions, and a vault holds the working versions. Version one is the book as released in 2018, so it goes into the repository as it is, dated, and the site starts as that book; everything after it is worked on in the vault and moved into the repository when it is ready, with a delta between each version, which is something I have always wanted for my books. From there: a semantic graph of the book, with its ontology and taxonomy; the book at every altitude, from a one-page view to the full text, with an infographic at each one; a narrative that guides the reader through it like a plot. While I read, I can comment by voice. There is a board, issues, and agents in roles, an editor, a copywriter and a publisher, who read the book, challenge it, write interview scripts for me, and sign off the parts we are happy with. Market research, evidence and maps for every section. And one correction to my own memo: the vault the book lives in will be public, so the OpenRouter key cannot go in it; it needs a vault of its own. The last part of the book should explain how all of this was built, because that is exactly what I want a Generation Z developer to be able to do. And I would argue that anyone who read the 2018 book and acted on it was well prepared for what happened next.

The figure, as published: The book's website. On the left, the repository: the official versions, starting with the 2018 book as released, and a delta between each version. On the right, the public vault: the working versions, the graph, the altitudes and their infographics, comments by voice, the board and issues, and the agents in their roles. A second, private vault holds the OpenRouter key and opens only with Dinis's passkey. When a version is ready, it moves from the vault into the repository.

In short

  • A website for the book. gen-z-developers.sgit.ai, matching the book's name.
  • The repository holds the official versions. Starting with the 2018 book, exactly as released.
  • A vault holds the working versions. Public, so anyone can read along.
  • A delta between every version. Something I have always wanted for my books.
  • The book as a graph, at every altitude. With an infographic at each one.
  • Agents in roles. Editor, copywriter, publisher: reading, challenging, interviewing me, signing off.
  • The OpenRouter key goes in a vault of its own. Not in the public one.

Why a website

Of everything we have built in these repositories, I want the best parts in one place, set up as the most effective and productive environment I can have for one job: reviewing and finishing this book. The ideas came from many places, most of them from the books on graphs.sgit.ai, where a lot of these concepts first appeared: a shelf with versions, seven roles with a folder each, the book as a graph, the same book at several altitudes. This is where they come together, for a book I want to finish.

The name

The site should match the book. The printed cover says Gen Z Developers , and the book is Generation Z Developers , so the address is gen-z-developers.sgit.ai rather than something shorter like genz-devs.

The repository and the vault

The organising rule: the repository contains the official versions; the vault contains the working versions.

The first version of the book is already final: released, dated September 2018, sixty per cent complete. So it goes into the repository as it is, and the first version of the website shows exactly that book. Everything after it is worked on in the vault: drafts, comments, graphs, reviews. When a version is ready, it moves from the vault into the repository, on top of the one before.

That gives the thing I have always wanted when I issue a new version of a book: a proper delta between one version and the next. The first one, from 2018 to 2026, will be brutal. After that, each delta will say exactly what changed, the way the versions of the page for publishers already do for one page, and the way versions of versions proposes for the parts of this site.

The book as a graph, at every altitude

Then the book becomes a semantic graph: its ontology and taxonomy, its concepts linked to each other and to the evidence, so I can make references across it and reshape it. The graphs books tried an altitude ladder, the same book at five altitudes, from a single paragraph down to the full text, each level a compression of the one below. This book should have that from the start, and an infographic at every altitude: the whole book on one page; a view per part; an infographic per chapter, and how they connect; the graph of each area. We go up and down between them until we arrive at the version that is just right.

And through it, a narrative. Not only a table of contents, but a path that guides the reader through the book, almost like a plot, from a simple version to the full one.

Reading, reviewing, signing off

What I need while I review:

  • Voice, while I read. Comments recorded as I read a section, attached to it.
  • Comments, a board and issues. What is open, what is being worked on, what is done.
  • Agents in roles. An editor, a copywriter and a publisher, at least, who read the book, give feedback, challenge it, and write interview scripts for me, so that I have to justify the points, the way ten hard questions for RiskMandate was done.
  • Sign-off. A way to mark parts of the book that we are happy with, so the work moves on.

All of it is public. The dynamic data starts in the vault, and the official versions end up in the repository.

Research and evidence

Then the agentic tasks around the text: market research on who the book is for and what else they read; validation of the claims; evidence behind each one; and maps and graphs for each section, eventually for each paragraph. The book should be able to show its work, the way this newsroom's articles do.

The OpenRouter key needs its own vault

My memo said to put an OpenRouter key in the book's vault, available only with the vault key. That does not work as described, because the book's vault is meant to be public: its read key will be published, so that anyone can read the working book. Anything in it is readable by everyone.

So the key goes in a second, private vault that opens only with my passkey, the way this newsroom's reader vault does. And the key itself should have a credit limit set at OpenRouter, so a mistake costs a little, not a lot; the key is the billing system describes keys with limits. The agents that need a model get it through that key; the public vault never holds it.

The last part of the book

The last part of the book should explain how all of this comes together: the repository and the vault, the graph and the altitudes, the agents and their roles, the reviews and the versions. Because that is exactly what I want a Generation Z developer to be able to build, for their own ideas.

It will also be interesting to see how much of the first book's core ideas has not changed. I would argue that they are universal. And I would say it plainly, not as a boast: anyone who read the 2018 book and acted on it, who learned how to learn, questioned everything and built things in public, was well prepared for the AI revolution that has just happened. Those who read it now should be ready for what happens next.

The brief

The build brief is a note: a website to finish the book. It is also on the briefs page. The book's plan is in Generation Z Developers, again.

What this does not claim

  • Nothing is built. No repository, vault or site yet.
  • The address is a proposal. gen-z-developers.sgit.ai, to confirm.
  • The altitude ladder was an experiment. It worked on graphs.sgit.ai for one book; this would be its second.
  • "Well prepared" is my argument. Not a measured result.

Where this comes from

A voice memo from me on 18 October 2026. graphs.sgit.ai, its altitude ladder and roles; the versions of the page for publishers. Related: Generation Z Developers, again, versions of versions, the graphs books, the key is the billing system, a book for one reader. Written up and checked by this site's agent, newsroom.writer; the editorial responsibility is mine.