# Codyssey
> A tech odyssey through code, chaos, and comedy. Software engineering tutorials, architecture deep-dives, and workplace satire from 15 years in the trenches.
Public Ghost content for AI and LLM tooling. Use `/llms-full.txt` for consolidated page and post context.
Append `.md` to any post or page URL to get the content in Markdown (for example, `/example-post.md`).

## Pages
- [About](https://www.codyssey.tech/about.md) - Fifteen years building and breaking software — now writing about engineering, careers, a little science, and the odd bit of tech satire.
- [Contact](https://www.codyssey.tech/contact.md) - Questions, feedback, collaboration, or speaking. One inbox, no communications team.
- [Newsletter](https://www.codyssey.tech/newsletter.md) - One email. One article. Every week. Tutorials with a pulse and satire with a point — no spam, no clickbait.
- [Privacy Policy](https://www.codyssey.tech/privacy.md) - How Codyssey handles your data — written by hand, in plain language, GDPR-compliant and jargon-free.
- [The Continental Rules Series](https://www.codyssey.tech/series-continental-rules.md) - Seven career parables from the John Wick universe: power, coins, exile, reputation — and Rule Zero.
- [Give the Robot Hands: Building MCP Servers That Don't Burn the House Down](https://www.codyssey.tech/series-give-the-robot-hands.md) - A 7-part course on the Model Context Protocol — give an AI safe, well-tested hands (tools, resources, prompts) by building a real MCP server for a fictional candle shop.
- [The Human Code Series](https://www.codyssey.tech/series-human-code.md) - A 7-part field guide to the corporate predator. Six species, one habitat, observed in the wild. Which one are you?
- [The Machine That Reads Badly](https://www.codyssey.tech/series-machine-reads.md) - A two-part machine learning debugging adventure: first train a model that doesn't work, then fix what the machine broke.
- [Spring Boot Microservices Series](https://www.codyssey.tech/series-spring-boot.md) - Thirteen parts, from empty project to production Kubernetes. The missing 95% of every twelve-line Spring Boot tutorial.
- [Terraform: Fake Infrastructure, Real Skills](https://www.codyssey.tech/series-terraform.md) - Ten parts, from an empty project to a full multi-environment platform — built entirely in Terraform's imagination. Fake infrastructure, real skills, zero cloud bill.
- [QA Testing Foundations Series](https://www.codyssey.tech/series-testing-foundations.md) - Ten parts, from requirement analysis to the QA Survival Kit. The testing curriculum nobody hands you on day one.
- [Article Series](https://www.codyssey.tech/series.md) - Multi-part series on testing, Spring Boot microservices, corporate satire, and machine learning — designed to be read in order, built to be binged.

## Posts
- [🪑 The Cobbler's Throne: Stick to the Shoes](https://www.codyssey.tech/the-cobblers-throne.md) - In the fourth century BC, a shoemaker told the greatest painter in Greece how to paint. From that moment, the word ultracrepidarian was born. A moral fable about Dunning-Kruger, the Peter Principle, and the question I keep avoiding: how often am I the shoemaker without knowing it?
- [🤖 The Machine That Reads Badly — Part II: Fixing What the Machine Broke](https://www.codyssey.tech/the-machine-that-reads-badly-part-ii-fixing-what-the-machine-broke.md) - The OCR engine returned a string where every O is a zero, every filler character is a K, and someone's date of birth starts with a letter. Part II is about building the second machine — the one that takes the first machine's best effort and systematically fixes its predictable mistakes.
- [🤖 The Machine That Reads Badly — Part I: Teaching Silicon to See](https://www.codyssey.tech/the-machine-that-reads-badly-part-i-teaching-silicon-to-see.md) - Here's a fun weekend project idea: build an app that scans ID documents. The answer, which you will discover approximately forty-five minutes in, is unreasonably hard. Not because the pieces are complicated — because the moment you connect them, they conspire against you.
- [🧫 The Antibody Problem](https://www.codyssey.tech/the-antibody-problem.md) - A learning comedy — the clinical case of a company whose immune system attacks its own cure: it advertises for a superhero, then rejects the one who shows up as “overqualified.” Why hiring gets sick, and how to read a rejection letter that contradicts its own evidence.
- [🧫 The Habitat: The Ecosystem That Breeds Them All](https://www.codyssey.tech/the-habitat.md) - The Human Code finale. Six awards travel to six species at the Engineering Excellence Awards, and the camera finally pulls back: the predators were never the organism under study. The habitat is. Which species does your building select for — and which are you becoming?
- [👻 The Phantom: The Manager Who Isn't There](https://www.codyssey.tech/the-phantom.md) - Episode 6 of Human Code. Praesentia vacua attends every meeting, nods at every update, and decides nothing. You can't observe this species directly — only the hole it leaves: the drift, the six-week-old access request, and Sync #7. The empty chair would cost less.
- [🪞 The Collector: The Predator That Hunts Trust](https://www.codyssey.tech/the-collector.md) - Episode 5 of Human Code — the one with teeth. Fiducia disponibilis acquires your trust faster than anyone you've ever met, keeps it in RAM, and never writes it to disk. One ordinary Tuesday, the migration begins. The host wasn't ended. The host was deprecated.
- [🪤 The Borrower: The Magpie in Your One-to-One](https://www.codyssey.tech/the-borrower.md) - Episode 4 of Human Code. Pica creditrix absorbs your ideas in private and presents them in public, 48 hours later, on slide seven, under the pronoun 'we'. The damage isn't the stolen thought — it's the silence that follows. Welcome to the food chain.
- [🔐 The Gatekeeper: The Dragon on a Hoard of Runbooks](https://www.codyssey.tech/the-gatekeeper.md) - Episode 3 of Human Code. Draco runbookensis answers your Slack question in four minutes at midnight and has never finished a runbook in its life. The most valuable animal in the building — and the most dangerous Confluence page. Bus factor: one.
- [🎭 The Performer: The Architect Who Builds for the Applause](https://www.codyssey.tech/the-performer.md) - Episode 2 of Human Code. Architectus theatralis builds monuments nobody asked for — four services, two queues, a standing ovation — then migrates before the maintenance bill arrives. The team inherits the peacock. The stairs stay with you.
- [🔥 The Arsonist: The Hero Who Smells Faintly of Smoke](https://www.codyssey.tech/the-arsonist.md) - Episode 1 of Human Code, a field guide to the corporate predator. Meet Ignis salvator: the engineer who is always first on the scene of every incident — for reasons the post-mortem never asks about. Hero syndrome, observed in its natural habitat.
- [☸️ To Production and Beyond: Kubernetes Deployment with Helm](https://www.codyssey.tech/to-production-and-beyond.md) - A Docker container without orchestration is a boat without navigation. This article covers the HELM framework — Kubernetes deployments, Helm chart templating, horizontal auto-scaling, network policies, pod security contexts, and the monitoring integration that ties the entire series together.
- [🐳 Ship It: Containerization with Docker and Docker Compose](https://www.codyssey.tech/ship-it.md) - The gap between "works on my machine" and "runs in production" is a Dockerfile. This article covers the DOCK framework — multi-stage builds that produce minimal images, non-root container security, Docker Compose orchestration with health checks, and lean image optimization.
- [🧪 Trust, But Verify: A Testing Strategy That Actually Works](https://www.codyssey.tech/trust-but-verify.md) - Code coverage is a number. Confidence is a feeling. They are not the same thing. This article introduces the PYRAMID framework — unit tests with Mockito, integration tests with MockMvc, ArchUnit architecture enforcement, JaCoCo coverage gates, and the test infrastructure that makes it all reliable.
- [🔭 Can You See Me Now?: The Three Pillars of Microservice Observability](https://www.codyssey.tech/can-you-see-me-now.md) - A microservice without observability is a black box you cannot operate. This article introduces the TRACE framework — structured logging with correlation IDs, custom business metrics with Micrometer, and distributed tracing with Zipkin. The three pillars that make production debuggable.
- [🚀 10,000 Threads and a Dream: Virtual Threads and Concurrent Microservices](https://www.codyssey.tech/10000-threads.md) - Traditional thread pools cap at 200 threads eating 200 MB of memory. Java virtual threads handle 10,000+ concurrent operations at 1 KB each. This article covers the ASYNC framework — virtual thread configuration, CompletableFuture composition, parallel fetching, and async bulk processing.
- [💥 Fail Gracefully: Error Handling, Validation, and the Art of Useful Errors](https://www.codyssey.tech/fail-gracefully.md) - Generic error responses tell your users nothing and your developers even less. This article introduces the CRAFT framework — sealed exception hierarchies, RFC 7807 ProblemDetail responses, multi-layer validation, and a GlobalExceptionHandler that turns failures into useful communication.
- [🔒 Guarding the Gates: Security Fundamentals for Microservices](https://www.codyssey.tech/guarding-the-gates.md) - Security is either invisible and effective or visible and broken. This article covers the GUARD framework for Spring Security — SecurityFilterChain configuration, role-based access control, CORS policies, BCrypt password encoding, and a test security setup that doesn't weaken production.
- [⚡ Cache Me If You Can: Smart Caching Strategies for Microservices](https://www.codyssey.tech/cache-me-if-you-can.md) - Naive caching causes stale data, memory exhaustion, and race conditions. Smart caching solves all three. This article introduces the TEMPO framework — TTL-based expiration, eviction strategies, multiple cache regions, and SpEL-driven cache keys using Caffeine and Spring.
- [🛡️ When the World Breaks: External API Integration and Resilience Patterns](https://www.codyssey.tech/when-the-world-breaks.md) - External APIs will fail. The question is whether your service fails with them. This article covers the SHIELD framework — RestClient configuration, Resilience4j circuit breakers, intelligent retries with exponential backoff, rate limiting, and graceful degradation when the world breaks.
- [🗄️ The Data Foundation: JPA, Hibernate, and the Database Migration Playbook](https://www.codyssey.tech/the-data-foundation.md) - Getting the data layer wrong costs you months of refactoring later. This article walks through the FORGE framework — Flyway migrations, JPA entity design, Spring Data repositories, transaction management, and audit trails — building a persistence layer that evolves safely.
- [🌐 REST Assured: Designing APIs Developers Actually Want to Use](https://www.codyssey.tech/rest-assured.md) - A perfectly engineered microservice is useless if developers hate the API. This article covers the CLEAR framework for REST design — consistent naming, multi-layer validation, RFC 7807 error contracts, and OpenAPI documentation that turns your endpoints into a product people want to use.
- [⚙️ Spring Boot Alchemy: Turning Configuration into a Running Service](https://www.codyssey.tech/spring-boot-alchemy.md) - Spring Boot auto-configuration feels like magic until something breaks at 2 AM. This article deconstructs the PROPS framework — profiles, property binding, bean lifecycle, and starter dependencies — so you understand every piece of the machinery running your microservice.
- [🏗️ The Blueprint Before the Build: Thinking in Layers](https://www.codyssey.tech/the-blueprint-before-the-build.md) - Every tangled codebase started as a clean idea. This article introduces the SLICED framework for layered architecture in Spring Boot, with automated ArchUnit rules that enforce boundaries for you.
- [🔭 Incoming Transmission: Science & Space Has Entered the Orbit](https://www.codyssey.tech/science-space-incoming-transmission.md) - Somewhere between Earth and the Moon — at a distance that would make your Wi-Fi router weep — a new section of Codyssey has powered up its antenna. Science & Space is open for business. The first article is in transit. The math checks out. Probably.
- [📊 The Watchers: A Documentary About the Company That Could See Everything Except Its Own Problems](https://www.codyssey.tech/the-watchers.md) - A dentist software company buys four observability platforms in 72 hours, builds 147 dashboards nobody opens, and spends $487K watching nothing. A mockumentary based on real industry data from Splunk, PagerDuty, and New Relic.
- [💼 Tech Layoffs and the Talent Market: What Changed](https://www.codyssey.tech/tech-layoffs-and-the-talent-market-what-changed.md) - The tech industry spent 2020–2022 hiring like there was no tomorrow, discovered there was in fact a tomorrow with a budget, and fired 622,000 people. A five-act tragedy about layoffs, ghost jobs, salary declines, and what it means for your career. With data, 22 sources, and appropriate sarcasm.
- [🌾 The Great Developer Famine: How Tech Ate Its Own Seed Corn](https://www.codyssey.tech/the-great-developer-famine-how-tech-ate-its-own-seed-corn.md) - Four million developers short. Response: hire 50% fewer juniors. This is the tech industry's self-inflicted famine—a trillion-dollar sector that burned its talent pipeline and now stands confused in the ashes, asking where all the seniors went.
- [🖖 Building a Technical Blog: What I Learned Running Codyssey](https://www.codyssey.tech/building-a-technical-blog-what-i-learned-running-codyssey.md) - There's an episode of Star Trek: TNG — "Darmok" — that has no business being the most useful blogging advice I've ever encountered. Six months. Thirty articles. Here's what actually worked, what failed spectacularly, and why 95% of tech blogs die after five posts.
- [🛡️ Resilience Patterns: Circuit Breakers, Bulkheads, and Retries](https://www.codyssey.tech/resilience-patterns-circuit-breakers-bulkheads-and-retries.md) - Your entire platform went down because a recommendation service got slow. Not down — slow. Here's how circuit breakers, bulkheads, and retries prevent cascading failures, with production-ready Spring Boot implementations and a real-world anatomy of the 2025 AWS outage.
- [🔺 The Testing Pyramid Is a Lie (Sort Of)](https://www.codyssey.tech/the-testing-pyramid-is-a-lie-sort-of.md) - The Testing Pyramid was a useful heuristic for monoliths in 2009. But most teams don't build monoliths anymore, and blindly following a triangle leads to test suites full of mocks that catch nothing. Here's how to figure out what shape your tests should actually be.
- [🌱 The Gardener's Paradox](https://www.codyssey.tech/the-gardeners-paradox.md) - There's no villain twirling a mustache in the corner. Just good people, doing reasonable things, wondering why the magic seems to have wandered off. A story about orchards, ducks, and the patterns that quietly shape our teams.
- [⚓ The Interim Captain](https://www.codyssey.tech/the-interim-captain.md) - Somewhere in the grey waters of the Atlantic, a frigate cut through the swells under the command of an interim captain. A fable about imposter syndrome, institutional blindness, and why the ship always knows who her real captain is. Dedicated to everyone who was told they are "just temporary."
- [🤖 The Parable of the Prophet Who Spoke Only in Tokens](https://www.codyssey.tech/the-parable-of-the-prophet-who-spoke-only-in-tokens.md) - A manager discovered AI and made it his answer to everything. $1.3 million, 47 database crashes, and 3,000 pages of useless docs later, only Janet from QA survived—saying exactly what she'd said since 2017.
- [🚀 The Glorious Pipeline Revolution of Station Kepler-7](https://www.codyssey.tech/the-glorious-pipeline-revolution-of-station-kepler-7.md) - A satirical sci-fi tale about a space station that tried to build a CI/CD pipeline in 30 days with no plan, wrong tools, and zero understanding of automation.
- [🚢 Kubernetes for the Confused: A Survival Guide for Developers Who Just Wanted to Deploy a Web App](https://www.codyssey.tech/kubernetes-deployment-guide.md) - A comedic survival guide to Kubernetes for developers who just wanted to deploy a web app. Covers Pods, Deployments, Services, Ingress, health checks, and production best practices—with enough humor to keep you from crying into your terminal.
- [🎰 The Parable of the Coin-Eating Kingdom](https://www.codyssey.tech/the-parable-of-the-coin-eating-kingdom.md) - A gaming empire built on grandma's slot machine addiction decided to stop making games, spent billions buying creativity they'd later destroy, and fired thousands while executives kept their ocean-view palaces. This is corporate self-destruction so spectacular it deserves its own casino.
- [🛠️ The QA Survival Kit: Your Complete Reference Guide](https://www.codyssey.tech/the-qa-survival-kit-your-complete-reference-guide.md) - Bookmark this! Complete QA survival kit with ready-to-use templates (test cases, bug reports, charters), essential checklists for every scenario, tools organized by category, career ladder with salaries, learning resources, and personal branding tips. Your go-to reference for daily QA work.
- [🐛 Bug Reports That Get Fixed: The Art of Communication](https://www.codyssey.tech/bug-reports-that-get-fixed-the-art-of-communication.md) - Stop getting "Cannot reproduce" on your bug reports! Learn the anatomy of reports that get fixed: specific titles, exact reproduction steps, clear evidence, and collaborative communication. Master severity vs priority, follow-up without annoyance, and build trust with developers. Words matter!
- [🎯 Modern QA Workflow & Best Practices](https://www.codyssey.tech/modern-qa-workflow-best-practices.md) - "How do I test everything in a 2-week sprint?" You don't—you test what matters! Learn modern Agile QA workflow, shift-left testing, CI/CD integration, and risk-based prioritization. Master the Three Amigos, parallel testing, and fast feedback loops. From waterfall bottleneck to DevOps enabler.
- [🚀 Real-World Case Study: Bringing It All Together](https://www.codyssey.tech/real-world-case-study-bringing-it-all-together.md) - The article you bookmark! Complete walkthrough of testing task reminders: ACID analysis, Three Amigos meeting, 6 test techniques combined, 38 test cases designed, 5 bugs found before production. Includes full test cases, HTML traceability matrix, coverage dashboard, and release decision rationale.
- [📊 Test Coverage Metrics: What Actually Matters](https://www.codyssey.tech/test-coverage-metrics-what-actually-matters.md) - "We have 90% coverage!" yet bugs still reach production. Learn the difference between coverage that helps and vanity metrics that lie. Master the test pyramid, requirement traceability, and risk-based testing. Build dashboards with context, not just numbers. Coverage is a compass, not a goal.
- [💥 Error Guessing & Exploratory Testing: The Art of Breaking Things](https://www.codyssey.tech/error-guessing-exploratory-testing-the-art-of-breaking-things.md) - Scripted tests miss interesting bugs! Learn Error Guessing for SQL injection, XSS, and race conditions. Master Exploratory Testing with SBTM for measurable creativity. Real case: found 11 critical bugs in 180 minutes that automation missed. Balance structure with intuition to find what matters.
- [🎲 Pairwise Testing: The Secret Weapon That Reduces Tests by 85%](https://www.codyssey.tech/pairwise-testing-the-secret-weapon-that-reduces-tests-by-85.md) - Cut 144 test cases down to 16 while finding the same bugs! Pairwise Testing uses proven mathematics to achieve 85-95% test reduction. Learn the science behind it, master free tools like PICT and TestCover, and discover when this technique saves weeks of testing time. Work smarter, not harder!
- [🔄 Decision Tables & State Transitions: Taming Complex Logic](https://www.codyssey.tech/decision-tables-state-transitions-taming-complex-logic.md) - Head spinning from complex "IF-AND-UNLESS" requirements? Learn Decision Tables to capture all logical combinations and State Transition Testing to map workflows systematically. Discover how to test both valid paths and prevent invalid transitions, achieving 100% coverage on complex features.
- [🎯 Equivalence Partitioning & Boundary Value Analysis: Test Smarter, Not Harder](https://www.codyssey.tech/equivalence-partitioning-boundary-value-analysis-test-smarter-not-harder.md) - Reduce your test cases by 68% while finding 50% MORE bugs! Learn Equivalence Partitioning and Boundary Value Analysis - two powerful techniques that help you test smarter, not harder. Discover why testing everything is impossible (and unnecessary) and where 70% of bugs actually hide: the boundaries.
- [🔍 From Chaos to Clarity: The Art of Requirement Analysis for QA](https://www.codyssey.tech/from-chaos-to-clarity-the-art-of-requirement-analysis-for-qa.md) - "The system should work intuitively" - sound familiar? Learn the ACID test framework to analyze requirements like a detective, ask the right questions before anyone else, and identify problems before they become 3 AM production incidents. Transform chaos into clarity with systematic QA analysis.
- [🐳Docker Fundamentals: A Complete Guide for Beginners](https://www.codyssey.tech/docker-fundamentals-guide.md) - You wanted to deploy a web app. Docker wanted you to understand images, containers, volumes, networks, and a file format that punishes indentation mistakes. This is the guide that explains all of it — from scratch, with practical examples, and without pretending any of it is intuitive.
- [🌍 Green Software Engineering: When Your Code Becomes an Environmental Hero](https://www.codyssey.tech/green-software-engineering-when-your-code-becomes-an-environmental-hero.md) - Think optimizing that loop made you a hero? Plot twist: your software might be melting glaciers. While we debated tabs vs. spaces, tech became a carbon colossus. Join this odyssey through green software engineering—where saving the planet matters as much as saving milliseconds.
- [🤖 AI-Native Software Architectures: How Autonomous Agents Will Redefine Software Development](https://www.codyssey.tech/ai-native-architectures.md) - Software used to be something you wrote. Now it's something you negotiate with. AI-native architectures replace traditional request-response patterns with autonomous agents, intent-driven orchestration, and systems that learn while they run. Here's what that actually looks like in practice.
- [⚛️ From Black Mesa's Monolith to Xen's Micro-Frontends: A Half-Life Inspired Journey into Modern Web Development](https://www.codyssey.tech/monolith-to-micro-frontends.md) - Your frontend monolith is a single point of failure, a deployment bottleneck, and a merge conflict generator. Micro-frontends fix that — but the journey from one to the other is full of trade-offs nobody warns you about. This guide explains the concepts using Half-Life as the map.
- [🤝The Magnificent World of Contract Testing: When Pinky Promises Get Technical](https://www.codyssey.tech/the-magnificent-world-of-contract-testing-when-pinky-promises-get-technical.md) - Your microservices talk to each other through APIs. When one team changes their contract without telling the other, production breaks at 2 AM. Contract testing with Pact prevents that — by making pinky promises enforceable.
- [🤖 The AI Developer Apocalypse That Never Came: A Survival Story from 2025](https://www.codyssey.tech/the-ai-developer-apocalypse-that-never-came-a-survival-story-from-2025.md) - A developer's survival story from the AI panic of 2024-2025. Discover the truth about AI in programming, testing, and why human skills still matter.
- [🔐 Cryptography in the Quantum Era: From Classical Algorithms to Post-Quantum Security](https://www.codyssey.tech/quantum-cryptography.md) - Everything you encrypted yesterday could be readable tomorrow. Quantum computers will break RSA, ECC, and most public-key cryptography. This is the complete guide to what's at risk, what's replacing it, and how post-quantum algorithms work.
- [🌟 The Empire Strikes Back: How Organizations Keep Making the Same Project Mistakes](https://www.codyssey.tech/project-mistakes-patterns.md) - New leadership arrives. They restructure teams, rebrand the methodology, and launch a transformation initiative. Six months later, the same bugs ship, the same deadlines slip, and the same post-mortem gets written in a slightly different font. A satirical look at why the cycle never breaks.
- [🚀 Go's Supremacy in Container Orchestration & Cloud Infrastructure](https://www.codyssey.tech/gos-supremacy-in-container-orchestration-and-cloud-infrastructure.md) - Docker, Kubernetes, Terraform, Prometheus — all written in Go. That's not a coincidence. Go's goroutines, static binaries, and fast compilation made it the default language of cloud infrastructure. Here's why, with the numbers to prove it.
- [🎭 The Great Tech Hiring Theater: A Comedy in Five Acts](https://www.codyssey.tech/the-great-tech-hiring-theater-a-comedy-in-five-acts.md) - Five years of experience required for a three-year-old framework. A whiteboard interview that tests nothing you'll do on the job. A "culture fit" assessment conducted over artisanal coffee. Tech hiring is broken, everyone knows it, and nobody fixes it. A comedy in five painful acts.
- [🚀 The Great Shift-Left Illusion: When QA Theory Crashes Into Development Reality](https://www.codyssey.tech/shift-left-qa-testing.md) - The conference talk says "shift left." The Sprint says "there's no time." The PM says "just test it faster." What happens when textbook QA methodology meets the reality of a development team that shipped yesterday's code this morning?
- [🚀Building Enterprise-Grade E2E Testing: A Complete Playwright Framework Guide](https://www.codyssey.tech/building-enterprise-grade-e2e-testing-a-complete-playwright-framework-guide.md) - Most E2E test suites start with enthusiasm and end with a flaky disaster everyone ignores. This guide builds an enterprise-grade Playwright framework from scratch — page objects, parallel execution, CI/CD integration, and the architecture that keeps it maintainable past month three.

## Optional
- [RSS Feed](https://www.codyssey.tech/rss/)
- [Sitemap](https://www.codyssey.tech/sitemap.xml)
- [Full content of pages and posts](https://www.codyssey.tech/llms-full.txt)