From 40c025396d5cae32ec697b4e70b74a65436cad25 Mon Sep 17 00:00:00 2001
From: "Builder.io" <builder-bot@builder.io>
Date: Mon, 17 Nov 2025 01:31:59 +0000
Subject: [PATCH] Phase 1 README - How to Use These Files

cgen-349d6272c6e04c2a888e5d2bd8cb152b
---
 docs/PHASE1-README.md | 67 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 67 insertions(+)
 create mode 100644 docs/PHASE1-README.md

diff --git a/docs/PHASE1-README.md b/docs/PHASE1-README.md
new file mode 100644
index 00000000..c35b5062
--- /dev/null
+++ b/docs/PHASE1-README.md
@@ -0,0 +1,67 @@
+# Axiom Model - Phase 1 Migration
+## How to Use This Package
+
+You have 3 files to help with the Phase 1 code migration:
+
+### 1. **PHASE1-CHECKLIST.txt** ← START HERE
+Simple, easy-to-read checklist of all files to copy.
+- ✅ Just check off items as you copy them
+- 📋 Best for quick reference while working
+- 👥 Share this with your team
+
+### 2. **PHASE1-FILES.json**
+Machine-readable list of all files with metadata.
+- 🤖 Use this if you want to script/automate the copy
+- 📊 Includes priority levels, categories, and notes
+- 💻 Parse this in your favorite tool
+
+### 3. **AXIOM-MODEL-PHASE1-SCOPE.md**
+Complete detailed documentation.
+- 📖 Full explanation of every file and why it matters
+- 🎯 Includes adaptation notes and potential blockers
+- 🔍 Reference this if you get stuck on something
+
+---
+
+## Quick Start
+
+1. **Read** PHASE1-CHECKLIST.txt
+2. **Copy** all files listed from aethex.dev → aethex.foundation
+3. **Update** environment variables on Replit
+4. **Test** login flow end-to-end
+5. **Proceed** to Phase 2 when Phase 1 passes
+
+---
+
+## Key Things to Remember
+
+- **Update VITE_API_BASE** from `https://aethex.dev` → `https://aethex.foundation`
+- **Convert API endpoints** from Vercel `/api/*` to Express routes
+- **Update Discord OAuth app** redirect URI to use aethex.foundation
+- **Set all environment variables** on Replit (Supabase, Discord, etc.)
+
+---
+
+## Estimated Time
+**17-25 hours** for complete Phase 1 migration
+
+---
+
+## Questions?
+Refer to AXIOM-MODEL-PHASE1-SCOPE.md sections:
+- **Import issues?** → Section 7: Libraries & Dependencies
+- **What file goes where?** → Sections 1-5: Complete file listing
+- **How do I adapt?** → Section 7: Critical Adaptations
+- **How do I test?** → Section 9: Checklist → Testing Phase 1
+
+---
+
+## Next: Phase 2
+Once Phase 1 is complete, Phase 2 involves:
+- Supabase permission migration (Foundation gets full access)
+- `aethex.dev` loses direct write access to user_profiles
+
+Then Phase 3:
+- Reroute `aethex.dev` login → `aethex.foundation` (SSO)
+
+**Done!** The Axiom Model is live.