From f066b4677fc7a0877df86c3588c22c1221a4242d Mon Sep 17 00:00:00 2001
From: Jordan Robinson <hello@jordanrobinson.org>
Date: Sun, 19 Oct 2025 15:41:38 +0100
Subject: [PATCH] add technology radar tech stack review

---
 README.md                                     |   3 +-
 .../technology-radar-tech-stack-review.md     | 114 ++++++++++++++++++
 2 files changed, 116 insertions(+), 1 deletion(-)
 create mode 100644 templates/technology-radar-tech-stack-review.md

diff --git a/README.md b/README.md
index 5f5a718148dbdb2051a922c8721d2dc5da7e4331..b9dcad901a07595bce10beb3fa7edfd73ef24d62 100644
--- a/README.md
+++ b/README.md
@@ -13,4 +13,5 @@ Comprehensive collection of templates for solutions design, architecture decisio
 * Code Review Standards & Guidelines
 * Technical Debt Registry
 * Capacity Planning & Scaling Document
-* Incident Postmortem
\ No newline at end of file
+* Incident Postmortem
+* Technology Radar / Tech Stack Review
\ No newline at end of file
diff --git a/templates/technology-radar-tech-stack-review.md b/templates/technology-radar-tech-stack-review.md
new file mode 100644
index 0000000000000000000000000000000000000000..d63e4fb71f183df4503eb288b0ae8acc9ca31a86
--- /dev/null
+++ b/templates/technology-radar-tech-stack-review.md
@@ -0,0 +1,114 @@
+# Technology Radar / Tech Stack Review
+
+## Overview
+**Last Updated:** [Date]  
+**Review Period:** [Quarter/Year]  
+**Next Review:** [Date]
+
+## Instructions
+- **Adopt:** Use this technology, it's proven and recommended
+- **Trial:** Experiment with this in limited scope
+- **Assess:** Watch and evaluate this technology
+- **Hold:** Stop using, deprecated, or not recommended for new projects
+
+## Adopted Technologies
+
+### [Technology Name] - [Category]
+**Status:** Adopted  
+**Version:** [Version]  
+**Since:** [When adopted]  
+**Rationale:** Why this is our standard  
+**Use Cases:** Where and when to use this  
+**Constraints:** Any limitations or gotchas  
+**Maintenance:** Who maintains it internally?  
+**Migration:** How to migrate from alternatives  
+
+## Trial Technologies
+
+### [Technology Name] - [Category]
+**Status:** Trial  
+**Version:** [Version]  
+**Started:** [When]  
+**Planned Duration:** [3-6 months typically]  
+**Rationale:** Why we're exploring this  
+**Trial Scope:** Limited use cases/teams  
+**Success Criteria:** How will we evaluate?  
+**Next Review:** [Date]  
+**Owners:** [Team evaluating]  
+
+## Assess Technologies
+
+### [Technology Name] - [Category]
+**Status:** Assess  
+**Version:** [Version]  
+**Added:** [When]  
+**Rationale:** Why this is on our radar  
+**Why Not Yet:** Why not adopted yet?  
+**Blockers:** What needs to change for adoption?  
+**Target Decision:** [When we'll make a decision]  
+**Owner:** [Who's tracking this]  
+
+## Hold/Deprecated
+
+### [Old Technology Name] - [Category]
+**Status:** Hold (or Deprecated)  
+**Version:** [Last version used]  
+**Used Until:** [When we stopped using it]  
+**Reason for Hold:** Why we're moving away  
+**Migration Path:** How to migrate from this  
+**Legacy Support:** How long we'll support existing code  
+**Migration Timeline:** When legacy support ends  
+
+## By Category
+
+### Languages
+- Go (Adopted)
+- Python (Adopted)
+- Rust (Assess)
+- Java (Hold)
+
+### Frameworks & Libraries
+- React (Adopted)
+- FastAPI (Adopted)
+- Django (Hold)
+
+### Databases
+- PostgreSQL (Adopted)
+- Redis (Adopted)
+- MongoDB (Trial)
+- Cassandra (Hold)
+
+### Infrastructure & DevOps
+- Kubernetes (Adopted)
+- Docker (Adopted)
+- Terraform (Adopted)
+
+### Monitoring & Observability
+- Prometheus (Adopted)
+- Grafana (Adopted)
+- DataDog (Trial)
+
+## Decision Process
+
+### How Technologies Enter the Radar
+1. Proposal by team
+2. Initial assessment
+3. Review meeting
+4. Decision and placement
+
+### Criteria for Adoption
+- Solves real problems
+- Team expertise available
+- Community/vendor support
+- Performance and reliability proven
+- Integration with existing stack
+
+### Review Schedule
+- Quarterly full radar review
+- Continuous assessment of trial technologies
+- Annual deep-dive on hold technologies
+
+## Historical Changes
+- Version history of this document
+- Technologies moved in/out each quarter
+- Notable decisions and rationale
\ No newline at end of file