diff --git a/.gitattributes b/.gitattributes
deleted file mode 100644
index dfe0770..0000000
--- a/.gitattributes
+++ /dev/null
@@ -1,2 +0,0 @@
-# Auto detect text files and perform LF normalization
-* text=auto
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..a41c062
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,30 @@
+# Secrets
+*.key
+*.pem
+*.env
+.env*
+.secrets/
+credentials.txt
+.ssh/
+
+# OS
+Thumbs.db
+.DS_Store
+ConsoleHost_history.txt
+
+# IDE
+.vscode/
+
+# Temporary
+*.log
+*.tmp
+*.bak
+*.old
+
+# Python
+__pycache__/
+*.pyc
+.venv/
+
+# Node
+node_modules/
diff --git a/PROJECTRULES.md b/PROJECTRULES.md
new file mode 100644
index 0000000..3c38fae
--- /dev/null
+++ b/PROJECTRULES.md
@@ -0,0 +1,7 @@
+# Project Rules
+
+1. Never modify production database schemas without migration scripts.
+2. Update documentation when architecture changes.
+3. Follow directory structure strictly.
+4. Do not place business logic in API controllers.
+5. All new features require tests.
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..fb25f43
--- /dev/null
+++ b/README.md
@@ -0,0 +1,29 @@
+Create a root README.md that explains the repo.
+
+Example:
+
+# Project Name
+
+## Purpose
+What the system does.
+
+## Architecture Overview
+High level explanation.
+
+## Repository Structure
+
+repo/
+  docs/
+  src/
+  data/
+  tests/
+  ops/
+
+## Development Workflow
+
+1. Edit docs
+2. Generate code
+3. Run tests
+4. Deploy
+
+This becomes the entry point for AI tools.
diff --git a/VERSION.md b/VERSION.md
new file mode 100644
index 0000000..86ae93f
--- /dev/null
+++ b/VERSION.md
@@ -0,0 +1,3 @@
+v0.x = experimental
+v1.x = stable production
+v2.x = major architecture change
diff --git a/docs/agents.md b/docs/agents.md
new file mode 100644
index 0000000..a45abc2
--- /dev/null
+++ b/docs/agents.md
@@ -0,0 +1 @@
+vision-strategy.md
\ No newline at end of file
diff --git a/docs/api-spec.md b/docs/api-spec.md
new file mode 100644
index 0000000..0a1a961
--- /dev/null
+++ b/docs/api-spec.md
@@ -0,0 +1 @@
+api-spec.md
\ No newline at end of file
diff --git a/docs/architecture.md b/docs/architecture.md
new file mode 100644
index 0000000..3d521ab
--- /dev/null
+++ b/docs/architecture.md
@@ -0,0 +1 @@
+environments.md
\ No newline at end of file
diff --git a/docs/build-plan.md b/docs/build-plan.md
new file mode 100644
index 0000000..0a1a961
--- /dev/null
+++ b/docs/build-plan.md
@@ -0,0 +1 @@
+api-spec.md
\ No newline at end of file
diff --git a/docs/data-model.md b/docs/data-model.md
new file mode 100644
index 0000000..0a1a961
--- /dev/null
+++ b/docs/data-model.md
@@ -0,0 +1 @@
+api-spec.md
\ No newline at end of file
diff --git a/docs/decisions.md b/docs/decisions.md
new file mode 100644
index 0000000..0a1a961
--- /dev/null
+++ b/docs/decisions.md
@@ -0,0 +1 @@
+api-spec.md
\ No newline at end of file
diff --git a/docs/environments.md b/docs/environments.md
new file mode 100644
index 0000000..f718ff7
--- /dev/null
+++ b/docs/environments.md
@@ -0,0 +1 @@
+data-model.md
\ No newline at end of file
diff --git a/docs/system.md b/docs/system.md
new file mode 100644
index 0000000..0a1a961
--- /dev/null
+++ b/docs/system.md
@@ -0,0 +1 @@
+api-spec.md
\ No newline at end of file
diff --git a/docs/user-flows.md b/docs/user-flows.md
new file mode 100644
index 0000000..2143f2f
--- /dev/null
+++ b/docs/user-flows.md
@@ -0,0 +1 @@
+architecture.md
\ No newline at end of file
diff --git a/docs/vision-strategy.md b/docs/vision-strategy.md
new file mode 100644
index 0000000..0658c20
--- /dev/null
+++ b/docs/vision-strategy.md
@@ -0,0 +1 @@
+user-flows.md
\ No newline at end of file