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

State destination
IdeaKindStateGoes toChapterFromAnswers
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…
frameacceptedthis-editionYou are lucky to be hereYou are lucky to be here, The opening: you are lucky to be here2
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.
claimacceptedthis-editionYou are lucky to be hereYou are lucky to be here1
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…
claimacceptedthis-editionYou are lucky to be hereYou are lucky to be here, Two years in, the opposite0
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.
storycandidatethis-editionYou are lucky to be hereYou are lucky to be here, The opening: you are lucky to be here2
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.
claimacceptedthis-editionYou are lucky to be hereYou are lucky to be here, Custom UIs are not the exception2
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.
claimacceptedthis-editionConnect the dots backwardsYou are lucky to be here, Connect the dots backwards2
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.
adviceacceptedthis-editionEveryone who can brief an agent is a developerYou are lucky to be here, The citizen developer is good news2
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.
adviceacceptedthis-editionConnect the dots backwardsYou are lucky to be here, Connect the dots backwards1
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.
claimcandidatethis-editionWhere do you land?You are lucky to be here0
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.
adviceacceptedthis-editionYou are lucky to be hereConnect the dots backwards2
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.
frameacceptedthis-editionConnect the dots backwardsConnect the dots backwards, Connect the dots backwards2
The edge is now multidisciplinary
Learning to intersect disciplines is where the advantage is; the humanities and mathematics both matter.
claimacceptedthis-editionConnect the dots backwardsConnect the dots backwards1
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…
claimacceptedthis-editionConnect the dots backwardsConnect the dots backwards1
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.
claimacceptedthis-editionConnect the dots backwardsConnect the dots backwards, Storyboards drawn by code, and the newsroom read in full1
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.
claimacceptedthis-editionConnect the dots backwardsConnect the dots backwards, Who will game the reading meter? Eight kinds of reader, nine ways to cheat, and the risks that will actually happen1
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.
frameacceptedthis-editionWhere 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.
frameacceptedthis-editionWhere 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 gravity1
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…
frameacceptedthis-editionWhere 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 more1
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.
methodacceptedthis-editionWhere 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 gravity1
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.
framecandidatethis-editionExplorer coding, not vibe coding, and the handoverExplorer coding, A browser for one2
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 …
framecandidatethis-editionExplorer coding, not vibe coding, and the handoverWho 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 fast2
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…
frameacceptedthis-editionEveryone who can brief an agent is a developerGeneration Z Developers (AI edition), The citizen developer is good news, GenAI in Portuguese, 2024 and 1 more3
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…
claimcandidatethis-editionHired for the workflowHired for the workflow, How to get a job2
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.
advicecandidatethis-editionHired for the workflowHired for the workflow1
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…
advicecandidatethis-editionHired for the workflowHired for the workflow2
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…
advicecandidatethis-editionAct as the job you wantAct as the job you want, How to get a job4
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.
advicecandidatethis-editionAct as the job you wantAct as the job you want, Three companies, three LinkedIn pages4
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.
advicecandidatethis-editionAct as the job you wantThe survey's gaps, Start from the storyline1
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…
claimcandidatethis-editionYou are lucky to be hereThe survey's gaps, Generation Z Developers (AI edition), You are lucky to be here1
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 …
methodcandidatethis-editionPublish, publish, publish: your own newsroomYour own newsroom, Books from articles, Twenty sites in fifteen days, and what that did to the writing4
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.
methodcandidatethis-editionPublish, publish, publish: your own newsroomThe man behind the curtain, For a startup, the most important question is whether they miss it1
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…
methodcandidatethis-editionYour first workspaceFrom a spreadsheet to a folder per person, Replicating the agentic inbox, How I work with Claude and 1 more3
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.
methodcandidatethis-editionHow to work with agentsHow I work with Claude, The agents write too, The Librarian's daily brief2
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…
methodcandidatethis-editionHow to work with agentsWrite it as an article, The briefs so far, Brief the agent too1
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.
methodcandidatethis-editionHow to work with agentsOmnichannel programming2
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.
claimcandidatethis-editionHow to work with agentsEvery mistake added a rule, Re-anchoring1
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.
advicecandidatethis-editionYour first workspaceWhy my agents do not run on my laptop1
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 …
framecandidatethis-editionDirection is the scarce skillPlaces of highest leverage, Not a straight line, Connect the dots backwards2
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…
claimcandidatethis-editionDirection is the scarce skillKnowing when to stop, Brain2
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…
framecandidatethis-editionDirection is the scarce skillThe human in the loop is a spectrum, The human in the loop, safety net or bottleneck, Footprint and blast radius and 1 more3
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.
claimcandidatethis-editionDirection is the scarce skillWho owns the words, The policy draws the liability line1
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…
methodcandidatethis-editionFacts, evidence and the recordMy memory, checked, Reviews on the record, Your agent's logs are a self-report and 1 more3
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…
framecandidatethis-editionControlling your agent: RiskMandateWhat 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 more2
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.
claimcandidatethis-editionControlling your agent: RiskMandateThe code you do not ship, The minimum code below3
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.
advicecandidatethis-editionControlling your agent: RiskMandateWho are you protecting against? Draw the security line where the attacker is, not above it, Fix the page yourself, Hacking Portugal, 20163
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.
advicecandidatethis-editionControlling your agent: RiskMandateHanding secrets to agents and browsers, Seven vaults, one method, A skill behaviour policy2
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…
claimcandidatethis-editionOpen sourceThe fork next door, What open source is, and what it is not, The eyeballs get cheap and 1 more2
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.
advicecandidatethis-editionOpen sourceOur first PR in Ruflo, Act as the job you want2
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.
methodcandidatethis-editionServerless, for realCloudflare as Lego blocks, Free models, your own key, Ephemeral town planner services and 2 more5
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…
claimcandidatethis-editionShipped means the user has itGreen does not mean live, Go slow to go fast, How to run synthetic users on your own site4
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…
framecandidatethis-editionGraphs, memory and your future selfThe graphs books, Knowledge that maintains itself, Bringing my past work back and 2 more5
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…
claimcandidatethis-editionBe a founder: the expert foundersThe expert founders, For a startup, the most important question is whether they miss it, Paying after the value and 1 more1
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.
claimcandidatethis-editionCivic responsibilityA web application security challenge to Portugal, 2010, Hacking Portugal, 2016, Judo for small countries and 1 more1
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.
processacceptedthis-editionHow this book was made, and what you madeA website to finish the book, Decision 005: Text issues live in the vault1
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…
processacceptedthis-editionHow this book was made, and what you madeShort, 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 speaking1
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.
processdeferrednext-versionHow this book was made, and what you madeA book for one reader0
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…
processacceptedthe-processHow this book was made, and what you madeRead, comment, decide, Decision 006: Every change is minor, unless Dinis says it is major0
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.
processacceptedthe-processHow this book was made, and what you madeWrite it as an article, Decision 007: Two kinds of article0
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 …
processacceptedthe-processHow this book was made, and what you madeRelease 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 more0
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…
processacceptedthe-processHow this book was made, and what you madeOne board for the book, Everything unfinished in one place, Decision 005: Text issues live in the vault0
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 …
processacceptedthe-processHow this book was made, and what you madeStart from the storyline, Storyboards drawn by code, and the newsroom read in full0
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 …
processacceptedthe-processHow this book was made, and what you madeA 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 more1
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…
frameacceptedthis-editionWhat generative AI isGenerative AI, not AI1
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…
claimacceptedthis-editionWhat generative AI isGenerative AI, not AI2
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…
methodacceptedthis-editionFacts, evidence and the recordGenerative AI, not AI, My memory, checked2
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…
processacceptedthis-editionHow this book was made, and what you madeGenerative AI, not AI, Generation Z Developers (AI edition), Decision 010: The title is Gen Z Developers (GenAI Edition) and 2 more0
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.
frameacceptedthis-editionYou are lucky to be hereWhere the thinking came from, You are lucky to be here1
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.
evidenceacceptedthis-editionConnect the dots backwardsWhere the thinking came from3
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.
frameacceptedthis-editionFacts, evidence and the recordWhere the thinking came from1
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 …
adviceacceptedthis-editionConnect the dots backwardsWhere the thinking came from2
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…
storyacceptedthis-editionOpen sourceWhere the thinking came from, OWASP2
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.
frameacceptedthis-editionExplorer coding, not vibe coding, and the handoverWhere the thinking came from2
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…
frameacceptedthis-editionYou are lucky to be hereWhere the thinking came from, Machine Learning and AI2
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,…
claimacceptedthis-editionFacts, evidence and the recordFollow the rabbit holes, Follow the rabbit holes, Facts1
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 …
storycandidatethis-editionFacts, evidence and the recordFollow the rabbit holes0
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…
adviceacceptedthis-editionFacts, evidence and the recordFollow the rabbit holes, Where the thinking came from, Generative AI, not AI1
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…
frameacceptedthis-editionFacts, evidence and the recordFollow the rabbit holes, My memory, checked, Reviews on the record and 1 more2
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…
claimcandidatethis-editionFacts, evidence and the recordFollow the rabbit holes1
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…
claimcandidatethis-editionFacts, evidence and the recordFollow the rabbit holes, The briefs so far1
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 …
advicecandidatethis-editionFacts, evidence and the recordFollow the rabbit holes0
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…
processacceptedthis-editionHow this book was made, and what you madeFollow the rabbit holes, From a spreadsheet to a folder per person, Your own newsroom and 2 more0
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…
frameacceptedthis-editionEverything is connected: graphsEverything is connected, The graphs books, graphs1
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…
storyacceptedthis-editionEverything is connected: graphsEverything is connected, Everything is connected, Follow the rabbit holes1
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 …
frameacceptedthis-editionEverything is connected: graphsEverything 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 gravity1
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…
frameacceptedthis-editionEverything is connected: graphsEverything is connected, Fractal Semantic Graphs2
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,…
claimacceptedthis-editionFacts, evidence and the recordEverything is connected, When journalism becomes intelligence, built, Memory is not a spectator sport2
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…
adviceacceptedthis-editionEverything is connected: graphsEverything is connected, Connect the dots backwards2
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…
evidencecandidatethis-editionEverything is connected: graphsEverything 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…
claimcandidatethis-editionEverything is connected: graphsCode review as a fractal semantic graph, Code review as a fractal semantic graph, Everything is connected3
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…
methodcandidatethis-editionFacts, evidence and the recordCode review as a fractal semantic graph, Knowledge that maintains itself2
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…
advicecandidatethis-editionBe a founder: the expert foundersCode review as a fractal semantic graph0
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…
methodcandidatethis-editionPublish, publish, publish: your own newsroomHow 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 was1
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…
claimcandidatethis-editionPublish, publish, publish: your own newsroomHow the voice works1
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 …
advicecandidatethis-editionHow to work with agentsHow the voice works, Re-anchoring0
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…
framecandidatethis-editionGraphs, memory and your future selfMemory is not a spectator sport, Memory is not a spectator sport, Memory is not a spectator sport2
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…
advicecandidatethis-editionGraphs, memory and your future selfMemory is not a spectator sport, Memory is not a spectator sport3
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…
claimcandidatethis-editionFacts, evidence and the recordMemory is not a spectator sport1
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…
methodcandidatethis-editionServerless, for realNo server, by design1
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 …
framecandidatethis-editionServerless, for realNo server, by design, No server, by design, No server, by design1
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…
claimcandidatethis-editionControlling your agent: RiskMandateNo server, by design, Who are you protecting against? Draw the security line where the attacker is, not above it2
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 …
claimcandidatethis-editionOpen sourceNo server, by design1
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.…
frameacceptedthis-editionLenses, roles and loopsLenses, roles and loops, Lenses, roles and loops0
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…
frameacceptedthis-editionLenses, roles and loopsLenses, roles and loops, How I work with Claude, Lenses, roles and loops0
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…
claimacceptedthis-editionLenses, roles and loopsLenses, roles and loops1
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…
claimacceptedthis-editionLenses, roles and loopsLenses, roles and loops, Memory is not a spectator sport0
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…
adviceacceptedthis-editionLenses, roles and loopsLenses, roles and loops, Re-anchoring, Replicating the agentic inbox0
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 …
processacceptedthe-processHow this book was made, and what you madeThe book in release mode, Decision 008: The book is made in release mode, through a review board, The book as a graph0
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…
processacceptedthe-processHow this book was made, and what you madeThe book in release mode, Decision 008: The book is made in release mode, through a review board, Lenses, roles and loops0
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…
processacceptedthe-processHow this book was made, and what you madeThe book in release mode, Decision 008: The book is made in release mode, through a review board0
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…
processacceptedthe-processHow this book was made, and what you madeDecision 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 register0
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…
frameacceptedthis-editionGen ZX: who this book is for, and what it is forGen ZX Developers, Be a founder, Decision 015: The Gen ZX proposal is the frame of release candidate 21
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…
frameacceptedthis-editionGen ZX: who this book is for, and what it is forGen 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…
claimacceptedthis-editionExplorer coding, not vibe coding, and the handoverGen ZX Developers, Explorer coding, Who will fix your mess? An answer to HBR's "deployment gap" from what this site has already published1
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,…
adviceacceptedthis-editionServerless, for realGen ZX Developers, No server, by design, Ephemeral town planner services and 1 more1
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…
processacceptedthis-editionHow this book was made, and what you madeGen ZX Developers0
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…
adviceacceptedthis-editionThe company itself: the UK, Portugal, Lithuania, the European UnionGen ZX Developers, Not a straight line0
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,…
processacceptedthe-processHow this book was made, and what you madeDecision 012: The book is 200 pages or more, Gen ZX Developers0
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…
processacceptedthe-processHow this book was made, and what you madeDecision 011: Precedents go on a list Dinis can overturn, and Dinis reads the diffs, The book in release mode0
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…
processacceptedthe-processHow this book was made, and what you madeDecision 013: The hands-on part is in the release candidate, Follow the rabbit holes0

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.