From 6b42088c4be6f5c703869d1e895571c92b911e20 Mon Sep 17 00:00:00 2001
From: rdev-worker <worker@threesix.ai>
Date: Mon, 9 Feb 2026 08:27:42 +0000
Subject: [PATCH] build: Set up the monorepo workspace. Ensure the root README
 describes a pro...

---
 .claude/CLAUDE.md | 16 ++++++++++----
 README.md         | 54 ++++++++++++++++++++++++++++++++++++-----------
 2 files changed, 54 insertions(+), 16 deletions(-)

diff --git a/.claude/CLAUDE.md b/.claude/CLAUDE.md
index bbc5e91..bac7bbc 100644
--- a/.claude/CLAUDE.md
+++ b/.claude/CLAUDE.md
@@ -1,6 +1,14 @@
-# foundary-test-1770625554
+# Foundary
 
-Project deployed to 88tq253n.threesix.ai via threesix.ai platform.
+Product studio for conversational product development. Deployed to 88tq253n.threesix.ai via threesix.ai platform.
+
+## Repository Layout
+
+This is a monorepo:
+
+- `services/` — Backend services
+- `packages/` — Shared libraries and utilities
+- `docs/` — Documentation
 
 ## Quick Start
 
@@ -10,10 +18,10 @@ git clone https://git.threesix.ai/jordan/foundary-test-1770625554.git
 cd foundary-test-1770625554
 
 # Build
-docker build -t foundary-test-1770625554 .
+docker build -t foundary .
 
 # Run
-docker run -p 8080:8080 foundary-test-1770625554
+docker run -p 8080:8080 foundary
 ```
 
 ## Deployment
diff --git a/README.md b/README.md
index 930bec1..9f1da46 100644
--- a/README.md
+++ b/README.md
@@ -1,21 +1,51 @@
-# foundary-test-1770625554
+# Foundary
 
-Deployed at: https://88tq253n.threesix.ai
+A product studio for conversational product development.
+
+Foundary turns natural-language conversations into working software. Describe what you want to build, iterate through dialogue, and ship production-ready products — all driven by conversation.
+
+## How It Works
+
+1. **Converse** — Describe your product idea in plain language.
+2. **Refine** — Iterate on requirements, design, and architecture through back-and-forth dialogue.
+3. **Build** — Foundary generates the code, infrastructure, and deployment configuration.
+4. **Ship** — Push to `main` and your product is live.
+
+## Repository Structure
+
+```
+├── services/       # Backend services
+├── packages/       # Shared libraries and utilities
+├── docs/           # Documentation
+├── Dockerfile      # Container build
+└── .woodpecker.yml # CI/CD pipeline
+```
 
 ## Getting Started
 
-1. Clone the repository
-2. Build with Docker: `docker build -t foundary-test-1770625554 .`
-3. Run locally: `docker run -p 8080:8080 foundary-test-1770625554`
+```bash
+# Clone
+git clone https://git.threesig.ai/jordan/foundary-test-1770625554.git
+cd foundary-test-1770625554
 
-## 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
+```
+
+## Deployment
+
+Pushes to `main` trigger automatic deployment via Woodpecker CI:
+
+1. Build Docker image
+2. Push to registry (`registry.threesix.ai`)
+3. Deploy to Kubernetes
+
+Live at: https://88tq253n.threesix.ai
 
 ## Resources
 
-- Live site: https://88tq253n.threesix.ai
-- Git repository: https://git.threesix.ai/jordan/foundary-test-1770625554.git
+- **Live site**: https://88tq253n.threesix.ai
+- **Repository**: https://git.threesix.ai/jordan/foundary-test-1770625554.git