diff --git a/Dockerfile b/Dockerfile
index e7846dc..40e70dc 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -1,8 +1,7 @@
 # Default Dockerfile - replace with your application
 FROM nginx:alpine
 
-# Copy static files or your app
-COPY . /usr/share/nginx/html/
+COPY README.md /usr/share/nginx/html/
 
 EXPOSE 80
 
diff --git a/README.md b/README.md
index 912931a..cab28f7 100644
--- a/README.md
+++ b/README.md
@@ -1,21 +1,52 @@
-# foundary-1770644471
+# Foundary
 
-Deployed at: https://qj7ckumy.threesix.ai
+Foundary is a conversational product studio — a platform where products are designed, refined, and built through natural dialogue. Instead of navigating complex toolchains, users describe what they want and Foundary turns the conversation into working software.
+
+## How It Works
+
+1. **Describe** — Tell Foundary what you want to build in plain language.
+2. **Refine** — Foundary asks clarifying questions, surfaces trade-offs, and proposes options.
+3. **Build** — Approved designs are translated into deployable artifacts automatically.
+
+Every product decision is captured as part of the conversation, creating a living record of intent that stays linked to the code it produced.
+
+## Repository Layout
+
+```
+foundary/
+├── services/       # Backend microservices
+├── packages/       # Shared libraries and utilities
+├── docs/           # Architecture and design documentation
+├── Dockerfile      # Container build
+└── .woodpecker.yml # CI/CD pipeline
+```
+
+| Directory    | Purpose                                          |
+|-------------|--------------------------------------------------|
+| `services/` | Independent backend services (APIs, workers)     |
+| `packages/` | Code shared across services (clients, models)    |
+| `docs/`     | ADRs, API specs, and system design documentation |
 
 ## Getting Started
 
-1. Clone the repository
-2. Build with Docker: `docker build -t foundary-1770644471 .`
-3. Run locally: `docker run -p 8080:8080 foundary-1770644471`
+```bash
+# Clone
+git clone https://git.threesix.ai/jordan/foundary-1770644471.git
+cd foundary-1770644471
 
-## CI/CD
+# Build
+docker build -t foundary .
 
-This project uses Woodpecker CI for continuous deployment. Pushing to `main` will:
-- Build a Docker image
-- Push to the container registry
-- Deploy to Kubernetes
+# Run
+docker run -p 8080:8080 foundary
+```
 
-## Resources
+## Deployment
 
-- Live site: https://qj7ckumy.threesix.ai
-- Git repository: https://git.threesix.ai/jordan/foundary-1770644471.git
+Pushes to `main` trigger automatic deployment via Woodpecker CI:
+
+1. Build Docker image
+2. Push to registry (`registry.threesix.ai`)
+3. Update Kubernetes deployment
+
+Live at: https://qj7ckumy.threesix.ai
diff --git a/docs/.gitkeep b/docs/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/packages/.gitkeep b/packages/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/services/.gitkeep b/services/.gitkeep
new file mode 100644
index 0000000..e69de29