Architecture Decisions & Publishing to ClawHub

You built the application. You understand its economics. Now you learn why it is built this way, and you publish it to the world.

This sub-module has two halves. The first half is a case study in real-world architecture decisions: six pivots from "build everything ourselves" to "publish an app on the Agent OS." The second half teaches you to document, version, and distribute an OpenClaw application on ClawHub.

What This Sub-Module Covers

Section A: Architecture Decisions

• Six architectural pivots that lead from custom brains to MCP-first agency.
• Invariant vs Variant layers: what must stay (pedagogy, content) vs what must change (delivery, routing).
• Eight meta-lessons for the AI-native architect.
• The Platform Inversion: the insight that learners ARE the infrastructure.

Section B: Professional Practice & Distribution

• Architecture Decision Records (ADRs): documenting the Why, not just the How.
• Versioning strategy: leveraging the 95% server-side update advantage.
• Distribution strategy: navigating ClawHub marketplace dynamics and network effects.
• Module 9.5, Chapter 10 Retrospective: bridging the gap from Consumer to Architect.

📚 Teaching Aid

Prerequisites

• Module 9.3 (Building TutorClaw): The application whose architecture we analyze.
• Module 9.4 (The Economics Stack): The economics that validate the architecture.