build: Set up the monorepo workspace. Ensure the root README describes a pro...

Dockerfile

@@ -1,8 +1,7 @@
 # Default Dockerfile - replace with your application
 FROM nginx:alpine
 
-# Copy static files or your app
+COPY README.md /usr/share/nginx/html/
-COPY . /usr/share/nginx/html/
 
 EXPOSE 80
 

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
+```bash
-2. Build with Docker: `docker build -t foundary-1770644471 .`
+# Clone
-3. Run locally: `docker run -p 8080:8080 foundary-1770644471`
+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:
+# Run
-- Build a Docker image
+docker run -p 8080:8080 foundary
-- Push to the container registry
+```
-- Deploy to Kubernetes
 
-## Resources
+## Deployment
 
-- Live site: https://qj7ckumy.threesix.ai
+Pushes to `main` trigger automatic deployment via Woodpecker CI:
-- Git repository: https://git.threesix.ai/jordan/foundary-1770644471.git
+
+1. Build Docker image
+2. Push to registry (`registry.threesix.ai`)
+3. Update Kubernetes deployment
+
+Live at: https://qj7ckumy.threesix.ai