Architecture Decisions

This section records key architecture decisions made during the development of common-fwk. Each decision document captures the context, the options considered, and the rationale.

Decision Log

ID	Title	Status
ADR-001	Spec-Driven Development (SDD) workflow	Active
ADR-002	Core/adapter boundary pattern	Active
ADR-003	No global singleton for Application	Active
ADR-004	Consolidated docs under /docs (deprecate openspec/)	Active

---

Table of contents

• ADR-001 SDD Workflow
• ADR-002 Adapter Boundary
• ADR-003 No Global Singleton
• ADR-004 Docs Structure