Skip to main content

Chapter 14: Ten Axioms of Agentic Development

Overview

This chapter bridges Parts 1-3 (experiential learning) with Parts 4-6 (technical implementation), formalizing the developer methodology that has been implicit throughout your work so far. Through General Agents, Applied Workflows, and SDD-RI, you have already practiced these axioms without naming them. Now we make them explicit, providing the rigorous foundation that governs all subsequent Python programming and agent-building work.

The Ten Axioms are not abstract theory. They are distilled from real agentic development practice and directly extend the Seven Principles introduced in Chapter 4.

Relationship to the Seven Principles (Chapter 4)

DimensionSeven PrinciplesTen Axioms
AudienceALL users of AI agentsDEVELOPERS building agents
ScopeMindset and approachMethodology and practice
LevelHow to think about agent workHow to engineer agent systems
IntroducedPart 1 (foundations)Part 4 (technical bridge)

The Principles tell you how to think. The Axioms tell you how to build.

The Ten Axioms

#AxiomPrinciple ConnectionCore Teaching
IShell as OrchestratorP1: Bash is the KeyShell coordinates all tools; programs compute
IIKnowledge is MarkdownP5: Persisting StateMarkdown is the universal knowledge format
IIIPrograms Over ScriptsP2: Code as InterfaceProduction requires typed programs with tests and CI
IVComposition Over MonolithsP4: DecompositionBuild from composable, focused units
VTypes Are GuardrailsP6: ConstraintsType systems prevent errors before runtime
VIData is RelationalP5: Persisting StateSQL as default for structured data
VIITests Are the SpecificationP3: VerificationTDG: tests define correctness
VIIIVersion Control is MemoryP5: Persisting StateGit as persistent memory layer
IXVerification is a PipelineP3: VerificationCI/CD automates verification
XObservability Extends VerificationP7: ObservabilityRuntime monitoring extends testing

Layer Progression

LessonsLayerFocus
01-04L1 (Manual)Introduce axioms conceptually with concrete examples
05-07L2 (Collaboration)Explore axioms with AI assistance
08-10L2 to L3Axioms compose into integrated systems

Prerequisites

  • Part 1: General Agents Foundations (Chapters 1-4)
  • Part 2: Applied General Agent Workflows (Chapters 5-10)
  • Part 3: SDD-RI Fundamentals (Chapters 11-13)

What You'll Learn

  • How the shell serves as an orchestration layer distinct from computation
  • Why markdown is the universal knowledge format for agent workflows
  • The difference between disposable scripts and production programs
  • How composition, types, and relational data create robust agent systems
  • Test-Driven Generation (TDG) as the specification mechanism for AI-generated code
  • Git as persistent memory and CI/CD as automated verification
  • How observability extends verification from build-time into runtime