🟡 Intermediate Tutorials

Prerequisite: Complete the Beginner Tutorials section first

Welcome to the intermediate tutorials! These thirteen tutorials build on your e-commerce architecture from the Beginner section, introducing controls, flows, documentation generation, AI-assisted design, and governance with Patterns and Standards.

What You'll Learn

Tutorial	What You'll Master
Controls for NFRs	Document security, compliance, and performance requirements
Business Flows	Map business processes to architecture components
Link ADRs	Connect architectural decisions to your architecture
Share as a Website	Generate a shareable documentation website
CALM Widgets	Create custom docs with the widget framework
Handlebars Templates	Advanced custom documentation with full template control
Architecture Advisor	Use AI to identify and fix resilience weaknesses
Operations Advisor	Enrich architecture with operational metadata for incident response
Generate Ops Docs	Auto-generate runbooks and on-call guides from architecture data
CALM Patterns	Define and use reusable architecture templates
Organizational Standards	Extend CALM with your organization's required properties
Enforcing Standards	Wire Standards into Patterns for automated compliance
Multi-Pattern Validation	Validate one architecture against multiple patterns

Prerequisites

Before starting, ensure you have:

• Completed all Beginner Tutorials, particularly the capstone Complete Architecture tutorial
• Your ecommerce-platform.json architecture file from the Beginner section
• The CALM CLI installed and verified with calm --version
• VSCode with the CALM Tools extension installed

Time Commitment

Each tutorial takes approximately 30-60 minutes to complete. The AI-assisted tutorials may vary depending on how deeply you explore the recommendations.

Getting Started

Ready to begin? Start with Controls for NFRs →

Learning Path

Controls for NFRs ─────────────► "I can enforce non-functional requirements!"
    │
    ▼
Business Flows ────────────────► "I can model business processes!"
    │
    ▼
Link ADRs ─────────────────────► "I can trace decisions to architecture!"
    │
    ▼
Share as a Website ────────────► "I can publish architecture docs!"
    │
    ▼
CALM Widgets ──────────────────► "I can create custom visualisations!"
    │
    ▼
Handlebars Templates ──────────► "I have full template control!"
    │
    ▼
Architecture Advisor ──────────► "I can improve resilience with AI!"
    │
    ▼
Operations Advisor ────────────► "My architecture is an ops manual!"
    │
    ▼
Generate Ops Docs ─────────────► "Docs auto-generate from architecture!"
    │
    ▼
CALM Patterns ─────────────────► "I can enforce reusable structures!"
    │
    ▼
Organizational Standards ──────► "I can mandate org-wide properties!"
    │
    ▼
Enforcing Standards ───────────► "Standards are automatically checked!"
    │
    ▼
Multi-Pattern Validation ──────► "I can apply layered governance!"
    │
    ▼
🎯 Ready to govern architectures at organizational scale!

Tips for Success

1. Work through tutorials in order — Each one builds directly on the previous
2. Keep your ecommerce-platform.json — Most tutorials evolve this same file
3. Use CALM Chat mode — The AI assistant accelerates implementation
4. Validate frequently — Run calm validate -a architectures/ecommerce-platform.json after each change
5. Commit as you go — Use of git is a best practice in working with architecture-as-code.