The Architect and the Machine: Decisions, Code, and Lessons from an Enterprise AI Project (The Professional and the Machine)

The book that explains how software is actually built with AINot from theory. Not from a prompt tutorial. From the experience of an architect with over twenty years in offensive cybersecurity and B2B business who decided to test a hypothesis: can a domain expert with Claude Code build what used to require a team of fifteen?This book documents the answer — with code, with reasoned decisions, with mistakes included. 26 chapters covering the full lifecycle of a software project: architecture, backend, language model integration, AI agents, frontend, testing, deployment, and operations.What you'll learnContext engineering — How to structure information so Claude Code generates coherent code in complex projects. The CLAUDE.md as the agent's contract.AI agents in production — Claude Agent SDK, RAG with millions of vectors in Qdrant, semantic search, conversational interfaces. Not demos: systems that work.Agent Teams — Teams of agents working in parallel: backend, frontend, tests, and security simultaneously, coordinated by the architect.Defensive architecture — IAM, security by design, REST APIs, asynchronous queues. Everything reviewed through a pentester's lens.Testing when AI generates the code — The quality gap, drift metrics, and why human oversight is not optional.Docker, CI/CD, and observability — From code to real deployment.Each chapter, three layersConcept — Accessible for executives.Decision — Trade-offs with discarded alternatives. For architects.Implementation — Didactic code. For those who build.Who this is forAI architects, CTOs, senior developers, and consultants who want to understand how to lead the construction of complex software with AI agents — not as a concept, but as daily practice.Honesty, not hypeWhen AI generates insecure code. When agents get it wrong. When a prototype is not a product. And when the judgment of an experienced professional remains the only thing separating a functional system from a vulnerable one.The Professional and the Machine series. Authors: Carlos Pérez González (OSCE, OSCP, OSWE, OSEP, CREST; founder of iHackLabs, acquired by Telefónica). Juan C. Montes (GCFA, GREM, PHRACK #65). Read more