The ideas register
The core ideas the second edition is made of, one node each: what it says in a sentence, where it comes from (the articles, decisions and memos, with the section), which 2018 chapters it answers, which proposed chapter it goes to, and its state. 119 ideas today: 65 Dinis has said in his own articles, 53 candidates waiting on him, 1 deferred.
105this-edition1next-version13the-process 27frame32claim4story22advice13method19process2evidence
| Idea | Kind | State | Goes to | Chapter | From | Answers |
|---|---|---|---|---|---|---|
| The book opens with wonder, not fear and not technologies The first edition opened with a slide of logos and went too technical too soon; the second opens with wonder and privilege, and the fear is what the reader hears, not whe… | frame | accepted | this-edition | You are lucky to be here | You are lucky to be here, The opening: you are lucky to be here | 2 |
| Whoever reads this now is lucky to be here Alive, and starting out, in the middle of a transition this big, while the pieces are still landing: that is luck, and the book says so before anything else. | claim | accepted | this-edition | You are lucky to be here | You are lucky to be here | 1 |
| Ignore the doom: nobody knows what happens next Every transformation came with the warning that this time is different; this one is televised. The hype may crash, as the dot-com did, and the opportunity was real both t… | claim | accepted | this-edition | You are lucky to be here | You are lucky to be here, Two years in, the opposite | 0 |
| Seven transformations, lived through: the Spectrum, the BBS, the internet, the mobile phone, the cloud, the apps, AI Dinis's own history as the evidence that transitions reward the people who get in early and keep learning; each dated, each with its warning at the time. | story | candidate | this-edition | You are lucky to be here | You are lucky to be here, The opening: you are lucky to be here | 2 |
| Technology can finally work for you Gen Z grew up with technology designed to hook them (the attention economy); with agents they can build again, and make technology serve them. | claim | accepted | this-edition | You are lucky to be here | You are lucky to be here, Custom UIs are not the exception | 2 |
| Learning can be made for you, not for a mythical average student Your gaps, your curiosity, your zone: an agent can shape learning to how you think, and you can build the tools for it. | claim | accepted | this-edition | Connect the dots backwards | You are lucky to be here, Connect the dots backwards | 2 |
| Become a developer, because craftspeople make their own tools The reason to become a developer is not a job title: every craft makes its own tools, and now anyone can. | advice | accepted | this-edition | Everyone who can brief an agent is a developer | You are lucky to be here, The citizen developer is good news | 2 |
| Think with the AI; never delegate your thinking to it Search gave answers; generative AI lets you question them. Use it to go deeper and ask for the evidence, not to skip understanding. | advice | accepted | this-edition | Connect the dots backwards | You are lucky to be here, Connect the dots backwards | 1 |
| The opportunity is in old jobs too: the ones that never scaled, and now can Jobs done for centuries one person at a time can now scale with agents; the map shows where a reader might land. | claim | candidate | this-edition | Where do you land? | You are lucky to be here | 0 |
| Read it on paper, with a pen The printed page is still the best technology to learn from; the opening tells the reader how to read the book before the first chapter. | advice | accepted | this-edition | You are lucky to be here | Connect the dots backwards | 2 |
| A path only makes sense looking back Trust your gut going forward and use a method for walking: doors, fast iteration, constraints, leverage. Jobs's calligraphy class became the Mac's typography. | frame | accepted | this-edition | Connect the dots backwards | Connect the dots backwards, Connect the dots backwards | 2 |
| The edge is now multidisciplinary Learning to intersect disciplines is where the advantage is; the humanities and mathematics both matter. | claim | accepted | this-edition | Connect the dots backwards | Connect the dots backwards | 1 |
| We teach maths, and music, as if to make people hate them We give the solution away and skip the wonder and the struggle (Lockhart's A Mathematician's Lament); a reader who hated maths at school was taught badly, not born withou… | claim | accepted | this-edition | Connect the dots backwards | Connect the dots backwards | 1 |
| Generative AI lets you explore and communicate again Ways of communicating you could not afford before, like the storyboards on this site, are now an afternoon's work; exploring is back. | claim | accepted | this-edition | Connect the dots backwards | Connect the dots backwards, Storyboards drawn by code, and the newsroom read in full | 1 |
| By reading this you are already in a small minority, and geography no longer decides Learning is a lifelong skill; the future is local, decentralised and sovereign; the reader who reads is already ahead. | claim | accepted | this-edition | Connect the dots backwards | Connect the dots backwards, Who will game the reading meter? Eight kinds of reader, nine ways to cheat, and the risks that will actually happen | 1 |
| Wardley maps run through the whole book, shown before they are named Let the reader feel the pattern, things moving from genesis to commodity, before learning the words; a map in every part. | frame | accepted | this-edition | Where do you land? | Where do you land? Wardley maps run through the whole book, shown before they are named, and the first thing a reader should work out is their centre of gravity, Why I love Wardley maps, Where do you land? | 1 |
| The four stages of evolution are not only for activities Dinis's table from his Open Security Summit talk: Wardley's four rows and ten more scales, from openness to backups to data, all move from genesis to commodity. | frame | accepted | this-edition | Where do you land? | Where do you land? Wardley maps run through the whole book, shown before they are named, and the first thing a reader should work out is their centre of gravity | 1 |
| Explorer, villager, town planner: personalities, each with a centre of gravity Wardley's three describe people better than the business personality tests; everyone has a centre of gravity, some can play at several levels, it moves over a career, and… | frame | accepted | this-edition | Where do you land? | Where do you land? Wardley maps run through the whole book, shown before they are named, and the first thing a reader should work out is their centre of gravity, Explorer coding, Software vendors should become villagers and town planners and 1 more | 1 |
| Each centre of gravity needs different skills and a different learning path All three are brilliant at different things; the book carries a black-and-white badge per chapter and three paths through it. | method | accepted | this-edition | Where do you land? | Where do you land? Wardley maps run through the whole book, shown before they are named, and the first thing a reader should work out is their centre of gravity | 1 |
| Explorer coding: what people call vibe coding, done as exploring Anyone with a need explores it by building, with the fast feedback loop that made spreadsheets win; it is not a way to ship, it is a way to find out. | frame | candidate | this-edition | Explorer coding, not vibe coding, and the handover | Explorer coding, A browser for one | 2 |
| The deployment gap is a handover, and the prototype is the best brief The step from a prototype to a tool people rely on is not a place to stop but a handover from explorers to villagers and town planners; what someone built for themselves … | frame | candidate | this-edition | Explorer coding, not vibe coding, and the handover | Who will fix your mess? An answer to HBR's "deployment gap" from what this site has already published, The citizen developer is good news, Go slow to go fast | 2 |
| Everyone who can brief an agent is a developer now The definition widened: the citizen developer is the spreadsheet grown up, and Portuguese is a programming language because prompts are natural language. The book must al… | frame | accepted | this-edition | Everyone who can brief an agent is a developer | Generation Z Developers (AI edition), The citizen developer is good news, GenAI in Portuguese, 2024 and 1 more | 3 |
| The one competitive advantage in 2026 is running agentic workflows Companies need AI operators, not model builders; 71% of leaders would rather hire less experience with AI skills; the roles pay 62% more; the edge shows when the choice i… | claim | candidate | this-edition | Hired for the workflow | Hired for the workflow, How to get a job | 2 |
| You are more technical than you think People who use email, websites and apps at an advanced level and still say they are not technical have learned every previous technique; they only need the new one. | advice | candidate | this-edition | Hired for the workflow | Hired for the workflow | 1 |
| The edge starts with the application A CV fitted to the role, an analysis of the company's problem, and something they have not seen: the interview then starts from your strengths. It worked for Dinis throug… | advice | candidate | this-edition | Hired for the workflow | Hired for the workflow | 2 |
| Act as the job you want: do the job in public before you have it If you are looking for a job you have time; pick a startup or an open-source project, do the work as that person, in public, so it can be linked; reach does not matter, t… | advice | candidate | this-edition | Act as the job you want | Act as the job you want, How to get a job | 4 |
| Your CV should be online, with links to the work A page anyone can forward, not only a PDF; your GitHub is your CV because it shows how you work with others; the bar to build it is an afternoon. | advice | candidate | this-edition | Act as the job you want | Act as the job you want, Three companies, three LinkedIn pages | 4 |
| How a job hunt works in 2026: interviews, take-home tests with AI, what a junior role looks like A gap no article covers yet: the mechanics of applying, interviewing and freelancing now; the journalist writes it from a memo. | advice | candidate | this-edition | Act as the job you want | The survey's gaps, Start from the storyline | 1 |
| The fear, impostor syndrome and anxiety about AI among young people Young Europeans are fed fear about AI; the book concedes which fears are right (the first hiring wave went to the wrong people, projects will be cancelled) and answers th… | claim | candidate | this-edition | You are lucky to be here | The survey's gaps, Generation Z Developers (AI edition), You are lucky to be here | 1 |
| Publish, publish, publish: your own newsroom A publishing loop you can copy on day one: a voice memo in, an agent researches, checks and writes in your voice, a validated static site out; small finished pieces over … | method | candidate | this-edition | Publish, publish, publish: your own newsroom | Your own newsroom, Books from articles, Twenty sites in fifteen days, and what that did to the writing | 4 |
| Write it once, link it many times; every part buys the next An article behind every answer; the subject buys the first line, the first line the paragraph; the Wizard of Oz in reverse: agent-drafted, person-sent. | method | candidate | this-edition | Publish, publish, publish: your own newsroom | The man behind the curtain, For a startup, the most important question is whether they miss it | 1 |
| Your first workspace: from a spreadsheet to a folder per person, drafts never send A Drive folder per person, a Claude Project connected to Drive and Gmail, a six-line policy, five exercises in an afternoon; then habits, an agent mailbox, and surfaces c… | method | candidate | this-edition | Your first workspace | From a spreadsheet to a folder per person, Replicating the agentic inbox, How I work with Claude and 1 more | 3 |
| An agent is a session with a focus: one session per topic, named, with a role file One session per topic, @names, a role.md saying what it does and does not do, lessons and debriefs as memory, a daily brief. | method | candidate | this-edition | How to work with agents | How I work with Claude, The agents write too, The Librarian's daily brief | 2 |
| The brief is the unit of work, and writing it as an article forces the research A written request an agent can start from: what is asked, what exists, what remains, what done looks like; an article beats a list because it makes you check the record f… | method | candidate | this-edition | How to work with agents | Write it as an article, The briefs so far, Brief the agent too | 1 |
| Omnichannel programming: brief by voice, review on the phone, one shared state Voice, chat, phone, IDE and pull requests all read and write one shared state (git, vaults, briefs, graphs); this is how a new generation programs. | method | candidate | this-edition | How to work with agents | Omnichannel programming | 2 |
| Every mistake added a rule: the complexity trap of the agent operator Each mistake becomes a rule, the prompt grows, compaction comes sooner and new mistakes follow; the way out is fewer, enforced rules, re-anchored after every summary. | claim | candidate | this-edition | How to work with agents | Every mistake added a rule, Re-anchoring | 1 |
| Why your agents should not run on your laptop An agent on your laptop runs as you, with your SSH keys, cookies and password-manager session; pick the cloud surface by reach. | advice | candidate | this-edition | Your first workspace | Why my agents do not run on my laptop | 1 |
| Direction is the scarce skill: the place of highest leverage When anyone can brief an agent, building stops being the bottleneck; choosing what to build next, where nothing blocks you, and starting without knowing the end, is what … | frame | candidate | this-edition | Direction is the scarce skill | Places of highest leverage, Not a straight line, Connect the dots backwards | 2 |
| Knowing when to stop is most of seniority Who the attackers are, the phase of the business, the bottleneck, what good enough looks like: experience gives people this, agents lack it, and the book has to teach the… | claim | candidate | this-edition | Direction is the scarce skill | Knowing when to stop, Brain | 2 |
| One-way and two-way doors, blast radius, and where a person belongs How cheap is it to undo decides where the human goes: put the person where the output cannot be undone and the blast radius is large; give them the why; let the record mo… | frame | candidate | this-edition | Direction is the scarce skill | The human in the loop is a spectrum, The human in the loop, safety net or bottleneck, Footprint and blast radius and 1 more | 3 |
| Agents decide, people answer Agents in loops make real decisions, but responsibility stays with whoever granted the reach and set the mandate; also ELIZA and anthropomorphism. | claim | candidate | this-edition | Direction is the scarce skill | Who owns the words, The policy draws the liability line | 1 |
| Make fact-based decisions: think out loud and let the record check you Count rather than remember; publish only what the record supports (5 claims confirmed, 5 corrected, 2 not found); review as a record with every finding answered; distrust… | method | candidate | this-edition | Facts, evidence and the record | My memory, checked, Reviews on the record, Your agent's logs are a self-report and 1 more | 3 |
| Mandate, reach and the gap: hope versus enforcement Before you give an agent access, write down what it is for and what it can reach; the gap is the risk; rules in a prompt are hope, rules in a hook or platform are enforce… | frame | candidate | this-edition | Controlling your agent: RiskMandate | What can your agent reach? RiskMandate and the Agent Behaviour Policy, explained for the person who has to decide, Are hooks the sweet spot? Moving an agent's rules from hope into hooks, rule by rule, until enforcement moves off the machine, Attacks rewritten as mandates and 1 more | 2 |
| Code is a liability; the future is the smallest code that does the job Every shipped line is a capability someone may misuse (Log4j; 428 of 1,500 files ran); the next maintainer is an agent; the minimal viable code path. | claim | candidate | this-edition | Controlling your agent: RiskMandate | The code you do not ship, The minimum code below | 3 |
| Learning to hack is still how you learn how things work: draw the line where the attacker is Name the threat agent, the vector and how sophisticated it is; a ladder from your own mistakes up to states; the bookmarklet trick; to hack means to solve problems. | advice | candidate | this-edition | Controlling your agent: RiskMandate | Who are you protecting against? Draw the security line where the attacker is, not above it, Fix the page yourself, Hacking Portugal, 2016 | 3 |
| The secret goes from the drop into the tool, never into the chat Classify the credential before it touches anything; an agent told something cannot untell it; the lethal trifecta. | advice | candidate | this-edition | Controlling your agent: RiskMandate | Handing secrets to agents and browsers, Seven vaults, one method, A skill behaviour policy | 2 |
| Open source means nobody can lock you in: the fork next door Anyone can fork, which protects founders, customers and investors from each other; forks take hold only when someone stops executing; six misconceptions; open source is a… | claim | candidate | this-edition | Open source | The fork next door, What open source is, and what it is not, The eyeballs get cheap and 1 more | 2 |
| Your first pull request: open source is still the newcomer's best door A one-file, 83-line documentation PR merged into a 9,625-commit project; contribute to the projects of the companies you want to work for. | advice | candidate | this-edition | Open source | Our first PR in Ruflo, Act as the job you want | 2 |
| Building blocks: cloud as Lego, free models with your own key, git as a standard What a non-specialist can assemble today, mostly free, with an agent doing the one-time setup; serverless as ephemeral town planner services; knowing what tokens cost. | method | candidate | this-edition | Serverless, for real | Cloudflare as Lego blocks, Free models, your own key, Ephemeral town planner services and 2 more | 5 |
| Shipped means the user has it: green does not mean live, go slow to go fast A CI pass is not a release until you have checked what the user sees; tests that never run are not tests; the explorer-to-villager move is a refactor you can prove; synth… | claim | candidate | this-edition | Shipped means the user has it | Green does not mean live, Go slow to go fast, How to run synthetic users on your own site | 4 |
| Think in graphs: knowledge that maintains itself, and your future self Graphs as the way of thinking, not only a drawing tool: brief from a graph, maintain it rather than perfect it, search as navigation; keep your work linkable and backed u… | frame | candidate | this-edition | Graphs, memory and your future self | The graphs books, Knowledge that maintains itself, Bringing my past work back and 2 more | 5 |
| Be a founder: the expert can build first now, and the test is whether they miss it Generative AI lets the people who know the problem build it; the mean founding age of the fastest-growing startups is 45; open source everything; do they miss it; pay aft… | claim | candidate | this-edition | Be a founder: the expert founders | The expert founders, For a startup, the most important question is whether they miss it, Paying after the value and 1 more | 1 |
| Civic responsibility: to hack means to solve problems, and small countries can lead now Dinis's Portugal talks as the then-and-now: what regulation delivered, the Portuguese Hacking Service, judo for small countries, sovereignty as the ability to move. | claim | candidate | this-edition | Civic responsibility | A web application security challenge to Portugal, 2010, Hacking Portugal, 2016, Judo for small countries and 1 more | 1 |
| The repository holds the official versions; the vault holds the working versions The rule this site is built on: v1 frozen in the repository, work in a public vault with its read key published, a delta between every two versions. | process | accepted | this-edition | How this book was made, and what you made | A website to finish the book, Decision 005: Text issues live in the vault | 1 |
| Co-written with Claude, credited, with the ratio shown; short and punchy; every paragraph knows what it is The book says it is co-written, shows the memo-to-word ratio (63,000 words in, 85,000 out on the newsroom), stays short and punchy, and every paragraph carries its purpos… | process | accepted | this-edition | How this book was made, and what you made | Short, punchy, and co-written with Claude, How much of this did I write? The numbers behind twenty articles in four weeks, and what the input actually was, Who is speaking | 1 |
| A personal edition, assembled by an agent, paid for as it is read Once the book is a graph an agent can assemble an edition for one person; sent not published; pay as you read from five pounds of credit. | process | deferred | next-version | How this book was made, and what you made | A book for one reader | 0 |
| Read, comment, decide: the loop that turns Dinis's decisions into versions Read an item, comment verbatim, pick a verb (keep, fix, rewrite, merge, cut, article first, later, not doing it); the editor records it as a file in the vault and acts; d… | process | accepted | the-process | How this book was made, and what you made | Read, comment, decide, Decision 006: Every change is minor, unless Dinis says it is major | 0 |
| An article is how to brief an agent, and the roles keep their names Reviewer, editor, publisher, journalist; every article ends with a brief; the first job is to ship the book we already shipped. | process | accepted | the-process | How this book was made, and what you made | Write it as an article, Decision 007: Two kinds of article | 0 |
| Release the book we already released: every format from one source Build v1.0.0 here, match it page by page to the 2018 PDF, then every format (print, screen, EPUB, Kindle) from the same build; Leanpub first, then Amazon; the licence is … | process | accepted | the-process | How this book was made, and what you made | Release the book we already released, Decision 001: The 2018 text is Creative Commons BY, Decision 002: Leanpub gets our own PDF, built here and matched to the 2018 one and 2 more | 0 |
| One board for the work, one inventory of everything unfinished Every issue a file, the boards generated; text issues in the vault; one inventory of the 89 outlines, the drafts, the 43 GitHub issues and the handwritten notes, with a d… | process | accepted | the-process | How this book was made, and what you made | One board for the book, Everything unfinished in one place, Decision 005: Text issues live in the vault | 0 |
| Start from the storyline, as storyboards drawn by code The 2018 text and the newsroom are the material, not the plan: the storyline first, as panels with a punchline, a concept, the evidence and the character they are for; a … | process | accepted | the-process | How this book was made, and what you made | Start from the storyline, Storyboards drawn by code, and the newsroom read in full | 0 |
| Everything we do here becomes a graph: ideas as nodes, provenance as edges, state on every node Sources, ideas, chapters, decisions and tasks as one graph, so that what goes in the book, what waits and what is declined is a property of a node with its evidence, and … | process | accepted | the-process | How this book was made, and what you made | A website to finish the book, Short, punchy, and co-written with Claude, Dinis's message of 18 October 2026 asking for the graph and 1 more | 1 |
| This book is about generative AI, not AI in general AI is a huge bucket (AI, machine learning, deep learning, generative AI); the book is about the kind that generates: data goes in, the model builds its own representation… | frame | accepted | this-edition | What generative AI is | Generative AI, not AI | 1 |
| A language model predicts the next word from a rich picture of how things connect; that is why a better prompt helps, and where hallucinations come from Everything is connected in the model's picture; the text you give it says which connections matter; the image-extension tools of 2022 and 2023 made it click. The correcti… | claim | accepted | this-edition | What generative AI is | Generative AI, not AI | 2 |
| Ask to be corrected, and print the corrections with their sources The article on generative AI carries a section of corrections (machine learning learns too; no stored graph inside a model; the prompt conditions; next-token prediction p… | method | accepted | this-edition | Facts, evidence and the record | Generative AI, not AI, My memory, checked | 2 |
| The name: Generation ZX Developers (GenAI Startup Edition) The edition carries its name in the title: Generation ZX Developers (GenAI Startup Edition), for two generations, the full form of the 2018 title with the second generati… | process | accepted | this-edition | How this book was made, and what you made | Generative AI, not AI, Generation Z Developers (AI edition), Decision 010: The title is Gen Z Developers (GenAI Edition) and 2 more | 0 |
| The immediate connection between a creator and what they make is the wonder the book opens with Bret Victor's Inventing on Principle: see the effect of a change as you make it. The 2018 book already had it as an outline; the opening uses it for the wonder. | frame | accepted | this-edition | You are lucky to be here | Where the thinking came from, You are lucky to be here | 1 |
| Flow and deliberate practice are the science of the zone and of learning Csikszentmihalyi on flow and Ericsson on deliberate practice back the 2018 chapters on the zone and on learning; the book names them in a 'where this comes from' box. | evidence | accepted | this-edition | Connect the dots backwards | Where the thinking came from | 3 |
| Question everything: a claim earns its status by being refutable Popper for the chapter on questioning, Schneier for security thinking: the cover's first line, with its philosophy named. | frame | accepted | this-edition | Facts, evidence and the record | Where the thinking came from | 1 |
| Know where your ideas come from: keep your own register The reader's exercise at the end of the learning part: write your influences as claims you can check, tied to where they show up in your work, the way influences.sgit.ai … | advice | accepted | this-edition | Connect the dots backwards | Where the thinking came from | 2 |
| Open source, community and OWASP: working and getting hired in the open, with the names behind it Torvalds, The Cathedral and the Bazaar, open source and OWASP as the influences behind act as the job you want; the 2018 book had already written the Cathedral and the Ba… | story | accepted | this-edition | Open source | Where the thinking came from, OWASP | 2 |
| Design, the design canon and Christopher Alexander: the villager's and town planner's craft The craft of making something others rely on has a canon; the book names it where the villager's chapters need it. | frame | accepted | this-edition | Explorer coding, not vibe coding, and the handover | Where the thinking came from | 2 |
| Purpose, and optimism: Sinek for why, Kevin Kelly for what technology wants The 2018 outline Start with Why gets its influence named; Kevin Kelly's view of where technology goes is the frame's optimism, with the anchor (What Technology Wants or a… | frame | accepted | this-edition | You are lucky to be here | Where the thinking came from, Machine Learning and AI | 2 |
| Questioning, and asking for the evidence, is one of the most important skills now Asking where a claim came from is one of the most important skills this generation needs, and in large part they already have it: they connect the dots, they find things,… | claim | accepted | this-edition | Facts, evidence and the record | Follow the rabbit holes, Follow the rabbit holes, Facts | 1 |
| They care about privacy; Snapchat's best feature was that images disappear This generation cares about privacy and has been told so often not to post anything that it becomes a problem of its own; Snapchat's disappearing images were the feature … | story | candidate | this-edition | Facts, evidence and the record | Follow the rabbit holes | 0 |
| Following a rabbit hole is now a prompt away; build the agents and tools that find where things come from Never take something at face value: provenance (where it came from) and explainability (why it is the way it is) are now a prompt away, and visualising the rabbit holes i… | advice | accepted | this-edition | Facts, evidence and the record | Follow the rabbit holes, Where the thinking came from, Generative AI, not AI | 1 |
| Provenance and explainability are how you disagree rationally Showing what is evidence and what is not, what we know and what we do not know (not knowing can be a fact), is how debate stays logical; the newsroom's rules 'not found i… | frame | accepted | this-edition | Facts, evidence and the record | Follow the rabbit holes, My memory, checked, Reviews on the record and 1 more | 2 |
| Managing information so that decisions can be made is what work is In a company much of the work is knowing where the information is, who is doing what, what the status is and how a decision can be made; learning to follow the evidence i… | claim | candidate | this-edition | Facts, evidence and the record | Follow the rabbit holes | 1 |
| What cost hundreds of thousands of pounds is now a brief and a feedback loop Systems that gathered and checked information used to cost hundreds of thousands or millions of pounds and took too long to be effective; generative AI makes the same che… | claim | candidate | this-edition | Facts, evidence and the record | Follow the rabbit holes, The briefs so far | 1 |
| Be the best-prepared person in the room: briefings, pre-briefings, follow-ups There is no excuse now not to be the most prepared person in the room: a briefing for you, a briefing on the people you meet, a follow-up after; what used to be overhead … | advice | candidate | this-edition | Facts, evidence and the record | Follow the rabbit holes | 0 |
| A hands-on part, dated 2026 and renewed each year The practical workflows (an agentic workflow from zero, images, infographics and storyboards, presentations, meeting briefs and follow-ups, publishing) change too fast fo… | process | accepted | this-edition | How this book was made, and what you made | Follow the rabbit holes, From a spreadsheet to a folder per person, Your own newsroom and 2 more | 0 |
| A graph is a network of nodes and edges, not a diagram Some readers think a graph is a picture with boxes; the book means a network, nodes and the edges between them, and shows it with visualisations. Of the three things peop… | frame | accepted | this-edition | Everything is connected: graphs | Everything is connected, The graphs books, graphs | 1 |
| The whodunit is the easiest way in: the detective's board is a graph The board on the wall with the photos, the notes and the red string is a graph, and the question is always a connection from A to B; this generation are good detectives a… | story | accepted | this-edition | Everything is connected: graphs | Everything is connected, Everything is connected, Follow the rabbit holes | 1 |
| A map is a graph with positions; a Wardley map is a graph with context A map is a graph where each node has a place: on a Wardley map, how visible it is and how evolved it is. That is why the graphs chapter and Where do you land belong next … | frame | accepted | this-edition | Everything is connected: graphs | Everything is connected, Where do you land? Wardley maps run through the whole book, shown before they are named, and the first thing a reader should work out is their centre of gravity | 1 |
| Graphs nest, and so does the world: groups of groups are the abstraction layers we think in Fractal graphs, graphs of graphs: there is no top and no bottom, only the altitude you look from and how much definition you load there. Even nature can be seen as a giga… | frame | accepted | this-edition | Everything is connected: graphs | Everything is connected, Fractal Semantic Graphs | 2 |
| Provenance is a graph: where a claim came from is a chain of edges back to its source How Dinis sees the world is connections, which is why provenance is a graph and why so many relationships in the book are graphs: the influences, the paths, the evidence,… | claim | accepted | this-edition | Facts, evidence and the record | Everything is connected, When journalism becomes intelligence, built, Memory is not a spectator sport | 2 |
| You can start anywhere: it matters that you start, and get movement A graph has no front page and no top, so you never need to feel overwhelmed: it does not matter where you start or whether you go straight in the right direction; it matt… | advice | accepted | this-edition | Everything is connected: graphs | Everything is connected, Connect the dots backwards | 2 |
| The 2018 book was already there: Dot Language and AST were graphs without saying so The 2018 outline Graphs has four bullets that are the new chapter in miniature, and two published chapters, Dot Language (drawing the diagrams software never has) and AST… | evidence | candidate | this-edition | Everything is connected: graphs | Everything is connected, Dot Language, AST (Abstract Syntax Tree) | 3 |
| Source code is a fractal semantic graph, and a review should read every layer of it Stories, flows, components, classes, methods and calls, the syntax tree: each layer is a graph with its own vocabulary. Naming a node and its verb is now cheap, so a chan… | claim | candidate | this-edition | Everything is connected: graphs | Code review as a fractal semantic graph, Code review as a fractal semantic graph, Everything is connected | 3 |
| A graph is trustworthy not because it is right but because it is where users, experts and tests can correct it A model's first reading of anything will be partly wrong; the plan does not need it right. It needs layers someone knows and predictions something can check: users confir… | method | candidate | this-edition | Facts, evidence and the record | Code review as a fractal semantic graph, Knowledge that maintains itself | 2 |
| There is a company in this: a code review that reads every layer, for somebody to build Say the business plainly: a review attached to a repository that keeps the layered graph current per commit and shows each change at every altitude, sold to anyone genera… | advice | candidate | this-edition | Be a founder: the expert founders | Code review as a fractal semantic graph | 0 |
| The voice is not a setting: a corpus, a memo, a short list of rules, and a reader who corrects An agent sounds like its author because of four inputs: a corpus of the author's writing that defines the vocabulary; voice memos that carry how the author thinks, in the… | method | candidate | this-edition | Publish, publish, publish: your own newsroom | How the voice works, How the voice works, How much of this did I write? The numbers behind twenty articles in four weeks, and what the input actually was | 1 |
| Speak it, do not type it: a memo carries how you got there, a brief only what to write A typed brief is already edited into someone else's register; a voice memo keeps the rhythm, the tangents and the order the ideas came in, and the agent keeps those phras… | claim | candidate | this-edition | Publish, publish, publish: your own newsroom | How the voice works | 1 |
| A wording correction is made once and enforced; a content correction is new thinking every time 'No em-dashes' is a rule an agent can keep; 'sound more human' is not. Each jarring word becomes a line in the behaviour policy, restored after every summary and checked … | advice | candidate | this-edition | How to work with agents | How the voice works, Re-anchoring | 0 |
| Memory is not a spectator sport: it is context management, many memories, fractal, published and shared The industry's picture is one store everything is pumped into and retrieved from by similarity. Dinis's is the opposite: memory is deciding what an agent needs in its win… | frame | candidate | this-edition | Graphs, memory and your future self | Memory is not a spectator sport, Memory is not a spectator sport, Memory is not a spectator sport | 2 |
| Publish, and your published work becomes your agents' memory, with a URL for every claim Open source and Creative Commons are not a licensing preference: they are what makes a memory usable by an agent. The more you publish, the more the next session stands o… | advice | candidate | this-edition | Graphs, memory and your future self | Memory is not a spectator sport, Memory is not a spectator sport | 3 |
| Stale pages become false memories, so a memory must say where each thing came from and name its own errors A shared memory made by agents and people becomes a rumour mill unless every item carries its source; and it goes stale: the session that wrote the article found four sta… | claim | candidate | this-edition | Facts, evidence and the record | Memory is not a spectator sport | 1 |
| The file system is the database: load, extract, transform, save, and keep every intermediate as a file A database server is a large, stateful, always-on thing to provision, secure, back up and pay for, and most of what it holds would be happy as files. LETS loads state, wo… | method | candidate | this-edition | Serverless, for real | No server, by design | 1 |
| No server, by design: retire the back end too, and keep only commodity servers After the database, the back end: the newsroom's personas, reading meter, payments, versions and databases all run in the browser, and what is left on the server side is … | frame | candidate | this-edition | Serverless, for real | No server, by design, No server, by design, No server, by design | 1 |
| Security experience is what lets you ship with known gaps: list them, match them to the reader, say what would change the call A design with no server has gaps, and the honest thing is to write them down: a reader can edit a balance, start again in a private window, credit themselves; every one c… | claim | candidate | this-edition | Controlling your agent: RiskMandate | No server, by design, Who are you protecting against? Draw the security line where the attacker is, not above it | 2 |
| Open source is why it is easy to throw your own technology away When everything you build is open, there is no moat you have to keep using and no part of the stack to protect from replacement; you can be the first to replace what you … | claim | candidate | this-edition | Open source | No server, by design | 1 |
| A prompt is a lens: translating into another language is, to a model, the same as explaining for a teenager or a doctor A model holds the frames of reference of many audiences, and the prompt puts the right lens in front of the idea; the analogy is the reason someone understands something.… | frame | accepted | this-edition | Lenses, roles and loops | Lenses, roles and loops, Lenses, roles and loops | 0 |
| A role is a model with a description and a question; an agent is that role on a loop with a goal The editor, the publisher, the journalist, the librarian on this site are each almost a raw model plus a role file (who you are, what you care about, what you refuse, how… | frame | accepted | this-edition | Lenses, roles and loops | Lenses, roles and loops, How I work with Claude, Lenses, roles and loops | 0 |
| Tools changed everything: the model answers with a request, the program runs it, and the result goes into the next request The first ChatGPT and Claude had only their training, a compression of the world that stopped at a date. Now a model can return a tool call instead of an answer (search t… | claim | accepted | this-edition | Lenses, roles and loops | Lenses, roles and loops | 1 |
| The model remembers nothing between requests: every request carries the whole conversation, which is why there is a context window There is no memory, only a cache that saves work; the model starts from the prompt it receives, so it has to receive all of it, and a long chat costs more every turn. Whe… | claim | accepted | this-edition | Lenses, roles and loops | Lenses, roles and loops, Memory is not a spectator sport | 0 |
| Long chats are compressed into a lower-resolution summary, so details drop out: work in many focused threads with named agents When a conversation gets too long it is replaced by a summary, and what the summary leaves out is gone unless it is in a file; the newsroom's session was summarised eight… | advice | accepted | this-edition | Lenses, roles and loops | Lenses, roles and loops, Re-anchoring, Replicating the agentic inbox | 0 |
| Do the book in release mode: a whole release candidate from the first list, then rounds, then the next candidate Run with the librarian's first list and make the first release candidate, a whole book start to finish that could be published and is not; the question for it is whether … | process | accepted | the-process | How this book was made, and what you made | The book in release mode, Decision 008: The book is made in release mode, through a review board, The book as a graph | 0 |
| After rc1, nothing enters the book without a hearing: an advocate, a cutter, the readers, a checker, the editor, and Dinis decides Every word, change and idea that wants in goes before a board whose seats are roles in their own sessions, so the one arguing against has not been persuaded by the contex… | process | accepted | the-process | How this book was made, and what you made | The book in release mode, Decision 008: The book is made in release mode, through a review board, Lenses, roles and loops | 0 |
| Every verdict is recorded with its reason, and a general reason becomes a precedent that decides the next case without a hearing A hearing starts with the precedents; if one covers the case the editor applies it and it goes on a list Dinis can overturn, and overturning makes a new precedent. So the… | process | accepted | the-process | How this book was made, and what you made | The book in release mode, Decision 008: The book is made in release mode, through a review board | 0 |
| A release candidate's working copy is in the vault; the site renders a frozen snapshot of it, marked, never official Release candidates are working versions and live in the vault; to be read, printed and marked up one is built on the site from a frozen snapshot whose hash is recorded on… | process | accepted | the-process | How this book was made, and what you made | Decision 009: A release candidate is read on the site from a frozen snapshot, marked, and is not a version, The book in release mode, The release candidate, written from the register | 0 |
| The reader this book is for is the founder, and its objective is that by the end you have started a company Not founder as an attitude, as the 2018 Be a founder meant it, but literally: in 2026 you can be the founder. The book is the one you give someone who wants to start a Ge… | frame | accepted | this-edition | Gen ZX: who this book is for, and what it is for | Gen ZX Developers, Be a founder, Decision 015: The Gen ZX proposal is the frame of release candidate 2 | 1 |
| Two generations, Z and X, together Gen ZX: back to the ZX Spectrum Generation Z, entering the workforce and becoming the entrepreneurs, and Generation X, the subject-matter experts starting companies, often their parents; the millennials… | frame | accepted | this-edition | Gen ZX: who this book is for, and what it is for | Gen ZX Developers, The expert founders, Decision 014: The title is Generation ZX Developers (GenAI Startup Edition) | 1 |
| Gen ZX are developers: coding with agents the explorer coding way, which is what vibe coding should be called The entrepreneurs the book is for are developers: they code with agents. What people call vibe coding is exploration, and the word should say so; the explorer builds to f… | claim | accepted | this-edition | Explorer coding, not vibe coding, and the handover | Gen ZX Developers, Explorer coding, Who will fix your mess? An answer to HBR's "deployment gap" from what this site has already published | 1 |
| Ship now, and ship your startup serverless: no servers of yours, no database, client side, with privacy by design and control of your agents A founder with no servers has nothing to run at three in the morning and nothing to pay for when nobody is using it; 'if it bills you by the hour when nobody is using it,… | advice | accepted | this-edition | Serverless, for real | Gen ZX Developers, No server, by design, Ephemeral town planner services and 1 more | 1 |
| The book is measured by how many companies are created from it, and builds a community of the people who tell us A book to read is fine; a book with an objective is a different thing. The measure is the companies created from it, which means asking readers to say what they are doing… | process | accepted | this-edition | How this book was made, and what you made | Gen ZX Developers | 0 |
| How to actually do it: a limited company in the UK, Lithuania, Portugal, the European Union, the cloud providers and the programmes The book should say the steps, for real, from experience and not as legal or tax advice: creating a limited company in the UK; the case for Lithuania; Portugal, where run… | advice | accepted | this-edition | The company itself: the UK, Portugal, Lithuania, the European Union | Gen ZX Developers, Not a straight line | 0 |
| The book is 200 printed pages or more; short and punchy stays the rule for chapters, not for the book The 2018 paperback was 139 pages and, Dinis says, quite thin; the target is 200 pages or more. The cutter still argues against every addition and the default is still no,… | process | accepted | the-process | How this book was made, and what you made | Decision 012: The book is 200 pages or more, Gen ZX Developers | 0 |
| A change decided by precedent goes on a list Dinis can overturn, and Dinis reads the diffs of the book Two safeguards instead of a yes on everything: the list of changes decided by precedent, which Dinis can overturn (overturning makes a new precedent), and the diff, becau… | process | accepted | the-process | How this book was made, and what you made | Decision 011: Precedents go on a list Dinis can overturn, and Dinis reads the diffs, The book in release mode | 0 |
| The hands-on part is inside the book, dated, in the release candidate The practical workflows, dated 2026 and renewed each year, are inside the book and go into the candidate with the rest: each as written as its sources allow, the others a… | process | accepted | the-process | How this book was made, and what you made | Decision 013: The hands-on part is in the release candidate, Follow the rabbit holes | 0 |
An idea is accepted when Dinis said it as his own position in a co-written article; the editor still records it in the vault as a decision on the text. A candidate is the librarian's reading of a newsroom article; it waits for the read, comment, decide loop. Source: admin/content/graph/ideas.json; graph.json; the graph.