AllenNeuralDynamics · tmchartrand · May 27, 2026 · May 27, 2026 · May 27, 2026
diff --git a/docs/source/aind/core_services.md b/docs/source/aind/core_services.md
@@ -1,5 +1,7 @@
 # Core Services
 
+The interactions between many of these services are illustrated in the [AIND software diagrams](./diagrams.md).
+
 **aind-data-transfer-service**
 
 FastAPI service to run data compression and transfer jobs on the HPC

diff --git a/docs/source/aind/diagrams.md b/docs/source/aind/diagrams.md
@@ -0,0 +1,11 @@
+# AIND Software and Systems Diagrams
+
+This page contains diagrams illustrating the interactions between AIND software and systems, including core services, data storage, and compute resources. These diagrams are intended to provide a high-level overview of how different components fit together, and will be updated periodically as our software and systems evolve.
+
+**New diagrams coming soon for future plans and low-level architecture.**
+
+## High-level architecture
+
+![High-level data flow](../diagrams/high_level/general_data_flow.drawio.svg)
+
+![AIND Software Overview](../_static/aind-software-overview.png)
diff --git a/...ging/dynamic_foraging_architecture.drawio → ...ging/dynamic_foraging_architecture.drawio b/...ging/dynamic_foraging_architecture.drawio → ...ging/dynamic_foraging_architecture.drawio
diff --git a/...oraging/dynamic_foraging_architecture.svg → ...oraging/dynamic_foraging_architecture.svg b/...oraging/dynamic_foraging_architecture.svg → ...oraging/dynamic_foraging_architecture.svg
diff --git a/...amic-foraging-low-level-processing.drawio → ...amic-foraging-low-level-processing.drawio b/...amic-foraging-low-level-processing.drawio → ...amic-foraging-low-level-processing.drawio
diff --git a/...dynamic-foraging-low-level-processing.svg → ...dynamic-foraging-low-level-processing.svg b/...dynamic-foraging-low-level-processing.svg → ...dynamic-foraging-low-level-processing.svg
diff --git a/diagrams/high_level/general_data_flow.drawio → ...grams/high_level/general_data_flow.drawio b/diagrams/high_level/general_data_flow.drawio → ...grams/high_level/general_data_flow.drawio
diff --git a/...s/high_level/general_data_flow.drawio.svg → ...s/high_level/general_data_flow.drawio.svg b/...s/high_level/general_data_flow.drawio.svg → ...s/high_level/general_data_flow.drawio.svg
diff --git a/...ice/aind-data-transfer-service-k8s.drawio → ...ice/aind-data-transfer-service-k8s.drawio b/...ice/aind-data-transfer-service-k8s.drawio → ...ice/aind-data-transfer-service-k8s.drawio
diff --git a/...-service/aind-metadata-service-k8s.drawio → ...-service/aind-metadata-service-k8s.drawio b/...-service/aind-metadata-service-k8s.drawio → ...-service/aind-metadata-service-k8s.drawio
diff --git a/...vice/aind-metadata-service-k8s.drawio.svg → ...vice/aind-metadata-service-k8s.drawio.svg b/...vice/aind-metadata-service-k8s.drawio.svg → ...vice/aind-metadata-service-k8s.drawio.svg
diff --git a/.../metadata_service_overview_diagram.drawio → .../metadata_service_overview_diagram.drawio b/.../metadata_service_overview_diagram.drawio → .../metadata_service_overview_diagram.drawio
diff --git a/...adata_service_overview_diagram.drawio.svg → ...adata_service_overview_diagram.drawio.svg b/...adata_service_overview_diagram.drawio.svg → ...adata_service_overview_diagram.drawio.svg
diff --git a/...rvice_procedures_extractor_diagram.drawio → ...rvice_procedures_extractor_diagram.drawio b/...rvice_procedures_extractor_diagram.drawio → ...rvice_procedures_extractor_diagram.drawio
diff --git a/...e_procedures_extractor_diagram.drawio.svg → ...e_procedures_extractor_diagram.drawio.svg b/...e_procedures_extractor_diagram.drawio.svg → ...e_procedures_extractor_diagram.drawio.svg
diff --git a/...s/low_level/asset_registration_api.drawio → ...s/low_level/asset_registration_api.drawio b/...s/low_level/asset_registration_api.drawio → ...s/low_level/asset_registration_api.drawio
diff --git a/...rams/low_level/asset_registration_api.svg → ...rams/low_level/asset_registration_api.svg b/...rams/low_level/asset_registration_api.svg → ...rams/low_level/asset_registration_api.svg
diff --git a/diagrams/low_level/data_asset_indexer.drawio → ...grams/low_level/data_asset_indexer.drawio b/diagrams/low_level/data_asset_indexer.drawio → ...grams/low_level/data_asset_indexer.drawio
diff --git a/diagrams/low_level/data_asset_indexer.svg → ...diagrams/low_level/data_asset_indexer.svg b/diagrams/low_level/data_asset_indexer.svg → ...diagrams/low_level/data_asset_indexer.svg
diff --git a/...ams/low_level/data_schema_to_docdb.drawio → ...ams/low_level/data_schema_to_docdb.drawio b/...ams/low_level/data_schema_to_docdb.drawio → ...ams/low_level/data_schema_to_docdb.drawio
diff --git a/diagrams/low_level/data_schema_to_docdb.svg → ...agrams/low_level/data_schema_to_docdb.svg b/diagrams/low_level/data_schema_to_docdb.svg → ...agrams/low_level/data_schema_to_docdb.svg
diff --git a/diagrams/low_level/docdb_api.drawio → ...ource/diagrams/low_level/docdb_api.drawio b/diagrams/low_level/docdb_api.drawio → ...ource/diagrams/low_level/docdb_api.drawio
diff --git a/diagrams/low_level/docdb_api.svg → docs/source/diagrams/low_level/docdb_api.svg b/diagrams/low_level/docdb_api.svg → docs/source/diagrams/low_level/docdb_api.svg
diff --git a/diagrams/low_level/redshift_client.drawio → ...diagrams/low_level/redshift_client.drawio b/diagrams/low_level/redshift_client.drawio → ...diagrams/low_level/redshift_client.drawio
diff --git a/diagrams/low_level/redshift_client.svg → ...ce/diagrams/low_level/redshift_client.svg b/diagrams/low_level/redshift_client.svg → ...ce/diagrams/low_level/redshift_client.svg
diff --git a/...d_level/codeocean_pipeline_diagram.drawio → ...d_level/codeocean_pipeline_diagram.drawio b/...d_level/codeocean_pipeline_diagram.drawio → ...d_level/codeocean_pipeline_diagram.drawio
diff --git a/.../mid_level/codeocean_pipeline_diagram.svg → .../mid_level/codeocean_pipeline_diagram.svg b/.../mid_level/codeocean_pipeline_diagram.svg → .../mid_level/codeocean_pipeline_diagram.svg
diff --git a/...s/mid_level/local_data_center_flow.drawio → ...s/mid_level/local_data_center_flow.drawio b/...s/mid_level/local_data_center_flow.drawio → ...s/mid_level/local_data_center_flow.drawio
diff --git a/...d_level/local_data_center_flow.drawio.svg → ...d_level/local_data_center_flow.drawio.svg b/...d_level/local_data_center_flow.drawio.svg → ...d_level/local_data_center_flow.drawio.svg
diff --git a/docs/source/index.md b/docs/source/index.md
@@ -32,7 +32,7 @@ Follow these links to request access to:
 
 ## I want to learn about...
 
-[Data organization](policies_practices/data_organization.md), [data governance](policies_practices/data_governance.md), and [software practices](policies_practices/software_practices.md) at AIND.
+[Data organization](policies_practices/data_organization.md), [data governance](policies_practices/data_governance.md), [software practices](policies_practices/software_practices.md), or [visualize how our software and systems interact](aind/diagrams.md).
 
 ```{toctree}
 :maxdepth: 1