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

Dockerfile

@@ -1,7 +1,6 @@
-# Default Dockerfile - replace with your application
+# Foundary — replace with application-specific build
 FROM nginx:alpine
 
-# Copy static files or your app
 COPY . /usr/share/nginx/html/
 
 EXPOSE 80

README.md

@@ -1,21 +1,66 @@
-# foundary-1770652398
+# Foundary
 
-Deployed at: https://wmqrefkk.threesix.ai
+**A product studio for conversational product development.**
+
+Foundary turns conversations into working software. Describe what you want to build, iterate through dialogue, and ship production-ready products — all driven by natural conversation.
+
+## How It Works
+
+1. **Converse** — Describe your product idea in plain language
+2. **Refine** — Iterate on requirements, design, and architecture through dialogue
+3. **Build** — Foundary generates and assembles the components
+4. **Ship** — Deploy to production with a single push
+
+## Repository Structure
+
+```
+foundary/
+├── apps/          # Deployable applications (web UI, CLI, etc.)
+├── services/      # Backend microservices
+├── packages/      # Shared libraries and modules
+├── docs/          # Documentation and guides
+├── scripts/       # Build, deploy, and development scripts
+├── Dockerfile     # Container build
+└── .woodpecker.yml # CI/CD pipeline
+```
+
+| Directory    | Purpose                                              |
+| ------------ | ---------------------------------------------------- |
+| `apps/`      | User-facing applications and interfaces              |
+| `services/`  | Independent backend services                         |
+| `packages/`  | Shared code — utilities, types, clients              |
+| `docs/`      | Architecture decisions, API docs, onboarding guides  |
+| `scripts/`   | Automation for local dev, CI, and deployment          |
 
 ## Getting Started
 
-1. Clone the repository
+```bash
-2. Build with Docker: `docker build -t foundary-1770652398 .`
+# Clone
-3. Run locally: `docker run -p 8080:8080 foundary-1770652398`
+git clone https://git.threesix.ai/jordan/foundary-1770652398.git
+cd foundary-1770652398
 
-## 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
+
+## Deployment
+
+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://wmqrefkk.threesix.ai
+
+## Contributing
+
+Each `services/`, `apps/`, and `packages/` subdirectory is independently buildable and testable. See the README in each directory for specific instructions.
 
 ## Resources
 
-- Live site: https://wmqrefkk.threesix.ai
+- **Live site**: https://wmqrefkk.threesig.ai
-- Git repository: https://git.threesix.ai/jordan/foundary-1770652398.git
+- **Repository**: https://git.threesig.ai/jordan/foundary-1770652398.git