Skip to main content

ADRs for the Capstone: Three Must-Write Decisions

This generated surface maps a learner-facing curriculum unit to its canonical source routes.

Curriculum surface​

  • Open learner-facing unit
  • Curriculum path: content/curriculum/production/semester-10-capstone/module-01-domain-analysis-architecture-design/concepts/cluster-04-design-communication/12-adrs-for-the-capstone-three-must-write-decisions-primary.md
  • App: production
  • Semester: semester-10-capstone
  • Module: module-01-domain-analysis-architecture-design
  • Unit kind: concept
  • Curation level: module_curated

Learning objectives​

  • Explain ADRs for the Capstone: Three Must-Write Decisions as the work of turning a real problem domain into explicit boundaries, constraints, and architectural decisions instead of vague project ambition.
  • Use ADRs for the Capstone: Three Must-Write Decisions to make the capstone direction defensible: what problem is being solved, what scope is excluded, and which tradeoffs matter most.
  • Use api-design-patterns, clean-architecture, fundamentals-of-software-architecture, learning-domain-driven-design to connect the learner-facing explanation to domain analysis, architecture sketches, requirements framing, and decision rationale.

Prerequisites​

  • Comfort with architecture, system design, and making tradeoffs explicit before implementation begins.

Source books​

  • api-design-patterns
  • clean-architecture
  • fundamentals-of-software-architecture
  • learning-domain-driven-design

Source routes​

Api Design Patterns​

Clean Architecture​

Fundamentals Of Software Architecture​

Learning Domain Driven Design​

Supporting curriculum routes​

External enrichment​

  • C4 Model (official_docs_companion) - Anchors capstone architecture communication in a practical model that is easy to apply and review.
  • arc42 Documentation (optional_deep_dive) - Adds a more complete documentation structure for teams that need stronger design traceability.

AI companion modes​

  • Explain simply
  • Socratic tutor
  • Challenge my understanding
  • Diagnose my confusion
  • Connect forward / backward

Source-of-truth note​

This teaching unit is learner-facing guidance assembled from canonical book routes plus prior curriculum surfaces. Use the listed source books as the primary conceptual spine for ADRs for the Capstone: Three Must-Write Decisions, and use the supporting curriculum routes to reconnect earlier learner-facing explanations when needed.