diff --git a/BUILD.md b/docs/BUILD.md
similarity index 100%
rename from BUILD.md
rename to docs/BUILD.md
diff --git a/CHANGELOG.md b/docs/CHANGELOG.md
similarity index 100%
rename from CHANGELOG.md
rename to docs/CHANGELOG.md
diff --git a/build.js b/scripts/build.js
similarity index 100%
rename from build.js
rename to scripts/build.js
diff --git a/publish.js b/scripts/publish.js
similarity index 100%
rename from publish.js
rename to scripts/publish.js
diff --git a/test-phase1.ts b/tests/database-schema.test.ts
similarity index 100%
rename from test-phase1.ts
rename to tests/database-schema.test.ts
diff --git a/test-phase3-integration.ts b/tests/hooks-database-integration.test.ts
similarity index 100%
rename from test-phase3-integration.ts
rename to tests/hooks-database-integration.test.ts
diff --git a/test-phase2.ts b/tests/sdk-prompts-parser.test.ts
similarity index 100%
rename from test-phase2.ts
rename to tests/sdk-prompts-parser.test.ts
diff --git a/test-phase3-e2e.ts b/tests/session-lifecycle.test.ts
similarity index 100%
rename from test-phase3-e2e.ts
rename to tests/session-lifecycle.test.ts