3-D Printing Production Software
Architecture, Validation, and Control for Agentic Software Engineering
Front Matter
Part 1 — The Context
Part 2 — The Mindset
Part 3 — The Governed Engineering Environment
- 6The Agent Stack
- 7Models and the Semantic Gap
- 8The Governed Environment: Ex-Ante and Ex-Post
- 9Lifecycles and Runbooks
- 10Metrics
Part 4 — The Model Zoo
- 11The Executable Zoo
- 12The Logical View
- 13The Process View
- 14The Development View
- 15The Physical View
- 16The Scenarios View
Part 5 — Putting It to Work
- 17Brownfield
- 18The Skills
- 19Everything Is a Transformation
- 20Training Data and the Novelty Axis
- 21Lessons Learned
Back Matter
Appendix A — Agent patterns
- AAppendix — the pattern language
- AAppendix A - 1. Brief-linting
- AAppendix A - 2. Docs hierarchy + governance index
- AAppendix A - 3. Dynamic context injection
- AAppendix A - 4. Role-typed dispatch
- AAppendix A - 5. Merge-train MIS batching
- AAppendix A - 6. Pre-commit hook (3-stanza, tree-sha markers)
- AAppendix A - 7. Sentinel first-commit early-abort
- AAppendix A - 8. Staged deploy gates (canary → smoke → promote)
- AAppendix A - 9. Aggregate-compute protection (`lint-all` host mutex)
- AAppendix A - 10. Build-serializer (M=8 semaphore)
- AAppendix A - 11. Resource-pressure gating (admit before, shed during)
- AAppendix A - 12. Test-serializer (N=1 flock on `dotnet test`)
- AAppendix A - 13. Agent registry (append-only log + marker cache)
- AAppendix A - 14. Caused-by provenance (agent-side change traceability)
- AAppendix A - 15. Cron-alerts gate
- AAppendix A - 16. Deploy heartbeats + stale-worker detection
- AAppendix A - 17. Lifecycle hooks (interpose on the agent runtime's events)
- AAppendix A - 18. Reflection-facet substrate (tempo-gated policy nudges)
- AAppendix A - 19. Tombstone commits (lifecycle close records)
- AAppendix A - 20. Orchestrator-as-reactor over an event bus
- AAppendix A - 21. CLAUDE.md rule index (the governance document as a mechanism)
- AAppendix A - 22. Doc-hygiene lints (index coverage, autogen provenance)
- AAppendix A - 23. Epic & design-doc templates
- AAppendix A - 24. Epic Definition-of-Done (Final-Opus trust-nothing re-run)
- AAppendix A - 25. Mandatory snippet-table enforcement
- AAppendix A - 26. Operational playbooks
- AAppendix A - 27. Operator runbook skill (positive map first, symptom index fallback)
- AAppendix A - 28. Enforce at the right semantic level
Appendix B — Models-bridge patterns
- BAppendix B - 1. The agent-first MBSE harness
- BAppendix B - 2. Agent-orchestration model (developer journeys)
- BAppendix B - 3. Component & zone model
- BAppendix B - 4. Mediator & single-writer contracts
- BAppendix B - 5. Control↔substrate dependency (computed blast-radius)
- BAppendix B - 6. Coverage → model-node mapping (which invariants are actually tested)
- BAppendix B - 7. Deployment & tier topology
- BAppendix B - 8. Domain registries
- BAppendix B - 9. Drift & parity gates
- BAppendix B - 10. Executable source-of-truth models
- BAppendix B - 11. Formal invariant verification (temporal form → model checking)
- BAppendix B - 12. Invariant-DAG execution policy (a typed Scheduler separates correctness from resource + cost)
- BAppendix B - 13. Journey-criticality → test-tier placement (which host a test runs on, derived)
- BAppendix B - 14. Meta-model consumption discipline (read, don't hardcode)
- BAppendix B - 15. Model-driven codegen
- BAppendix B - 16. Model-graded finding severity (distance-graded gate)
- BAppendix B - 17. Model query surface (`repo-query`)
- BAppendix B - 18. Service-flow / API model
- BAppendix B - 19. Symbol-anchored traceability graph (derived edges)
- BAppendix B - 20. Synchronization model (meta-sync)
- BAppendix B - 21. User-journey model (product-goal → implementation bridge)
Appendix C — Product patterns
- CAppendix C - 1. Canonical walkers (one traversal per tree)
- CAppendix C - 2. Office Models ({Slides,Docs,Sheets}Model)
- CAppendix C - 3. PdfModel (sole PDF mutation surface)
- CAppendix C - 4. Sole raw-Redis seam (the dispatch module)
- CAppendix C - 5. ServiceClient (typed cross-service seam)
- CAppendix C - 6. Cross-source coherence lints
- CAppendix C - 7. ContentValidator (input ⊆ output fidelity)
- CAppendix C - 8. Blocking semantic lints
- CAppendix C - 9. Standards / WCAG rule engine
- CAppendix C - 10. DDT pin-trailers (doc-derived characterization)
- CAppendix C - 11. Fuzz campaigns (+ auto-coverage)
- CAppendix C - 12. FsCheck property tests
- CAppendix C - 13. Test-onion tiers (Smoke / Lite / targeted / full)
- CAppendix C - 14. `a11y_` prefix convention
- CAppendix C - 15. `derive-changelog` (reconstruct mutations)
- CAppendix C - 16. F10 mutator-stamp-wiring lint
- CAppendix C - 17. Per-mutator attribution stamps
- CAppendix C - 18. Codemod-first threshold (N≳50 → AST transformer)
- CAppendix C - 19. Closed remediation-verb sets
- CAppendix C - 20. Typed `ViolationCategory` / `FailureCategory` enums
Appendix D — Mechanism Stacks
- DAppendix D — Mechanism Stacks
- DAppendix D - 1. The MBSE stack
- DAppendix D - 2. The self-operations stack
- DAppendix D - 3. The semantic-lint stack
- DAppendix D - 4. The worktree-lifecycle stack
- DAppendix D - 5. The canonical-seam stack
- DAppendix D - 6. The observability stack
Appendix E — How to Write a Skill
Index
© James C. Davis, 2026–present