Developer/_architecture-migration-review
Architecture Migration Review Checklist
Working doc, not part of the permanent knowledge base — delete this file once the review below is done and Architecture/ has been cleared (or kept, if review turns up problems).
All 108 Architecture/ notes below have a matched Developer/ location, verified programmatically (exact Sources-URL match, or exact title match where a note had no external source — mostly self-authored Challenges). Check each row by opening both files side by side and confirming content survived the reformat intact (nothing truncated, tradeoff tables/Sources/Related preserved, cross-links resolve). Tick the box as you go.
Once every box is ticked and nothing looks wrong, Architecture/ is safe to delete — ask and I'll do it (it still has real value as a live folder until then, so nothing removes it automatically).
Fundamentals (54)
| ✓ | Architecture/ source | → | Developer/ location | matched by |
|---|---|---|---|---|
| [ ] | Fundamentals/api-gateway-pattern.md |
→ | Networking/APIGateway/Fundamentals/api-gateway-pattern.md |
url |
| [ ] | Fundamentals/api-versioning-strategies.md |
→ | APIDesign/Versioning/Fundamentals/api-versioning-strategies.md |
url |
| [ ] | Fundamentals/autoscaling-strategies.md |
→ | Availability/Scalability/Fundamentals/autoscaling-strategies.md |
url |
| [ ] | Fundamentals/backend-for-frontend-pattern.md |
→ | ArchitecturePatterns/Microservices/Fundamentals/backend-for-frontend-bff-pattern.md |
url |
| [ ] | Fundamentals/backpressure-and-flow-control.md |
→ | CommunicationPatterns/Sync-vs-Async/Fundamentals/backpressure-and-flow-control.md |
url |
| [ ] | Fundamentals/blue-green-canary-deployments.md |
→ | DeveloperTools/DeploymentStrategies/BlueGreen/Fundamentals/blue-green-and-canary-deployments.md |
url |
| [ ] | Fundamentals/bulkhead-pattern.md |
→ | Idempotency/Bulkheads/Fundamentals/bulkhead-pattern.md |
url |
| [ ] | Fundamentals/caching-strategies.md |
→ | DataManagement/Caching/Fundamentals/caching-strategies.md |
url |
| [ ] | Fundamentals/cap-theorem-and-pacelc.md |
→ | ConsistencyConcurrency/Fundamentals/cap-theorem-and-the-pacelc-extension.md |
url |
| [ ] | Fundamentals/cdn-and-edge-caching.md |
→ | Networking/CDN/Fundamentals/cdn-and-edge-caching.md |
url |
| [ ] | Fundamentals/cell-based-architecture.md |
→ | Availability/Scalability/Fundamentals/cell-based-architecture.md |
url |
| [ ] | Fundamentals/change-data-capture.md |
→ | AppIntegration/ETL-ELT/Fundamentals/change-data-capture-cdc.md |
url |
| [ ] | Fundamentals/chaos-engineering.md |
→ | Idempotency/ChaosEngineering/Fundamentals/chaos-engineering.md |
url |
| [ ] | Fundamentals/circuit-breaker-pattern.md |
→ | Idempotency/CircuitBreakers/Fundamentals/circuit-breaker-pattern.md |
url |
| [ ] | Fundamentals/compute-pricing-models.md |
→ | CostManagement/ReservedVsOnDemand/Fundamentals/compute-pricing-models.md |
url |
| [ ] | Fundamentals/connection-pooling.md |
→ | DataManagement/Database/Fundamentals/connection-pooling.md |
url |
| [ ] | Fundamentals/consistent-hashing.md |
→ | ConsistencyConcurrency/Partitioning-Sharding/Fundamentals/consistent-hashing.md |
url |
| [ ] | Fundamentals/data-storage-tiering.md |
→ | DataManagement/Storage/Fundamentals/data-storage-tiering-and-lifecycle-policies.md |
url |
| [ ] | Fundamentals/data-transfer-and-egress-costs.md |
→ | CostManagement/CloudCostOptimization/Fundamentals/data-transfer-and-egress-costs.md |
url |
| [ ] | Fundamentals/database-indexing-strategies.md |
→ | DataManagement/Database/Indexing/Fundamentals/database-indexing-strategies.md |
url |
| [ ] | Fundamentals/database-sharding-strategies.md |
→ | DataManagement/Database/Sharding/Fundamentals/database-sharding-strategies.md |
url |
| [ ] | Fundamentals/defense-in-depth.md |
→ | Security/Fundamentals/defense-in-depth.md |
url |
| [ ] | Fundamentals/disaster-recovery-strategies.md |
→ | Availability/DisasterRecovery/Fundamentals/disaster-recovery-strategies.md |
title |
| [ ] | Fundamentals/distributed-consensus-raft.md |
→ | ConsistencyConcurrency/Replication/Fundamentals/distributed-consensus-raft-and-leader-election.md |
url |
| [ ] | Fundamentals/distributed-locking-and-fencing-tokens.md |
→ | ConsistencyConcurrency/Concurrency-Threading/Locks-Mutexes-ReadWriteLock/Fundamentals/distributed-locking-and-fencing-tokens.md |
url |
| [ ] | Fundamentals/encryption-at-rest-in-transit-in-use.md |
→ | Security/EncryptionAtRestInTransit/Fundamentals/encryption-at-rest-in-transit-and-in-use.md |
url |
| [ ] | Fundamentals/event-sourcing-and-cqrs.md |
→ | ArchitecturePatterns/CQRS/Fundamentals/event-sourcing-and-cqrs.md |
url |
| [ ] | Fundamentals/feature-flags-and-progressive-delivery.md |
→ | DeveloperTools/DeploymentStrategies/Canary/Fundamentals/feature-flags-and-progressive-delivery.md |
url |
| [ ] | Fundamentals/finops-cost-allocation-tagging.md |
→ | CostManagement/FinOps/Fundamentals/finops-cost-allocation-tagging-showback-chargeback.md |
url |
| [ ] | Fundamentals/gitops.md |
→ | DeveloperTools/CI-CD/Fundamentals/gitops.md |
url |
| [ ] | Fundamentals/health-checks-liveness-vs-readiness.md |
→ | Availability/Availability/Fundamentals/health-checks-liveness-vs-readiness-probes.md |
url |
| [ ] | Fundamentals/idempotency-keys.md |
→ | Idempotency/Idempotency/Fundamentals/idempotency-keys.md |
url |
| [ ] | Fundamentals/infrastructure-as-code.md |
→ | DeveloperTools/IaC/Fundamentals/infrastructure-as-code-iac.md |
url |
| [ ] | Fundamentals/least-privilege-and-iam-policy-design.md |
→ | Auth/RBAC-ABAC/Fundamentals/least-privilege-and-iam-policy-design.md |
url |
| [ ] | Fundamentals/load-balancing-algorithms.md |
→ | Networking/LoadBalancing/Fundamentals/load-balancing-algorithms.md |
url |
| [ ] | Fundamentals/message-queues-and-event-streaming.md |
→ | CommunicationPatterns/MessageQueues/Fundamentals/message-queues-vs-event-streaming.md |
url |
| [ ] | Fundamentals/mutual-tls.md |
→ | Security/TransportSecurity/Fundamentals/mutual-tls-mtls.md |
url |
| [ ] | Fundamentals/oauth2-and-oidc.md |
→ | Auth/AuthenticationProtocols/Fundamentals/oauth-2-0-and-openid-connect.md |
url |
| [ ] | Fundamentals/postmortems-and-blameless-culture.md |
→ | Governance/ChangeManagement/Fundamentals/postmortems-and-blameless-incident-culture.md |
url |
| [ ] | Fundamentals/public-key-infrastructure-and-certificates.md |
→ | Security/TransportSecurity/Fundamentals/public-key-infrastructure-pki-and-certificate-management.md |
url |
| [ ] | Fundamentals/rate-limiting-algorithms.md |
→ | RateLimiting/Fundamentals/rate-limiting-algorithms.md |
url |
| [ ] | Fundamentals/read-replicas-and-replication-lag.md |
→ | DataManagement/Database/Replication/Fundamentals/read-replicas-and-replication-lag.md |
url |
| [ ] | Fundamentals/retry-backoff-and-jitter.md |
→ | Idempotency/RetriesBackoff/Fundamentals/retry-strategies-backoff-jitter-and-retry-storms.md |
url |
| [ ] | Fundamentals/saga-pattern.md |
→ | ConsistencyConcurrency/SagaPattern/Fundamentals/saga-pattern.md |
url |
| [ ] | Fundamentals/secrets-management-and-rotation.md |
→ | Auth/SecretManagement/Fundamentals/secrets-management-and-rotation.md |
url |
| [ ] | Fundamentals/service-mesh.md |
→ | Networking/ServiceMesh/Fundamentals/service-mesh.md |
url |
| [ ] | Fundamentals/slo-sli-error-budgets.md |
→ | Observability/Alerting-SLOs/Fundamentals/slis-slos-and-error-budgets.md |
url |
| [ ] | Fundamentals/spot-instances-and-interruption-handling.md |
→ | CostManagement/ReservedVsOnDemand/Fundamentals/spot-instances-and-interruption-handling.md |
url |
| [ ] | Fundamentals/strangler-fig-pattern.md |
→ | MigrationTransfer/LiftAndShift-Replatform/Fundamentals/strangler-fig-pattern.md |
url |
| [ ] | Fundamentals/team-topologies-and-conways-law.md |
→ | Governance/ArchitectureGovernance/Fundamentals/team-topologies-and-conways-law.md |
url |
| [ ] | Fundamentals/threat-modeling-stride.md |
→ | Security/ThreatModeling/Fundamentals/threat-modeling-with-stride.md |
url |
| [ ] | Fundamentals/three-pillars-of-observability.md |
→ | Observability/Fundamentals/three-pillars-of-observability.md |
url |
| [ ] | Fundamentals/transactional-outbox-pattern.md |
→ | CommunicationPatterns/MessageQueues/Fundamentals/transactional-outbox-pattern.md |
url |
| [ ] | Fundamentals/zero-trust-architecture.md |
→ | Security/NetworkSecurity/Fundamentals/zero-trust-architecture.md |
url |
CaseStudies (31)
| ✓ | Architecture/ source | → | Developer/ location | matched by |
|---|---|---|---|---|
| [ ] | CaseStudies/airbnb-identity-graph-knowledge-graph-platform.md |
→ | DataManagement/DataEng/CaseStudies/airbnb-scaling-the-identity-graph-off-a-vendor-graph-database.md |
title |
| [ ] | CaseStudies/airbnb-multi-product-data-architecture.md |
→ | DataManagement/DataEng/CaseStudies/airbnb-evolving-data-architecture-for-a-multi-product-world.md |
url |
| [ ] | CaseStudies/aws-hybrid-multi-tenant-stateful-services.md |
→ | ArchitecturePatterns/Microservices/CaseStudies/aws-hybrid-multi-tenant-architecture-for-stateful-services-at-scale.md |
url |
| [ ] | CaseStudies/box-itdag-architectural-decision-making.md |
→ | Governance/ArchitectureGovernance/CaseStudies/box-scaling-cross-team-architectural-decisions-with-itdag.md |
title |
| [ ] | CaseStudies/canva-stateless-sessions-and-revocation.md |
→ | Auth/IdentityLifecycle/CaseStudies/canva-stateless-session-cookies-and-revocation-at-hundreds-of-millions-of-users.md |
url |
| [ ] | CaseStudies/cloudflare-security-insights-scaling-10x.md |
→ | Availability/Scalability/CaseStudies/cloudflare-scaling-security-insights-to-a-10x-increase-in-global-scanning-capacity.md |
url |
| [ ] | CaseStudies/coinbase-fragment-apis-identity-scaling.md |
→ | Auth/IdentityLifecycle/CaseStudies/coinbase-fragment-apis-and-federated-identity-at-1-5m-reads-second.md |
title |
| [ ] | CaseStudies/coinbase-outage-circular-recovery-dependency.md |
→ | Availability/FaultTolerance/CaseStudies/coinbase-when-the-recovery-tooling-depends-on-what-just-broke.md |
title |
| [ ] | CaseStudies/discord-scylla-control-plane-automation.md |
→ | DataManagement/Database/CaseStudies/discord-automating-scylladb-cluster-operations-with-the-scylla-control-plane.md |
url |
| [ ] | CaseStudies/doordash-clusterless-ml-feature-store.md |
→ | MachineLearning/FeatureEngineering/CaseStudies/doordash-a-clusterless-feature-store-serving-layer.md |
url |
| [ ] | CaseStudies/github-30x-capacity-rearchitecture.md |
→ | Availability/Scalability/CaseStudies/github-rearchitecting-for-30x-capacity-under-agentic-ai-load-growth.md |
title |
| [ ] | CaseStudies/grab-apache-iceberg-data-lake-migration.md |
→ | DataManagement/DataEng/CaseStudies/grab-migrating-a-petabyte-scale-data-lake-to-apache-iceberg.md |
title |
| [ ] | CaseStudies/grab-palana-secure-ai-agent-platform.md |
→ | AI/AgenticWorkflows/CaseStudies/grab-palana-a-secure-kubernetes-platform-for-autonomous-ai-agents.md |
title |
| [ ] | CaseStudies/netflix-data-bridge-connector-factory.md |
→ | AppIntegration/ETL-ELT/CaseStudies/netflix-data-bridge-connector-factory-for-cassandra-data-movement.md |
url |
| [ ] | CaseStudies/netflix-kueue-batch-compute-migration.md |
→ | Compute/BatchProcessing/CaseStudies/netflix-retiring-a-homegrown-batch-scheduler-for-kueue.md |
url |
| [ ] | CaseStudies/netflix-nebula-archrules-governance.md |
→ | Governance/ArchitectureGovernance/CaseStudies/netflixs-nebula-archrules-architecture-governance-across-thousands-of-repos.md |
url |
| [ ] | CaseStudies/netflix-real-time-service-topology.md |
→ | Networking/ServiceMesh/CaseStudies/netflix-building-a-real-time-service-topology-map.md |
url |
| [ ] | CaseStudies/pinterest-automated-schema-evolution-cdc.md |
→ | MigrationTransfer/SchemaVersioning/CaseStudies/pinterest-automated-schema-evolution-in-a-cdc-ingestion-pipeline.md |
title |
| [ ] | CaseStudies/pinterest-rpp-terraform-least-privilege.md |
→ | DeveloperTools/IaC/CaseStudies/pinterest-resource-provisioner-pipeline-a-centralized-terraform-engine-for-least-privilege-aws-at-scale.md |
title |
| [ ] | CaseStudies/shopify-inventory-reservations-mysql.md |
→ | DataManagement/Database/RowVersioning-OptimisticConcurrency/CaseStudies/shopify-replacing-redis-with-mysql-for-inventory-reservations.md |
url |
| [ ] | CaseStudies/slack-quarry-ssh-to-rest-emr-pipelines.md |
→ | AppIntegration/ETL-ELT/CaseStudies/slack-eliminating-standing-ssh-access-from-emr-data-pipelines.md |
title |
| [ ] | CaseStudies/slack-whitecastle-cloud-network-rearchitecture.md |
→ | Networking/VPC-Subnetting/CaseStudies/slack-whitecastle-rebuilding-slacks-cloud-network-to-escape-the-vpc-peering-trap.md |
title |
| [ ] | CaseStudies/spotify-random-access-parquet-data-lake-indexing.md |
→ | DataManagement/DataEng/CaseStudies/spotify-random-access-parquet-indexing-the-data-lake-for-online-point-queries.md |
title |
| [ ] | CaseStudies/stripe-connect-fund-segregation.md |
→ | Compliance/ComplianceFrameworks/CaseStudies/stripe-connect-fund-segregation-with-allocated-balances.md |
url |
| [ ] | CaseStudies/stripe-idempotency-keys.md |
→ | Idempotency/Idempotency/CaseStudies/stripe-idempotency-keys.md |
url |
| [ ] | CaseStudies/stripe-mongodb-fleet-auto-remediation.md |
→ | DataManagement/Database/CaseStudies/stripe-graph-search-and-state-machines-to-auto-remediate-a-global-database-fleet.md |
url |
| [ ] | CaseStudies/stripe-thin-events-notification-handlers.md |
→ | CommunicationPatterns/Webhooks/CaseStudies/stripe-thin-events-and-notification-handlers-for-version-stable-webhooks.md |
url |
| [ ] | CaseStudies/uber-gitfarm-git-as-a-service.md |
→ | DeveloperTools/CI-CD/CaseStudies/uber-gitfarm-git-as-a-service-for-large-scale-monorepos.md |
url |
| [ ] | CaseStudies/uber-scaling-exact-count-distinct.md |
→ | DataFlowPatterns/MapReduce-BatchAggregation/CaseStudies/uber-scaling-exact-count-distinct-for-high-cardinality-metrics.md |
url |
| [ ] | CaseStudies/uber-verify-with-wallet-identity.md |
→ | Auth/IdentityLifecycle/CaseStudies/uber-scaling-verify-with-wallet-for-identity-verification.md |
url |
| [ ] | CaseStudies/uber-zone-failure-resilient-opensearch.md |
→ | Availability/FaultTolerance/CaseStudies/uber-zone-failure-resilient-opensearch.md |
url |
Challenges (23)
| ✓ | Architecture/ source | → | Developer/ location | matched by |
|---|---|---|---|---|
| [ ] | Challenges/design-a-cost-anomaly-detection-system.md |
→ | CostManagement/CloudCostOptimization/Challenges/design-a-cost-anomaly-detection-system-for-a-multi-account-cloud-estate.md |
title |
| [ ] | Challenges/design-a-cost-optimized-batch-pipeline.md |
→ | Compute/BatchProcessing/Challenges/design-a-cost-optimized-batch-data-pipeline.md |
title |
| [ ] | Challenges/design-a-cross-service-data-deletion-pipeline.md |
→ | Regulatory/GDPR/Challenges/design-a-cross-service-data-deletion-right-to-be-forgotten-pipeline.md |
title |
| [ ] | Challenges/design-a-deployment-pipeline-with-canary-analysis-and-rollback.md |
→ | DeveloperTools/DeploymentStrategies/Canary/Challenges/design-a-deployment-pipeline-with-automated-canary-analysis-and-rollback.md |
title |
| [ ] | Challenges/design-a-distributed-id-generation-service.md |
→ | ConsistencyConcurrency/Challenges/design-a-distributed-unique-id-generation-service.md |
title |
| [ ] | Challenges/design-a-distributed-job-scheduler.md |
→ | SchedulingQueueingDisciplines/Challenges/design-a-distributed-job-scheduler.md |
title |
| [ ] | Challenges/design-a-feature-flag-platform.md |
→ | DeveloperTools/DeploymentStrategies/Canary/Challenges/design-a-feature-flag-progressive-delivery-platform.md |
title |
| [ ] | Challenges/design-a-kyc-aml-onboarding-pipeline.md |
→ | Compliance/ComplianceFrameworks/Challenges/design-a-kyc-aml-onboarding-pipeline-for-a-fintech-platform.md |
title |
| [ ] | Challenges/design-a-multi-region-caching-layer.md |
→ | DataManagement/Caching/CDN-EdgeCache/Challenges/design-a-multi-region-caching-layer-for-a-read-heavy-api.md |
title |
| [ ] | Challenges/design-a-multi-tenant-data-isolation-strategy.md |
→ | Governance/DataGovernance/Challenges/design-a-multi-tenant-data-isolation-strategy.md |
title |
| [ ] | Challenges/design-a-payment-reconciliation-system.md |
→ | RecordsAudit/AuditLogging/Challenges/design-a-payment-reconciliation-system.md |
title |
| [ ] | Challenges/design-a-rate-limiter.md |
→ | RateLimiting/Challenges/design-a-rate-limiter.md |
title |
| [ ] | Challenges/design-a-real-time-collaborative-document-editor.md |
→ | CommunicationPatterns/Protocols/WebSockets/Challenges/design-a-real-time-collaborative-document-editing-system.md |
title |
| [ ] | Challenges/design-a-real-time-fraud-detection-system.md |
→ | DataFlowPatterns/ScatterGather/Challenges/design-a-real-time-fraud-detection-system.md |
title |
| [ ] | Challenges/design-a-real-time-order-matching-engine.md |
→ | SchedulingQueueingDisciplines/PriorityScheduling/Challenges/design-a-real-time-order-matching-engine.md |
title |
| [ ] | Challenges/design-a-saas-metering-cost-chargeback-system.md |
→ | CostManagement/UnitEconomics/Challenges/design-a-multi-tenant-saas-metering-cost-chargeback-system.md |
title |
| [ ] | Challenges/design-a-search-autocomplete-system.md |
→ | DesignPatterns/AlgorithmsDataStructures/TreesAndHeaps/Challenges/design-a-search-autocomplete-typeahead-system.md |
title |
| [ ] | Challenges/design-a-secrets-management-system.md |
→ | Auth/SecretManagement/Challenges/design-a-secrets-management-system.md |
title |
| [ ] | Challenges/design-a-webhook-delivery-system.md |
→ | CommunicationPatterns/Webhooks/Challenges/design-a-webhook-delivery-system.md |
title |
| [ ] | Challenges/design-a-zero-downtime-database-migration-system.md |
→ | MigrationTransfer/ZeroDowntimeMigration/Challenges/design-a-zero-downtime-database-migration-system.md |
title |
| [ ] | Challenges/design-an-audit-log-system-for-a-regulated-platform.md |
→ | RecordsAudit/AuditLogging/Challenges/design-an-audit-log-system-for-a-regulated-trading-platform.md |
title |
| [ ] | Challenges/design-an-incident-response-escalation-system.md |
→ | Observability/Alerting-SLOs/Challenges/design-an-incident-response-and-on-call-escalation-system.md |
title |
| [ ] | Challenges/design-an-observability-pipeline-for-microservices.md |
→ | Observability/DistributedTracing/Challenges/design-an-observability-pipeline-for-a-microservices-platform.md |
title |