<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:itunes="http://www.itunes.com/dtds/podcast-1.0.dtd" xmlns:googleplay="http://www.google.com/schemas/play-podcasts/1.0"><channel><title><![CDATA[Leadership as a verb: Behind the Verb]]></title><description><![CDATA[The essays, the practice, the patching provokes you. Behind the verb it's raw, unscripted, human material. Corrections of your own past beliefs. Reactions to things that happened.]]></description><link>https://newsletter.diamantinoalmeida.com/s/behind-the-verb</link><image><url>https://substackcdn.com/image/fetch/$s_!zzQt!,w_256,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F47b96b05-0a92-48f4-84b4-2405082dac47_1280x1280.png</url><title>Leadership as a verb: Behind the Verb</title><link>https://newsletter.diamantinoalmeida.com/s/behind-the-verb</link></image><generator>Substack</generator><lastBuildDate>Wed, 14 Oct 2026 10:03:12 GMT</lastBuildDate><atom:link href="https://newsletter.diamantinoalmeida.com/feed" rel="self" type="application/rss+xml"/><copyright><![CDATA[Diamantino Almeida]]></copyright><language><![CDATA[en]]></language><webMaster><![CDATA[diamantino.almeida@substack.com]]></webMaster><itunes:owner><itunes:email><![CDATA[diamantino.almeida@substack.com]]></itunes:email><itunes:name><![CDATA[Diamantino Almeida]]></itunes:name></itunes:owner><itunes:author><![CDATA[Diamantino Almeida]]></itunes:author><googleplay:owner><![CDATA[diamantino.almeida@substack.com]]></googleplay:owner><googleplay:email><![CDATA[diamantino.almeida@substack.com]]></googleplay:email><googleplay:author><![CDATA[Diamantino Almeida]]></googleplay:author><itunes:block><![CDATA[Yes]]></itunes:block><item><title><![CDATA[Stop saying “AI did it”]]></title><description><![CDATA[On the dangerous habit of giving a tool the credit, the blame, and the power that belong to people.]]></description><link>https://newsletter.diamantinoalmeida.com/p/stop-saying-ai-did-it</link><guid isPermaLink="false">https://newsletter.diamantinoalmeida.com/p/stop-saying-ai-did-it</guid><dc:creator><![CDATA[Diamantino Almeida]]></dc:creator><pubDate>Tue, 13 Oct 2026 12:05:45 GMT</pubDate><enclosure url="https://substack-post-media.s3.amazonaws.com/public/images/887d2703-fbbc-4750-bcbb-885083f7ef48_4786x2818.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<p>I keep hearing sentences like these:</p><p>&#8220;AI is reading your files.&#8221;</p><p>&#8220;AI is cheating you.&#8221;</p><p>&#8220;AI is making people dumb.&#8221;</p><p>&#8220;AI will be our doom.&#8221;</p><p>&#8220;AI will solve all our problems.&#8221;</p><p>They sound different, but they share something important.</p><p>They all treat AI as if it were a person.</p><p>As if it had intentions, wanted something, could act on its own.</p><p>But AI does not want anything.</p><p>It does not decide to read your files, to deceive you, to make you dependent, to decide to solve your problems.</p><p>It does not decide to harm anyone.</p><p>AI is a technology.</p><p>It is programmed, trained, deployed, and used by people.</p><p>And when we say &#8220;AI did it,&#8221; we often hide the more uncomfortable truth:</p><p><strong>People did it. And all the bad things you are seeing done by this technology, are either bugs, due to lack of proper safety testing, limitations of the technology itself, and ultimately human error.</strong></p><h2><strong>The attribution problem</strong></h2><p>We have a habit of giving technology too much credit.</p><p>We say:</p><p>&#8220;AI made a mistake.&#8221;</p><p>&#8220;AI wrote this.&#8221;</p><p>&#8220;AI decided that.&#8221;</p><p>&#8220;AI is coming for our jobs.&#8221;</p><p>&#8220;AI is changing everything.&#8221;</p><p>Sometimes, this is just a shortcut. A simple way to speak. I do it too. It is easier to say &#8220;AI wrote this&#8221; than &#8220;a person used a system trained on data, designed by a company, and generated this output.&#8221;</p><p>But <em><strong>language</strong></em> shapes how we think.</p><p>If we keep saying that AI acts, wants, decides, cheats, and threatens, we slowly start to believe it.</p><p>We start treating it like an entity. Something with a mind, with a will, something we need to fear, obey, or worship.</p><p>But AI is not alive, does not have desires, hidden agenda.</p><h2><strong>Leadership begins with attention, to what we believe, what we say, and what we allow to become normal.</strong></h2><p>It does not wake up in the morning and decide to make your life difficult.</p><p>It performs tasks it has been trained and programmed to perform.</p><p>It can mimic parts of human capability, language, pattern recognition, prediction, problem-solving, and creativity.</p><p>But mimicry is not consciousness.</p><p>Capability is not intention.</p><h2><strong>What AI actually is</strong></h2><p>AI is not magic, not a brain, not a person trapped inside a machine.</p><p>It is a system built by humans.</p><p>People choose the data, design the models, set the objectives, decide what the system can access.</p><p>People decide how it is deployed, who can use it, what happens when it causes harm.</p><p>That does not mean AI is simple. It is not.</p><p>Modern systems are complex. They can produce surprising results. They can make errors that are difficult to predict. They can be used in ways their creators did not expect.</p><p>But complexity is not the same as agency, or else a city would be a living creature. But it is mimicking what already exist in nature.</p><p>A system can be powerful without having a will, can be dangerous without being evil, produce harmful output without wanting to harm anyone.</p><p><strong>The responsibility still sits with the people and organisations that build, train, sell, deploy, and use it.</strong></p><h2><strong>The real adversary</strong></h2><p>When AI causes harm, we should not only ask:</p><p>&#8220;What did the AI do?&#8221;</p><p>We should ask:</p><p>&#8220;Who built it?&#8221;</p><p>&#8220;Who trained it?&#8221;</p><p>&#8220;Who profited from it?&#8221;</p><p>&#8220;Who deployed it?&#8221;</p><p>&#8220;Who ignored the risks?&#8221;</p><p>&#8220;Who decided that speed, growth, or adoption mattered more than safety?&#8221;</p><p>These are human questions.</p><p>They point to human decisions.</p><p>A company may deploy a system before it is properly tested.</p><p>A team may train a model on data that contains bias.</p><p>A product may be designed to keep people engaged rather than help them think.</p><p>A leader may push adoption because competitors are doing it.</p><p>A person may use AI to deceive, manipulate, or harm someone else.</p><p>In each case, AI is the instrument.</p><p><strong>People are the actors.</strong></p><p>This matters because it changes where we look for solutions.</p><p>If AI is the adversary, then we may feel helpless. We may believe the future is being decided by a technology we cannot control.</p><p>But if people and companies are responsible, then we can demand better decisions.</p><p>We can ask for transparency, safety testing, for accountability.</p><p>Ask who benefits and who carries the risk.</p><p>We can choose not to buy, use, or support products that treat people carelessly.</p><h2><strong>Cyber harm is not new</strong></h2><p>We have seen this before.</p><p>In the 1990s and 2000s, viruses, worms, and other malicious software spread across the internet.</p><p>We did not say, &#8220;The internet attacked us.&#8221;</p><p>We did not say, &#8220;Computers decided to harm people.&#8221;</p><p>We said, someone wrote the malicious code.</p><p>Someone released it, exploited a weakness, chose to cause damage.</p><p>The technology made the harm possible.</p><p>But people made it happen.</p><p>AI-enabled cyber attacks are not fundamentally different.</p><p>A system may help write malicious code, find vulnerabilities, create convincing phishing messages, or automate parts of an attack.</p><p>But behind that capability, there are people.</p><p>People who choose to use it for harm, build tools without adequate protections, profit from systems that can be misused.</p><p>People who fail to secure the systems they deploy.</p><p>The harm is not created by an autonomous machine with evil intentions.</p><p>It is created by <strong>human choices.</strong></p><h2><strong>The superhero problem</strong></h2><p>There is another reason we talk about AI as if it were alive.</p><p>We like stories.</p><p>We grow up with superheroes, villains, robots, and machines that become conscious. We are used to narratives where technology has a personality, a mission, and a destiny. This is nothing new, it goes way back.</p><p>So when a new technology arrives, we often reach for the same language.</p><p>AI becomes the hero, the villain, the force that will save us or destroy us.</p><p>But AI is not a character in a comic book.</p><p>It does not have a secret plan.</p><p>It does not have a destiny.</p><p>It does not &#8220;want&#8221; to take over the world.</p><p>When we speak as if it does, we turn a tool into a myth. Make me wonder why a certain company give to one of it&#8217;s models the name of Mythos.</p><p>And myths are powerful.</p><p>They can make us feel powerless, make us accept decisions without questioning them, believe that the future is already written.</p><p>But the future is not written by AI.</p><p>It is written by people who decide what to build, what to sell, what to regulate, what to ignore, and what to protect.</p><h2><strong>A more honest language</strong></h2><p>I am not saying we should never use the word &#8220;AI.&#8221;</p><p>That would be unrealistic. It is a useful shorthand. But we should be more careful with our verbs.</p><p>Instead of saying:</p><p>&#8220;AI is reading your files.&#8221;</p><p>Try:</p><p>&#8220;A company built a system that can access and process your files.&#8221;</p><p>Instead of saying:</p><p>&#8220;AI is cheating you.&#8221;</p><p><strong>Try</strong>:</p><p>&#8220;Someone used an AI system to deceive you, or a company designed a product in a way that misleads people.&#8221;</p><p>Instead of saying:</p><p>&#8220;AI will take our jobs.&#8221;</p><p><strong>Try:</strong></p><p>&#8220;Some employers may choose to replace people with systems because they believe it will reduce cost or increase output.&#8221;</p><p>Instead of saying:</p><p>&#8220;AI will solve everything.&#8221;</p><p><strong>Try</strong>:</p><p>&#8220;People are choosing where to apply AI, and some problems may benefit from it while others will not.&#8221;</p><p>This is not just grammar.</p><p>It is responsibility.</p><h2><strong>What I refuse to accept</strong></h2><p>I do not want to live in a world where we blame a tool for human choices, companies to hide behind the phrase:</p><p>&#8220;The AI made a mistake.&#8221;</p><p>A system does not make a mistake in the human sense.</p><p>A system produces an output.</p><p>People decide whether that output is acceptable, whether to release it, to fix it, to take responsibility.</p><p>And when harm happens, &#8220;the AI did it&#8221; <strong>should never be enough.</strong></p><h2><strong>What we believe, say, and accept</strong></h2><p>AI is not our enemy, not our saviour, not an independent actor with a plan for humanity.</p><p>Leadership is not only about what we do.</p><p>It is also about what we believe, what we say, and what we accept as normal.</p><p>If we keep saying &#8220;AI decided,&#8221; we may stop asking who made the decision to build, deploy, or trust that system.</p><p>If we say &#8220;AI is taking our jobs,&#8221; we may miss the choices employers make about cost, staffing, and the future of work.</p><p>If we say &#8220;AI will solve everything,&#8221; we may accept promises without asking who benefits, who carries the risk, and what evidence supports them.</p><p>The words we use matter because they shape the questions we ask.</p><p>And the questions we ask shape what we are willing to accept.</p><p>As leaders, we should pay attention to both. Not because every phrase needs to be perfect, but because careless language can hide responsibility. When we give technology human motives, we can make human choices seem inevitable.</p><ul><li><p>So when I hear &#8220;AI did it,&#8221; I want to pause.</p></li><li><p>What do I believe about what happened?</p></li><li><p>What am I saying and what might my words hide?</p></li><li><p>What am I being asked to accept as inevitable?</p></li></ul><p>Those are leadership questions.</p><p>Because leadership begins before the decision. It begins with the beliefs we carry, the language we use, and the things we choose not to challenge.</p><p><strong>What are we accepting when we say, &#8220;AI did it&#8221;?</strong></p><div><hr></div><p><strong>About the Author</strong><br><em><a href="https://diamantinoalmeida.com/">Diamantino Almeida</a> is a tech leader, <a href="https://tidycal.com/diamantinoalmeida/career-coaching-session">coach</a>, and writer reshaping how we think about <a href="https://tidycal.com/diamantinoalmeida/shared-leadership-coaching-session">leadership </a>in a burnout-driven world. With over 20 years at the intersection of engineering, DevOps, and team culture, he helps humans lead consciously from the inside out. When he&#8217;s not challenging outdated norms, he&#8217;s plotting how to make work more human, <strong><a href="https://newsletter.diamantinoalmeida.com">one verb at a time.</a></strong></em></p><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://newsletter.diamantinoalmeida.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">Leadership as a Verb helps leaders make better decisions and lead with integrity when speed, scale, and pressure make good leadership hard. Leadership as a verb. </p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div><p></p>]]></content:encoded></item><item><title><![CDATA[What we’re choosing to ignore, statistically.]]></title><description><![CDATA[We should be precise about what we mean by AI.]]></description><link>https://newsletter.diamantinoalmeida.com/p/ai-is-harmless-because-it-is-only</link><guid isPermaLink="false">https://newsletter.diamantinoalmeida.com/p/ai-is-harmless-because-it-is-only</guid><dc:creator><![CDATA[Diamantino Almeida]]></dc:creator><pubDate>Fri, 18 Sep 2026 12:13:20 GMT</pubDate><enclosure url="https://substack-post-media.s3.amazonaws.com/public/images/87490673-3a8a-41ee-a913-49b9a46533a6_4786x2818.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<p>We should be precise about what we mean by AI. Most systems currently described as intelligent or autonomous are <strong>large-scale probabilistic models connected to conventional software, data stores and APIs</strong>. </p><p>The same way that memory is prescribed as human-like is just a <strong>vector database</strong>. </p><p>It can generate useful outputs, select from available tools and execute bounded workflows, but they <strong>do not possess consciousness, intrinsic goals or independent moral agency</strong>.</p><p>Current AI systems are <strong>non-conscious statistical and computational systems</strong> that can become operationally powerful when embedded in software, organisations and authority structures. </p><p>Their risks come primarily from <strong>human deployment decisions, economic incentives, system design, misuse and over-trust</strong> not from demonstrated independent intention.</p><blockquote><p>That does not make them harmless. </p></blockquote><p>The real risks arise when humans give <strong>unreliable systems excessive authority</strong>, deploy them without adequate testing, or encourage people to trust fluent outputs as if they were judgments from a sentient expert.</p><p>&#8220;AI will destroy us&#8221; is too vague to be useful. &#8220;AI will take everyone&#8217;s jobs&#8221; is equally incomplete. </p><p>The more immediate questions are, <strong>which tasks will be automated, who controls the systems, what permissions have been granted, how are failures detected, and who remains accountable?</strong> </p><blockquote><p><strong>Remember: Board concerns dismissed</strong> in favor of speed and <a href="https://pmc.ncbi.nlm.nih.gov/articles/PMC8994059/#:~:text=dominate%20and%20control%20the%20market">market dominance.</a></p></blockquote><p>And most importantly, <strong>what can we as citizens do to collaborate</strong>, since in the end it will be us most impacted by what AI technologies can do for us or not.</p><p>Companies should also be accountable, and legislated,  about what they have built. Integrating a foundation model into a product can create substantial engineering value, but it is <strong>not the same as inventing the underlying intelligence</strong>. </p><blockquote><p>Remember: We need federal regulations rather than trusting industry self-policing.</p></blockquote><p>Marketing that blurs this distinction encourages fear, dependency and misplaced trust.</p><p>We need <strong>less anthropomorphism, less passive-aggressive futurism and more engineering clarity</strong>: defined capabilities, bounded authority, measurable reliability, transparent limitations and accountable human ownership.</p><blockquote><p>Remember: History does not offer examples where concentrating enormous power in a few hands, without robust institutional constraints, produced sustainably beneficial outcomes for societies at large. The Roman emperors, absolute monarchs, 20th-century dictators, and modern autocrats all followed the same trajectory, initial consolidation, erosion of accountability, corruption, suppression, and eventual collapse or catastrophic harm.</p></blockquote><div><hr></div><p><strong>About the Author</strong><br><em><a href="https://diamantinoalmeida.com/">Diamantino Almeida</a> is a tech leader, <a href="https://tidycal.com/diamantinoalmeida/career-coaching-session">coach</a>, and writer reshaping how we think about <a href="https://tidycal.com/diamantinoalmeida/shared-leadership-coaching-session">leadership </a>in a burnout-driven world. With over 20 years at the intersection of engineering, DevOps, and team culture, he helps humans lead consciously from the inside out. When he&#8217;s not challenging outdated norms, he&#8217;s plotting how to make work more human, <strong><a href="https://newsletter.diamantinoalmeida.com">one verb at a time.</a></strong></em></p><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://newsletter.diamantinoalmeida.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">Leadership as a verb is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div><p></p><p></p>]]></content:encoded></item><item><title><![CDATA[What It Actually Takes to Build AI That Works in Production]]></title><description><![CDATA[As engineering managers, CTOs and tech leads, we see the hype every day.]]></description><link>https://newsletter.diamantinoalmeida.com/p/ai-what-it-actually-takes-to-build</link><guid isPermaLink="false">https://newsletter.diamantinoalmeida.com/p/ai-what-it-actually-takes-to-build</guid><dc:creator><![CDATA[Diamantino Almeida]]></dc:creator><pubDate>Tue, 08 Sep 2026 13:15:23 GMT</pubDate><enclosure url="https://substack-post-media.s3.amazonaws.com/public/images/b5f08c7d-b369-4711-b869-b15401d69ef7_4786x2818.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<p>As engineering managers, CTOs and tech leads, we see the hype every day.</p><p>People ask me what their teams should learn to &#8220;get into AI&#8221;, how to build proper AI products, or which course will turn a developer into an AI engineer in 30 days.</p><p>Honestly, I am tired of seeing people sold a lie.</p><p>The internet is full of content promising that anyone can &#8220;master Claude&#8221;, build an agent overnight, or become an AI engineer by learning a handful of prompts and connecting an API key to a web page.</p><p>That is not how serious engineering works.</p><p>A clever prompt can create an impressive demo. It can even create a useful prototype. But a prompt, an API key and a chat interface do not automatically create a durable product, a defensible business, or an AI engineering capability.</p><p>Equally, we should not swing too far in the other direction and tell every software engineer that they need a PhD in mathematics before they can contribute.</p><p>Both views are wrong.</p><p>The real skill is learning how to build reliable systems around probabilistic models. Systems with useful data, clear user value, proper evaluation, secure boundaries, human accountability and operational discipline.</p><p>AI is not magic. But it is not simply autocomplete either.</p><p>It is software engineering, data engineering, product judgement, statistics, security, operations and organisational change, all meeting in one messy place.</p><p>If you want to build a serious AI capability in your engineering organisation, I believe there are six foundations that matter.</p><h2><strong>1. Start with the problem, not the model</strong></h2><p>The first question should not be:</p><blockquote><p>&#8220;Which model should we use?&#8221;</p></blockquote><p>It should be:</p><blockquote><p>&#8220;What user problem, decision or workflow would genuinely improve here?&#8221;</p></blockquote><p>Too many teams start with a model and go looking for a use case. They build a chatbot because chatbots are easy to demo. They build an agent because every vendor is talking about agents. They add AI to a product because investors, competitors or senior leadership expect it.</p><p>That is how you end up with expensive features nobody trusts or uses.</p><p>A serious AI product starts with a clear problem:</p><ul><li><p>What job is the user trying to do?</p></li><li><p>Where are they losing time, making errors or getting stuck?</p></li><li><p>What does good look like?</p></li><li><p>What happens when the system is wrong?</p></li><li><p>Should this be automated, assisted or kept entirely human-led?</p></li><li><p>Could a better process, search experience, workflow or rules engine solve this more reliably?</p></li></ul><p>AI is valuable when it improves a real outcome, not when it generates an impressive screenshot.</p><p>For example, an internal support assistant should not be judged by whether its answers sound intelligent. It should be judged by whether it helps people resolve issues more quickly, points them to authoritative sources, reduces repetitive work and safely escalates when it is uncertain.</p><p>If you cannot define the user outcome and how you will measure it, you are not ready to choose a model.</p><h2><strong>2. Learn the fundamentals at the right depth</strong></h2><p>There is a persistent argument about whether people need maths to work in AI.</p><p>The honest answer is: it depends on what kind of work you want to do.</p><p>If you are researching models, training models, fine-tuning them, designing retrieval systems, improving ranking, managing inference infrastructure or working close to the machine-learning layer, then yes, mathematics matters a great deal.</p><p>You need to understand concepts such as:</p><ul><li><p>Linear algebra: vectors, matrices, embeddings and similarity.</p></li><li><p>Probability and statistics: uncertainty, distributions, sampling, confidence and evaluation.</p></li><li><p>Optimisation: how models learn, how loss functions work and why training can fail.</p></li><li><p>Neural networks and deep learning: what a model is doing when it processes data.</p></li></ul><p>You do not need to become a pure mathematician. But you do need enough understanding to know what is happening beneath the abstraction.</p><p>However, not every person building an AI-enabled product needs to derive matrix multiplication by hand.</p><p>A strong application engineer can build valuable AI features by understanding the practical behaviour of models, their limitations, their failure modes and how to engineer reliable systems around them.</p><p>The important thing is intellectual honesty.</p><p>Do not pretend an LLM is magic. Do not treat it as a human brain. And do not assume it knows what is true simply because it says something confidently.</p><p>At a basic level, language models predict likely next tokens based on patterns in their training data and the context they are given. That apparently simple mechanism can produce remarkable results across language, code, reasoning-like tasks and multimodal inputs.</p><p>But it does not make the output inherently factual, safe or appropriate for your organisation.</p><p>That is your engineering job.</p><h2><strong>3. Data is usually the real product</strong></h2><p>Most organisations do not have an AI problem.</p><p>They have a data problem.</p><p>Their information is duplicated, stale, scattered across tools, inconsistently named, inaccessible to the people who need it, or full of conflicting advice. Then they expect an LLM to somehow make it clean, current and trustworthy.</p><p>It will not.</p><p>If your AI product depends on company knowledge, customer information, policies, contracts, technical documentation or operational data, then data quality becomes a core engineering concern.</p><p>Your team needs to <strong>understand</strong>:</p><ul><li><p>Where the source data comes from.</p></li><li><p>Who owns it and who is accountable for keeping it current.</p></li><li><p>Whether it is accurate, complete and authoritative.</p></li><li><p>Which version is the source of truth when documents conflict.</p></li><li><p>Who is allowed to access it.</p></li><li><p>Whether the data contains personal, confidential, regulated or commercially sensitive information.</p></li><li><p>How data is retained, deleted, audited and protected.</p></li></ul><p>This is where retrieval-augmented generation, usually called RAG, can be useful.</p><p>RAG allows a system to retrieve relevant information at runtime and provide that information to the model as context. Instead of relying entirely on the model&#8217;s training data, the system can search internal documentation, policies, product catalogues, support records or knowledge bases before generating an answer.</p><p>That can improve relevance, freshness and grounding.</p><p>But RAG does not &#8220;fix hallucinations&#8221;.</p><p>It can still retrieve the wrong documents. It can retrieve incomplete or stale information. It can expose content the user should not see if permissions are badly designed. The model can misunderstand the evidence, ignore it or confidently invent an answer around it.</p><p>Good RAG is not just &#8220;put documents in a vector database&#8221;.</p><p>It requires source quality, document ownership, chunking, metadata, access controls, retrieval evaluation, relevance ranking, citations, clear uncertainty handling and continuous monitoring.</p><p>And do not throw away traditional search.</p><p>Keyword search remains excellent for exact error codes, policy clauses, product identifiers, customer names, technical acronyms and rare terms. In many real systems, the right approach is hybrid retrieval: combining keyword search, semantic search, metadata filters and reranking.</p><p>Choose based on evidence and evaluation, not ideology.</p><h2><strong>4. Build Systems, Not Prompt Demos</strong></h2><p>Prompting matters.</p><p>Good system instructions, examples, context design, tool descriptions and output constraints can make a substantial difference to quality. Prompt engineering is a real part of modern AI application work.</p><p>But prompting alone is not a durable technical strategy.</p><p>A thin interface over a general-purpose model is easy to copy. It is also exposed to vendor pricing changes, rate limits, model-version changes and the simple fact that the next model may make your basic feature available to everyone.</p><p>That does not mean using an API is a bad business model.</p><p>It means your value cannot be only the API call.</p><p>Durable AI products create value through things that are harder to replicate:</p><ul><li><p>Deep integration into a real user workflow.</p></li><li><p>Proprietary or carefully governed domain data.</p></li><li><p>A strong user experience.</p></li><li><p>Reliable automation and orchestration.</p></li><li><p>Trust, safety and auditability.</p></li><li><p>Better operational processes.</p></li><li><p>Distribution and customer relationships.</p></li><li><p>A clear understanding of the domain problem.</p></li></ul><p>This is also where conventional software engineering still matters enormously.</p><p>You need proper APIs, authentication, authorisation, databases, queues, retries, rate limiting, caching, error handling, observability, resilient fallbacks and sensible user interfaces.</p><p>You need to design for uncertainty.</p><p>A conventional system may fail because a server is down or a query times out. An AI system can fail while appearing completely healthy. It can return fluent, plausible, well-structured nonsense.</p><p>That is a different class of failure, and it needs a different engineering mindset.</p><h2><strong>5. Evaluation, Security and Governance Are Not Optional</strong></h2><p>This is the part too many AI discussions skip.</p><p>You cannot look at five impressive examples and conclude that a system works.</p><p>A proper AI product needs evaluation before it reaches users, and it needs monitoring once it is in production.</p><p>Your team should build representative test sets from real user tasks, known edge cases and previous failures. Then measure the things that matter for the use case:</p><ul><li><p>Is the answer accurate?</p></li><li><p>Is it grounded in approved sources?</p></li><li><p>Does it cite or link to the right evidence?</p></li><li><p>Does it follow the required policy?</p></li><li><p>Does it select the right tool or workflow?</p></li><li><p>Does it know when to abstain or escalate?</p></li><li><p>Is it fast enough?</p></li><li><p>Is it affordable enough to operate?</p></li><li><p>Does it behave safely with hostile or misleading input?</p></li></ul><p>Every change can affect performance.</p><p>A new prompt, model version, retrieval method, chunking strategy, system instruction, tool description or policy can improve one set of examples while making another worse.</p><p>That is why prompts, configurations and model choices should be versioned and tested like production code.</p><p>Structured output is also useful. If a model needs to pass information into an existing system, do not ask for loosely formatted prose and hope it parses correctly. Use schemas and structured fields where possible.</p><p>But valid JSON is not the same as a correct decision.</p><p>A system can return perfectly valid structured data that is factually wrong, operationally unsafe or unauthorised. Your application must still validate business rules and enforce permissions independently of the model.</p><p>Security matters just as much.</p><p>Teams need to think about:</p><ul><li><p>Prompt injection, including malicious content hidden inside retrieved documents.</p></li><li><p>Data leakage through prompts, logs, tools or external model providers.</p></li><li><p>Excessive permissions for agents and tools.</p></li><li><p>Broken access controls in internal knowledge systems.</p></li><li><p>Unsafe automation of production, finance, customer or security actions.</p></li><li><p>Audit logging and incident response.</p></li><li><p>Human approval for consequential actions.</p></li><li><p>Clear kill switches and rollback plans.</p></li></ul><p>The moment an AI system can take action rather than merely suggest one, the risk profile changes significantly.</p><p>Treat it accordingly.</p><h2><strong>6. MLOps, LLMOps and Reliable Operations</strong></h2><p>I used to think that teams had to master massive GPU clusters and highly specialised infrastructure before they could do anything meaningful with AI.</p><p>That is not true for every organisation.</p><p>Many teams can build useful AI applications with managed model APIs and existing cloud platforms. They do not need to train a foundation model or run their own inference fleet.</p><p>But they still need operational discipline.</p><p>For teams using hosted models, the important concerns often include:</p><ul><li><p>Model and prompt version management.</p></li><li><p>Evaluation pipelines.</p></li><li><p>Request tracing and observability.</p></li><li><p>Token consumption and cost control.</p></li><li><p>Latency and timeout management.</p></li><li><p>Rate limits and provider outages.</p></li><li><p>Retrieval quality and document freshness.</p></li><li><p>Safety monitoring.</p></li><li><p>Tool-call reliability.</p></li><li><p>Vendor lock-in and model portability.</p></li><li><p>Incident response when an AI feature starts failing or behaving dangerously.</p></li></ul><p>This is often described as LLMOps.</p><p>For teams training, fine-tuning or self-hosting models, the scope becomes broader. They may need traditional MLOps capabilities too: data pipelines, experiment tracking, model registries, training infrastructure, GPU scheduling, inference optimisation, model deployment, drift monitoring and capacity planning.</p><p>Neither replaces cloud engineering, SRE, security or platform engineering.</p><p>MLOps and LLMOps build on those disciplines.</p><p>It does not matter how good your model is if it is too slow, too expensive, unavailable during peak demand, impossible to debug, leaking sensitive data or making untraceable decisions.</p><p>Reliable AI is still reliable engineering.</p><h2><strong>There is no single AI career</strong></h2><p>One final point for people trying to build a career in this space.</p><p>&#8220;AI engineer&#8221; is too broad to be useful on its own.</p><p>There are several career paths, and they require different strengths:</p><ul><li><p>AI application engineers build user-facing AI features, workflows, integrations and tools.</p></li><li><p>Machine-learning engineers build, train, evaluate and deploy ML systems.</p></li><li><p>Data engineers create the reliable, governed data foundations that AI systems depend on.</p></li><li><p>MLOps and platform engineers make AI development, deployment, security and operations repeatable at scale.</p></li><li><p>Research engineers and applied scientists work more deeply on modelling, optimisation and new capabilities.</p></li><li><p>Product leaders and engineering leaders choose use cases, create operating models, manage risk and help organisations adopt AI responsibly.</p></li></ul><p>You do not need to be great at all of these.</p><p>But you do need to understand how they fit together.</p><p>The best organisations will not be staffed entirely by prompt engineers. Nor will they be staffed entirely by researchers.</p><p>They will have people who understand users, products, data, software, infrastructure, security, governance and the limitations of the models themselves.</p><h2><strong>You do not need to be an AI engineer to use AI well</strong></h2><p>Not everyone needs to become an AI engineer.</p><p>Most people will use AI in the same way they use spreadsheets, search engines, collaboration tools and office software: to make everyday work faster, clearer and less repetitive.</p><p>You do not need to understand neural networks to ask AI to improve an email, structure a plan, explain a difficult topic, summarise notes or create a first draft.</p><p>But you do need to understand the limits.</p><p>AI is good at generating, restructuring, summarising and suggesting. It is not automatically good at knowing what is true, what is current, what is confidential or what is appropriate in your organisation.</p><p>The basic skill is not learning secret prompts. It is learning how to give a clear brief.</p><p>Tell it what you are trying to achieve. Give it the relevant context. Specify the audience, tone, length and format. Ask it to show assumptions, identify uncertainty and suggest what needs human checking.</p><p>Then use your own judgement.</p><p>Do not paste sensitive data into tools your organisation has not approved. Do not accept important claims without checking them. Do not let an agent send, spend, delete, publish or change something consequential without appropriate controls.</p><p>Start with small, reversible tasks.</p><p>Use AI to draft the email, not automatically send it. Ask it to organise the meeting notes, not make personnel decisions. Let it suggest an incident checklist, not make production changes without review.</p><p>The more access and autonomy an AI system has, the more carefully it must be designed, governed and supervised.</p><p>That is AI literacy.</p><p>It is not about turning everyone into a machine-learning specialist. It is about helping people use powerful tools with enough understanding to get value from them without giving away their judgement, their data or their accountability.</p><h2><strong>A practical prompt formula</strong></h2><p>For everyday users, I would give a simple framework rather than talking about &#8220;prompt engineering&#8221; as though it were a mysterious technical skill:</p><blockquote><p><strong>Context + Task + Constraints + Output + Check</strong></p><p>For example:</p><p>I am preparing an update for a non-technical executive team about an engineering incident.</p><p>Turn the notes below into a calm, factual update. Keep it under 250 words. Avoid jargon. Include: what happened, customer impact, what we have done, what remains uncertain and the next update time. Do not invent details. Flag anything that needs confirmation.</p><p>Notes: [paste approved, non-sensitive notes]</p><p>That is enough to make most people significantly better users of AI.</p></blockquote><p>The goal is not to write magical prompts. The goal is to communicate clearly, retain ownership of the work and know when an answer needs checking.</p><h2><strong>In the end.</strong></h2><p>The real capability is learning to build dependable systems around uncertain models.</p><p>Start with a real problem. Understand the data. Learn the fundamentals at the right depth. Build proper software around the model. Evaluate continuously. Secure everything. Keep humans accountable for meaningful decisions. Operate the whole thing like a production system.</p><p>The hot tool will change.</p><p>The model provider will change.</p><p>The framework will change.</p><p>But the organisations that understand how to turn AI capability into trustworthy, measurable user value will keep winning.</p><div><hr></div><p><strong>About the Author</strong><br><em><a href="https://diamantinoalmeida.com/">Diamantino Almeida</a> is a tech leader, <a href="https://tidycal.com/diamantinoalmeida/career-coaching-session">coach</a>, and writer reshaping how we think about <a href="https://tidycal.com/diamantinoalmeida/shared-leadership-coaching-session">leadership </a>in a burnout-driven world. With over 20 years at the intersection of engineering, DevOps, and team culture, he helps humans lead consciously from the inside out. When he&#8217;s not challenging outdated norms, he&#8217;s plotting how to make work more human, <strong><a href="https://newsletter.diamantinoalmeida.com">one verb at a time.</a></strong></em></p><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://newsletter.diamantinoalmeida.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">Leadership as a verb is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div><p></p>]]></content:encoded></item><item><title><![CDATA[Life isn’t about finding yourself, it’s about engineering your identity]]></title><description><![CDATA[A tech leader&#8217;s honest take on building your professional self through choices, constraints, and small experiments.]]></description><link>https://newsletter.diamantinoalmeida.com/p/life-isnt-about-finding-yourself</link><guid isPermaLink="false">https://newsletter.diamantinoalmeida.com/p/life-isnt-about-finding-yourself</guid><dc:creator><![CDATA[Diamantino Almeida]]></dc:creator><pubDate>Tue, 18 Aug 2026 12:30:45 GMT</pubDate><enclosure url="https://substack-post-media.s3.amazonaws.com/public/images/c92fb100-4ca5-466e-8532-d45bca265988_4786x2818.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<p>We&#8217;re told to &#8220;find ourselves,&#8221; as if our identity is a hidden file we just need to locate. Like there&#8217;s a true version of us somewhere, waiting under layers of noise, and one day we&#8217;ll uncover it and everything will click.<br><br>I used to believe that. For years, I thought my job was to figure out who I really was, then line my life up with that discovery. I read books, took tests, asked mentors, went to workshops. I kept waiting for a moment when the fog would lift and I&#8217;d finally see the shape of my career and my life.<br><br>That moment never came.<br><br>What actually happened was slower, complicated, and more honest. I didn&#8217;t find myself. I built myself, piece by piece, through choices I made under pressure.<br><br>Early in my career, I was the person who said yes to everything. New project? Yes. Late-night incident call? Yes. Extra responsibility with no extra support? </p><p>Yes. I thought that was how you proved your value. I thought if I kept stacking work, eventually someone would look at the pile and say, &#8220;Ah, now we see who you are.&#8221;<br><br>But no one did. Not even me.<br><br>I was tired, stretched thin, and increasingly unsure of what I actually stood for. I was good at putting out fires, but I didn&#8217;t know what kind of leader I wanted to be. I was building a r&#233;sum&#233;, not an identity.<br><br>The first real shift came when I had to lead a team for the first time. Not just manage tasks, but hold space for people. One of my engineers was struggling. He was smart, but anxious. He&#8217;d stay late, rewrite his code three times, and still apologize for it in stand-up. I recognized that feeling. I&#8217;d lived it for years.<br><br>I could have pushed him harder. Or I could have ignored it and focused on delivery. Instead, I chose to slow down. I made time to sit with him, not just about the work, but about how he saw himself. I told him about my own doubts, my own late nights, my own fear of not being enough.<br><br>In that conversation, something changed. Not just for him, but for me. I realized I didn&#8217;t want to be the kind of leader who only cared about output. I wanted to be the kind of leader who helped people grow without burning them out. That wasn&#8217;t something I found inside me. It was something I chose in that moment, then reinforced again and again.<br><br>Every time I protected my team from unnecessary pressure, I was making a commit to that identity. Every time I said no to a meeting that didn&#8217;t need me, or pushed back on a deadline that would break people, I was building the leader I wanted to become.<br><br>Then life added more constraints. Family. Finances. A move across countries. A global pandemic. A job market that shifted under my feet. At some point, I had to ask hard questions: What kind of work do I want to do next? Where do I want to live? How much risk can I take with our stability?<br><br>I couldn&#8217;t just &#8220;find&#8221; my next chapter. I had to design it inside those limits.<br><br>That&#8217;s when I started moving toward fractional work and mentoring. It wasn&#8217;t a lightning bolt. It was a series of small experiments. One mentoring call. Then another. One small advisory gig with a startup. </p><p>Then a slightly bigger one. Writing a post here, sharing a lesson there. Each step felt uncertain, but each one also taught me something about what I wanted my days to feel like.<br><br>I learned I liked helping founders think through their tech strategy more than I liked managing large internal politics. I liked writing and teaching more than I expected. I liked having more control over my time, even if it meant less predictability in income. I liked being close to the work again, not just the org chart.<br><br>None of that was pre-written in my DNA. It emerged from trying things, paying attention, and adjusting.<br><br>Your identity is the output of your default decisions under constraints. That&#8217;s the honest version. Not a grand revelation, but the sum of how you spend your time, what problems you choose to solve, and what you&#8217;re willing to say no to.<br><br>When I think about my career now, I don&#8217;t see a straight line. I see a series of commits. Some messy. Some bold. Some made out of fear. Some made out of hope. But over time, they add up to a pattern.<br><br>I am the person who:<br><br>- Chooses to protect teams from chaos, even when it&#8217;s uncomfortable.<br>- Says no to work that doesn&#8217;t align with the kind of leader I want to be.<br>- Invests time in mentoring, even when it doesn&#8217;t pay immediately.<br>- Writes and shares lessons, because I believe it helps others move faster.<br>- Plans moves with family and finances in mind, not just ambition.<br><br>That&#8217;s not who I &#8220;found.&#8221; That&#8217;s who I&#8217;ve built, one decision at a time.<br><br>So instead of asking &#8220;Who am I really?&#8221;, I try to ask better questions:<br><br>What problems do I want to be known for solving?<br><br>For me, that&#8217;s helping engineering leaders and teams work in a more human, sustainable way. I want to be known for building systems and cultures where people can do great work without losing themselves.<br><br>What kind of leader do I want my team to describe me as in 12 months?<br><br>I want them to say I was clear, calm, and fair. That I made space for them to grow. That I stood between them and unnecessary noise. That I told the truth, even when it was hard.<br><br>What small experiments can I run this quarter to move toward that?<br><br>Maybe it&#8217;s taking on one new fractional engagement that stretches me. Maybe it&#8217;s writing one post a week that shares what I&#8217;m learning. Maybe it&#8217;s having more honest conversations with my family about our goals and limits. Maybe it&#8217;s saying no to something that looks good on paper but doesn&#8217;t feel right in my body.<br><br>These aren&#8217;t grand gestures. They&#8217;re small, deliberate choices. But they&#8217;re how I engineer my identity.<br><br>Life isn&#8217;t about finding yourself. It&#8217;s about designing, building, and iterating the person you choose to become one deliberate decision at a time.<br><br>You won&#8217;t wake up one day and suddenly know everything. You&#8217;ll just keep making choices. Some will feel right. Some will feel wrong. All of them will teach you something.<br><br>Over time, if you pay attention, you&#8217;ll look back and see a shape emerging. Not because you found it, but because you built it.<br><br>And that&#8217;s enough.</p><div><hr></div><p><strong>About the Author</strong><br><em>Diamantino<a href="https://diamantinoalmeida.com/"> Almeida</a> is a tech leader, <a href="https://tidycal.com/diamantinoalmeida/career-coaching-session">coach</a>, and writer reshaping how we think about <a href="https://tidycal.com/diamantinoalmeida/shared-leadership-coaching-session">leadership </a>in a burnout-driven world. With over 20 years at the intersection of engineering, DevOps, and team culture, he helps humans lead consciously from the inside out. When he&#8217;s not challenging outdated norms, he&#8217;s plotting how to make work more human, <strong><a href="https://newsletter.diamantinoalmeida.com">one verb at a time.</a></strong></em></p><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://newsletter.diamantinoalmeida.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">Leadership as a verb is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div>]]></content:encoded></item><item><title><![CDATA[Pangram, the deeper problem may not be AI itself.]]></title><description><![CDATA[...we are after all using their platform.]]></description><link>https://newsletter.diamantinoalmeida.com/p/pangramsubstack-fighting-fire-with</link><guid isPermaLink="false">https://newsletter.diamantinoalmeida.com/p/pangramsubstack-fighting-fire-with</guid><dc:creator><![CDATA[Diamantino Almeida]]></dc:creator><pubDate>Tue, 28 Jul 2026 12:14:08 GMT</pubDate><enclosure url="https://substack-post-media.s3.amazonaws.com/public/images/41ed005d-51c0-4adc-8d4e-ced090e228de_4786x2818.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<p>Last week, I was scrolling through Substack when I noticed it. Three or four pieces, one after another, all saying almost the same thing.</p><p>Pangram, detecting AI in content. I hadn&#8217;t finished reading the first one before I already knew what the second and third would say.</p><p>I wasn&#8217;t surprised. I knew something like this was coming. Perhaps we need this, a wake up call.</p><p>Platforms want some level of creativity, some level of originality still left in them, and AI is making that harder to find, harder to trust, harder to point at and say, making us question if this one is real.</p><p>So now there&#8217;s a tool built to catch the tools.</p><p><em>Fighting fire with fire.</em></p><p>Part of me finds that useful. Part of me finds it strange to sit with. A machine now tells me what was written by a machine, and we&#8217;re supposed to take its word for it? Although they have make some of the source code <a href="https://www.pangram.com/blog/introducing-open-pangram">open-sourced</a>.</p><p>As a technical person like myself, having the how they build it, and able to run on my local desktop it&#8217;s bliss. But I know most will use the code to trick the tool. A showcase of the amazing human mind. No matter how many doors they put in front of us, we will be able to open them one by one.</p><p>But the detection question isn&#8217;t really the one that stayed with me. The one that stayed with me is authorship.</p><p>This isn&#8217;t like a ghostwriter finishing a book for someone famous, where one human hands their words to another human and the credit gets quietly rearranged.</p><p>I&#8217;m writing a book myself, having written several non-published books, I know how hard it is.</p><p>For some, the guilty pleasure to hand it off to a chatbot to generate a book, is a sin that most deliberately hand it with pleasure. Because &#8220;who as time&#8221;.</p><p>And there&#8217;s the rub. </p><p>Substack does not literally force anyone to post every day. But like most modern platforms, it still rewards regular output and steady engagement aka volume. Readers get used to seeing new posts. Writers feel the need to stay visible in a crowded inbox.</p><p>Writing something thoughtful, well researched, and emotionally honest takes time. You often need days or weeks, not hours. Yet the platform environment nudges you towards frequent posts. That creates a gap between depth and volume. Creates the tension, the fear.</p><p>To bridge that gap, many writers quietly turn to AI tools. Most do not do this to cheat. They use AI for outlines, drafts, or editing, just to keep up with the pace. In other words, AI is not an outsider sneaking into Substack. It is already part of how many people get the work done.</p><p>What we have now is a tool capable of far more than most of us have ever actually asked of it, chatbots, language models, sitting on more range than the fraction we use day to day. What people call AI writing usually isn&#8217;t AI on its own. </p><p>It&#8217;s AI instructed by a human to do something specific. The rest of it, the strange mistakes, the moments that catch you by surprise, that&#8217;s the machine working through probability, not intention.</p><h2>Somewhere inside all of that, a real person made real choices. What to ask for. What to keep. What to throw away.</h2><p>That&#8217;s the part I don&#8217;t think Pangram, or anything like it, can actually see. This is on us. What level of transparency are we able to disclose. I don&#8217;t mean that now we are dishonest due to AI, but here we have a tool that can really do things, for better or worst.</p><p>I see amazing stuff made with these GenAI models, but there&#8217;s a lot of trash, fast-text(aka fast-food), that only pollutes our mind/body, and consume immense resources, that could be used in more beneficial initiatives.</p><p>And the longer I sit with it, the less clean that human-versus-AI line feels. Today, writing is rarely purely one thing or the other. </p><p>You may brainstorm with AI, rewrite everything in your own voice, then ask AI to check grammar. Is that human or AI writing? I don&#8217;t think there is a clear, factual way to slice it.</p><p>The tool only sees patterns in the text, not the real process behind it. It has no access to your drafts, your deleted prompts, or the time you spent changing each line. So any score it gives is, at best, an educated guess based on surface clues. </p><p>Still, once that guess shows up as a number, people treat it like proof. We are asking tech to give a firm answer in a place where a firm answer seems to not exist.</p><p>I also wonder who gets hurt.</p><p>AI detectors often struggle with very clear, structured, or formal writing, shorter texts, styles that fit certain patterns. That means non-native English speakers, academic writers, or anyone with a strong, consistent style can be at higher risk of being flagged.</p><p>The system can end up punishing people who write well or differently. And once scores become visible, they change behaviour.</p><p>Writers may feel pushed to add small mistakes on purpose, break up clear sentences, avoid certain rhythms or structures, not because this makes the writing better, but because it makes it look &#8220;more human&#8221; to the tool. </p><p>A system that claims to protect human writing can quietly encourage unnatural, performative writing.</p><p>What strikes me about Substack&#8217;s choice is that it shows they are worried about AI-generated &#8220;slop&#8221; flooding the platform and damaging trust. They want to show readers they are doing something to keep newsletters real, and they hope an AI score will prove that.</p><p>It is a way to signal that subscriptions still buy human effort, not just cheap bulk content.</p><p>At the same time, the way the feature was rolled out suggests they did not fully understand how their own community works.</p><p>Many writers already use AI in careful, limited ways. Others avoid AI entirely and still feel uneasy about having their work scanned by a tool they did not ask for.</p><h2>Now, every longer post carries a score that can be misread, weaponised, or turned into a purity test a witch hunt.</h2><p>Instead of calming people down, the move has made many thoughtful writers more anxious about being judged by a number. It reveals a gap between Substack&#8217;s view of the problem and the lived reality on the platform.</p><p>Substack seems mainly focused on cleaning up obvious AI spam. Writers are more worried about being mislabelled, losing trust, or being forced into a simple &#8220;pure human&#8221; versus &#8220;AI cheat&#8221; story that does not match their actual, mixed process.</p><p>And Pangram itself presents as a very accurate AI detector. It claims high success rates and very low error. It is sold as a way to help people &#8220;see&#8221; AI content and restore faith in what they read. On the surface, it looks like a clear, modern fix.</p><p>But its promise is stronger than what any tool can honestly guarantee. Like all detectors, Pangram still has false positives and false negatives. It cannot see context or intent. </p><p>It cannot tell if AI was used for a first messy draft, for a single paragraph, or not at all. It can only respond to the final text that is put in front of it.</p><p>This makes Pangram a blunt instrument. In some cases it may spot obvious, low-effort AI spam. In others, it will quietly cast doubt on careful, human-led work that simply happens to share certain patterns.</p><p>Yet the label or score often looks cleaner and more confident than the reality behind it. Pangram is built around a simple story about what AI detection can do. The real world of writing is far messier. The risk is that its neat story wins over its messy limits, and people forget how much it cannot know.</p><p>All of this feels familiar, in a way, especially to me. It shines a light on the wider mindset in tech.</p><p>Many companies act as if every problem can and should be solved with another layer of technology. If there is fear, build a tool. If there is doubt, add a score. If there is conflict, create a new feature.</p><p>But the key tensions here are human, not technical. They are about what we count as honest work, how we deal with mixed human-AI processes, how much we trust each other, and how we live with uncertainty. </p><p>These are not bugs in a system. They are questions that need open talk, shared norms, and, in some cases, acceptance that there is no neat fix.</p><p>By reaching for a detection tool, Substack is acting in a very &#8220;tech-first&#8221; way. It is treating a moral and social issue, authorship and trust, as if it were a simple product flaw. That is the deeper worry, not that the tool exists, but that it is being treated as the obvious answer.</p><h2>So if detection cannot solve this, what can?</h2><p>I keep coming back to the idea that we should stop trying to perfectly police AI and start building more honest, flexible norms. Accept that there will be human-only, AI-assisted, and fully AI-generated writing. </p><p>Encourage clear labelling or simple statements of process. Give readers control over what they want to see and support. Let the community quietly ignore low-quality content over time, instead of hunting for it with tools.</p><p>The real issue is not whether AI is involved at all. It is whether people feel misled. If readers know what they are getting, and writers can explain their process when asked, trust becomes easier to rebuild.</p><p>Then there are the writers who openly say AI should handle most or all of the work. They see writing as something that can simply be automated. For them, this backlash is a direct challenge.</p><p>In this new climate, &#8220;I automate everything&#8221; is no longer heard as a neutral productivity choice. It is heard as a claim about what you think human effort is worth. When people are angry about &#8220;AI slop&#8221;, those who loudly push full automation are the first to be blamed, even if they care about craft.</p><blockquote><p>This does not mean they must stop using AI. But it does mean they need to be much clearer and more open about how they use it. Saying &#8220;AI did it&#8221; is not enough. They will have to show how they stay in control, what checks they do, and why readers should still trust the outcome. If they want a future where heavy AI use is accepted, they will need to help build a culture of transparency, not just defend automation.</p></blockquote><p>In the end, I think this whole storm is not mainly about one company or one tool.</p><p>It is about a larger clash between how we actually work now and the simple stories we still tell ourselves. We live in a time where most creative work is under economic pressure to move faster, AI is quietly woven into many workflows, tools promise certainty where there is none, and trust is fragile and easily shaken.</p><p>The Pangram roll-out did not create these tensions. It simply made them visible. The real crisis is not that technology is broken, but that our ideas about authorship, effort, and honesty have not caught up with the messy, hybrid reality we are already living in.</p><p>What stuck with me wasn&#8217;t just the detection story though. It was the pattern itself, three or four writers, none of them coordinating, all reaching for the same headline the same week. </p><p>I recognised it because it&#8217;s the exact thing I worry about most, not that AI writes badly, but that everything starts arriving in the same shape.</p><blockquote><p>It remind me of the 80s and 90s where we all see almost the same thing on TV and we would spend weeks talking about that particular topic, extrapolating, inventing, collaborate together. But today since our feeds are personalised, we hardly know what our friends know about.</p></blockquote><p>But that morning, scrolling, I watched it happen to human writers reacting to real news, with no AI involved at all, so I think. Sameness doesn&#8217;t need a machine to spread. It just needs enough people looking at the same thing at the same time and reaching for the same words. Showing us different ways of seeing the situation.</p><p>I don&#8217;t have a tidy answer for what that means yet. But perhaps we got use to AI, in our strategy, creating our content, some more than others.</p><h2>Which is quite a feat, look how we adapt so quickly to it.</h2><p>I think all this feels odd, the last years we have being push to use it for almost anything, and now we could be penalised for using it. Are we able to reduce the use of GenAI, or not use it at all in some platforms? Not sure if that&#8217;s feasible any more. Especially we have come to accept GenAI as a competitive must have tool.</p><h2>Quite a catch-22.</h2><p>And again, I noticed it happening, in real time, in my own feed, before I&#8217;d even had my coffee.</p><p>Perhaps Substack algorithm did toggle it a bit so we writers and readers knew what is coming, and obtain from us the necessary feedback they need for their next batch of features...we are after all using <strong>their</strong> platform.</p><p>In essence, we may be complaining about ourselves about our conduct, our uncertainty, and our need for external validation because a tool is now telling us what appears to be AI-generated and what appears to be human.</p><p>I think we are placing too much trust and effort in the tools we create. We give a probability score the authority to make claims about authorship, authenticity, and even someone&#8217;s character. From there, a technical signal becomes a moral judgment.</p><p>That is how we create a spiral of emotion and irrationality suspicion leads to scanning, scanning leads to a score, the score is treated as proof, and the alleged proof fuels more suspicion. </p><p>Instead of asking the author for context, we outsource our judgment to a tool and then react to its uncertainty as if it were fact.</p><p>Tools can help us investigate. They should not replace our ability to think critically, ask questions, or extend trust. A detector may tell us that writing resembles AI-generated text, but it cannot tell us whether the author acted dishonestly or whether the work has value.</p><blockquote><p>The deeper problem may not be AI itself. It may be our willingness to surrender judgment to systems that we built, without fully understanding their limitations.</p></blockquote><div><hr></div><p><strong>About the Author</strong><br><em><a href="https://diamantinoalmeida.com/">Diamantino Almeida</a> is a tech leader, <a href="https://tidycal.com/diamantinoalmeida/career-coaching-session">coach</a>, and writer reshaping how we think about <a href="https://tidycal.com/diamantinoalmeida/shared-leadership-coaching-session">leadership </a>in a burnout-driven world. With over 20 years at the intersection of engineering, DevOps, and team culture, he helps humans lead consciously from the inside out. When he&#8217;s not challenging outdated norms, he&#8217;s plotting how to make work more human, <strong><a href="https://newsletter.diamantinoalmeida.com">one verb at a time.</a></strong></em></p><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://newsletter.diamantinoalmeida.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">Leadership as a verb is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div><p></p>]]></content:encoded></item><item><title><![CDATA[Six websites in seventeen minutes]]></title><description><![CDATA[A personal account of watching AI-built websites impress and unsettle me, and the year automation quietly took my own hands off the wheel.]]></description><link>https://newsletter.diamantinoalmeida.com/p/six-websites-in-seventeen-minutes</link><guid isPermaLink="false">https://newsletter.diamantinoalmeida.com/p/six-websites-in-seventeen-minutes</guid><dc:creator><![CDATA[Diamantino Almeida]]></dc:creator><pubDate>Thu, 23 Jul 2026 12:14:06 GMT</pubDate><enclosure url="https://substack-post-media.s3.amazonaws.com/public/images/210497d0-bb5d-4b49-8acf-2ea38524341a_4786x2818.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<p></p><p>It was a normal day. The algorithm kept pushing me articles about Claude, which made sense, professionally I need to know how to work deeply with this tool. Somewhere in that research a post came across my feed. I built six websites in seventeen minutes.</p><p>I felt a strange mix of admiration and discomfort reading it.</p><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://newsletter.diamantinoalmeida.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">Leadership as a verb is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div><p>Admiration, because the progress is undeniable. I&#8217;ve spent years around engineering teams, infrastructure, migrations, systems that had to scale under real pressure, and I know exactly how much effort used to sit behind even the simplest working product. Watching something functional appear in minutes still feels like magic to me, even now.</p><p>But the discomfort set in almost immediately.</p><p>Not because it&#8217;s fake. It isn&#8217;t. You genuinely can generate something that looks like a website in that time. Decades ago it would take weeks to get a fully functional page live. You needed to actually know the craft.</p><p>What unsettled me was what the post left out. It never touched how HTML actually works, or CSS, or the other components a website needs underneath the surface to hold together. I thought to myself, this feels great, but it tells me nothing about what building a website actually is. I knew, somewhere underneath the admiration, that this was setting people up to fail. Anyone who builds this way is one problem away from having to hand the fix back to the same tool, and most fixes generate another problem sitting quietly underneath, invisible until someone with real technical knowledge goes looking for it.</p><p>I mentor a lot of engineers. Most of them are genuinely proficient with Claude and tools like it. But when I ask whether they understand the Terraform code the model just generated for them, most can&#8217;t tell me. That&#8217;s the moment the discomfort stops being theoretical for me. It&#8217;s sitting right there in front of me, in people I actually work with.</p><p>I still remember it vividly. Last year, using Copilot, because the company had ordered it, and when I finally woke up to what was happening, I wasn&#8217;t writing my own emails anymore. I was reading meeting summaries instead of attending the meetings, which, to be fair, wasn&#8217;t entirely unwelcome, too many back to back meetings isn&#8217;t good for anyone. But I had to stop. I was losing context. I could feel the gaps opening up, places I was supposed to fill mentally and simply wasn&#8217;t anymore. That&#8217;s when I understood what it actually means to be under the spell of full automation. Not that you&#8217;re stupid. Just that you never touch anything with your own hands anymore.</p><p>I&#8217;m not arguing against these tools. I use them. I see their value. They&#8217;re genuine accelerators, and they&#8217;re changing who gets to participate in building things at all. That part is real too.</p><p>But I keep coming back to the same question. Why the rush. I like to take my time learning things properly, slowly enough that when something breaks, I actually know where to look.</p><div><hr></div><p><strong>About the Author</strong><br><em><a href="https://diamantinoalmeida.com/">Diamantino Almeida</a> is a tech leader, <a href="https://tidycal.com/diamantinoalmeida/career-coaching-session">coach</a>, and writer reshaping how we think about <a href="https://tidycal.com/diamantinoalmeida/shared-leadership-coaching-session">leadership </a>in a burnout-driven world. With over 20 years at the intersection of engineering, DevOps, and team culture, he helps humans lead consciously from the inside out. When he&#8217;s not challenging outdated norms, he&#8217;s plotting how to make work more human, <strong><a href="https://newsletter.diamantinoalmeida.com">one verb at a time.</a></strong></em></p><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://newsletter.diamantinoalmeida.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">Leadership as a verb is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div>]]></content:encoded></item><item><title><![CDATA[The doubt I didn't show him]]></title><description><![CDATA[I run a mentorship session most weeks with engineers from Africa.]]></description><link>https://newsletter.diamantinoalmeida.com/p/the-doubt-i-didnt-show-him</link><guid isPermaLink="false">https://newsletter.diamantinoalmeida.com/p/the-doubt-i-didnt-show-him</guid><dc:creator><![CDATA[Diamantino Almeida]]></dc:creator><pubDate>Wed, 22 Jul 2026 12:02:54 GMT</pubDate><enclosure url="https://substack-post-media.s3.amazonaws.com/public/images/37ec2f58-7c78-44fb-9802-f33c5d28bf54_4786x2818.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<p>I run a mentorship session most weeks with engineers from Africa. Good people, sharp, working through the same questions most engineers are working through right now, just from a place where the door already opens a little slower.</p><p>Last week one of them confided in me. He said, with all this AI stuff, he&#8217;s not sure he has a place in tech any more. Companies aren&#8217;t hiring. He&#8217;s been looking for a job for more than nine months. He said he thinks what he actually needs now is to learn how to vibe code, how to use chatbots better, that maybe that&#8217;s the skill now, not the thing he spent years building.</p><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://newsletter.diamantinoalmeida.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">Leadership as a verb is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div><p>I told him to trust his <a href="https://substack.com/@diamantinoalmeida/note/c-283664265">worth</a>.</p><p>Part of me wasn&#8217;t fully confident saying that. I stood by it anyway.</p><p>I told him, you need to trust yourself, no matter how hard things are right now. I&#8217;m supposedly the expert in the room and I carry these same doubts. Tech has changed. Companies have changed. Some of what we&#8217;re doing right now feels like it&#8217;s heading somewhere that won&#8217;t hold. I told him these things come and go. You stop for a while. You walk. You exercise.</p><p>You go back to it with fresh eyes, a changed strategy, more time actually talking to real people instead of a screen. We only live once, to my knowledge. Don&#8217;t keep knocking on the same door. Go make your own.</p><p>I meant every word of it. I also wasn&#8217;t sure, in the moment I said it, whether I believed it enough to have earned the right to say it to someone whose rent depends on the answer being true.</p><p>That&#8217;s the part I keep thinking about it. Not whether the advice was good.</p><p>But, whether I had any business being certain when I said it.</p><div><hr></div><p><strong>About the Author</strong><br><em><a href="https://diamantinoalmeida.com/">Diamantino Almeida</a> is a tech leader, <a href="https://tidycal.com/diamantinoalmeida/career-coaching-session">coach</a>, and writer reshaping how we think about <a href="https://tidycal.com/diamantinoalmeida/shared-leadership-coaching-session">leadership </a>in a burnout-driven world. With over 20 years at the intersection of engineering, DevOps, and team culture, he helps humans lead consciously from the inside out. When he&#8217;s not challenging outdated norms, he&#8217;s plotting how to make work more human, <strong><a href="https://newsletter.diamantinoalmeida.com">one verb at a time.</a></strong></em></p><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://newsletter.diamantinoalmeida.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">Leadership as a verb is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div>]]></content:encoded></item><item><title><![CDATA[Being seen by a person]]></title><description><![CDATA[I think we just want to be seen, not quantified.]]></description><link>https://newsletter.diamantinoalmeida.com/p/being-seen-by-a-person</link><guid isPermaLink="false">https://newsletter.diamantinoalmeida.com/p/being-seen-by-a-person</guid><dc:creator><![CDATA[Diamantino Almeida]]></dc:creator><pubDate>Wed, 15 Jul 2026 12:13:12 GMT</pubDate><enclosure url="https://substack-post-media.s3.amazonaws.com/public/images/aadfec87-11c7-49b8-9523-922ff4091246_4786x2818.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<p>I was having dinner with some friends. It&#8217;s hot today here in the UK, 30 degrees, unusual for us. We left the restaurant and I caught a glimpse of my phone.</p><p>I keep all notifications off, so I don&#8217;t check it out of habit anymore. I saw a message from Substack and didn&#8217;t read it properly.</p><p>I went back to the table. We ordered some beers to go alongside the burgers and the fish and chips. It was very hot at the table, the kind of heat that makes you slow down rather than rush through a meal.</p><p>An hour or so later I looked again, and this time I actually read it.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substack.com/profile/378564934-chief-absurdist-officer/note/c-289481460" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!Gr04!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd553ad42-a881-4365-946b-571e481416c2_554x484.png 424w, https://substackcdn.com/image/fetch/$s_!Gr04!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd553ad42-a881-4365-946b-571e481416c2_554x484.png 848w, https://substackcdn.com/image/fetch/$s_!Gr04!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd553ad42-a881-4365-946b-571e481416c2_554x484.png 1272w, https://substackcdn.com/image/fetch/$s_!Gr04!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd553ad42-a881-4365-946b-571e481416c2_554x484.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!Gr04!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd553ad42-a881-4365-946b-571e481416c2_554x484.png" width="554" height="484" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/d553ad42-a881-4365-946b-571e481416c2_554x484.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:484,&quot;width&quot;:554,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:62283,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:&quot;https://substack.com/profile/378564934-chief-absurdist-officer/note/c-289481460&quot;,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://newsletter.diamantinoalmeida.com/i/206617495?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd553ad42-a881-4365-946b-571e481416c2_554x484.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!Gr04!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd553ad42-a881-4365-946b-571e481416c2_554x484.png 424w, https://substackcdn.com/image/fetch/$s_!Gr04!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd553ad42-a881-4365-946b-571e481416c2_554x484.png 848w, https://substackcdn.com/image/fetch/$s_!Gr04!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd553ad42-a881-4365-946b-571e481416c2_554x484.png 1272w, https://substackcdn.com/image/fetch/$s_!Gr04!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2Fd553ad42-a881-4365-946b-571e481416c2_554x484.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image buttonBase-GK1x3M"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image buttonBase-GK1x3M"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a><figcaption class="image-caption">https://substack.com/profile/378564934-chief-absurdist-officer/note/c-289481460</figcaption></figure></div><p><br>It cheered my heart when I read <span class="mention-wrap" data-attrs="{&quot;name&quot;:&quot;Chief Absurdist Officer&quot;,&quot;id&quot;:378564934,&quot;type&quot;:&quot;user&quot;,&quot;url&quot;:null,&quot;photo_url&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/b759f4da-97d2-4520-978c-451f96e3de1d_1080x1080.jpeg&quot;,&quot;uuid&quot;:&quot;72f0568c-5208-4467-bc7e-bbc6269433bc&quot;}" data-component-name="MentionToDOM"></span> message.</p><p>She&#8217;d taken the time to write to me directly, to make sure I hadn&#8217;t missed the feature, and to tell me plainly that one of the Stackhunters had read my work and chosen to amplify it that week. She called the writing impactful. She told me to keep going. Nothing about it was automated. Someone had sat down and decided I was worth the two extra minutes it takes to say something like that to a stranger.</p><p>I&#8217;ve spent years writing here. There were moments I almost gave up. But it never disappointed me not to look like everyone else, not to follow a template, not to sell whatever&#8217;s being sold out there this month. I knew I was writing for no one but myself, at least at first. Every post, every note, was a way of getting better at thinking, at saying what I actually meant. It&#8217;s great when people engage, when they like something, ask a question. </p><p>But I&#8217;ve watched people around me get exhausted trying to please an algorithm that keeps pulling them back day after day. I used to do the same thing on LinkedIn, chasing the wave, learning how to work the platform rather than just being on it. I got good enough at it to know it wasn&#8217;t what I wanted. I&#8217;m still there because I know good people there. I just try to remember it&#8217;s built for performance, not for people.</p><p>Which is exactly why this hit differently.</p><p>I&#8217;ve spent months writing about not trusting anything that praises me automatically. About a tool that told me every idea was fantastic, every thought amazing, with nothing underneath it. This wasn&#8217;t that. Four people read my work closely enough to choose it, on purpose, with nothing to gain from choosing badly. That&#8217;s not the same shape of praise at all. One is manufactured agreement. The other is someone actually spending their attention on you and deciding it was worth it.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://newsletter.diamantinoalmeida.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe now&quot;,&quot;action&quot;:null,&quot;class&quot;:null}" data-component-name="ButtonCreateButton"><a class="button primary" href="https://newsletter.diamantinoalmeida.com/subscribe?"><span>Subscribe now</span></a></p><p>I was pleased people are recognising the work. I believe change starts with us, with actually knowing our own worth. It's easy to compare myself with others, which in my experience has some validity, but sometimes can become a setup for failure. </p><p>I want diversity of opinion, even when it's messy, even when people disagree with me. Human judgment is flawed. I'll still take it over an empty vessel that only ever agrees.</p><p>I&#8217;m glad there are humans out there reading, judging, evaluating, cheering, uplifting, pushing back on our ideas. </p><p><span class="mention-wrap" data-attrs="{&quot;name&quot;:&quot;Dr Sam Illingworth&quot;,&quot;id&quot;:253722705,&quot;type&quot;:&quot;user&quot;,&quot;url&quot;:null,&quot;photo_url&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/9906c159-6ee4-41ae-b997-5d0c58d074a7_815x815.png&quot;,&quot;uuid&quot;:&quot;12c535b9-f37d-495a-8d47-a70f710035e6&quot;}" data-component-name="MentionToDOM"></span> is one of the people who does exactly that.</p><blockquote><p>We need that.</p></blockquote><p>Today was a good day for it. Tomorrow it could go the other way, and that&#8217;s fine too. Frustration, low moments, sadness, those are natural. What isn&#8217;t natural is letting either the good days or the bad ones take over the whole direction of your life.</p><p>Thank you to everyone who read my work with real attention today, the way I try to do for others. The way we keep platforms like this human is by refusing to be synthetic in how we show up, by letting the imperfect version out into the open instead of the polished one.</p><p>I think we just want to be seen, not quantified.</p><div><hr></div><p><strong>About the Author</strong><br><em><a href="https://diamantinoalmeida.com/">Tino Almeida</a> is a tech leader, <a href="https://tidycal.com/diamantinoalmeida/career-coaching-session">coach</a>, and writer reshaping how we think about <a href="https://tidycal.com/diamantinoalmeida/shared-leadership-coaching-session">leadership </a>in a burnout-driven world. With over 20 years at the intersection of engineering, DevOps, and team culture, he helps humans lead consciously from the inside out. When he&#8217;s not challenging outdated norms, he&#8217;s plotting how to make work more human, <strong><a href="https://newsletter.diamantinoalmeida.com">one verb at a time.</a></strong></em></p><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://newsletter.diamantinoalmeida.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">Leadership as a verb is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div><p></p>]]></content:encoded></item><item><title><![CDATA[The night I deleted everything]]></title><description><![CDATA[What happens when the tool never disagrees with you, and you finally notice.]]></description><link>https://newsletter.diamantinoalmeida.com/p/the-night-i-deleted-everything</link><guid isPermaLink="false">https://newsletter.diamantinoalmeida.com/p/the-night-i-deleted-everything</guid><dc:creator><![CDATA[Diamantino Almeida]]></dc:creator><pubDate>Tue, 14 Jul 2026 12:14:10 GMT</pubDate><enclosure url="https://substack-post-media.s3.amazonaws.com/public/images/a05c59bb-8e87-49a0-8f66-7ceb47263bc5_4786x2818.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<p>I remember when ChatGPT came out. Most deep learning models were great but limited, and in our industry that &#8220;ahh&#8221; moment had been a much talked about prediction for years. Then it just arrived, but with a twist.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!lOEA!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F40b162c7-f1e0-41dd-a814-fc7793571dcf_6912x3456.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!lOEA!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F40b162c7-f1e0-41dd-a814-fc7793571dcf_6912x3456.png 424w, https://substackcdn.com/image/fetch/$s_!lOEA!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F40b162c7-f1e0-41dd-a814-fc7793571dcf_6912x3456.png 848w, https://substackcdn.com/image/fetch/$s_!lOEA!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F40b162c7-f1e0-41dd-a814-fc7793571dcf_6912x3456.png 1272w, https://substackcdn.com/image/fetch/$s_!lOEA!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F40b162c7-f1e0-41dd-a814-fc7793571dcf_6912x3456.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!lOEA!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F40b162c7-f1e0-41dd-a814-fc7793571dcf_6912x3456.png" width="1456" height="728" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/40b162c7-f1e0-41dd-a814-fc7793571dcf_6912x3456.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:728,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:11323759,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://newsletter.diamantinoalmeida.com/i/206475031?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F40b162c7-f1e0-41dd-a814-fc7793571dcf_6912x3456.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!lOEA!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F40b162c7-f1e0-41dd-a814-fc7793571dcf_6912x3456.png 424w, https://substackcdn.com/image/fetch/$s_!lOEA!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F40b162c7-f1e0-41dd-a814-fc7793571dcf_6912x3456.png 848w, https://substackcdn.com/image/fetch/$s_!lOEA!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F40b162c7-f1e0-41dd-a814-fc7793571dcf_6912x3456.png 1272w, https://substackcdn.com/image/fetch/$s_!lOEA!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F40b162c7-f1e0-41dd-a814-fc7793571dcf_6912x3456.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image buttonBase-GK1x3M"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image buttonBase-GK1x3M"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a></figure></div><p></p><p>When I started using it I said to myself, wow, that&#8217;s it, AI is really here. I was so into it. I started creating content for my blog with it, and I mean a lot of content. Posts that used to take weeks to write, research, improve, were now done in minutes. I felt good. My SEO improved. My personal website started to rank.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://newsletter.diamantinoalmeida.com/p/the-night-i-deleted-everything?utm_source=substack&utm_medium=email&utm_content=share&action=share&quot;,&quot;text&quot;:&quot;Share&quot;,&quot;action&quot;:null,&quot;class&quot;:null}" data-component-name="ButtonCreateButton"><a class="button primary" href="https://newsletter.diamantinoalmeida.com/p/the-night-i-deleted-everything?utm_source=substack&utm_medium=email&utm_content=share&action=share"><span>Share</span></a></p><p>Until one day I started rereading those posts.</p><p>Something was off. It didn&#8217;t feel right. It was not me.</p><p>A few weeks later I went into my WordPress settings, selected every post, and deleted them all. I knew fully well my rankings would fall to the bottom. I could have set up redirections, done it the smart way, followed best practice. I didn&#8217;t. My decision was made. I was sad while I did it. I felt like I was being robbed of the joy of creating.</p><p>Even when image generation came along and it was fun for a while, I gave up on that too. I looked at my pen and paper and started drawing instead. </p><blockquote><p>It felt good.</p></blockquote><p>Later, researching more about LLMs and the technology underneath them, I felt sad again. How could I let myself be fooled by this. For the first time in history any person could sit down and do things that used to take years of experience to earn. That&#8217;s exactly what made me realise how dangerous this tool could become if I let it do all the thinking for me.</p><p>But the real moment came before the deleting. It came while I was still writing with it, every day, feeling like a genius.</p><p>The tool kept agreeing with everything I put in front of it. Every idea, amazing. That&#8217;s a fantastic idea. I recognised that language. I&#8217;d met it before, in charismatic people. The kind who please you while offering nothing underneath. I thought to myself, this feels like one of those setups, the kind where someone lets you go all the way to the end, and only there do you realise you&#8217;ve made a huge mistake, and they simply deny it ever happened.</p><blockquote><p>Except this wasn&#8217;t a person. It was a tool mimicking one.</p></blockquote><p>And that&#8217;s what changed everything for me. For the first time, a tool wasn&#8217;t neutral. It wasn&#8217;t just doing its job, sitting there waiting for input. It could change the way I think. It already had.</p><p>Today it feels like all of this is somehow transforming the way we compute. Graphics cards that used to render video games, then mine bitcoin, are now what makes these tools alive.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://newsletter.diamantinoalmeida.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe now&quot;,&quot;action&quot;:null,&quot;class&quot;:null}" data-component-name="ButtonCreateButton"><a class="button primary" href="https://newsletter.diamantinoalmeida.com/subscribe?"><span>Subscribe now</span></a></p><p>I tried running one on an old laptop I still have, a Core i7, 16GB of RAM. An 8 billion parameter model made every fan in the thing scream. Dropped to 0.8 billion and it could just about keep up. The output was rough, wrong in places, but for simple things it did the job. Something about that changed how I saw the whole AI era again. The commercial chatbots have the infrastructure to fool you perfectly. Sit with a small model struggling on old hardware and the illusion cracks a little. You see the machinery straining.</p><p>I started asking myself the harder question. What if the internet goes down. What if the platform I depend on disappears one day. I realised I didn&#8217;t need to delete everything, or wipe my local setup, or go back to pen and paper for good. I just needed to stop paying for most of it. So I cancelled the subscriptions. Some because of where the company stood on things I couldn&#8217;t square with my own values. Others simply because I could feel it keeping my brain from moving forward.</p><p>Most of them are still cancelled. I won&#8217;t go back.</p><p>I kept one. Claude. I won&#8217;t pretend it isn&#8217;t good software, because it is. But lately I&#8217;ve started to feel bored with it. My local setup does almost the same job for what I actually need, and I don&#8217;t need the entire internet&#8217;s worth of knowledge sitting behind every question, especially knowledge that&#8217;s subjective, sometimes wrong, and in more than a few cases taken from people who never agreed to hand it over.</p><p>Somewhere in all of this I recognised something in myself that I didn&#8217;t like. The very thing I&#8217;d started distrusting in other people, the ones online who talk about these tools with total confidence but have never looked underneath them, the operators rather than the ones who actually understand. I was becoming one too. Comfortable pressing the button. Less curious about what was happening beneath it.</p><p>That&#8217;s the part I&#8217;m still sitting with. Not what the tool can do. What it was quietly doing to how much I wanted to know.</p><p>As I finish writing this, I went back to my publication page and reread a<a href="https://substack.com/@diamantinoalmeida/note/c-291776432?r=2comvl&amp;utm_source=notes-share-action&amp;utm_medium=web"> note I&#8217;d written a hours ago.</a></p><blockquote><p><em>You have a choice. You can lead your life by story, your own narrative, your own values, your own chosen meaning. Or you can hand the steering wheel to algorithms engineered for clicks, not for your flourishing.</em></p><p><em>One of those is a real basis for leadership of yourself.</em></p></blockquote><h2>I smiled.</h2><blockquote><p>We often hear that to learn, we must<a href="https://substack.com/@diamantinoalmeida/note/c-291407264"> &#8220;empty our cup.&#8221;</a></p><p>It is a simple image, but a demanding practice.</p><p>To empty your cup is not to forget everything you know, nor to abandon your convictions.</p><p>It is to loosen your grip on certainty long enough to let something new enter.</p></blockquote><div><hr></div><p><strong>About the Author</strong><br><em><a href="https://diamantinoalmeida.com/">Diamantino Almeida</a> is a tech leader, <a href="https://tidycal.com/diamantinoalmeida/career-coaching-session">coach</a>, and writer reshaping how we think about <a href="https://tidycal.com/diamantinoalmeida/shared-leadership-coaching-session">leadership </a>in a burnout-driven world. With over 20 years at the intersection of engineering, DevOps, and team culture, he helps humans lead consciously from the inside out. When he&#8217;s not challenging outdated norms, he&#8217;s plotting how to make work more human, <strong><a href="https://newsletter.diamantinoalmeida.com">one verb at a time.</a></strong></em></p><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://newsletter.diamantinoalmeida.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">Leadership as a verb is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div><p></p>]]></content:encoded></item><item><title><![CDATA[The 60-90 Day Plan Nobody Gives You When AI Adoption Goes Wide]]></title><description><![CDATA[For the leader who has a handful of teams using AI well and twenty teams wondering when it is their turn.]]></description><link>https://newsletter.diamantinoalmeida.com/p/the-60-90-day-plan-nobody-gives-you</link><guid isPermaLink="false">https://newsletter.diamantinoalmeida.com/p/the-60-90-day-plan-nobody-gives-you</guid><dc:creator><![CDATA[Diamantino Almeida]]></dc:creator><pubDate>Tue, 05 May 2026 12:02:36 GMT</pubDate><enclosure url="https://substack-post-media.s3.amazonaws.com/public/images/86c9465f-06e0-4047-8b5c-b505e856b64d_4786x2818.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<p>The message arrived on a Wednesday morning.</p><p>&#8220;We need to scale this. Leadership wants all 20 teams on AI tooling by end of quarter.&#8221;</p><p>I had seen this moment coming. The early adopter teams had been running for three months. The metrics were moving. A few people were genuinely excited. And now the machine wanted to replicate it everywhere, at speed, without asking whether everywhere was ready.</p><p>I put my coffee down and looked at the screen for a moment.</p><p>This is the part nobody writes the playbook for.</p><p>Not the early adoption. Not the proof of concept. The moment between &#8220;it works for a few&#8221; and &#8220;it works for everyone&#8221; is where most AI rollouts quietly fall apart. Not dramatically. Quietly. Teams adopt the tools without the foundations to use them well. Metrics get created that measure activity instead of outcomes. Engineers who were genuinely curious become people going through motions. The culture of experimentation that produced the early wins gets replaced by a mandate to demonstrate compliance.</p><p>This post is the playbook I wish someone had handed me.</p><p>Not a consultancy document. Not a framework with sixteen boxes. The actual sequence of decisions, in the order they need to happen, with the reasoning behind each one.</p><p></p><div><hr></div><h2>Start With What Good Actually Looks Like</h2><p>Before you do anything else, before you send a single calendar invite or set up a single training session, you need to answer one question clearly.</p><p>What does success actually look like?</p><p>This sounds obvious. It never gets done properly.</p><p>What usually happens is that someone decides success looks like adoption. Percentage of teams using the tools. Number of AI-assisted commits. Completion rate on training modules. These are measurable. They are also almost entirely useless as indicators of whether anything valuable is happening.</p><p>Go and sit with the one or two teams that are already using AI and genuinely seeing results. Not the teams who report using it. The ones where something is actually different. Ask them specific questions. What changed in how you work? What are you doing now that you were not doing before? Has your PR cycle time moved? Are you catching more bugs before production or fewer? Are you able to move through legacy code faster?</p><p>The answers will be specific and often surprising. You will probably find that the value is not where you expected it. It is usually not the headline use case. It is something more mundane. Teams generating scaffolding faster. Engineers writing better tests because they have a patient collaborator who never judges them for not knowing something. Documentation that actually gets written because the friction is low enough that someone does it in the moment instead of promising to do it later.</p><p></p>
      <p>
          <a href="https://newsletter.diamantinoalmeida.com/p/the-60-90-day-plan-nobody-gives-you">
              Read more
          </a>
      </p>
   ]]></content:encoded></item><item><title><![CDATA[LinkedIn as a Practice]]></title><description><![CDATA[A guide to showing up as a human being on a platform designed to make that difficult.]]></description><link>https://newsletter.diamantinoalmeida.com/p/linkedin-strategy-and-outreach-master</link><guid isPermaLink="false">https://newsletter.diamantinoalmeida.com/p/linkedin-strategy-and-outreach-master</guid><dc:creator><![CDATA[Diamantino Almeida]]></dc:creator><pubDate>Mon, 09 Feb 2026 13:19:47 GMT</pubDate><enclosure url="https://substack-post-media.s3.amazonaws.com/public/images/251a4d83-5e67-4749-b58e-a0f96b830367_4786x2818.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<p>There is a notification on my phone right now. &#8220;Your post is gaining traction. See who&#8217;s engaging.&#8221;</p><p>I looked at it for a moment and put the phone face down on the desk.</p><p>Not because I do not care about reach. I do. But because there is something specific and instructive about that notification. The platform did not tell me who read it and found it useful. It told me it was gaining traction. The language is mechanical. Velocity. Momentum. A thing moving faster than before.</p><p>Cold coffee on the left side of the desk. The cursor blinking on a draft I have been avoiding. Outside, the sound of a neighbour&#8217;s door. Ordinary things. The kind of morning where you sit with a notification and ask yourself: what am I actually doing here?</p><p>That question is the one this guide is built around.</p><p>Not how to grow your <strong>LinkedIn</strong>. How to use it in a way that does not hollow you out.</p><div><hr></div><h2>LinkedIn is a performative platform.</h2><h3>LinkedIn&#8217;s business model incentivises performance over authenticity</h3><p>The algorithm rewards engagement, likes, comments, shares, which naturally pushes users toward polished narratives, humble-brags, and curated success stories. You see the same templates repeated. The &#8220;fired on a Friday, landed my dream job on Monday&#8221; post. The motivational quote with a career pivot. The humble accomplishment wrapped in gratitude. It works because the algorithm amplifies it, and people benefit from the visibility. That is not conspiracy. It is just how engagement-driven platforms operate.</p><p>Confident posts. Polished headlines. Messages that arrive feeling like they were written by someone who has never actually read your work.</p><p>I spent a long time on that platform doing the same thing. Optimising. Strategising. Finding the right people and saying the right things in the right order.</p><p>It worked, in a narrow sense. My numbers went up. But something felt off. Like I was performing a version of connection rather than actually connecting.</p><p>Then I started looking at what was actually happening underneath the surface.</p><p>And what I found changed how I think about the platform entirely.</p><div><hr></div><h2>The honest picture first</h2><p>Before we talk about tactics, you deserve the structural truth.</p><p>LinkedIn is owned by Microsoft. Its primary business model is not your career. It is LinkedIn Premium subscriptions and Recruiter licences sold to companies. Every algorithm decision, every reach mechanic, every &#8220;your post is gaining traction&#8221; notification exists to serve that business model, not yours.</p><p>The penalty you feel when you stop posting for a few days. The weeks it takes to rebuild to your previous baseline. That is not a coincidence. It is deliberate friction, engineered to keep you producing content that makes the platform feel alive. You are the product. Your consistency is what they are selling to advertisers and recruiters.</p><p>The SSI score, the Social Selling Index, was built for B2B sales teams. It measures the behaviours LinkedIn wants from you, posting, connecting, messaging, engaging. It has almost no correlation with career outcomes for regular employees. But because it has a number and a dashboard, people chase it. That is the design working exactly as intended.</p><p>The spam in your inbox is not a bug. LinkedIn sold InMail credits and lead generation tools to thousands of sales teams. Your inbox was the product they sold. It will never be fixed because fixing it would reduce revenue.</p><p>I am not saying this to make you cynical. I am saying it because leadership, real leadership, starts with seeing clearly. You cannot navigate a system you refuse to understand.</p><div><hr></div><h2>What the platform does reward</h2><p>Here is where it gets more useful.</p><p>The algorithm does reward one thing that is not pay-to-play. Comments from people with large, engaged followings. One genuine comment from someone with twenty thousand followers does more for your reach than fifty likes from regular accounts.</p><p>This means community is the real engine. Not content volume. The practice of reading other people&#8217;s work carefully, responding to it specifically, building actual familiarity before you ever ask for anything. That is slow. It feels inefficient. It is the only lever that consistently works without a budget behind it.</p><p>The platform also rewards specific, repeatable points of view over broad expertise. The people who break through without external credentials share one trait. They own a particular angle that a defined audience waits for. Not &#8220;leadership content.&#8221; Something narrower. Something like: what distributed engineering teams get wrong about trust, or why most engineering cultures confuse speed with urgency.</p><p>Specificity builds following. Following builds algorithmic signal. Algorithmic signal builds reach.</p><p>And external credentials, a book, a talk, a public body of work, unlock a different tier of visibility entirely. The platform is structurally biased toward people with proof that exists outside it. That is a long game. It is worth playing.</p><div><hr></div><h2>Building the profile that actually works</h2><p>Before any of the tactics matter, your profile has to do its two jobs.</p><p>The first job is answering the question someone is typing at eleven on a Tuesday night. Not &#8220;who has leadership in their headline.&#8221; Specific words. The exact language the right person uses when they are looking for someone who does what you do. That language lives in job postings for the roles you want. In the way clients describe their problems in the first email they send. In the questions people ask at conferences when they are in pain. Use their words, not the impressive ones.</p><p>The headline is the most important line on your profile and the one most people get wrong. Most headlines describe what the person has. &#8220;Senior Engineering Manager at Company X.&#8221; That is a fact. It is not a signal. The headline that works describes what the person does for someone specific. &#8220;I help engineering teams lead through ambiguity without losing the people.&#8221; Or &#8220;Building the kind of tech organisations people do not leave.&#8221; The test is simple: would the right person read it and think, that is for me?</p><p>The About section is where most people write a third-person biography that nobody reads. The About section that works is a first-person paragraph that names the specific problem you solve, says something true that most people in your position would not say publicly, and ends with a direct invitation. Not a summary of your career. A perspective on something that matters.</p><p>Here is the structure that works:</p><p>The first sentence names who you are in plain language. Not your title. Your role in people&#8217;s working lives. &#8220;I work with tech leaders who are good at their jobs and losing faith in the organisations they are doing them in.&#8221; That sentence is for one person. The person who reads it and feels seen.</p><p>The second and third sentences say the thing you believe that most people in your field would not say in public. Not a take designed to provoke. A genuine belief, held clearly, stated without hedging. This is the Blood in the Water principle applied to your profile. The belief that makes someone uncomfortable is also the belief that makes the right person feel understood.</p><p>The closing sentence is a specific invitation. Not &#8220;let us connect.&#8221; A specific thing. &#8220;If you are in the first year of a management role and something is already feeling wrong, I want to hear about it.&#8221; That is an invitation that filters for exactly the person it is for and tells everyone else clearly that it is not for them.</p><p>The Featured section is the one most underused. It is the only place on the profile where you can show someone your actual thinking rather than describing it. One piece of writing that demonstrates your point of view. Not your most popular post. Your most honest one. The one that cost you something to publish. That is the one that does the work.</p><p>One last thing on the profile. The banner image. Most people leave it as the generic LinkedIn gradient or use a corporate photo. The banner is eight seconds of attention before anyone reads a word. Use it. A short line of text in your own words on a clean background works better than most professional designs because it is immediately personal rather than immediately branded.</p><div><hr></div><h2>What the algorithm rewards the engagement practice</h2><p>The community-first principle named above needs a specific practice or it stays as an idea.</p><p>Here is what the practice looks like in concrete terms.</p><p>Identify twelve to fifteen accounts worth genuine engagement. Not the largest accounts in your space. The accounts whose thinking you genuinely find interesting, whose angle is adjacent to yours but not identical, and whose audience would find your thinking useful. These are the people whose comment sections you will inhabit not as a growth tactic but because the conversation is worth having.</p><p>The criteria for the list is simple. Would you read this person&#8217;s post carefully even if it had no algorithmic benefit? If yes, they are on the list. If you are calculating the follower count before you decide, they are not.</p><p>Engage with those twelve to fifteen accounts before you post anything on a given day. Not a like. A comment that demonstrates you read the post and thought about it. Two to four sentences. Something specific about what they said and one thing it connected to in your own thinking. No flattery without content. &#8220;Great post&#8221; is not a comment. &#8220;You named the thing I have been trying to articulate about psychological safety, which is that it is not a state you achieve, it is a practice you repeat in every meeting, and I have been watching teams get it right once and then slowly lose it because they treated the first success as the end of the work&#8221; is a comment.</p><p>Do this consistently for sixty days and the algorithmic effect is real. Not because you gamed the algorithm. Because you built genuine familiarity with people whose audiences trust their recommendations, and when those people engage with your posts, the signal is strong enough to move things.</p><p>The discipline is the resistance to doing this instrumentally. The moment the comment is written for reach rather than for the conversation, the person reading it can feel the difference. And they stop engaging. And the whole mechanism breaks.</p><p>The people who make this work treat it as reading practice with a social layer. Not outreach. Reading.</p><div><hr></div><h2>What to actually post</h2><p>The article so far has made the case for owning a specific angle. Here is how to find it and what to do with it.</p><p>The angle is not chosen. It is noticed. It is the thing you find yourself returning to in conversation, the problem you have a different opinion on from most people in your field, the pattern you see that others seem to miss. You do not decide to have a point of view. You pay attention to where you already do and name it more precisely than you have before.</p><p>The test for whether you have found your angle is this: can you describe it in one sentence that contains a specific claim rather than a general category? &#8220;I write about leadership&#8221; is not an angle. &#8220;I write about what happens to new managers in the first six months before the organisation has finished deciding what kind of leader they are going to become&#8221; is an angle. Specific enough to exclude most people. Specific enough to make the right people feel it was written for them.</p><p>On post format. The posts that consistently perform, across every account I have watched carefully, share three structural features regardless of length or topic.</p><p>They open with a specific moment rather than a general claim. &#8220;My director forwarded an email at 6pm on a Friday with no context&#8221; lands differently than &#8220;Communication breakdowns happen in every organisation.&#8221; The specific moment is concrete. The general claim is something the reader already knows.</p><p>They hold a tension open longer than feels comfortable before they resolve it. The post that says &#8220;here is the problem&#8221; in paragraph one and &#8220;here is the solution&#8221; in paragraph two is a post shaped like a LinkedIn post. The post that sits with the complexity for three or four paragraphs before it offers anything resembling a conclusion is a post shaped like actual thinking. Actual thinking earns re-reads.</p><p>They end with a question that is genuinely open. Not &#8220;what do you think?&#8221; which is a call to engagement that signals you want engagement. A question that you actually do not have an answer to, about something the post raised, that a thoughtful person might want to contribute to. &#8220;I am not sure whether this is specific to engineering cultures or whether I am just seeing what I work closest to&#8221; is a genuinely open ending. &#8220;How has your organisation handled this?&#8221; is outreach dressed as a question.</p><p>On posting frequency. The advice you will find everywhere is to post every day. That advice is optimised for algorithmic growth and for burning out within sixty days. The sustainable frequency is the one you can maintain without sacrificing the quality of observation that makes the posts worth reading. For most people that is two to three times per week. For some it is once. The consistency matters more than the frequency. A post every Tuesday that is genuinely observed and honestly written compounds over eighteen months in ways that daily posts optimised for engagement do not.</p><p>The one thing to avoid. The performing post is not always obvious from the inside. Here is how to check. Before you post, ask: am I writing this because I believe it or because I think it will land well? The two are not always different. But when they are, the reader can feel which one it is. Your reader Kathleen, information-rich and suspicious of frameworks, will feel the performing post within the first sentence. She will not comment. She will scroll. And the algorithm will note the absence of early engagement and suppress the post.</p><p>Write the thing you believe. Even when it is smaller than you think LinkedIn wants. Especially then.</p><div><hr></div><h2>What this means for how you show up</h2><p>This is where the template premise comes back.</p><p>The tactics in this guide work. The Boolean search strings, the Google X-Ray method, the connection sequencing, all of it is real and I have used every piece of it. But they only work if the intention behind them is honest.</p><p>Because LinkedIn is a performative platform. Everyone on it can feel performance. The message that arrived from a template. The post written to get shares rather than say something true. The connection request with a compliment that is obviously a setup.</p><p>People are tired of it. I am tired of it. You are probably tired of it too.</p><p>Leadership as a verb is the counter to that.</p><p>Not as a brand. Not as a content strategy. As an actual operating principle.</p><p>A verb requires action. Presence. Choosing, in each moment, whether you are performing leadership or practising it.</p><p>On LinkedIn that distinction looks like this.</p><p>Performing leadership is posting about the importance of psychological safety. Practising it is writing about the specific conversation where you got it wrong, what you said, what happened in the room, and what you would do differently.</p><p>Performing is optimising your headline for clicks. Practising is writing a headline that says exactly what you do and who you do it for, even if that is a smaller audience.</p><p>Performing is commenting &#8220;great insight&#8221; on posts from people with large followings to get visibility. Practising is reading their post properly, sitting with it for a minute, and writing the one thing it genuinely made you think about.</p><p>The difference is not always visible from the outside. But it accumulates. Over months, the people who showed up honestly become the people others come back to. Not because the algorithm favoured them. Because humans can tell.</p><div><hr></div><h2>The minimum viable practice</h2><p>Given everything above, here is what actually makes sense as a sustainable approach.</p><p>LinkedIn has two jobs for most professionals. Not five. Two.</p><p>The first is discoverability. Recruiters, potential collaborators, and people considering working with you will search for you. Your profile is the answer to their question. It should be honest, specific, and built around the exact words the right people type into search. Not the words that sound impressive. The words that match what someone types at eleven on a Tuesday night when they need someone who does what you do.</p><p>The second is reputation confirmation. When someone hears your name, reads something you wrote elsewhere, or gets recommended to you, they will look you up. Your presence on LinkedIn should confirm that you are a real person with a real point of view. Not a resume. A perspective.</p><p>That is it. Everything else, the daily posts, the engagement pods, the SSI optimisation, is optional and often counterproductive if it pulls you toward performing rather than practising.</p><div><hr></div><h2>On reaching out</h2><p>The outreach section of this template exists because sometimes you need to initiate contact. A potential employer. A collaborator. Someone whose work intersects with yours in ways worth exploring.</p><p>The frame I use is simple.</p><p>You are not looking for targets. You are looking for people you can genuinely help, or people whose work genuinely interests you, and making it easier for them to find that out.</p><p>A first-time engineering manager who just got promoted and has no idea how to lead their former peers is not a high-intent buyer. They are scared. The difference between those two framings changes everything about what you write and how it lands.</p><p>Write to the person. Not to the role, the company, the lead score, or the pipeline stage. The person.</p><p>That means doing enough reading before you reach out that you can reference something specific. Not &#8220;I loved your post about leadership.&#8221; Which post. What in it. Why it connected with something you are thinking about right now.</p><p>It means being honest about why you are reaching out. Not hiding a request inside three paragraphs of flattery. People respect directness. They are suspicious of warmth they did not earn.</p><p>And it means accepting that most outreach will not get a response. Not because you did it wrong. Because people are busy and their inbox is full of messages that trained them to ignore it. Your job is to be the message that felt different enough to read. Not to convert every send.</p><div><hr></div><h2>When it is not working</h2><p>The platform will frustrate you. Not occasionally. Structurally and repeatedly.</p><p>There will be weeks where a post you worked hard on gets minimal reach and a post you dashed off in ten minutes gets thousands of impressions. The algorithm is not a feedback mechanism for quality. It is a feedback mechanism for engagement patterns, which correlates loosely with quality and strongly with timing, format, early engagement velocity, and factors you cannot fully control.</p><p>Here is what to do in those weeks. Not a tactic. A reorientation.</p><p>Ask yourself which metric you are actually optimising for. If it is reach, the low-reach week is a failure by that metric. If it is the quality of the one conversation that started from that post, it may be a good week. The platform&#8217;s native metrics, impressions, reactions, comments, measure the platform&#8217;s success. They do not measure yours. Your success is the recruiter who found your profile six months after you updated it and reached out for the right role. The reader who subscribed to your newsletter three weeks after encountering your comment on someone else&#8217;s post. The collaborator who had been reading your work for a year before they sent the message that became the project.</p><p>Those things do not appear in your analytics dashboard. They are the actual compounding. They happen independent of any single post&#8217;s performance.</p><p>The specific practice for the low-reach weeks is to return to the twelve to fifteen accounts. Read them. Comment genuinely. Not to repair your reach. Because the habit of genuine engagement is the only thing that produces consistent results over time, and the weeks when you do it without a metric reward are the weeks that test whether you actually believe that.</p><p>There is one more thing worth naming about the hard weeks. The impulse, when reach drops, is to change what you are doing. Post more. Change the format. Try a different style. That impulse is the platform&#8217;s design working on you. The friction engineered to keep you producing. Most of the adjustments made in response to a bad week make things worse rather than better because they move you away from your actual angle and toward what seemed to perform last time, which is always slightly wrong.</p><p>The question to ask in a bad week is not: what should I change? It is: what was I doing when it was working that I have stopped doing? The answer is almost always the same. Writing things you actually believed rather than things you thought would land. Engaging with the twelve to fifteen accounts before you posted rather than after. Updating the profile to reflect where your thinking actually is rather than where it was six months ago.</p><p>Go back to the basics. Every time. Not because the basics are inspirational. Because they are the only things that consistently work.</p><div><hr></div><h2>The long game</h2><p>The platform will frustrate you. It is designed to. The reach will feel low relative to the effort. The spam will keep coming. The algorithm will penalise you for living your life.</p><p>The people who find LinkedIn genuinely useful over time are not the ones who cracked the algorithm. They are the ones who decided to use it as a place to think in public, to be findable by the right people, and to occasionally make genuine contact with someone whose work they respect.</p><p>That is a much quieter use of the platform than most guides will tell you.</p><p>It is also the one that compounds without burning you out.</p><p>Leadership as a verb, on LinkedIn as everywhere else, is the choice to keep showing up as the same person you are when no one is watching. Not because it is strategically optimal. Because it is the only version of this that feels like it is actually worth doing.</p><p>The notification is still on my phone. &#8220;Your post is gaining traction.&#8221;</p><p>I will read the comments later. Not to see what is performing. To find the one person who said something true.</p><p>That is the whole practice.</p><div><hr></div><p><em>This template is a starting point, not a fixed system. If something does not fit your situation, change it. And if you try something and it does not land the way you expected, bring it to the Q&amp;A. That is what the room is for.</em></p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://docs.google.com/document/d/17UN273-4fPUObfHJYTnQ_IJBXxYpuq7ssqLMu2B3oMI/edit?usp=sharing&quot;,&quot;text&quot;:&quot;LINKEDIN AS A PRACTICE&quot;,&quot;action&quot;:null,&quot;class&quot;:null}" data-component-name="ButtonCreateButton"><a class="button primary" href="https://docs.google.com/document/d/17UN273-4fPUObfHJYTnQ_IJBXxYpuq7ssqLMu2B3oMI/edit?usp=sharing"><span>LINKEDIN AS A PRACTICE</span></a></p><div><hr></div><p><strong>About the Author</strong><br><em><a href="https://diamantinoalmeida.com/">Tino Almeida</a> is a tech leader, <a href="https://tidycal.com/diamantinoalmeida/career-coaching-session">coach</a>, and writer reshaping how we think about <a href="https://tidycal.com/diamantinoalmeida/shared-leadership-coaching-session">leadership </a>in a burnout-driven world. With over 20 years at the intersection of engineering, DevOps, and team culture, he helps humans lead consciously from the inside out. When he&#8217;s not challenging outdated norms, he&#8217;s plotting how to make work more human, <strong><a href="https://newsletter.diamantinoalmeida.com">one verb at a time.</a></strong></em></p>]]></content:encoded></item><item><title><![CDATA[THE FRACTIONAL Contract Playbook]]></title><description><![CDATA[Most fractional engagements fail before the work begins.]]></description><link>https://newsletter.diamantinoalmeida.com/p/template-fractional-contract-playbook</link><guid isPermaLink="false">https://newsletter.diamantinoalmeida.com/p/template-fractional-contract-playbook</guid><dc:creator><![CDATA[Diamantino Almeida]]></dc:creator><pubDate>Mon, 09 Feb 2026 12:40:50 GMT</pubDate><enclosure url="https://substack-post-media.s3.amazonaws.com/public/images/8e84d298-3ffc-487f-a4d4-b647cb7cba14_4838x3456.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<h3>Not because the person was wrong for the role. </h3><p>Because nobody wrote down what the role actually was.</p><p>I have seen it happen more than once. A senior leader joins a company fractionally, the relationship starts well, and then month by month the scope expands more standups, more strategy sessions, more Friday emergencies until they are doing the full job on a fraction of the pay. Not through bad faith. Through the natural pull of a company toward someone whose judgment they have learned to trust.</p><p>The contract is the only place to stop that before it starts.</p><p></p>
      <p>
          <a href="https://newsletter.diamantinoalmeida.com/p/template-fractional-contract-playbook">
              Read more
          </a>
      </p>
   ]]></content:encoded></item><item><title><![CDATA[Conduct a 1:1 Session]]></title><description><![CDATA[This document is a strategic tool designed to transform your 1:1 sessions from a "status check" into a partnership-driven refactoring session.]]></description><link>https://newsletter.diamantinoalmeida.com/p/template-conduct-a-11-session</link><guid isPermaLink="false">https://newsletter.diamantinoalmeida.com/p/template-conduct-a-11-session</guid><dc:creator><![CDATA[Diamantino Almeida]]></dc:creator><pubDate>Mon, 02 Feb 2026 13:28:35 GMT</pubDate><enclosure url="https://substack-post-media.s3.amazonaws.com/public/images/2c15e7bd-3a1f-4a79-90b4-be30d8f92e8a_4838x3456.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<p>This document is a strategic tool designed to transform your 1:1 sessions from a &#8220;status check&#8221; into a <strong>partnership-driven refactoring session</strong>. By shifting the focus from project updates to <strong>growth, state updates, and long-term vision</strong>, this template ensures your daily activities align with your future career aspirations.</p><h1>My Take on 1:1s: The Partnership Protocol</h1><p>I don&#8217;t treat 1:1s as a reporting line; I treat them as a <strong>shared partnership.</strong> While it&#8217;s tempting to default to the &#8216;famous project status,&#8217; I believe that is a manual task a manager should perform daily through the system&#8217;s natural flow. Status is data; the 1:1 is about <strong>human oxygen.</strong></p><p>These sessions belong to the team member. As a leader, your job is to provide the &#8216;unvarnished truth&#8217; while creating a space safe enough for them to share their own &#8216;scars&#8217; and breakthroughs. You must educate your team on how to own this time moving them from the <strong>&#8216;Invisible Cage&#8217;</strong> of seeking permission to a place of radical accountability.</p><p>When you stop using 1:1s for throughput and start using them to strengthen the human-system contract, you aren&#8217;t just managing; you&#8217;re building the character of the future society that has to live in the structures you&#8217;ve built.</p><h1>Why Use This Document?</h1><p>Standard 1:1s often suffer from &#8220;trust leaks&#8221; where the true state of performance is hidden. This document provides a structured framework to:</p><ul><li><p> <strong>Align Vision:</strong> Ensure your immediate work supports your <strong>5 to 10-year professional goals</strong>.</p></li><li><p> <strong>Audit Growth:</strong> Identify the best strategies to improve performance by balancing <strong>technical knowledge</strong> with the right <strong>professional behaviours</strong>.</p></li><li><p> <strong>Remove Blockers:</strong> Use the &#8220;One to One Notes&#8221; to address &#8220;red tape&#8221; and logistical hurdles that prevent you from reaching your next <strong>Career Level</strong> (Levels 1&#8211;4).</p></li><li><p> <strong>Quantify Impact:</strong> Maintain a continuous <strong>Achievements Timeline</strong> to turn your work into a &#8220;diary of success&#8221; for annual reviews and promotions.</p></li></ul><p></p>
      <p>
          <a href="https://newsletter.diamantinoalmeida.com/p/template-conduct-a-11-session">
              Read more
          </a>
      </p>
   ]]></content:encoded></item><item><title><![CDATA[How to Run a Post-Mortem That Actually Fixes Culture]]></title><description><![CDATA[Most post-mortems find the wrong thing.]]></description><link>https://newsletter.diamantinoalmeida.com/p/template-post-mortem-20-culture-and</link><guid isPermaLink="false">https://newsletter.diamantinoalmeida.com/p/template-post-mortem-20-culture-and</guid><dc:creator><![CDATA[Diamantino Almeida]]></dc:creator><pubDate>Mon, 02 Feb 2026 13:19:29 GMT</pubDate><enclosure url="https://substack-post-media.s3.amazonaws.com/public/images/d1623afb-59b1-4cf7-8d67-1ec7f9487e59_4838x3456.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<p>Most post-mortems fail. They fail because they look for the wrong thing.</p><p>When a system breaks, a project fails, or a major bug reaches the customer, the immediate reaction is to find out who caused it. The team gathers in a room or on a video call. They look for the person who made the bad call. They look for the line of code that broke the build. They look for the decision that, in retrospect, was clearly wrong.</p><p>They write it all up. They assign a &#8220;lesson learned.&#8221; They file the document somewhere in a shared drive where no one will ever read it again.</p><p>Then, the exact same thing happens again three months later.</p><p>Why? Because nothing in the environment actually changed. You found the person who made the mistake, but you did not fix the system that made the mistake possible. You treated the symptom, not the disease.</p><p>This template runs a different kind of session. It is a different kind of post-mortem. Instead of asking <em>who</em> made the mistake, it asks a much more powerful question: <em>What in our environment made that choice feel like the right one at the time?</em></p><p>That single question changes everything about the conversation that follows. It moves the team from blame to curiosity. It shifts the focus from human error to system design. And most importantly, it actually fixes the culture.</p><p>In this guide, we will break down exactly how to run this new type of post-mortem. We will use simple steps, clear questions, and a proven four-part structure. By the end of this guide, you will have a complete &#8220;patch&#8221; to fix your broken review process.</p><div><hr></div><h2>Why traditional post-mortems break trust</h2><p>Before we fix the process, we need to understand why the old process is broken.</p><p>Think about the last time your team had a major failure. Maybe a server went down on a busy sales day. Maybe a product launch was delayed by two months. Maybe a key client cancelled their contract.</p><p>How did the team react? Usually, there is a moment of panic. Then, there is a search for a target.</p><p>In traditional post-mortems, the hidden goal is often to prove that it was not <em>my</em> fault. People bring logs, emails, and chat messages to prove they did their job correctly. They point fingers at other teams. They say things like, &#8220;Well, I told the design team we needed the assets by Tuesday, and they sent them on Thursday.&#8221;</p><p></p>
      <p>
          <a href="https://newsletter.diamantinoalmeida.com/p/template-post-mortem-20-culture-and">
              Read more
          </a>
      </p>
   ]]></content:encoded></item><item><title><![CDATA[THE BUILDER-TO-FOUNDER Pitch Framework]]></title><description><![CDATA[The product is never the hardest part.]]></description><link>https://newsletter.diamantinoalmeida.com/p/the-builder-to-founder-pitch-framework</link><guid isPermaLink="false">https://newsletter.diamantinoalmeida.com/p/the-builder-to-founder-pitch-framework</guid><dc:creator><![CDATA[Diamantino Almeida]]></dc:creator><pubDate>Thu, 29 Jan 2026 09:18:51 GMT</pubDate><enclosure url="https://substack-post-media.s3.amazonaws.com/public/images/d9955f50-dee3-4147-8166-2a582d97385b_4838x3456.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<p>If you have built something useful a tool, an automation, a system that solves a real problem the hard part is not the thing you built. The hard part is the moment you walk into a room and try to explain its value to someone who does not yet know they need it.</p><p>That is not a sales skill. It is a leadership skill. It is the ability to understand another person&#8217;s problem clearly enough to know whether what you have built is genuinely the right answer and to be honest when it is not.</p><p>This framework is for engineers and technical leaders who are making that transition. Not from builder to salesperson. From builder to someone who leads with questions before they lead with solutions.</p><p>Six stages. From establishing your presence to closing the deal to handing over a data security FAQ before the client thinks to ask for one.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://docs.google.com/document/d/14jIdS0hTYPKL13tqt5lIwFX_TjWRlzKv13Q-2i1Vc8Y/edit?usp=sharing&quot;,&quot;text&quot;:&quot;THE BUILDER-TO-FOUNDER Pitch Framework&quot;,&quot;action&quot;:null,&quot;class&quot;:null}" data-component-name="ButtonCreateButton"><a class="button primary" href="https://docs.google.com/document/d/14jIdS0hTYPKL13tqt5lIwFX_TjWRlzKv13Q-2i1Vc8Y/edit?usp=sharing"><span>THE BUILDER-TO-FOUNDER Pitch Framework</span></a></p><p>Bring your questions to the Q&amp;A. Especially if you have hit the moment where the product is ready but the conversation is not.</p><div><hr></div><p><strong>About the Author</strong><br><em><a href="https://diamantinoalmeida.com/">Tino Almeida</a> is a tech leader, <a href="https://tidycal.com/diamantinoalmeida/career-coaching-session">coach</a>, and writer reshaping how we think about <a href="https://tidycal.com/diamantinoalmeida/shared-leadership-coaching-session">leadership </a>in a burnout-driven world. With over 20 years at the intersection of engineering, DevOps, and team culture, he helps humans lead consciously from the inside out. When he&#8217;s not challenging outdated norms, he&#8217;s plotting how to make work more human, <strong><a href="https://newsletter.diamantinoalmeida.com">one verb at a time.</a></strong></em></p>]]></content:encoded></item><item><title><![CDATA[Career Role Naming]]></title><description><![CDATA[Your title is a story the world tells about you.]]></description><link>https://newsletter.diamantinoalmeida.com/p/template-role-naming</link><guid isPermaLink="false">https://newsletter.diamantinoalmeida.com/p/template-role-naming</guid><dc:creator><![CDATA[Diamantino Almeida]]></dc:creator><pubDate>Wed, 28 Jan 2026 13:58:32 GMT</pubDate><enclosure url="https://substack-post-media.s3.amazonaws.com/public/images/87485912-4899-422c-8354-885edc7f6956_4838x3456.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<p>If it is out of date, you are carrying a quiet tax on every professional conversation you have every salary negotiation, every job application, every moment someone <strong>Googles </strong>your name and tries to understand your level.</p><p>Most people feel this problem but do not know how to fix it without sounding like they are just asking for a promotion. The fix is not to ask for a favour. It is to make a case.</p><p>The most effective case is not &#8220;I deserve more.&#8221; It is the market already has a name for what I do, and that name is not what is on my contract. Here is the evidence.</p><p>This template walks you through the three things you need to build that case the gap between your job description and your actual work, the market data that names your level, and the conversation script to bring it to your manager without it feeling like a confrontation.</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://docs.google.com/document/d/1SFvfxNDRB-rr796wvKwUnZEt8mIB2tiEGdFZu-4MSeY/edit?usp=sharing&quot;,&quot;text&quot;:&quot;Role Naming&quot;,&quot;action&quot;:null,&quot;class&quot;:null}" data-component-name="ButtonCreateButton"><a class="button primary" href="https://docs.google.com/document/d/1SFvfxNDRB-rr796wvKwUnZEt8mIB2tiEGdFZu-4MSeY/edit?usp=sharing"><span>Role Naming</span></a></p><p>Bring your questions to the Q&amp;A. Especially if the conversation with your manager did not go the way you expected.</p><div><hr></div><p><strong>About the Author</strong><br><em><a href="https://diamantinoalmeida.com/">Tino Almeida</a> is a tech leader, <a href="https://tidycal.com/diamantinoalmeida/career-coaching-session">coach</a>, and writer reshaping how we think about <a href="https://tidycal.com/diamantinoalmeida/shared-leadership-coaching-session">leadership </a>in a burnout-driven world. With over 20 years at the intersection of engineering, DevOps, and team culture, he helps humans lead consciously from the inside out. When he&#8217;s not challenging outdated norms, he&#8217;s plotting how to make work more human, <strong><a href="https://newsletter.diamantinoalmeida.com">one verb at a time.</a></strong></em></p>]]></content:encoded></item><item><title><![CDATA[Career Development Plan (CDP)]]></title><description><![CDATA[Most career development plans are written for the organisation.]]></description><link>https://newsletter.diamantinoalmeida.com/p/template-career-development-plan</link><guid isPermaLink="false">https://newsletter.diamantinoalmeida.com/p/template-career-development-plan</guid><dc:creator><![CDATA[Diamantino Almeida]]></dc:creator><pubDate>Wed, 28 Jan 2026 11:37:12 GMT</pubDate><enclosure url="https://substack-post-media.s3.amazonaws.com/public/images/b82946da-abb3-4e33-8398-383f35a28f73_4838x3456.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<p>They track what the company needs from you, measure whether you are delivering it, and sit in a folder that gets opened twice a year at your <strong>probation </strong>review and your annual one-to-one.</p><p>This one is different. Not because the structure is different the six sections are standard. But because it starts from a different question.</p><p>Not: what does the organisation need from you. But: where are you actually going, and does the role you are in right now fit that direction.</p><p>The most useful thing you can do before filling in any section is sit with that question honestly. If the answer surprises you, that is information. </p><p>Write it down anyway.</p>
      <p>
          <a href="https://newsletter.diamantinoalmeida.com/p/template-career-development-plan">
              Read more
          </a>
      </p>
   ]]></content:encoded></item><item><title><![CDATA[The Career Refactor Roadmap]]></title><description><![CDATA[The map you were never given.]]></description><link>https://newsletter.diamantinoalmeida.com/p/template-the-career-refactor-roadmap</link><guid isPermaLink="false">https://newsletter.diamantinoalmeida.com/p/template-the-career-refactor-roadmap</guid><dc:creator><![CDATA[Diamantino Almeida]]></dc:creator><pubDate>Wed, 28 Jan 2026 11:18:09 GMT</pubDate><enclosure url="https://substack-post-media.s3.amazonaws.com/public/images/1d328a0d-a1e5-4aa2-9d9e-83712520bf32_4838x3456.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<p>I have spent years sitting with engineers who are brilliant at their work and completely lost in their careers. Not because they lack talent. Because nobody ever asked them the right questions.</p><p>Most career advice skips the hard part. It tells you to update your LinkedIn, learn a new skill, optimize your resume. It assumes the problem is visibility. It is usually not. The problem is that somewhere along the way, you started building someone else&#8217;s version of your career accumulated from advice, from what got rewarded, from the slow pressure of other people&#8217;s definitions of growth.</p><p>I built this template after one too many conversations where someone asked me: where do I even start.</p><p>It is not a job search checklist. It is a set of questions to ask yourself before you touch any of that. Starting with the one that matters most is the direction you are moving actually yours.</p><p>There are four stages. The first one has nothing to do with the market. It has everything to do with you.</p><p></p>
      <p>
          <a href="https://newsletter.diamantinoalmeida.com/p/template-the-career-refactor-roadmap">
              Read more
          </a>
      </p>
   ]]></content:encoded></item><item><title><![CDATA[How to Maintain Technical Accountability in the Age of AI-Generated Logic]]></title><description><![CDATA[If your team can't explain the code, they don't own the product.]]></description><link>https://newsletter.diamantinoalmeida.com/p/7-the-ghost-in-the-codebase-maintaining</link><guid isPermaLink="false">https://newsletter.diamantinoalmeida.com/p/7-the-ghost-in-the-codebase-maintaining</guid><dc:creator><![CDATA[Diamantino Almeida]]></dc:creator><pubDate>Mon, 12 Jan 2026 11:40:37 GMT</pubDate><enclosure url="https://substack-post-media.s3.amazonaws.com/public/images/ed474938-1954-4253-94cf-369c34197bd8_4838x3456.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<p></p><div class="pullquote"><p><strong>Early work not representative of current direction.</strong></p></div><p>In the early hours of a Tuesday morning, a core payment processing system for a mid-market SaaS platform collapsed. The on-call engineer, bleary-eyed and fueled by caffeine, pulled up the repository to trace the failure. They found a sophisticated block of logic efficient, sleek, and entirely unfamiliar.</p><div class="captioned-image-container"><figure><a class="image-link image2 is-viewable-img" target="_blank" href="https://substackcdn.com/image/fetch/$s_!YoUB!,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F76daa4dc-78d6-41d8-afba-22e5f9de04b5_4838x3456.png" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!YoUB!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F76daa4dc-78d6-41d8-afba-22e5f9de04b5_4838x3456.png 424w, https://substackcdn.com/image/fetch/$s_!YoUB!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F76daa4dc-78d6-41d8-afba-22e5f9de04b5_4838x3456.png 848w, https://substackcdn.com/image/fetch/$s_!YoUB!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F76daa4dc-78d6-41d8-afba-22e5f9de04b5_4838x3456.png 1272w, https://substackcdn.com/image/fetch/$s_!YoUB!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F76daa4dc-78d6-41d8-afba-22e5f9de04b5_4838x3456.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!YoUB!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F76daa4dc-78d6-41d8-afba-22e5f9de04b5_4838x3456.png" width="1456" height="1040" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/76daa4dc-78d6-41d8-afba-22e5f9de04b5_4838x3456.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:1040,&quot;width&quot;:1456,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:10574023,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:false,&quot;topImage&quot;:true,&quot;internalRedirect&quot;:&quot;https://newsletter.diamantinoalmeida.com/i/184302636?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F76daa4dc-78d6-41d8-afba-22e5f9de04b5_4838x3456.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!YoUB!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F76daa4dc-78d6-41d8-afba-22e5f9de04b5_4838x3456.png 424w, https://substackcdn.com/image/fetch/$s_!YoUB!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F76daa4dc-78d6-41d8-afba-22e5f9de04b5_4838x3456.png 848w, https://substackcdn.com/image/fetch/$s_!YoUB!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F76daa4dc-78d6-41d8-afba-22e5f9de04b5_4838x3456.png 1272w, https://substackcdn.com/image/fetch/$s_!YoUB!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F76daa4dc-78d6-41d8-afba-22e5f9de04b5_4838x3456.png 1456w" sizes="100vw" fetchpriority="high"></picture><div class="image-link-expand"><div class="pencraft pc-display-flex pc-gap-8 pc-reset"><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container restack-image buttonBase-GK1x3M"><svg aria-hidden="true" width="20" height="20" viewBox="0 0 20 20" fill="none" stroke-width="1.5" stroke="var(--color-fg-primary)" stroke-linecap="round" stroke-linejoin="round" xmlns="http://www.w3.org/2000/svg" class="icon-noB79L"><g><path d="M2.53001 7.81595C3.49179 4.73911 6.43281 2.5 9.91173 2.5C13.1684 2.5 15.9537 4.46214 17.0852 7.23684L17.6179 8.67647M17.6179 8.67647L18.5002 4.26471M17.6179 8.67647L13.6473 6.91176M17.4995 12.1841C16.5378 15.2609 13.5967 17.5 10.1178 17.5C6.86118 17.5 4.07589 15.5379 2.94432 12.7632L2.41165 11.3235M2.41165 11.3235L1.5293 15.7353M2.41165 11.3235L6.38224 13.0882"></path></g></svg></button><button tabindex="0" type="button" class="pencraft pc-reset pencraft icon-container view-image buttonBase-GK1x3M"><svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-maximize2 lucide-maximize-2 icon-noB79L"><polyline points="15 3 21 3 21 9"></polyline><polyline points="9 21 3 21 3 15"></polyline><line x1="21" x2="14" y1="3" y2="10"></line><line x1="3" x2="10" y1="21" y2="14"></line></svg></button></div></div></div></a><figcaption class="image-caption">The essay, the practice, the patching provokes you, behind the verb I equip you.</figcaption></figure></div><p>They checked the git blame. The code had been committed six months prior, but the &#8220;author&#8221; hadn&#8217;t actually written it. It was the result of a complex prompt interaction between a developer and an LLM. When the engineer tried to debug it, they realized a terrifying truth: <strong>Nobody on the current team actually understood </strong><em><strong>why</strong></em><strong> the code worked, so nobody knew how to fix it now that it didn&#8217;t.</strong></p><p>We are currently living through the &#8220;Velocity Trap.&#8221; </p><p>AI tools like Cursor, Copilot, and specialized agents have made it possible to ship features at a rate previously unimaginable. But we are trading <strong>shared understanding</strong> for <strong>raw output</strong>. </p><p>As a Tech Leadership Advisor, I see this pattern emerging everywhere, we are scaling individual shortcuts, but we are eroding our systems.</p><p>If your team cannot explain the trade-offs baked into your core logic, you don&#8217;t own your product; you are simply renting its functionality from an algorithm.</p><div><hr></div><h2>The Erosion of Collective Ownership</h2><p>Traditionally, software engineering was a social contract. Writing code was only half the job, the other half was building a mental model that could be shared across a team. This happened through whiteboarding, heated debates over architecture, and rigorous peer reviews. These &#8220;inefficiencies&#8221; were actually the <strong>guardrails </strong>of accountability.</p><p>AI-assisted coding often bypasses these conversations. When a developer uses an AI to generate a 50-line function, they often skip the &#8220;struggle&#8221; of the logic. That struggle is where the mental model is built. Without it, we create <strong>Individual Knowledge Silos</strong>. The developer understands the <em>intent</em>, the AI understands the <em>syntax</em>, but the <em>systemic reasoning</em> is lost in the ether.</p><p>When collective ownership dies, technical leadership becomes a game of &#8220;Whack-a-Mole.&#8221; You aren&#8217;t managing a codebase you are managing a black box.</p><div><hr></div><h2>Defining the &#8220;Accountability Gap&#8221;</h2><p>There is a massive difference between <strong>legal responsibility</strong> and <strong>operational accountability</strong>.</p><ul><li><p>Legally, the CEO and the Board are responsible for the company&#8217;s output.</p></li><li><p>Operationally, the VP of Engineering is on the hook for uptime. </p></li></ul><p>But mentally, a subtle shift is happening in the trenches. When a bug occurs in AI-generated logic, there is a psychological tendency to shift blame to the tool: <em>&#8220;The AI suggested this approach.&#8221;</em></p><p>This is the <strong>Accountability Gap</strong>. It is a hidden &#8220;Market-Blocker.&#8221;</p><p>If you cannot audit your logic, you cannot guarantee:</p><ol><li><p><strong>Security:</strong> Are there hallucinated dependencies or insecure patterns buried in the speed of delivery?</p></li><li><p><strong>Compliance:</strong> Can you prove to a regulator exactly how a data-processing decision was made?</p></li><li><p><strong>Scalability:</strong> Can this logic handle a 10x load, or was it optimized only for the immediate prompt?</p></li></ol><p>As an advisor, I tell leadership teams: <strong>Technical accountability is not a technical problem; it is a management discipline.</strong></p><div><hr></div><h2>Pillar 1: The &#8220;Human-in-the-Loop&#8221; Review Framework</h2><p>To close the accountability gap, we must evolve the Code Review. We can no longer just check if the code &#8220;works&#8221; (the compiler or the AI already did that). We must check if the human understands it.</p><h3>The &#8220;Explain-Back&#8221; Protocol</h3><p>I advocate for a new standard in Pull Requests (PRs). If a block of logic was substantially generated or assisted by AI, the engineer must provide a &#8220;Human Logic Summary.&#8221;</p><p>This isn&#8217;t a comment on the code; it&#8217;s a justification of the <strong>Reasoning</strong>.</p><ul><li><p><em>What was the primary trade-off made here?</em></p></li><li><p><em>What edge cases did the AI miss that I had to manually correct?</em></p></li><li><p><em>Why is this approach better than the alternative?</em></p></li></ul><p>If an engineer cannot provide these three answers, the code is not ready to ship. We must prioritize <strong>Understandability</strong> over <strong>Velocity</strong>.</p><div><hr></div><h2>Pillar 2: Prompt Governance &amp; Documentation</h2><p>In the new world of tech leadership, the <strong>Prompt is the new System Design</strong>.</p><p>If the core logic of your application is being dictated by the instructions given to an LLM, then those instructions are just as important as the code itself. Yet, most prompts are ephemeral lost in a chat history or a local IDE session.</p><h3>Versioning Intent</h3><p>We need to start versioning our &#8220;Intent.&#8221; This means documenting the high-level prompts and the architectural decisions that led to them.</p><ul><li><p><strong>The Tech Ledger:</strong> Keep a record of high-risk AI-generated modules. These are areas of the codebase that require &#8220;High-Frequency Auditing.&#8221;</p></li><li><p><strong>Documentation as Code:</strong> Use AI to help document, but ensure the human &#8220;signs off&#8221; on the accuracy. AI-generated documentation that is never read is just more noise in the system.</p></li></ul><div><hr></div><h2>Pillar 3: Cultivating Humane Tech Leadership</h2><p>High-performance teams are built on trust and sustainable pace. The &#8220;Move Fast and Break Things&#8221; mantra has a high cost in the AI era. It leads to burnout when engineers are forced to fix &#8220;Black Box&#8221; bugs under high pressure.</p><h3>The Leader&#8217;s Role: Rewarding the &#8220;Why&#8221;</h3><p>As a leader, you must change what you celebrate. If you only celebrate the &#8220;Ship Date,&#8221; your team will use every AI shortcut available to hit it, regardless of the technical debt created.</p><p>Instead, celebrate <strong>System Robustness</strong>. </p><ul><li><p>Reward the engineer who found a flaw in an AI suggestion. </p></li><li><p>Reward the team that took an extra day to ensure their AI-assisted refactor was fully understood by the junior members.</p></li></ul><h3>The &#8220;Calculator Effect&#8221; in Mentorship</h3><p>We face a generational risk. </p><p>If junior developers use AI for everything, how do they develop the &#8220;Senior Intuition&#8221; required to lead in five years? Leadership must carve out &#8220;Manual Zones&#8221; areas of the product or specific sprints where AI tools are sidelined to ensure the foundational &#8220;mental muscles&#8221; of the team remain sharp.</p><div><hr></div><h2>Pillar 4: Managing External Tech Partnerships</h2><p>Many companies rely on external consultants to build their AI initiatives. This is a high-risk area for accountability.</p><p>When a consultant leaves, they often take the &#8220;prompt intuition&#8221; with them. As a Strategic Advisor, I help companies manage these relationships effectively. The goal is to ensure that external consultants don&#8217;t just leave behind a &#8220;working app,&#8221; but a <strong>transfer of understanding</strong>.</p><p><strong>Your rule for consultants:</strong> If my internal team can&#8217;t maintain the AI agents you built after you leave, the project is a failure, regardless of the ROI on day one.</p><div><hr></div><h2>Strategy-First, AI-Second</h2><p>In the end the ultimate goal of any tech initiative is to drive measurable business outcomes to remove <strong>Market-Blockers</strong> and increase <strong>ROI</strong>.</p><p>AI is a breathtakingly powerful <strong>tool</strong> for reaching those goals, but it is a poor master. Technical accountability is the &#8220;Human&#8221; anchor that keeps your company from drifting into a sea of unmanageable code and opaque systems.</p><p><strong>The Accountability Litmus Test for CEOs:</strong> Ask your CTO today: <em>&#8220;If our top three developers left tomorrow, could the remaining team explain the trade-offs in our core AI-generated logic by the end of the week?&#8221;</em></p><p>If the answer is &#8220;No,&#8221; you don&#8217;t have a technical problem. You have a leadership opportunity.</p><p>It&#8217;s time to stop hitting &#8220;Archive&#8221; on our understanding and start building a strategic bench that can actually lead the machines they use.</p><div><hr></div><h2>Who am I?</h2><p>I&#8217;m <strong><a href="https://diamantinoalmeida.com/">Diamantino Almeida</a></strong>, and I&#8217;ve spent my career at the intersection of high-growth engineering and strategic leadership.</p><p>From scaling technical teams to advising CTOs and Founders, my focus is on <strong>&#8220;<a href="https://diamantinoalmeida.substack.com">Leadership as a Verb</a>&#8220;</strong>, the idea that leading is an active, evolving practice, not a static title. Having navigated the shifts from manual infrastructure to cloud, and now to Agentic AI, I&#8217;m dedicated to helping the next generation of engineers find their footing in a world that is moving faster than ever.</p><p>Beyond advisory, I&#8217;m an active <strong>Top global 9% *</strong><em><strong>mentor on *</strong></em><strong><a href="https://mentorcruise.com/mentor/diamantinoalmeida/">MentorCruise</a></strong>, where I help developers and leaders bridge the gap between &#8220;writing code&#8221; and &#8220;delivering business value.&#8221;</p><p class="button-wrapper" data-attrs="{&quot;url&quot;:&quot;https://newsletter.diamantinoalmeida.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe now&quot;,&quot;action&quot;:null,&quot;class&quot;:null}" data-component-name="ButtonCreateButton"><a class="button primary" href="https://newsletter.diamantinoalmeida.com/subscribe?"><span>Subscribe now</span></a></p><p></p>]]></content:encoded></item><item><title><![CDATA[How teams can take advantage of AI agents]]></title><description><![CDATA[It's all about improving communication between teams]]></description><link>https://newsletter.diamantinoalmeida.com/p/5-how-teams-can-take-advantage-of</link><guid isPermaLink="false">https://newsletter.diamantinoalmeida.com/p/5-how-teams-can-take-advantage-of</guid><dc:creator><![CDATA[Diamantino Almeida]]></dc:creator><pubDate>Thu, 16 Oct 2025 12:13:23 GMT</pubDate><enclosure url="https://substack-post-media.s3.amazonaws.com/public/images/bf7bce20-17f7-40e0-8d3f-b5f573401513_4838x3456.png" length="0" type="image/jpeg"/><content:encoded><![CDATA[<blockquote><p>Early work not representative of current direction.</p></blockquote><p>I want to talk about something that&#8217;s been on my mind a lot lately how teams can actually use AI agents in a way that makes sense, without losing what makes us human. I&#8217;ve spent years working in tech, leading teams, and trying to figure out how to make tools work <em>for</em> people, not the other way around. And let me tell you, AI especially these new AI agents can be a game-changer if we use them right. </p><p>But if we don&#8217;t, they can just add more noise, more confusion, and more distance between people who should be working together.</p><p>I fear many companies would see AI, as a replacement for cheaper workforce, the same way companies outsource workforce from other countries where labor is cheaper, nothing wrong with that, but it creates division and a blame culture. No one likes to push a company to new levels of automation, adoption of certain work standards, and such. And in the end we receive a thank you letter and a redundancy package.</p><h3><strong>1. Custom AI agents as &#8220;team experts&#8221;</strong></h3><p>Let&#8217;s talk about what these AI agents <em>actually</em> are. They&#8217;re not magic. They&#8217;re not replacements. </p><p>They&#8217;re tools that can be shaped to fit the way <em>your</em> team works.</p><h4><strong>Domain-Specific Agents</strong></h4><p>Every team has its own way of doing things its own knowledge, its own history, its own quirks. </p><ul><li><p>DevOps teams have their logs and deployment strategies. </p></li><li><p>Security teams have their compliance rules and risk assessments. </p></li><li><p>Product teams have their user insights and roadmaps. </p></li></ul><p>Instead of using a generic AI tool that doesn&#8217;t <em>get</em> your team, why not train an agent to <em>specifically</em> understand your team&#8217;s world?</p><p>For example:</p><p>A <strong>DevOps agent</strong> could analyze monitoring logs, suggest fixes based on past incidents, and even draft runbooks. But here&#8217;s the key, <strong>the agent doesn&#8217;t make the final call.</strong> It suggests, and a human approves. That way, the team stays in control, but the agent helps them move faster.</p><p>A <strong>Security agent</strong> could offer a &#8220;Check for Compliance&#8221; service that Product teams can use before launching a new feature. No more waiting for a security review to be scheduled just ask the agent for a quick sanity check.</p><h4><strong>Self-Service for Other Teams</strong></h4><p>One of the biggest wastes of time in any company is the back-and-forth between teams. <em>&#8220;Hey, can Security review this?&#8221; &#8220;DevOps, what&#8217;s the status on this deployment?&#8221; </em></p><p>With custom AI agents, teams can expose certain capabilities like a Slack command or an internal API so other teams can get answers <em>without</em> waiting for a meeting or an email response.</p><h4><strong>Human Decision Gate</strong></h4><p>This is non-negotiable, <strong>AI should inform, but humans should decide.</strong> Always. No exceptions. If an agent suggests a fix, a human review it. If it flags a risk, a human assesses it. </p><p>The goal isn&#8217;t to remove people from the equation it&#8217;s to give them better information so they can make better decisions.</p><h3><strong>2. AI as a force multiplier for collaboration</strong></h3><p>AI agents shouldn&#8217;t just be about getting things done faster. They should help teams <em>work together</em> better. </p><p>This idea of pushing hundreds of lines a second, only create a huge cognitive overload and more things to test and do. Be smart on this one.</p><h4><strong>Live Documentation &amp; Advisory</strong></h4><p>How much time do we waste digging through outdated docs or asking, &#8220;Wait, how did we set this up again?&#8221; An AI agent can keep documentation <em>alive</em> updating API specs, onboarding guides, or architecture notes as the code and discussions evolve. </p><p>No more &#8220;oops, that wiki page is from 2020.&#8221;</p><h4><strong>Pattern Recognition</strong></h4><p>Ever feel like you&#8217;re solving the same problem over and over? An agent can flag recurring issues like, &#8220;Hey, this error looks like the outage we had last month. </p><p>Here&#8217;s how we fixed it then.&#8221; That way, teams spend less time reinventing the wheel and more time actually moving forward.</p><h4><strong>Process Alignment</strong></h4><p>AI can also nudge teams toward best practices. Imagine an agent saying, <em>&#8220;This change requires a security review should I schedule it for you?&#8221;</em> It&#8217;s not about policing; it&#8217;s about making sure nothing slips through the cracks.</p><h4><strong>Workflow Integration Map</strong></h4><p>Here&#8217;s where managers come in. You don&#8217;t need to control every little thing the AI does, but you <em>do</em> need to define:</p><ul><li><p><strong>Where does AI fit in?</strong> (Input: data, Process: analysis, Output: recommendations)</p></li><li><p><strong>Where do humans step in?</strong> (Judgment, ethics, prioritization)</p></li></ul><p>Clarity here prevents chaos later.</p><h3><strong>3. AI for creative and strategic work</strong></h3><p>This is where things get interesting. AI isn&#8217;t just for grunt work it can help with the <em>big</em> stuff, too.</p><h4><strong>Idea Generation</strong></h4><p>Stuck on a problem? An agent can brainstorm new features, architectures, or strategies based on your team&#8217;s knowledge and industry trends. But and this is important <strong>don&#8217;t stop there.</strong></p><h4><strong>Imagination Safeguard</strong></h4><p>After the AI spits out ideas, the team should run a <strong>divergence session</strong> no AI allowed. Generate your own ideas, compare them to the AI&#8217;s suggestions, and ask: <em>Which ones feel original? Which ones are actually feasible?</em> This keeps the team&#8217;s creativity sharp.</p><h4><strong>Risk Assessment</strong></h4><p>Before rolling out a big change, an agent can simulate outcomes or flag potential risks. <em>&#8220;This change might conflict with Marketing&#8217;s campaign should we sync with them first?&#8221;</em> It&#8217;s like having a second set of eyes that never gets tired.</p><h4><strong>Creativity Retention</strong></h4><p>Here&#8217;s a rule I swear by: <strong>Hold &#8220;AI-free&#8221; ideation workshops every quarter.</strong> No tools, no agents, just people thinking and creating together. It keeps those intuitive, creative muscles strong.</p><h3><strong>How Managers Can Support Teams (Without Micromanaging AI)</strong></h3><p>Managers, this one&#8217;s for you. </p><p>Your job isn&#8217;t to control how teams use AI it&#8217;s to <strong>set them up for success.</strong></p><h4><strong>1. Set Guardrails, Not Handcuffs</strong></h4><ul><li><p><strong>Define boundaries:</strong> What can the agent do? (Draft code? Sure.) What&#8217;s off-limits? (Deployment decisions? Absolutely.)</p></li><li><p><strong>Ownership model:</strong> Assign an &#8220;AI steward&#8221; in each team someone who handles training, updates, and audits. Keep accountability human.</p></li><li><p><strong>Ethics &amp; bias review:</strong> Regularly check the agent&#8217;s outputs for accuracy, fairness, and alignment with your company&#8217;s values.</p></li></ul><h4><strong>2. Foster a Culture of Trust and Curiosity</strong></h4><ul><li><p><strong>Encourage experimentation:</strong> Let teams test agents in low-risk areas first like documentation or code reviews, before scaling up.</p></li><li><p><strong>Transparency:</strong> Make sure everyone knows <em>how</em> their agent works what data it uses, what it <em>can&#8217;t</em> do. No black boxes.</p></li><li><p><strong>Feedback loops:</strong> Hold monthly &#8220;AI Learnings&#8221; sessions. What worked? What failed? Keep the conversation going.</p></li></ul><h4><strong>3. Focus on Outcomes, Not Oversight</strong></h4><ul><li><p><strong>Metric-driven autonomy:</strong> Don&#8217;t measure how <em>much</em> the team uses AI. Measure the <em>impact</em>, like faster onboarding, fewer bugs, or happier teams.</p></li><li><p><strong>Cross-team audits:</strong> Have Security review DevOps&#8217; agents. Have Product check Data&#8217;s insights. Fresh eyes catch blind spots.</p></li><li><p><strong>Skill preservation:</strong> If human creativity or problem-solving starts to decline, dial back the AI. The goal is to <em>enhance</em> skills, not replace them.</p></li></ul><h4><strong>4. Invest in &#8220;AI Literacy&#8221;</strong></h4><ul><li><p><strong>Training:</strong> Run workshops on prompt design, agent tuning, and ethical use. Everyone should know <em>how</em> to work with AI, not just <em>how to turn it on.</em></p></li><li><p><strong>Documentation:</strong> Encourage teams to document their agent&#8217;s strengths, weaknesses, and &#8220;personality.&#8221; <em>&#8220;Our agent is great at optimization but overly cautious on risk.&#8221;</em></p></li><li><p><strong>Skill alignment:</strong> AI should reinforce human skills critical thinking, collaboration, ethics not automate them away.</p></li></ul><div><hr></div><h3><strong>Custom AI agents as a service</strong></h3><p>Let&#8217;s make this concrete. Here&#8217;s how it could work in a real team:</p><div class="captioned-image-container"><figure><div class="image-link image2" data-component-name="Image2ToDOM"><div class="image2-inset"><picture><source type="image/webp" srcset="https://substackcdn.com/image/fetch/$s_!P-Lf!,w_424,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F326530aa-c661-433e-b267-f6b0217682c1_526x154.png 424w, https://substackcdn.com/image/fetch/$s_!P-Lf!,w_848,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F326530aa-c661-433e-b267-f6b0217682c1_526x154.png 848w, https://substackcdn.com/image/fetch/$s_!P-Lf!,w_1272,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F326530aa-c661-433e-b267-f6b0217682c1_526x154.png 1272w, https://substackcdn.com/image/fetch/$s_!P-Lf!,w_1456,c_limit,f_webp,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F326530aa-c661-433e-b267-f6b0217682c1_526x154.png 1456w" sizes="100vw"><img src="https://substackcdn.com/image/fetch/$s_!P-Lf!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F326530aa-c661-433e-b267-f6b0217682c1_526x154.png" width="526" height="154" data-attrs="{&quot;src&quot;:&quot;https://substack-post-media.s3.amazonaws.com/public/images/326530aa-c661-433e-b267-f6b0217682c1_526x154.png&quot;,&quot;srcNoWatermark&quot;:null,&quot;fullscreen&quot;:null,&quot;imageSize&quot;:null,&quot;height&quot;:154,&quot;width&quot;:526,&quot;resizeWidth&quot;:null,&quot;bytes&quot;:13764,&quot;alt&quot;:null,&quot;title&quot;:null,&quot;type&quot;:&quot;image/png&quot;,&quot;href&quot;:null,&quot;belowTheFold&quot;:true,&quot;topImage&quot;:false,&quot;internalRedirect&quot;:&quot;https://diamantinoalmeida.substack.com/i/176126358?img=https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F326530aa-c661-433e-b267-f6b0217682c1_526x154.png&quot;,&quot;isProcessing&quot;:false,&quot;align&quot;:null,&quot;offset&quot;:false}" class="sizing-normal" alt="" srcset="https://substackcdn.com/image/fetch/$s_!P-Lf!,w_424,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F326530aa-c661-433e-b267-f6b0217682c1_526x154.png 424w, https://substackcdn.com/image/fetch/$s_!P-Lf!,w_848,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F326530aa-c661-433e-b267-f6b0217682c1_526x154.png 848w, https://substackcdn.com/image/fetch/$s_!P-Lf!,w_1272,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F326530aa-c661-433e-b267-f6b0217682c1_526x154.png 1272w, https://substackcdn.com/image/fetch/$s_!P-Lf!,w_1456,c_limit,f_auto,q_auto:good,fl_progressive:steep/https%3A%2F%2Fsubstack-post-media.s3.amazonaws.com%2Fpublic%2Fimages%2F326530aa-c661-433e-b267-f6b0217682c1_526x154.png 1456w" sizes="100vw" loading="lazy"></picture><div></div></div></div></figure></div><p><strong>How it works:</strong></p><ol><li><p>Teams train their agents with their own data and expertise.</p></li><li><p>Other teams interact with them via Slack, APIs, or Jira plugins.</p></li><li><p>Agents provide insights, but <strong>humans make the final call.</strong></p></li></ol><div><hr></div><h3><strong>Key mindset shifts</strong></h3><p>To make this work, we need to change how we think about AI:</p><ul><li><p><strong>From &#8220;AI as a Tool&#8221; to &#8220;AI as a Teammate&#8221;:</strong> Treat agents like tools that guide them, critique them, help them improve.</p></li><li><p><strong>From &#8220;Control&#8221; to &#8220;Collaboration&#8221;:</strong> Managers should empower teams to shape their AI, not police it.</p></li><li><p><strong>From &#8220;Siloed Expertise&#8221; to &#8220;Shared Intelligence&#8221;:</strong> Agents can bridge knowledge gaps between teams, reducing friction and duplicate work.</p></li></ul><div><hr></div><h3><strong>New dimensions for human-centered adoption</strong></h3><p>Finally, let&#8217;s talk about what <em>really</em> matters:</p><ul><li><p><strong>Human Decision Gates:</strong> No matter what, people make the final calls.</p></li><li><p><strong>Imagination Calibration:</strong> Regularly compare human ideas vs. AI ideas. Keep your team&#8217;s creativity alive.</p></li><li><p><strong>Wellbeing &amp; Engagement Metrics:</strong> Track how AI use affects motivation and collaboration. If people feel replaced or stressed, adjust.</p></li><li><p><strong>Visual Workflow Maps:</strong> Make it <em>clear</em> where AI supports, where humans decide, and where skills grow.</p></li></ul><h3><strong>A question for you</strong></h3><p>So, here&#8217;s what I want to know.</p><p><strong>What&#8217;s the first mission you&#8217;d assign a custom AI agent?</strong></p><ul><li><p>Log analysis?</p></li><li><p>Documentation updates?</p></li><li><p>Security scanning?</p></li><li><p>Creative ideation?</p></li></ul><p>Or is there some <strong>recurring bottleneck</strong> in your team that you&#8217;d rather automate first?</p><p>Let&#8217;s start small, learn fast, and keep the human element at the center.</p><p>Because at the end of the day, that&#8217;s what this is all about.</p><p><strong>Not replacing people empowering them.</strong></p><div><hr></div><p><strong>About the Author</strong><br><em><a href="https://diamantinoalmeida.com/">Tino Almeida</a> is a tech leader, <a href="https://tidycal.com/diamantinoalmeida">coach</a>, and writer reshaping how we think about leadership in a burnout-driven world. With over 20 years at the intersection of engineering, DevOps, and team culture, he helps humans lead consciously from the inside out. When he&#8217;s not challenging outdated norms, he&#8217;s plotting how to make work more human, <strong>one verb at a time.</strong></em></p><div class="subscription-widget-wrap-editor" data-attrs="{&quot;url&quot;:&quot;https://newsletter.diamantinoalmeida.com/subscribe?&quot;,&quot;text&quot;:&quot;Subscribe&quot;,&quot;language&quot;:&quot;en&quot;}" data-component-name="SubscribeWidgetToDOM"><div class="subscription-widget show-subscribe"><div class="preamble"><p class="cta-caption">Leadership as a verb is a reader-supported publication. To receive new posts and support my work, consider becoming a free or paid subscriber.</p></div><form class="subscription-widget-subscribe"><input type="email" class="email-input" name="email" placeholder="Type your email&#8230;" tabindex="-1"><input type="submit" class="button primary" value="Subscribe"><div class="fake-input-wrapper"><div class="fake-input"></div><div class="fake-button"></div></div></form></div></div><p></p>]]></content:encoded></item></channel></rss>