diff --git a/docs/architecture.md b/docs/architecture/architecture.md
similarity index 100%
rename from docs/architecture.md
rename to docs/architecture/architecture.md
diff --git a/docs/diagnostics.md b/docs/architecture/diagnostics.md
similarity index 100%
rename from docs/diagnostics.md
rename to docs/architecture/diagnostics.md
diff --git a/docs/output-schemas.md b/docs/architecture/output-schemas.md
similarity index 100%
rename from docs/output-schemas.md
rename to docs/architecture/output-schemas.md
diff --git a/docs/prompts.md b/docs/architecture/prompts.md
similarity index 100%
rename from docs/prompts.md
rename to docs/architecture/prompts.md
diff --git a/docs/public-contract.md b/docs/architecture/public-contract.md
similarity index 100%
rename from docs/public-contract.md
rename to docs/architecture/public-contract.md
diff --git a/docs/structured-llm.md b/docs/architecture/structured-llm.md
similarity index 100%
rename from docs/structured-llm.md
rename to docs/architecture/structured-llm.md
diff --git a/docs/validators.md b/docs/architecture/validators.md
similarity index 100%
rename from docs/validators.md
rename to docs/architecture/validators.md
diff --git a/docs/subprocess-operations.md b/docs/integration/subprocess-operations.md
similarity index 100%
rename from docs/subprocess-operations.md
rename to docs/integration/subprocess-operations.md