Writing
Engineering, delivery, and building things which last.
Flash Cards · Responsible AI
Flash Card: Measuring Bias With Clarify
You must measure a GenAI feature for bias and toxicity before launch. Which service?
Read articleConsulting and Craft · Hands On
Extracting Lease Terms with Bedrock
An envisioning session parked this one with a single note: no gold answers. Pulling structured terms out of lease PDFs is a clean extraction job, but you can't ship what you can't measure, and there was nothing to measure against. So the build starts where the parking note pointed, building the gold set, and only then wires up the model: structured output, field-level confidence, and a human confirming anything the model isn't sure of before it touches the system of record.
Read articleExam Room · Advanced GenAI
Hybrid Search and Reranking for Bedrock RAG
A support assistant on Bedrock retrieves by pure semantic search and keeps whiffing on exact-term queries: product codes, error codes, part numbers, acronyms, proper names. The embedding of 'ERR-4021' sits close to a hundred other error codes, so a plausible-but-wrong chunk outranks the one document that actually names it. The fix is two levers, hybrid retrieval and a reranker, and knowing which one the precision problem actually needs.
Read articleFlash Cards · Responsible AI
Flash Card: The Eight Responsible-AI Dimensions
AWS names its responsible-AI dimensions. Roughly, what are they?
Read articleExam Room · Advanced GenAI
Evaluating a RAG Pipeline End to End
A citations-required assistant over internal documents answers most questions well and a few of them wrong, and the team cannot tell why. Was the right passage never retrieved, or was it retrieved and then ignored? Those are two different failures with two different fixes, and an evaluation that reports one score for the whole pipeline hides which one you have. This walks through separating the retrieval half from the generation half so the regression harness points at the part that actually broke.
Read articleThe Workshop
The Workshop: Retrospectives
A pattern for creating a structured, safe space to inspect how the team is working and decide one or two things to change, so that continuous improvement stops being a poster on the wall and starts being a thing that actually happens.
Read articleFlash Cards · Governance
Flash Card: Turning Logs Into an Audit
The reviewer wants a control-mapped report and a statement of what the model is approved for. Two artifacts?
Read articleThe Greenbox Story · Faster Together
API Contracts: Two Squads, One Direction
Perth and Melbourne have their own backlogs, their own sprint rhythms, and their own priorities. They keep surprising each other with dependencies nobody saw coming.
Read articleExam Room · Advanced GenAI
Keeping PII Out of LLM Prompts and Logs
A claims assistant that has to answer questions about a customer's claim while keeping the customer's name, address, policy number, and medical details out of training data, out of logs, and out of anything a subpoena could touch later. PII redaction isn't one knob, it's four or five, in different places, each covering a different leak path. Comprehend, Bedrock Guardrails, custom redaction, and the prompt itself each handle a different shape of the problem.
Read articleFlash Cards · Governance
Flash Card: Who Changed It vs What It Said
Who turned off the PII filter, and when? Which log, and why not invocation logging?
Read articleEarlier writing
July 2026
How Databases Actually Work Under the Hood Code Is Read More Than It Is Written Consulting and Craft · In Practice Flash Card: The Prompt-and-Completion Record Flash Cards · Governance Wardley Mapping: Build, Buy, or Borrow? The Greenbox Story · Faster Together Provisioned Throughput vs On-Demand Bedrock Exam Room · Advanced GenAI Flash Card: Freshness and Access Are Metadata Flash Cards · Retrieval How Encryption Works Under the Hood · Trust Flash Card: Hierarchical Chunking in One Line Flash Cards · Retrieval Catching Rent Arrears Without a Model Consulting and Craft · Hands On Checking a Bedrock Feature for Bias and Explainability Exam Room · Advanced GenAI Flash Card: What a Reranker Actually Fixes Flash Cards · Retrieval Keeping an AI Pilot Honest After It Ships Consulting and Craft · Hands On Making a Bedrock App Audit-Ready Exam Room · Advanced GenAI Flash Card: Why Hybrid Search Finds ERR-4021 Flash Cards · Retrieval Picking an Embedding Model for Retrieval Exam Room · Advanced GenAI The Workshop: Decision Tables The Workshop Flash Card: S3 Vectors and the Latency Budget Flash Cards · Vector stores Value Stream Mapping: Finding Where to Focus The Greenbox Story · Faster Together When a Document Won't Fit the Context Window Exam Room · Advanced GenAI Flash Card: The Silent Distance-Metric Bug Flash Cards · Vector stores How Git Works Under the Hood The Language of Tests Consulting and Craft · In Practice Flash Card: When Aurora pgvector Wins Flash Cards · Vector stores Strategic Alignment: The Spreadsheet Anika Never Showed The Greenbox Story · Faster Together Streaming Responses to Cut First-Token Latency Exam Room · Advanced GenAI Flash Card: OpenSearch Serverless's Hidden Floor Flash Cards · Vector stores How Identity Works Under the Hood · Trust Answering Tenant Questions from the Lease with Bedrock Consulting and Craft · Hands On Triaging Maintenance Requests with a Bedrock Classifier Consulting and Craft · Hands On The Workshop: DDD Modelling The Workshop Service Design: Customer Support at Scale The Greenbox Story · Growing Pains Importing Custom Weights into Bedrock Exam Room · Advanced GenAI How Email Works Under the Hood Resting the Meat Consulting and Craft · Through the Kitchen Developer Onboarding: Ramping Up Without Slowing Down The Greenbox Story · Growing Pains How to Cut a Bedrock Bill Without Hurting Quality Exam Room · Advanced GenAI Why Trust Is Hard Under the Hood · Trust The Workshop: AI Use Case Envisioning The Workshop Hiring Mistakes: The Hire Who Doesn't Work Out The Greenbox Story · Growing Pains How to Build a Multi-Modal Bedrock Assistant for Insurance Claims Exam Room · Advanced GenAI The Workshop: C4 Modelling The Workshop Capacity Planning: The Seasonal Crunch The Greenbox Story · Growing Pains Evaluating LLM Output With Bedrock Eval Jobs Exam Room · Advanced GenAI Past the Ten-Second Wall Under the HoodJune 2026
Technical Debt Is a Loan, Not a Crime Consulting and Craft · In Practice When a Container Earns Its Own Zoom The Greenbox Story · Drawing the Lines How to Manage Prompts Across Thirty Services on Bedrock Exam Room · Advanced GenAI The Transformer Attention Budget Under the Hood Domain-Driven Design: CQRS and Read Models in Go The Greenbox Story · Drawing the Lines Domain-Driven Design: Event Sourcing the Ledger in Go The Greenbox Story · Drawing the Lines The Workshop: Event Storming an Architecture The Workshop Architecture Decision Records: Why We Did It That Way The Greenbox Story · Drawing the Lines Picking a Vector Store for Bedrock RAG Exam Room · Advanced GenAI When Not to Use an LLM Under the Hood · The AI Field Guide The Probe in the Meat Consulting and Craft · Through the Kitchen Decision Tables: The Substitution Engine in Go The Greenbox Story · Drawing the Lines How to Wire an LLM to Side-Effecting Actions with Bedrock Agents Exam Room · Advanced GenAI How Containers Work Under the Hood Decision Tables: Making Maya's Brain Explicit The Greenbox Story · Drawing the Lines Building RAG When the Source Documents Change Daily Exam Room · Advanced GenAI The Workshop: Prioritisation The Workshop Spreading Bedrock Load with Cross-Region Inference Profiles Exam Room · Advanced GenAI Bayesian Reasoning Under the Hood · The AI Field Guide The Price of Everything Consulting and Craft · In Practice Drawing the System: From Event Storm to C4 The Greenbox Story · Drawing the Lines Configuring Bedrock Guardrails for PII, Topics, and Grounding Exam Room · Advanced GenAI How Estimation Works (And Why It Doesn't) Under the Hood Knowledge, Logic, and Constraints Under the Hood · The AI Field Guide Domain-Driven Design: The Anti-Corruption Layer in Go The Greenbox Story · Drawing the Lines Domain-Driven Design: Events Across Boundaries in Go The Greenbox Story · Drawing the Lines Domain-Driven Design: Modelling the Subscription Context in Go The Greenbox Story · Drawing the Lines Domain-Driven Design: Drawing the Boundaries The Greenbox Story · Drawing the Lines Designing Short-Term and Long-Term Memory for a Bedrock Chat Assistant Exam Room · Advanced GenAI Search and Planning Under the Hood · The AI Field Guide The Workshop: Business Model Canvas The Workshop Time Is Wrong Everywhere All at Once Under the Hood · Time Combining RAG and Fine-Tuning for a Legal Contract Assistant Exam Room · Advanced GenAI How to Build a Citations-Required RAG Over 50K Internal Documents Exam Room · Advanced GenAIMay 2026
Rules, Grammars, and Regex Under the Hood · The AI Field Guide The Salt in the Dish Consulting and Craft · Through the Kitchen Why Does Thursday Last Forever? Under the Hood · Time Picking a Bedrock Model for High-Volume RAG Exam Room · Advanced GenAI Prioritisation: What Changes First The Greenbox Story · Finding the Fit Choosing Responsible-AI Controls for a Loan-Approval Model Exam Room · GenAI Choosing Between SageMaker, Bedrock, and Purpose-Built AI APIs Exam Room · GenAI The Boring Baseline That Wins Under the Hood · The AI Field Guide A Gentle Guide to Typography: From Chisels to Character Sets Under the Hood The Clock Inside You Under the Hood · Time How to Match Inference Parameters to the Job at Hand Exam Room · GenAI Choosing Between Chains, Retrieval, and Agents for a GenAI Assistant Exam Room · GenAI Pricing Experiments: The Right Box at the Right Price The Greenbox Story · Finding the Fit How to Make a Bedrock Chatbot Audit-Ready with Guardrails and Watermarks Exam Room · GenAI Before the Transformer Under the Hood · The AI Field Guide The Workshop: Assumption Mapping The Workshop Can You Turn Back Time? Under the Hood · Time Forecasting Without Writing Python Exam Room · GenAI Business Model Canvas: Does This Actually Work? The Greenbox Story · Finding the Fit Grounding a Chatbot in Your Own PDFs Exam Room · GenAI After the Transformer Under the Hood · The AI Field Guide The Workshop: Jobs to be Done The Workshop Does Time Even Exist? Under the Hood · Time Choosing Between Prompting, RAG, and Fine-Tuning Exam Room · GenAI Assumption Mapping: Testing What You Believe The Greenbox Story · Finding the Fit How to Take a Foundation Model from Pick to Production Endpoint Exam Room · GenAI The Reranker You Didn't Know You Needed Under the Hood · The AI Field Guide The Knife in My Hand Consulting and Craft · Through the KitchenApril 2026
Time Is Weirder Than You Think Under the Hood · Time Picking the AWS AI Service Tier for Each Feature Exam Room · GenAI Jobs to Be Done: Why Subscribers Actually Stay The Greenbox Story · Finding the Fit The Other Transformers Under the Hood · The AI Field Guide The Workshop: User Story Mapping The Workshop Ticks or Tocks? Under the Hood · Time Accessibility: A Product Decision, Not a Compliance Tick The Greenbox Story · Shipping What Matters What Day Is It? Under the Hood · Time The Workshop: Impact Mapping The Workshop User Story Mapping: Seeing the Whole The Greenbox Story · Shipping What Matters The Workshop: Sprint Planning The Workshop What Time Is It? Under the Hood · Time The Workshop: Example Mapping The Workshop Impact Mapping: Connecting Work to Goals The Greenbox Story · Shipping What Matters The Workshop: Event Storming a Process The Workshop The Workshop: Event Storming a Domain The Workshop Teaching Your LLM the Codebase: CLAUDE.md and AGENTS.md The Greenbox Story · Shipping What Matters Teaching Your LLM the Codebase The Greenbox Story · Shipping What Matters Behaviour-Driven Development: From Stories to Working Software The Greenbox Story · Shipping What Matters The Quiet Jar in the Fridge Consulting and Craft · Through the Kitchen Sprint Planning: Turning Sticky Notes into Delivery The Greenbox Story · From Chaos to Clarity To LLMs... and Beyond! Under the Hood · The AI Field GuideMarch 2026
Example Mapping: Making Stories Concrete The Greenbox Story · From Chaos to Clarity How LLMs Actually Work Under the Hood · The AI Field Guide Event Storming: Building Shared Understanding The Greenbox Story · From Chaos to Clarity Retrospectives: Catching the Wrong Kind of Fast The Greenbox Story · From Chaos to Clarity The Value Is in Ideas, Not Code Consulting and Craft · In Practice Minimum Viable Product: The First Box The Greenbox Story · From Chaos to Clarity Customer Discovery: Before the First Line of Code The Greenbox Story · From Chaos to Clarity