Feature/workflow management research

README.md

@@ -2,7 +2,7 @@
 
 This toolkit helps teams build consistent, well-documented APIs for safety net programs—enabling faster integration between benefits systems and reducing the technical barriers to improving service delivery.
 
-**New here?** Start with the [Executive Summary](./docs/presentation/executive-summary.md) for a one-page overview, or view the [Toolkit Overview](https://codeforamerica.github.io/safety-net-openapi/presentation/safety-net-openapi-overview.html) presentation for a detailed walkthrough.
+**New here?** Start with the [Executive Summary](./docs/presentation/executive-summary.md) for a one-page overview, or view the [Toolkit Overview](https://codeforamerica.github.io/safety-net-openapi/presentation/safety-net-openapi-overview.html) presentation for a detailed walkthrough. For the technical design, see the [Domain Architecture](./docs/architecture/domain-design.md).
 
 ## About This Repository
 
@@ -67,6 +67,9 @@ Visit `http://localhost:3000` for interactive API docs.
 - [Project Structure](./docs/reference/project-structure.md) — File layout and conventions
 - [Troubleshooting](./docs/reference/troubleshooting.md) — Common issues and solutions
 
+### Architecture
+- [Architecture Overview](./docs/architecture/README.md) — Domain design, API architecture, design decisions, and roadmap
+
 ### Architecture Decisions
 - [Multi-State Overlays](./docs/architecture-decisions/multi-state-overlays.md)
 - [Search Patterns](./docs/architecture-decisions/search-patterns.md)

docs/architecture/README.md

@@ -0,0 +1,23 @@
+# Architecture Documentation
+
+This directory contains architecture documentation for the Safety Net Benefits API.
+
+> **Status: Proposed Architecture**
+> These documents describe the target architecture. The current implementation includes only a subset (Intake with Applications and Persons). The remaining domains and functionality are planned for future development.
+
+## Documents
+
+| Document | Description |
+|----------|-------------|
+| [Domain Design](domain-design.md) | Domain organization, entities, data flow, and safety net concerns |
+| [API Architecture](api-architecture.md) | API layers, vendor independence, and operational architecture |
+| [Design Decisions](design-decisions.md) | Key decisions with rationale and alternatives considered |
+| [Roadmap](roadmap.md) | Migration, implementation phases, future considerations, and documentation gaps |
+
+## Related Resources
+
+| Resource | Description |
+|----------|-------------|
+| [api-patterns.yaml](../../packages/schemas/openapi/patterns/api-patterns.yaml) | Machine-readable API design patterns |
+| [Architecture Decision Records](../architecture-decisions/) | Formal ADRs for significant decisions |
+| [Guides](../guides/) | How-to guides for working with the toolkit |