From ccbd55097998712f89df78ab70647e5cd642b6ba Mon Sep 17 00:00:00 2001
From: Brooke Hamilton <45323234+brooke-hamilton@users.noreply.github.com>
Date: Fri, 30 Jan 2026 11:21:33 -0500
Subject: [PATCH 1/2] constitution

Signed-off-by: Brooke Hamilton <45323234+brooke-hamilton@users.noreply.github.com>
---
 .specify/memory/constitution.md | 37 ++++++++++++++++++++++++++++++---
 1 file changed, 34 insertions(+), 3 deletions(-)

diff --git a/.specify/memory/constitution.md b/.specify/memory/constitution.md
index be23bbe5..0f493fad 100644
--- a/.specify/memory/constitution.md
+++ b/.specify/memory/constitution.md
@@ -1,8 +1,11 @@
 <!--
 Sync Impact Report
-- Version change: N/A -> 1.0.0
-- Modified principles: none (new document)
+- Version change: 1.1.0 -> 1.2.0
+- Modified principles: none
 - Added sections:
+  - Project Structure (multi-repository overview)
+  - VS Code Workspace (workspace file guidance for Spec Kit users)
+  - Spec Kit Usage (template folder exclusion guidance)
   - Principle I (API-First Design)
   - Principle II (Idiomatic Code Standards)
   - Principle III (Multi-Cloud Neutrality)
@@ -32,6 +35,34 @@ Sync Impact Report
 
 # Radius Design Notes Constitution
 
+## Project Structure
+
+Radius is a **multi-repository application**. To fully understand Radius as a platform, you MUST consider the following repositories, which work together to form the complete system:
+
+| Repository | Purpose | Location |
+| ------------ | --------- | ---------- |
+| **radius** | Core control plane, CLI, resource providers, controllers, and API definitions (Go, TypeSpec) | `../radius` |
+| **dashboard** | Web UI for Radius built on Backstage (TypeScript, React) | `../dashboard` |
+| **docs** | User documentation site built with Hugo (Markdown) | `../docs` |
+| **resource-types-contrib** | Community-contributed resource type schemas and Recipes (YAML, Bicep, Terraform) | `../resource-types-contrib` |
+
+These repositories are located as sibling folders to this `design-notes` repository. Features and changes often span multiple repositories, requiring coordinated design and implementation.
+
+### VS Code Workspace
+
+This repository includes a VS Code workspace file at the root: `design-notes.code-workspace`. **Users of Spec Kit in this repository are strongly encouraged to open this workspace** rather than opening individual repositories. The workspace provides:
+
+- All five Radius repositories in a single VS Code window
+- Consistent settings for cross-repository development
+- Unified search across all Radius codebases
+- Better context for AI assistants understanding the full scope of Radius
+
+To use: Open VS Code → File → Open Workspace from File → Select `design-notes.code-workspace`
+
+### Spec Kit Usage
+
+When using Spec Kit commands in this repository, the `./template` folder at the repository root MUST be ignored. This folder contains legacy or example templates that are NOT intended for use with Spec Kit workflows. Spec Kit templates are located in `.specify/templates/` and are managed separately.
+
 ## Core Principles
 
 ### I. API-First Design
@@ -368,4 +399,4 @@ For day-to-day development guidance beyond this constitution, refer to:
 - [Developer guides](https://github.com/radius-project/radius/tree/main/docs/contributing) for detailed technical instructions
 - [Code organization guide](https://github.com/radius-project/radius/blob/main/docs/contributing/contributing-code/contributing-code-organization/README.md) for repository structure
 
-**Version**: 1.0.0 | **Ratified**: 2025-11-06 | **Last Amended**: 2025-11-07
+**Version**: 1.2.0 | **Ratified**: 2025-11-06 | **Last Amended**: 2026-01-30

From 60edfe8a97df60a08f5f6066aa316598d5b410d0 Mon Sep 17 00:00:00 2001
From: Brooke Hamilton <45323234+brooke-hamilton@users.noreply.github.com>
Date: Sat, 31 Jan 2026 10:10:58 -0500
Subject: [PATCH 2/2] Apply suggestions from code review

Co-authored-by: Dariusz Porowski <3431813+DariuszPorowski@users.noreply.github.com>
Signed-off-by: Brooke Hamilton <45323234+brooke-hamilton@users.noreply.github.com>
---
 .specify/memory/constitution.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.specify/memory/constitution.md b/.specify/memory/constitution.md
index 0f493fad..190416bc 100644
--- a/.specify/memory/constitution.md
+++ b/.specify/memory/constitution.md
@@ -1,6 +1,6 @@
 <!--
 Sync Impact Report
-- Version change: 1.1.0 -> 1.2.0
+- Version change: 1.0.0 -> 1.1.0
 - Modified principles: none
 - Added sections:
   - Project Structure (multi-repository overview)
@@ -399,4 +399,4 @@ For day-to-day development guidance beyond this constitution, refer to:
 - [Developer guides](https://github.com/radius-project/radius/tree/main/docs/contributing) for detailed technical instructions
 - [Code organization guide](https://github.com/radius-project/radius/blob/main/docs/contributing/contributing-code/contributing-code-organization/README.md) for repository structure
 
-**Version**: 1.2.0 | **Ratified**: 2025-11-06 | **Last Amended**: 2026-01-30
+**Version**: 1.1.0 | **Ratified**: 2025-11-06 | **Last Amended**: 2026-01-30