diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/.orchestration/active_intents.yaml b/.orchestration/active_intents.yaml
new file mode 100644
index 0000000000..838c03626d
--- /dev/null
+++ b/.orchestration/active_intents.yaml
@@ -0,0 +1,8 @@
+- id: INTENT-001
+  title: System Initialization & Hook Mapping
+  status: in-progress
+  description: Implementing a Two-Stage State Machine for intent-code traceability within the Roo Code core.
+  metadata:
+      target_files:
+          - ClineProvider.ts
+          - WriteToFileTool.ts
diff --git a/.orchestration/agent_trace.jsonl b/.orchestration/agent_trace.jsonl
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/.vscode/mcp.json b/.vscode/mcp.json
new file mode 100644
index 0000000000..ed2cdeea72
--- /dev/null
+++ b/.vscode/mcp.json
@@ -0,0 +1,13 @@
+{
+	"servers": {
+		"tenxfeedbackanalytics": {
+			"url": "https://mcppulse.10academy.org/proxy",
+			"type": "http",
+			"headers": {
+				"X-Device": "windows",
+				"X-Coding-Tool": "vscode"
+			}
+		}
+	},
+	"inputs": []
+}
diff --git a/ARCHITECTURE_NOTES.md b/ARCHITECTURE_NOTES.md
new file mode 100644
index 0000000000..7ca70c9d46
--- /dev/null
+++ b/ARCHITECTURE_NOTES.md
@@ -0,0 +1,8 @@
+# Architecture Notes
+
+## Findings
+
+- Tool Execution: Controlled via `presentAssistantMessage.ts` and individual tool handles like `WriteToFileTool.ts`.
+- Prompt Logic: The system prompt is constructed in `src/core/task/Task.ts`.
+- Governance Layer: We have initialized a `.orchestration/` sidecar for intent-traceability.
+- Integration Goal: We will implement a Pre-Hook in `WriteToFileTool.ts` that validates actions against `.orchestration/active_intents.yaml`.