# 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.
- [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 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)