diff --git a/docs/tech-specs/__TEMPLATE.ar.md b/docs/tech-specs/ar/__TEMPLATE.ar.md
similarity index 100%
rename from docs/tech-specs/__TEMPLATE.ar.md
rename to docs/tech-specs/ar/__TEMPLATE.ar.md
diff --git a/docs/tech-specs/agent-explainability.ar.md b/docs/tech-specs/ar/agent-explainability.ar.md
similarity index 100%
rename from docs/tech-specs/agent-explainability.ar.md
rename to docs/tech-specs/ar/agent-explainability.ar.md
diff --git a/docs/tech-specs/architecture-principles.ar.md b/docs/tech-specs/ar/architecture-principles.ar.md
similarity index 100%
rename from docs/tech-specs/architecture-principles.ar.md
rename to docs/tech-specs/ar/architecture-principles.ar.md
diff --git a/docs/tech-specs/cassandra-consolidation.ar.md b/docs/tech-specs/ar/cassandra-consolidation.ar.md
similarity index 100%
rename from docs/tech-specs/cassandra-consolidation.ar.md
rename to docs/tech-specs/ar/cassandra-consolidation.ar.md
diff --git a/docs/tech-specs/cassandra-performance-refactor.ar.md b/docs/tech-specs/ar/cassandra-performance-refactor.ar.md
similarity index 100%
rename from docs/tech-specs/cassandra-performance-refactor.ar.md
rename to docs/tech-specs/ar/cassandra-performance-refactor.ar.md
diff --git a/docs/tech-specs/collection-management.ar.md b/docs/tech-specs/ar/collection-management.ar.md
similarity index 100%
rename from docs/tech-specs/collection-management.ar.md
rename to docs/tech-specs/ar/collection-management.ar.md
diff --git a/docs/tech-specs/document-embeddings-chunk-id.ar.md b/docs/tech-specs/ar/document-embeddings-chunk-id.ar.md
similarity index 100%
rename from docs/tech-specs/document-embeddings-chunk-id.ar.md
rename to docs/tech-specs/ar/document-embeddings-chunk-id.ar.md
diff --git a/docs/tech-specs/embeddings-batch-processing.ar.md b/docs/tech-specs/ar/embeddings-batch-processing.ar.md
similarity index 100%
rename from docs/tech-specs/embeddings-batch-processing.ar.md
rename to docs/tech-specs/ar/embeddings-batch-processing.ar.md
diff --git a/docs/tech-specs/entity-centric-graph.ar.md b/docs/tech-specs/ar/entity-centric-graph.ar.md
similarity index 100%
rename from docs/tech-specs/entity-centric-graph.ar.md
rename to docs/tech-specs/ar/entity-centric-graph.ar.md
diff --git a/docs/tech-specs/explainability-cli.ar.md b/docs/tech-specs/ar/explainability-cli.ar.md
similarity index 100%
rename from docs/tech-specs/explainability-cli.ar.md
rename to docs/tech-specs/ar/explainability-cli.ar.md
diff --git a/docs/tech-specs/extraction-flows.ar.md b/docs/tech-specs/ar/extraction-flows.ar.md
similarity index 100%
rename from docs/tech-specs/extraction-flows.ar.md
rename to docs/tech-specs/ar/extraction-flows.ar.md
diff --git a/docs/tech-specs/extraction-provenance-subgraph.ar.md b/docs/tech-specs/ar/extraction-provenance-subgraph.ar.md
similarity index 100%
rename from docs/tech-specs/extraction-provenance-subgraph.ar.md
rename to docs/tech-specs/ar/extraction-provenance-subgraph.ar.md
diff --git a/docs/tech-specs/extraction-time-provenance.ar.md b/docs/tech-specs/ar/extraction-time-provenance.ar.md
similarity index 100%
rename from docs/tech-specs/extraction-time-provenance.ar.md
rename to docs/tech-specs/ar/extraction-time-provenance.ar.md
diff --git a/docs/tech-specs/flow-class-definition.ar.md b/docs/tech-specs/ar/flow-class-definition.ar.md
similarity index 100%
rename from docs/tech-specs/flow-class-definition.ar.md
rename to docs/tech-specs/ar/flow-class-definition.ar.md
diff --git a/docs/tech-specs/flow-configurable-parameters.ar.md b/docs/tech-specs/ar/flow-configurable-parameters.ar.md
similarity index 100%
rename from docs/tech-specs/flow-configurable-parameters.ar.md
rename to docs/tech-specs/ar/flow-configurable-parameters.ar.md
diff --git a/docs/tech-specs/graph-contexts.ar.md b/docs/tech-specs/ar/graph-contexts.ar.md
similarity index 100%
rename from docs/tech-specs/graph-contexts.ar.md
rename to docs/tech-specs/ar/graph-contexts.ar.md
diff --git a/docs/tech-specs/graphql-query.ar.md b/docs/tech-specs/ar/graphql-query.ar.md
similarity index 100%
rename from docs/tech-specs/graphql-query.ar.md
rename to docs/tech-specs/ar/graphql-query.ar.md
diff --git a/docs/tech-specs/graphrag-performance-optimization.ar.md b/docs/tech-specs/ar/graphrag-performance-optimization.ar.md
similarity index 100%
rename from docs/tech-specs/graphrag-performance-optimization.ar.md
rename to docs/tech-specs/ar/graphrag-performance-optimization.ar.md
diff --git a/docs/tech-specs/import-export-graceful-shutdown.ar.md b/docs/tech-specs/ar/import-export-graceful-shutdown.ar.md
similarity index 100%
rename from docs/tech-specs/import-export-graceful-shutdown.ar.md
rename to docs/tech-specs/ar/import-export-graceful-shutdown.ar.md
diff --git a/docs/tech-specs/jsonl-prompt-output.ar.md b/docs/tech-specs/ar/jsonl-prompt-output.ar.md
similarity index 100%
rename from docs/tech-specs/jsonl-prompt-output.ar.md
rename to docs/tech-specs/ar/jsonl-prompt-output.ar.md
diff --git a/docs/tech-specs/large-document-loading.ar.md b/docs/tech-specs/ar/large-document-loading.ar.md
similarity index 100%
rename from docs/tech-specs/large-document-loading.ar.md
rename to docs/tech-specs/ar/large-document-loading.ar.md
diff --git a/docs/tech-specs/logging-strategy.ar.md b/docs/tech-specs/ar/logging-strategy.ar.md
similarity index 100%
rename from docs/tech-specs/logging-strategy.ar.md
rename to docs/tech-specs/ar/logging-strategy.ar.md
diff --git a/docs/tech-specs/mcp-tool-arguments.ar.md b/docs/tech-specs/ar/mcp-tool-arguments.ar.md
similarity index 100%
rename from docs/tech-specs/mcp-tool-arguments.ar.md
rename to docs/tech-specs/ar/mcp-tool-arguments.ar.md
diff --git a/docs/tech-specs/mcp-tool-bearer-token.ar.md b/docs/tech-specs/ar/mcp-tool-bearer-token.ar.md
similarity index 100%
rename from docs/tech-specs/mcp-tool-bearer-token.ar.md
rename to docs/tech-specs/ar/mcp-tool-bearer-token.ar.md
diff --git a/docs/tech-specs/minio-to-s3-migration.ar.md b/docs/tech-specs/ar/minio-to-s3-migration.ar.md
similarity index 100%
rename from docs/tech-specs/minio-to-s3-migration.ar.md
rename to docs/tech-specs/ar/minio-to-s3-migration.ar.md
diff --git a/docs/tech-specs/more-config-cli.ar.md b/docs/tech-specs/ar/more-config-cli.ar.md
similarity index 100%
rename from docs/tech-specs/more-config-cli.ar.md
rename to docs/tech-specs/ar/more-config-cli.ar.md
diff --git a/docs/tech-specs/multi-tenant-support.ar.md b/docs/tech-specs/ar/multi-tenant-support.ar.md
similarity index 100%
rename from docs/tech-specs/multi-tenant-support.ar.md
rename to docs/tech-specs/ar/multi-tenant-support.ar.md
diff --git a/docs/tech-specs/neo4j-user-collection-isolation.ar.md b/docs/tech-specs/ar/neo4j-user-collection-isolation.ar.md
similarity index 100%
rename from docs/tech-specs/neo4j-user-collection-isolation.ar.md
rename to docs/tech-specs/ar/neo4j-user-collection-isolation.ar.md
diff --git a/docs/tech-specs/ontology-extract-phase-2.ar.md b/docs/tech-specs/ar/ontology-extract-phase-2.ar.md
similarity index 100%
rename from docs/tech-specs/ontology-extract-phase-2.ar.md
rename to docs/tech-specs/ar/ontology-extract-phase-2.ar.md
diff --git a/docs/tech-specs/ontology.ar.md b/docs/tech-specs/ar/ontology.ar.md
similarity index 100%
rename from docs/tech-specs/ontology.ar.md
rename to docs/tech-specs/ar/ontology.ar.md
diff --git a/docs/tech-specs/ontorag.ar.md b/docs/tech-specs/ar/ontorag.ar.md
similarity index 100%
rename from docs/tech-specs/ontorag.ar.md
rename to docs/tech-specs/ar/ontorag.ar.md
diff --git a/docs/tech-specs/openapi-spec.ar.md b/docs/tech-specs/ar/openapi-spec.ar.md
similarity index 100%
rename from docs/tech-specs/openapi-spec.ar.md
rename to docs/tech-specs/ar/openapi-spec.ar.md
diff --git a/docs/tech-specs/pubsub.ar.md b/docs/tech-specs/ar/pubsub.ar.md
similarity index 100%
rename from docs/tech-specs/pubsub.ar.md
rename to docs/tech-specs/ar/pubsub.ar.md
diff --git a/docs/tech-specs/python-api-refactor.ar.md b/docs/tech-specs/ar/python-api-refactor.ar.md
similarity index 100%
rename from docs/tech-specs/python-api-refactor.ar.md
rename to docs/tech-specs/ar/python-api-refactor.ar.md
diff --git a/docs/tech-specs/query-time-explainability.ar.md b/docs/tech-specs/ar/query-time-explainability.ar.md
similarity index 100%
rename from docs/tech-specs/query-time-explainability.ar.md
rename to docs/tech-specs/ar/query-time-explainability.ar.md
diff --git a/docs/tech-specs/rag-streaming-support.ar.md b/docs/tech-specs/ar/rag-streaming-support.ar.md
similarity index 100%
rename from docs/tech-specs/rag-streaming-support.ar.md
rename to docs/tech-specs/ar/rag-streaming-support.ar.md
diff --git a/docs/tech-specs/schema-refactoring-proposal.ar.md b/docs/tech-specs/ar/schema-refactoring-proposal.ar.md
similarity index 100%
rename from docs/tech-specs/schema-refactoring-proposal.ar.md
rename to docs/tech-specs/ar/schema-refactoring-proposal.ar.md
diff --git a/docs/tech-specs/streaming-llm-responses.ar.md b/docs/tech-specs/ar/streaming-llm-responses.ar.md
similarity index 100%
rename from docs/tech-specs/streaming-llm-responses.ar.md
rename to docs/tech-specs/ar/streaming-llm-responses.ar.md
diff --git a/docs/tech-specs/structured-data-2.ar.md b/docs/tech-specs/ar/structured-data-2.ar.md
similarity index 100%
rename from docs/tech-specs/structured-data-2.ar.md
rename to docs/tech-specs/ar/structured-data-2.ar.md
diff --git a/docs/tech-specs/structured-data-descriptor.ar.md b/docs/tech-specs/ar/structured-data-descriptor.ar.md
similarity index 100%
rename from docs/tech-specs/structured-data-descriptor.ar.md
rename to docs/tech-specs/ar/structured-data-descriptor.ar.md
diff --git a/docs/tech-specs/structured-data-schemas.ar.md b/docs/tech-specs/ar/structured-data-schemas.ar.md
similarity index 100%
rename from docs/tech-specs/structured-data-schemas.ar.md
rename to docs/tech-specs/ar/structured-data-schemas.ar.md
diff --git a/docs/tech-specs/structured-data.ar.md b/docs/tech-specs/ar/structured-data.ar.md
similarity index 100%
rename from docs/tech-specs/structured-data.ar.md
rename to docs/tech-specs/ar/structured-data.ar.md
diff --git a/docs/tech-specs/structured-diag-service.ar.md b/docs/tech-specs/ar/structured-diag-service.ar.md
similarity index 100%
rename from docs/tech-specs/structured-diag-service.ar.md
rename to docs/tech-specs/ar/structured-diag-service.ar.md
diff --git a/docs/tech-specs/tool-group.ar.md b/docs/tech-specs/ar/tool-group.ar.md
similarity index 100%
rename from docs/tech-specs/tool-group.ar.md
rename to docs/tech-specs/ar/tool-group.ar.md
diff --git a/docs/tech-specs/tool-services.ar.md b/docs/tech-specs/ar/tool-services.ar.md
similarity index 100%
rename from docs/tech-specs/tool-services.ar.md
rename to docs/tech-specs/ar/tool-services.ar.md
diff --git a/docs/tech-specs/universal-decoder.ar.md b/docs/tech-specs/ar/universal-decoder.ar.md
similarity index 100%
rename from docs/tech-specs/universal-decoder.ar.md
rename to docs/tech-specs/ar/universal-decoder.ar.md
diff --git a/docs/tech-specs/vector-store-lifecycle.ar.md b/docs/tech-specs/ar/vector-store-lifecycle.ar.md
similarity index 100%
rename from docs/tech-specs/vector-store-lifecycle.ar.md
rename to docs/tech-specs/ar/vector-store-lifecycle.ar.md
diff --git a/docs/tech-specs/__TEMPLATE.es.md b/docs/tech-specs/es/__TEMPLATE.es.md
similarity index 100%
rename from docs/tech-specs/__TEMPLATE.es.md
rename to docs/tech-specs/es/__TEMPLATE.es.md
diff --git a/docs/tech-specs/agent-explainability.es.md b/docs/tech-specs/es/agent-explainability.es.md
similarity index 100%
rename from docs/tech-specs/agent-explainability.es.md
rename to docs/tech-specs/es/agent-explainability.es.md
diff --git a/docs/tech-specs/architecture-principles.es.md b/docs/tech-specs/es/architecture-principles.es.md
similarity index 100%
rename from docs/tech-specs/architecture-principles.es.md
rename to docs/tech-specs/es/architecture-principles.es.md
diff --git a/docs/tech-specs/cassandra-consolidation.es.md b/docs/tech-specs/es/cassandra-consolidation.es.md
similarity index 100%
rename from docs/tech-specs/cassandra-consolidation.es.md
rename to docs/tech-specs/es/cassandra-consolidation.es.md
diff --git a/docs/tech-specs/cassandra-performance-refactor.es.md b/docs/tech-specs/es/cassandra-performance-refactor.es.md
similarity index 100%
rename from docs/tech-specs/cassandra-performance-refactor.es.md
rename to docs/tech-specs/es/cassandra-performance-refactor.es.md
diff --git a/docs/tech-specs/collection-management.es.md b/docs/tech-specs/es/collection-management.es.md
similarity index 100%
rename from docs/tech-specs/collection-management.es.md
rename to docs/tech-specs/es/collection-management.es.md
diff --git a/docs/tech-specs/document-embeddings-chunk-id.es.md b/docs/tech-specs/es/document-embeddings-chunk-id.es.md
similarity index 100%
rename from docs/tech-specs/document-embeddings-chunk-id.es.md
rename to docs/tech-specs/es/document-embeddings-chunk-id.es.md
diff --git a/docs/tech-specs/embeddings-batch-processing.es.md b/docs/tech-specs/es/embeddings-batch-processing.es.md
similarity index 100%
rename from docs/tech-specs/embeddings-batch-processing.es.md
rename to docs/tech-specs/es/embeddings-batch-processing.es.md
diff --git a/docs/tech-specs/entity-centric-graph.es.md b/docs/tech-specs/es/entity-centric-graph.es.md
similarity index 100%
rename from docs/tech-specs/entity-centric-graph.es.md
rename to docs/tech-specs/es/entity-centric-graph.es.md
diff --git a/docs/tech-specs/explainability-cli.es.md b/docs/tech-specs/es/explainability-cli.es.md
similarity index 100%
rename from docs/tech-specs/explainability-cli.es.md
rename to docs/tech-specs/es/explainability-cli.es.md
diff --git a/docs/tech-specs/extraction-flows.es.md b/docs/tech-specs/es/extraction-flows.es.md
similarity index 100%
rename from docs/tech-specs/extraction-flows.es.md
rename to docs/tech-specs/es/extraction-flows.es.md
diff --git a/docs/tech-specs/extraction-provenance-subgraph.es.md b/docs/tech-specs/es/extraction-provenance-subgraph.es.md
similarity index 100%
rename from docs/tech-specs/extraction-provenance-subgraph.es.md
rename to docs/tech-specs/es/extraction-provenance-subgraph.es.md
diff --git a/docs/tech-specs/extraction-time-provenance.es.md b/docs/tech-specs/es/extraction-time-provenance.es.md
similarity index 100%
rename from docs/tech-specs/extraction-time-provenance.es.md
rename to docs/tech-specs/es/extraction-time-provenance.es.md
diff --git a/docs/tech-specs/flow-class-definition.es.md b/docs/tech-specs/es/flow-class-definition.es.md
similarity index 100%
rename from docs/tech-specs/flow-class-definition.es.md
rename to docs/tech-specs/es/flow-class-definition.es.md
diff --git a/docs/tech-specs/flow-configurable-parameters.es.md b/docs/tech-specs/es/flow-configurable-parameters.es.md
similarity index 100%
rename from docs/tech-specs/flow-configurable-parameters.es.md
rename to docs/tech-specs/es/flow-configurable-parameters.es.md
diff --git a/docs/tech-specs/graph-contexts.es.md b/docs/tech-specs/es/graph-contexts.es.md
similarity index 100%
rename from docs/tech-specs/graph-contexts.es.md
rename to docs/tech-specs/es/graph-contexts.es.md
diff --git a/docs/tech-specs/graphql-query.es.md b/docs/tech-specs/es/graphql-query.es.md
similarity index 100%
rename from docs/tech-specs/graphql-query.es.md
rename to docs/tech-specs/es/graphql-query.es.md
diff --git a/docs/tech-specs/graphrag-performance-optimization.es.md b/docs/tech-specs/es/graphrag-performance-optimization.es.md
similarity index 100%
rename from docs/tech-specs/graphrag-performance-optimization.es.md
rename to docs/tech-specs/es/graphrag-performance-optimization.es.md
diff --git a/docs/tech-specs/import-export-graceful-shutdown.es.md b/docs/tech-specs/es/import-export-graceful-shutdown.es.md
similarity index 100%
rename from docs/tech-specs/import-export-graceful-shutdown.es.md
rename to docs/tech-specs/es/import-export-graceful-shutdown.es.md
diff --git a/docs/tech-specs/jsonl-prompt-output.es.md b/docs/tech-specs/es/jsonl-prompt-output.es.md
similarity index 100%
rename from docs/tech-specs/jsonl-prompt-output.es.md
rename to docs/tech-specs/es/jsonl-prompt-output.es.md
diff --git a/docs/tech-specs/large-document-loading.es.md b/docs/tech-specs/es/large-document-loading.es.md
similarity index 100%
rename from docs/tech-specs/large-document-loading.es.md
rename to docs/tech-specs/es/large-document-loading.es.md
diff --git a/docs/tech-specs/logging-strategy.es.md b/docs/tech-specs/es/logging-strategy.es.md
similarity index 100%
rename from docs/tech-specs/logging-strategy.es.md
rename to docs/tech-specs/es/logging-strategy.es.md
diff --git a/docs/tech-specs/mcp-tool-arguments.es.md b/docs/tech-specs/es/mcp-tool-arguments.es.md
similarity index 100%
rename from docs/tech-specs/mcp-tool-arguments.es.md
rename to docs/tech-specs/es/mcp-tool-arguments.es.md
diff --git a/docs/tech-specs/mcp-tool-bearer-token.es.md b/docs/tech-specs/es/mcp-tool-bearer-token.es.md
similarity index 100%
rename from docs/tech-specs/mcp-tool-bearer-token.es.md
rename to docs/tech-specs/es/mcp-tool-bearer-token.es.md
diff --git a/docs/tech-specs/minio-to-s3-migration.es.md b/docs/tech-specs/es/minio-to-s3-migration.es.md
similarity index 100%
rename from docs/tech-specs/minio-to-s3-migration.es.md
rename to docs/tech-specs/es/minio-to-s3-migration.es.md
diff --git a/docs/tech-specs/more-config-cli.es.md b/docs/tech-specs/es/more-config-cli.es.md
similarity index 100%
rename from docs/tech-specs/more-config-cli.es.md
rename to docs/tech-specs/es/more-config-cli.es.md
diff --git a/docs/tech-specs/multi-tenant-support.es.md b/docs/tech-specs/es/multi-tenant-support.es.md
similarity index 100%
rename from docs/tech-specs/multi-tenant-support.es.md
rename to docs/tech-specs/es/multi-tenant-support.es.md
diff --git a/docs/tech-specs/neo4j-user-collection-isolation.es.md b/docs/tech-specs/es/neo4j-user-collection-isolation.es.md
similarity index 100%
rename from docs/tech-specs/neo4j-user-collection-isolation.es.md
rename to docs/tech-specs/es/neo4j-user-collection-isolation.es.md
diff --git a/docs/tech-specs/ontology-extract-phase-2.es.md b/docs/tech-specs/es/ontology-extract-phase-2.es.md
similarity index 100%
rename from docs/tech-specs/ontology-extract-phase-2.es.md
rename to docs/tech-specs/es/ontology-extract-phase-2.es.md
diff --git a/docs/tech-specs/ontology.es.md b/docs/tech-specs/es/ontology.es.md
similarity index 100%
rename from docs/tech-specs/ontology.es.md
rename to docs/tech-specs/es/ontology.es.md
diff --git a/docs/tech-specs/ontorag.es.md b/docs/tech-specs/es/ontorag.es.md
similarity index 100%
rename from docs/tech-specs/ontorag.es.md
rename to docs/tech-specs/es/ontorag.es.md
diff --git a/docs/tech-specs/openapi-spec.es.md b/docs/tech-specs/es/openapi-spec.es.md
similarity index 100%
rename from docs/tech-specs/openapi-spec.es.md
rename to docs/tech-specs/es/openapi-spec.es.md
diff --git a/docs/tech-specs/pubsub.es.md b/docs/tech-specs/es/pubsub.es.md
similarity index 100%
rename from docs/tech-specs/pubsub.es.md
rename to docs/tech-specs/es/pubsub.es.md
diff --git a/docs/tech-specs/python-api-refactor.es.md b/docs/tech-specs/es/python-api-refactor.es.md
similarity index 100%
rename from docs/tech-specs/python-api-refactor.es.md
rename to docs/tech-specs/es/python-api-refactor.es.md
diff --git a/docs/tech-specs/query-time-explainability.es.md b/docs/tech-specs/es/query-time-explainability.es.md
similarity index 100%
rename from docs/tech-specs/query-time-explainability.es.md
rename to docs/tech-specs/es/query-time-explainability.es.md
diff --git a/docs/tech-specs/rag-streaming-support.es.md b/docs/tech-specs/es/rag-streaming-support.es.md
similarity index 100%
rename from docs/tech-specs/rag-streaming-support.es.md
rename to docs/tech-specs/es/rag-streaming-support.es.md
diff --git a/docs/tech-specs/schema-refactoring-proposal.es.md b/docs/tech-specs/es/schema-refactoring-proposal.es.md
similarity index 100%
rename from docs/tech-specs/schema-refactoring-proposal.es.md
rename to docs/tech-specs/es/schema-refactoring-proposal.es.md
diff --git a/docs/tech-specs/streaming-llm-responses.es.md b/docs/tech-specs/es/streaming-llm-responses.es.md
similarity index 100%
rename from docs/tech-specs/streaming-llm-responses.es.md
rename to docs/tech-specs/es/streaming-llm-responses.es.md
diff --git a/docs/tech-specs/structured-data-2.es.md b/docs/tech-specs/es/structured-data-2.es.md
similarity index 100%
rename from docs/tech-specs/structured-data-2.es.md
rename to docs/tech-specs/es/structured-data-2.es.md
diff --git a/docs/tech-specs/structured-data-descriptor.es.md b/docs/tech-specs/es/structured-data-descriptor.es.md
similarity index 100%
rename from docs/tech-specs/structured-data-descriptor.es.md
rename to docs/tech-specs/es/structured-data-descriptor.es.md
diff --git a/docs/tech-specs/structured-data-schemas.es.md b/docs/tech-specs/es/structured-data-schemas.es.md
similarity index 100%
rename from docs/tech-specs/structured-data-schemas.es.md
rename to docs/tech-specs/es/structured-data-schemas.es.md
diff --git a/docs/tech-specs/structured-data.es.md b/docs/tech-specs/es/structured-data.es.md
similarity index 100%
rename from docs/tech-specs/structured-data.es.md
rename to docs/tech-specs/es/structured-data.es.md
diff --git a/docs/tech-specs/structured-diag-service.es.md b/docs/tech-specs/es/structured-diag-service.es.md
similarity index 100%
rename from docs/tech-specs/structured-diag-service.es.md
rename to docs/tech-specs/es/structured-diag-service.es.md
diff --git a/docs/tech-specs/tool-group.es.md b/docs/tech-specs/es/tool-group.es.md
similarity index 100%
rename from docs/tech-specs/tool-group.es.md
rename to docs/tech-specs/es/tool-group.es.md
diff --git a/docs/tech-specs/tool-services.es.md b/docs/tech-specs/es/tool-services.es.md
similarity index 100%
rename from docs/tech-specs/tool-services.es.md
rename to docs/tech-specs/es/tool-services.es.md
diff --git a/docs/tech-specs/universal-decoder.es.md b/docs/tech-specs/es/universal-decoder.es.md
similarity index 100%
rename from docs/tech-specs/universal-decoder.es.md
rename to docs/tech-specs/es/universal-decoder.es.md
diff --git a/docs/tech-specs/vector-store-lifecycle.es.md b/docs/tech-specs/es/vector-store-lifecycle.es.md
similarity index 100%
rename from docs/tech-specs/vector-store-lifecycle.es.md
rename to docs/tech-specs/es/vector-store-lifecycle.es.md
diff --git a/docs/tech-specs/__TEMPLATE.he.md b/docs/tech-specs/he/__TEMPLATE.he.md
similarity index 100%
rename from docs/tech-specs/__TEMPLATE.he.md
rename to docs/tech-specs/he/__TEMPLATE.he.md
diff --git a/docs/tech-specs/agent-explainability.he.md b/docs/tech-specs/he/agent-explainability.he.md
similarity index 100%
rename from docs/tech-specs/agent-explainability.he.md
rename to docs/tech-specs/he/agent-explainability.he.md
diff --git a/docs/tech-specs/architecture-principles.he.md b/docs/tech-specs/he/architecture-principles.he.md
similarity index 100%
rename from docs/tech-specs/architecture-principles.he.md
rename to docs/tech-specs/he/architecture-principles.he.md
diff --git a/docs/tech-specs/cassandra-consolidation.he.md b/docs/tech-specs/he/cassandra-consolidation.he.md
similarity index 100%
rename from docs/tech-specs/cassandra-consolidation.he.md
rename to docs/tech-specs/he/cassandra-consolidation.he.md
diff --git a/docs/tech-specs/cassandra-performance-refactor.he.md b/docs/tech-specs/he/cassandra-performance-refactor.he.md
similarity index 100%
rename from docs/tech-specs/cassandra-performance-refactor.he.md
rename to docs/tech-specs/he/cassandra-performance-refactor.he.md
diff --git a/docs/tech-specs/collection-management.he.md b/docs/tech-specs/he/collection-management.he.md
similarity index 100%
rename from docs/tech-specs/collection-management.he.md
rename to docs/tech-specs/he/collection-management.he.md
diff --git a/docs/tech-specs/document-embeddings-chunk-id.he.md b/docs/tech-specs/he/document-embeddings-chunk-id.he.md
similarity index 100%
rename from docs/tech-specs/document-embeddings-chunk-id.he.md
rename to docs/tech-specs/he/document-embeddings-chunk-id.he.md
diff --git a/docs/tech-specs/embeddings-batch-processing.he.md b/docs/tech-specs/he/embeddings-batch-processing.he.md
similarity index 100%
rename from docs/tech-specs/embeddings-batch-processing.he.md
rename to docs/tech-specs/he/embeddings-batch-processing.he.md
diff --git a/docs/tech-specs/entity-centric-graph.he.md b/docs/tech-specs/he/entity-centric-graph.he.md
similarity index 100%
rename from docs/tech-specs/entity-centric-graph.he.md
rename to docs/tech-specs/he/entity-centric-graph.he.md
diff --git a/docs/tech-specs/explainability-cli.he.md b/docs/tech-specs/he/explainability-cli.he.md
similarity index 100%
rename from docs/tech-specs/explainability-cli.he.md
rename to docs/tech-specs/he/explainability-cli.he.md
diff --git a/docs/tech-specs/extraction-flows.he.md b/docs/tech-specs/he/extraction-flows.he.md
similarity index 100%
rename from docs/tech-specs/extraction-flows.he.md
rename to docs/tech-specs/he/extraction-flows.he.md
diff --git a/docs/tech-specs/extraction-provenance-subgraph.he.md b/docs/tech-specs/he/extraction-provenance-subgraph.he.md
similarity index 100%
rename from docs/tech-specs/extraction-provenance-subgraph.he.md
rename to docs/tech-specs/he/extraction-provenance-subgraph.he.md
diff --git a/docs/tech-specs/extraction-time-provenance.he.md b/docs/tech-specs/he/extraction-time-provenance.he.md
similarity index 100%
rename from docs/tech-specs/extraction-time-provenance.he.md
rename to docs/tech-specs/he/extraction-time-provenance.he.md
diff --git a/docs/tech-specs/flow-class-definition.he.md b/docs/tech-specs/he/flow-class-definition.he.md
similarity index 100%
rename from docs/tech-specs/flow-class-definition.he.md
rename to docs/tech-specs/he/flow-class-definition.he.md
diff --git a/docs/tech-specs/flow-configurable-parameters.he.md b/docs/tech-specs/he/flow-configurable-parameters.he.md
similarity index 100%
rename from docs/tech-specs/flow-configurable-parameters.he.md
rename to docs/tech-specs/he/flow-configurable-parameters.he.md
diff --git a/docs/tech-specs/graph-contexts.he.md b/docs/tech-specs/he/graph-contexts.he.md
similarity index 100%
rename from docs/tech-specs/graph-contexts.he.md
rename to docs/tech-specs/he/graph-contexts.he.md
diff --git a/docs/tech-specs/graphql-query.he.md b/docs/tech-specs/he/graphql-query.he.md
similarity index 100%
rename from docs/tech-specs/graphql-query.he.md
rename to docs/tech-specs/he/graphql-query.he.md
diff --git a/docs/tech-specs/graphrag-performance-optimization.he.md b/docs/tech-specs/he/graphrag-performance-optimization.he.md
similarity index 100%
rename from docs/tech-specs/graphrag-performance-optimization.he.md
rename to docs/tech-specs/he/graphrag-performance-optimization.he.md
diff --git a/docs/tech-specs/import-export-graceful-shutdown.he.md b/docs/tech-specs/he/import-export-graceful-shutdown.he.md
similarity index 100%
rename from docs/tech-specs/import-export-graceful-shutdown.he.md
rename to docs/tech-specs/he/import-export-graceful-shutdown.he.md
diff --git a/docs/tech-specs/jsonl-prompt-output.he.md b/docs/tech-specs/he/jsonl-prompt-output.he.md
similarity index 100%
rename from docs/tech-specs/jsonl-prompt-output.he.md
rename to docs/tech-specs/he/jsonl-prompt-output.he.md
diff --git a/docs/tech-specs/large-document-loading.he.md b/docs/tech-specs/he/large-document-loading.he.md
similarity index 100%
rename from docs/tech-specs/large-document-loading.he.md
rename to docs/tech-specs/he/large-document-loading.he.md
diff --git a/docs/tech-specs/logging-strategy.he.md b/docs/tech-specs/he/logging-strategy.he.md
similarity index 100%
rename from docs/tech-specs/logging-strategy.he.md
rename to docs/tech-specs/he/logging-strategy.he.md
diff --git a/docs/tech-specs/mcp-tool-arguments.he.md b/docs/tech-specs/he/mcp-tool-arguments.he.md
similarity index 100%
rename from docs/tech-specs/mcp-tool-arguments.he.md
rename to docs/tech-specs/he/mcp-tool-arguments.he.md
diff --git a/docs/tech-specs/mcp-tool-bearer-token.he.md b/docs/tech-specs/he/mcp-tool-bearer-token.he.md
similarity index 100%
rename from docs/tech-specs/mcp-tool-bearer-token.he.md
rename to docs/tech-specs/he/mcp-tool-bearer-token.he.md
diff --git a/docs/tech-specs/minio-to-s3-migration.he.md b/docs/tech-specs/he/minio-to-s3-migration.he.md
similarity index 100%
rename from docs/tech-specs/minio-to-s3-migration.he.md
rename to docs/tech-specs/he/minio-to-s3-migration.he.md
diff --git a/docs/tech-specs/more-config-cli.he.md b/docs/tech-specs/he/more-config-cli.he.md
similarity index 100%
rename from docs/tech-specs/more-config-cli.he.md
rename to docs/tech-specs/he/more-config-cli.he.md
diff --git a/docs/tech-specs/multi-tenant-support.he.md b/docs/tech-specs/he/multi-tenant-support.he.md
similarity index 100%
rename from docs/tech-specs/multi-tenant-support.he.md
rename to docs/tech-specs/he/multi-tenant-support.he.md
diff --git a/docs/tech-specs/neo4j-user-collection-isolation.he.md b/docs/tech-specs/he/neo4j-user-collection-isolation.he.md
similarity index 100%
rename from docs/tech-specs/neo4j-user-collection-isolation.he.md
rename to docs/tech-specs/he/neo4j-user-collection-isolation.he.md
diff --git a/docs/tech-specs/ontology-extract-phase-2.he.md b/docs/tech-specs/he/ontology-extract-phase-2.he.md
similarity index 100%
rename from docs/tech-specs/ontology-extract-phase-2.he.md
rename to docs/tech-specs/he/ontology-extract-phase-2.he.md
diff --git a/docs/tech-specs/ontology.he.md b/docs/tech-specs/he/ontology.he.md
similarity index 100%
rename from docs/tech-specs/ontology.he.md
rename to docs/tech-specs/he/ontology.he.md
diff --git a/docs/tech-specs/ontorag.he.md b/docs/tech-specs/he/ontorag.he.md
similarity index 100%
rename from docs/tech-specs/ontorag.he.md
rename to docs/tech-specs/he/ontorag.he.md
diff --git a/docs/tech-specs/openapi-spec.he.md b/docs/tech-specs/he/openapi-spec.he.md
similarity index 100%
rename from docs/tech-specs/openapi-spec.he.md
rename to docs/tech-specs/he/openapi-spec.he.md
diff --git a/docs/tech-specs/pubsub.he.md b/docs/tech-specs/he/pubsub.he.md
similarity index 100%
rename from docs/tech-specs/pubsub.he.md
rename to docs/tech-specs/he/pubsub.he.md
diff --git a/docs/tech-specs/python-api-refactor.he.md b/docs/tech-specs/he/python-api-refactor.he.md
similarity index 100%
rename from docs/tech-specs/python-api-refactor.he.md
rename to docs/tech-specs/he/python-api-refactor.he.md
diff --git a/docs/tech-specs/query-time-explainability.he.md b/docs/tech-specs/he/query-time-explainability.he.md
similarity index 100%
rename from docs/tech-specs/query-time-explainability.he.md
rename to docs/tech-specs/he/query-time-explainability.he.md
diff --git a/docs/tech-specs/rag-streaming-support.he.md b/docs/tech-specs/he/rag-streaming-support.he.md
similarity index 100%
rename from docs/tech-specs/rag-streaming-support.he.md
rename to docs/tech-specs/he/rag-streaming-support.he.md
diff --git a/docs/tech-specs/schema-refactoring-proposal.he.md b/docs/tech-specs/he/schema-refactoring-proposal.he.md
similarity index 100%
rename from docs/tech-specs/schema-refactoring-proposal.he.md
rename to docs/tech-specs/he/schema-refactoring-proposal.he.md
diff --git a/docs/tech-specs/streaming-llm-responses.he.md b/docs/tech-specs/he/streaming-llm-responses.he.md
similarity index 100%
rename from docs/tech-specs/streaming-llm-responses.he.md
rename to docs/tech-specs/he/streaming-llm-responses.he.md
diff --git a/docs/tech-specs/structured-data-2.he.md b/docs/tech-specs/he/structured-data-2.he.md
similarity index 100%
rename from docs/tech-specs/structured-data-2.he.md
rename to docs/tech-specs/he/structured-data-2.he.md
diff --git a/docs/tech-specs/structured-data-descriptor.he.md b/docs/tech-specs/he/structured-data-descriptor.he.md
similarity index 100%
rename from docs/tech-specs/structured-data-descriptor.he.md
rename to docs/tech-specs/he/structured-data-descriptor.he.md
diff --git a/docs/tech-specs/structured-data-schemas.he.md b/docs/tech-specs/he/structured-data-schemas.he.md
similarity index 100%
rename from docs/tech-specs/structured-data-schemas.he.md
rename to docs/tech-specs/he/structured-data-schemas.he.md
diff --git a/docs/tech-specs/structured-data.he.md b/docs/tech-specs/he/structured-data.he.md
similarity index 100%
rename from docs/tech-specs/structured-data.he.md
rename to docs/tech-specs/he/structured-data.he.md
diff --git a/docs/tech-specs/structured-diag-service.he.md b/docs/tech-specs/he/structured-diag-service.he.md
similarity index 100%
rename from docs/tech-specs/structured-diag-service.he.md
rename to docs/tech-specs/he/structured-diag-service.he.md
diff --git a/docs/tech-specs/tool-group.he.md b/docs/tech-specs/he/tool-group.he.md
similarity index 100%
rename from docs/tech-specs/tool-group.he.md
rename to docs/tech-specs/he/tool-group.he.md
diff --git a/docs/tech-specs/tool-services.he.md b/docs/tech-specs/he/tool-services.he.md
similarity index 100%
rename from docs/tech-specs/tool-services.he.md
rename to docs/tech-specs/he/tool-services.he.md
diff --git a/docs/tech-specs/universal-decoder.he.md b/docs/tech-specs/he/universal-decoder.he.md
similarity index 100%
rename from docs/tech-specs/universal-decoder.he.md
rename to docs/tech-specs/he/universal-decoder.he.md
diff --git a/docs/tech-specs/vector-store-lifecycle.he.md b/docs/tech-specs/he/vector-store-lifecycle.he.md
similarity index 100%
rename from docs/tech-specs/vector-store-lifecycle.he.md
rename to docs/tech-specs/he/vector-store-lifecycle.he.md
diff --git a/docs/tech-specs/__TEMPLATE.hi.md b/docs/tech-specs/hi/__TEMPLATE.hi.md
similarity index 100%
rename from docs/tech-specs/__TEMPLATE.hi.md
rename to docs/tech-specs/hi/__TEMPLATE.hi.md
diff --git a/docs/tech-specs/agent-explainability.hi.md b/docs/tech-specs/hi/agent-explainability.hi.md
similarity index 100%
rename from docs/tech-specs/agent-explainability.hi.md
rename to docs/tech-specs/hi/agent-explainability.hi.md
diff --git a/docs/tech-specs/architecture-principles.hi.md b/docs/tech-specs/hi/architecture-principles.hi.md
similarity index 100%
rename from docs/tech-specs/architecture-principles.hi.md
rename to docs/tech-specs/hi/architecture-principles.hi.md
diff --git a/docs/tech-specs/cassandra-consolidation.hi.md b/docs/tech-specs/hi/cassandra-consolidation.hi.md
similarity index 100%
rename from docs/tech-specs/cassandra-consolidation.hi.md
rename to docs/tech-specs/hi/cassandra-consolidation.hi.md
diff --git a/docs/tech-specs/cassandra-performance-refactor.hi.md b/docs/tech-specs/hi/cassandra-performance-refactor.hi.md
similarity index 100%
rename from docs/tech-specs/cassandra-performance-refactor.hi.md
rename to docs/tech-specs/hi/cassandra-performance-refactor.hi.md
diff --git a/docs/tech-specs/collection-management.hi.md b/docs/tech-specs/hi/collection-management.hi.md
similarity index 100%
rename from docs/tech-specs/collection-management.hi.md
rename to docs/tech-specs/hi/collection-management.hi.md
diff --git a/docs/tech-specs/document-embeddings-chunk-id.hi.md b/docs/tech-specs/hi/document-embeddings-chunk-id.hi.md
similarity index 100%
rename from docs/tech-specs/document-embeddings-chunk-id.hi.md
rename to docs/tech-specs/hi/document-embeddings-chunk-id.hi.md
diff --git a/docs/tech-specs/embeddings-batch-processing.hi.md b/docs/tech-specs/hi/embeddings-batch-processing.hi.md
similarity index 100%
rename from docs/tech-specs/embeddings-batch-processing.hi.md
rename to docs/tech-specs/hi/embeddings-batch-processing.hi.md
diff --git a/docs/tech-specs/entity-centric-graph.hi.md b/docs/tech-specs/hi/entity-centric-graph.hi.md
similarity index 100%
rename from docs/tech-specs/entity-centric-graph.hi.md
rename to docs/tech-specs/hi/entity-centric-graph.hi.md
diff --git a/docs/tech-specs/explainability-cli.hi.md b/docs/tech-specs/hi/explainability-cli.hi.md
similarity index 100%
rename from docs/tech-specs/explainability-cli.hi.md
rename to docs/tech-specs/hi/explainability-cli.hi.md
diff --git a/docs/tech-specs/extraction-flows.hi.md b/docs/tech-specs/hi/extraction-flows.hi.md
similarity index 100%
rename from docs/tech-specs/extraction-flows.hi.md
rename to docs/tech-specs/hi/extraction-flows.hi.md
diff --git a/docs/tech-specs/extraction-provenance-subgraph.hi.md b/docs/tech-specs/hi/extraction-provenance-subgraph.hi.md
similarity index 100%
rename from docs/tech-specs/extraction-provenance-subgraph.hi.md
rename to docs/tech-specs/hi/extraction-provenance-subgraph.hi.md
diff --git a/docs/tech-specs/extraction-time-provenance.hi.md b/docs/tech-specs/hi/extraction-time-provenance.hi.md
similarity index 100%
rename from docs/tech-specs/extraction-time-provenance.hi.md
rename to docs/tech-specs/hi/extraction-time-provenance.hi.md
diff --git a/docs/tech-specs/flow-class-definition.hi.md b/docs/tech-specs/hi/flow-class-definition.hi.md
similarity index 100%
rename from docs/tech-specs/flow-class-definition.hi.md
rename to docs/tech-specs/hi/flow-class-definition.hi.md
diff --git a/docs/tech-specs/flow-configurable-parameters.hi.md b/docs/tech-specs/hi/flow-configurable-parameters.hi.md
similarity index 100%
rename from docs/tech-specs/flow-configurable-parameters.hi.md
rename to docs/tech-specs/hi/flow-configurable-parameters.hi.md
diff --git a/docs/tech-specs/graph-contexts.hi.md b/docs/tech-specs/hi/graph-contexts.hi.md
similarity index 100%
rename from docs/tech-specs/graph-contexts.hi.md
rename to docs/tech-specs/hi/graph-contexts.hi.md
diff --git a/docs/tech-specs/graphql-query.hi.md b/docs/tech-specs/hi/graphql-query.hi.md
similarity index 100%
rename from docs/tech-specs/graphql-query.hi.md
rename to docs/tech-specs/hi/graphql-query.hi.md
diff --git a/docs/tech-specs/graphrag-performance-optimization.hi.md b/docs/tech-specs/hi/graphrag-performance-optimization.hi.md
similarity index 100%
rename from docs/tech-specs/graphrag-performance-optimization.hi.md
rename to docs/tech-specs/hi/graphrag-performance-optimization.hi.md
diff --git a/docs/tech-specs/import-export-graceful-shutdown.hi.md b/docs/tech-specs/hi/import-export-graceful-shutdown.hi.md
similarity index 100%
rename from docs/tech-specs/import-export-graceful-shutdown.hi.md
rename to docs/tech-specs/hi/import-export-graceful-shutdown.hi.md
diff --git a/docs/tech-specs/jsonl-prompt-output.hi.md b/docs/tech-specs/hi/jsonl-prompt-output.hi.md
similarity index 100%
rename from docs/tech-specs/jsonl-prompt-output.hi.md
rename to docs/tech-specs/hi/jsonl-prompt-output.hi.md
diff --git a/docs/tech-specs/large-document-loading.hi.md b/docs/tech-specs/hi/large-document-loading.hi.md
similarity index 100%
rename from docs/tech-specs/large-document-loading.hi.md
rename to docs/tech-specs/hi/large-document-loading.hi.md
diff --git a/docs/tech-specs/logging-strategy.hi.md b/docs/tech-specs/hi/logging-strategy.hi.md
similarity index 100%
rename from docs/tech-specs/logging-strategy.hi.md
rename to docs/tech-specs/hi/logging-strategy.hi.md
diff --git a/docs/tech-specs/mcp-tool-arguments.hi.md b/docs/tech-specs/hi/mcp-tool-arguments.hi.md
similarity index 100%
rename from docs/tech-specs/mcp-tool-arguments.hi.md
rename to docs/tech-specs/hi/mcp-tool-arguments.hi.md
diff --git a/docs/tech-specs/mcp-tool-bearer-token.hi.md b/docs/tech-specs/hi/mcp-tool-bearer-token.hi.md
similarity index 100%
rename from docs/tech-specs/mcp-tool-bearer-token.hi.md
rename to docs/tech-specs/hi/mcp-tool-bearer-token.hi.md
diff --git a/docs/tech-specs/minio-to-s3-migration.hi.md b/docs/tech-specs/hi/minio-to-s3-migration.hi.md
similarity index 100%
rename from docs/tech-specs/minio-to-s3-migration.hi.md
rename to docs/tech-specs/hi/minio-to-s3-migration.hi.md
diff --git a/docs/tech-specs/more-config-cli.hi.md b/docs/tech-specs/hi/more-config-cli.hi.md
similarity index 100%
rename from docs/tech-specs/more-config-cli.hi.md
rename to docs/tech-specs/hi/more-config-cli.hi.md
diff --git a/docs/tech-specs/multi-tenant-support.hi.md b/docs/tech-specs/hi/multi-tenant-support.hi.md
similarity index 100%
rename from docs/tech-specs/multi-tenant-support.hi.md
rename to docs/tech-specs/hi/multi-tenant-support.hi.md
diff --git a/docs/tech-specs/neo4j-user-collection-isolation.hi.md b/docs/tech-specs/hi/neo4j-user-collection-isolation.hi.md
similarity index 100%
rename from docs/tech-specs/neo4j-user-collection-isolation.hi.md
rename to docs/tech-specs/hi/neo4j-user-collection-isolation.hi.md
diff --git a/docs/tech-specs/ontology-extract-phase-2.hi.md b/docs/tech-specs/hi/ontology-extract-phase-2.hi.md
similarity index 100%
rename from docs/tech-specs/ontology-extract-phase-2.hi.md
rename to docs/tech-specs/hi/ontology-extract-phase-2.hi.md
diff --git a/docs/tech-specs/ontology.hi.md b/docs/tech-specs/hi/ontology.hi.md
similarity index 100%
rename from docs/tech-specs/ontology.hi.md
rename to docs/tech-specs/hi/ontology.hi.md
diff --git a/docs/tech-specs/ontorag.hi.md b/docs/tech-specs/hi/ontorag.hi.md
similarity index 100%
rename from docs/tech-specs/ontorag.hi.md
rename to docs/tech-specs/hi/ontorag.hi.md
diff --git a/docs/tech-specs/openapi-spec.hi.md b/docs/tech-specs/hi/openapi-spec.hi.md
similarity index 100%
rename from docs/tech-specs/openapi-spec.hi.md
rename to docs/tech-specs/hi/openapi-spec.hi.md
diff --git a/docs/tech-specs/pubsub.hi.md b/docs/tech-specs/hi/pubsub.hi.md
similarity index 100%
rename from docs/tech-specs/pubsub.hi.md
rename to docs/tech-specs/hi/pubsub.hi.md
diff --git a/docs/tech-specs/python-api-refactor.hi.md b/docs/tech-specs/hi/python-api-refactor.hi.md
similarity index 100%
rename from docs/tech-specs/python-api-refactor.hi.md
rename to docs/tech-specs/hi/python-api-refactor.hi.md
diff --git a/docs/tech-specs/query-time-explainability.hi.md b/docs/tech-specs/hi/query-time-explainability.hi.md
similarity index 100%
rename from docs/tech-specs/query-time-explainability.hi.md
rename to docs/tech-specs/hi/query-time-explainability.hi.md
diff --git a/docs/tech-specs/rag-streaming-support.hi.md b/docs/tech-specs/hi/rag-streaming-support.hi.md
similarity index 100%
rename from docs/tech-specs/rag-streaming-support.hi.md
rename to docs/tech-specs/hi/rag-streaming-support.hi.md
diff --git a/docs/tech-specs/schema-refactoring-proposal.hi.md b/docs/tech-specs/hi/schema-refactoring-proposal.hi.md
similarity index 100%
rename from docs/tech-specs/schema-refactoring-proposal.hi.md
rename to docs/tech-specs/hi/schema-refactoring-proposal.hi.md
diff --git a/docs/tech-specs/streaming-llm-responses.hi.md b/docs/tech-specs/hi/streaming-llm-responses.hi.md
similarity index 100%
rename from docs/tech-specs/streaming-llm-responses.hi.md
rename to docs/tech-specs/hi/streaming-llm-responses.hi.md
diff --git a/docs/tech-specs/structured-data-2.hi.md b/docs/tech-specs/hi/structured-data-2.hi.md
similarity index 100%
rename from docs/tech-specs/structured-data-2.hi.md
rename to docs/tech-specs/hi/structured-data-2.hi.md
diff --git a/docs/tech-specs/structured-data-descriptor.hi.md b/docs/tech-specs/hi/structured-data-descriptor.hi.md
similarity index 100%
rename from docs/tech-specs/structured-data-descriptor.hi.md
rename to docs/tech-specs/hi/structured-data-descriptor.hi.md
diff --git a/docs/tech-specs/structured-data-schemas.hi.md b/docs/tech-specs/hi/structured-data-schemas.hi.md
similarity index 100%
rename from docs/tech-specs/structured-data-schemas.hi.md
rename to docs/tech-specs/hi/structured-data-schemas.hi.md
diff --git a/docs/tech-specs/structured-data.hi.md b/docs/tech-specs/hi/structured-data.hi.md
similarity index 100%
rename from docs/tech-specs/structured-data.hi.md
rename to docs/tech-specs/hi/structured-data.hi.md
diff --git a/docs/tech-specs/structured-diag-service.hi.md b/docs/tech-specs/hi/structured-diag-service.hi.md
similarity index 100%
rename from docs/tech-specs/structured-diag-service.hi.md
rename to docs/tech-specs/hi/structured-diag-service.hi.md
diff --git a/docs/tech-specs/tool-group.hi.md b/docs/tech-specs/hi/tool-group.hi.md
similarity index 100%
rename from docs/tech-specs/tool-group.hi.md
rename to docs/tech-specs/hi/tool-group.hi.md
diff --git a/docs/tech-specs/tool-services.hi.md b/docs/tech-specs/hi/tool-services.hi.md
similarity index 100%
rename from docs/tech-specs/tool-services.hi.md
rename to docs/tech-specs/hi/tool-services.hi.md
diff --git a/docs/tech-specs/universal-decoder.hi.md b/docs/tech-specs/hi/universal-decoder.hi.md
similarity index 100%
rename from docs/tech-specs/universal-decoder.hi.md
rename to docs/tech-specs/hi/universal-decoder.hi.md
diff --git a/docs/tech-specs/vector-store-lifecycle.hi.md b/docs/tech-specs/hi/vector-store-lifecycle.hi.md
similarity index 100%
rename from docs/tech-specs/vector-store-lifecycle.hi.md
rename to docs/tech-specs/hi/vector-store-lifecycle.hi.md
diff --git a/docs/tech-specs/__TEMPLATE.pt.md b/docs/tech-specs/pt/__TEMPLATE.pt.md
similarity index 100%
rename from docs/tech-specs/__TEMPLATE.pt.md
rename to docs/tech-specs/pt/__TEMPLATE.pt.md
diff --git a/docs/tech-specs/agent-explainability.pt.md b/docs/tech-specs/pt/agent-explainability.pt.md
similarity index 100%
rename from docs/tech-specs/agent-explainability.pt.md
rename to docs/tech-specs/pt/agent-explainability.pt.md
diff --git a/docs/tech-specs/architecture-principles.pt.md b/docs/tech-specs/pt/architecture-principles.pt.md
similarity index 100%
rename from docs/tech-specs/architecture-principles.pt.md
rename to docs/tech-specs/pt/architecture-principles.pt.md
diff --git a/docs/tech-specs/cassandra-consolidation.pt.md b/docs/tech-specs/pt/cassandra-consolidation.pt.md
similarity index 100%
rename from docs/tech-specs/cassandra-consolidation.pt.md
rename to docs/tech-specs/pt/cassandra-consolidation.pt.md
diff --git a/docs/tech-specs/cassandra-performance-refactor.pt.md b/docs/tech-specs/pt/cassandra-performance-refactor.pt.md
similarity index 100%
rename from docs/tech-specs/cassandra-performance-refactor.pt.md
rename to docs/tech-specs/pt/cassandra-performance-refactor.pt.md
diff --git a/docs/tech-specs/collection-management.pt.md b/docs/tech-specs/pt/collection-management.pt.md
similarity index 100%
rename from docs/tech-specs/collection-management.pt.md
rename to docs/tech-specs/pt/collection-management.pt.md
diff --git a/docs/tech-specs/document-embeddings-chunk-id.pt.md b/docs/tech-specs/pt/document-embeddings-chunk-id.pt.md
similarity index 100%
rename from docs/tech-specs/document-embeddings-chunk-id.pt.md
rename to docs/tech-specs/pt/document-embeddings-chunk-id.pt.md
diff --git a/docs/tech-specs/embeddings-batch-processing.pt.md b/docs/tech-specs/pt/embeddings-batch-processing.pt.md
similarity index 100%
rename from docs/tech-specs/embeddings-batch-processing.pt.md
rename to docs/tech-specs/pt/embeddings-batch-processing.pt.md
diff --git a/docs/tech-specs/entity-centric-graph.pt.md b/docs/tech-specs/pt/entity-centric-graph.pt.md
similarity index 100%
rename from docs/tech-specs/entity-centric-graph.pt.md
rename to docs/tech-specs/pt/entity-centric-graph.pt.md
diff --git a/docs/tech-specs/explainability-cli.pt.md b/docs/tech-specs/pt/explainability-cli.pt.md
similarity index 100%
rename from docs/tech-specs/explainability-cli.pt.md
rename to docs/tech-specs/pt/explainability-cli.pt.md
diff --git a/docs/tech-specs/extraction-flows.pt.md b/docs/tech-specs/pt/extraction-flows.pt.md
similarity index 100%
rename from docs/tech-specs/extraction-flows.pt.md
rename to docs/tech-specs/pt/extraction-flows.pt.md
diff --git a/docs/tech-specs/extraction-provenance-subgraph.pt.md b/docs/tech-specs/pt/extraction-provenance-subgraph.pt.md
similarity index 100%
rename from docs/tech-specs/extraction-provenance-subgraph.pt.md
rename to docs/tech-specs/pt/extraction-provenance-subgraph.pt.md
diff --git a/docs/tech-specs/extraction-time-provenance.pt.md b/docs/tech-specs/pt/extraction-time-provenance.pt.md
similarity index 100%
rename from docs/tech-specs/extraction-time-provenance.pt.md
rename to docs/tech-specs/pt/extraction-time-provenance.pt.md
diff --git a/docs/tech-specs/flow-class-definition.pt.md b/docs/tech-specs/pt/flow-class-definition.pt.md
similarity index 100%
rename from docs/tech-specs/flow-class-definition.pt.md
rename to docs/tech-specs/pt/flow-class-definition.pt.md
diff --git a/docs/tech-specs/flow-configurable-parameters.pt.md b/docs/tech-specs/pt/flow-configurable-parameters.pt.md
similarity index 100%
rename from docs/tech-specs/flow-configurable-parameters.pt.md
rename to docs/tech-specs/pt/flow-configurable-parameters.pt.md
diff --git a/docs/tech-specs/graph-contexts.pt.md b/docs/tech-specs/pt/graph-contexts.pt.md
similarity index 100%
rename from docs/tech-specs/graph-contexts.pt.md
rename to docs/tech-specs/pt/graph-contexts.pt.md
diff --git a/docs/tech-specs/graphql-query.pt.md b/docs/tech-specs/pt/graphql-query.pt.md
similarity index 100%
rename from docs/tech-specs/graphql-query.pt.md
rename to docs/tech-specs/pt/graphql-query.pt.md
diff --git a/docs/tech-specs/graphrag-performance-optimization.pt.md b/docs/tech-specs/pt/graphrag-performance-optimization.pt.md
similarity index 100%
rename from docs/tech-specs/graphrag-performance-optimization.pt.md
rename to docs/tech-specs/pt/graphrag-performance-optimization.pt.md
diff --git a/docs/tech-specs/import-export-graceful-shutdown.pt.md b/docs/tech-specs/pt/import-export-graceful-shutdown.pt.md
similarity index 100%
rename from docs/tech-specs/import-export-graceful-shutdown.pt.md
rename to docs/tech-specs/pt/import-export-graceful-shutdown.pt.md
diff --git a/docs/tech-specs/jsonl-prompt-output.pt.md b/docs/tech-specs/pt/jsonl-prompt-output.pt.md
similarity index 100%
rename from docs/tech-specs/jsonl-prompt-output.pt.md
rename to docs/tech-specs/pt/jsonl-prompt-output.pt.md
diff --git a/docs/tech-specs/large-document-loading.pt.md b/docs/tech-specs/pt/large-document-loading.pt.md
similarity index 100%
rename from docs/tech-specs/large-document-loading.pt.md
rename to docs/tech-specs/pt/large-document-loading.pt.md
diff --git a/docs/tech-specs/logging-strategy.pt.md b/docs/tech-specs/pt/logging-strategy.pt.md
similarity index 100%
rename from docs/tech-specs/logging-strategy.pt.md
rename to docs/tech-specs/pt/logging-strategy.pt.md
diff --git a/docs/tech-specs/mcp-tool-arguments.pt.md b/docs/tech-specs/pt/mcp-tool-arguments.pt.md
similarity index 100%
rename from docs/tech-specs/mcp-tool-arguments.pt.md
rename to docs/tech-specs/pt/mcp-tool-arguments.pt.md
diff --git a/docs/tech-specs/mcp-tool-bearer-token.pt.md b/docs/tech-specs/pt/mcp-tool-bearer-token.pt.md
similarity index 100%
rename from docs/tech-specs/mcp-tool-bearer-token.pt.md
rename to docs/tech-specs/pt/mcp-tool-bearer-token.pt.md
diff --git a/docs/tech-specs/minio-to-s3-migration.pt.md b/docs/tech-specs/pt/minio-to-s3-migration.pt.md
similarity index 100%
rename from docs/tech-specs/minio-to-s3-migration.pt.md
rename to docs/tech-specs/pt/minio-to-s3-migration.pt.md
diff --git a/docs/tech-specs/more-config-cli.pt.md b/docs/tech-specs/pt/more-config-cli.pt.md
similarity index 100%
rename from docs/tech-specs/more-config-cli.pt.md
rename to docs/tech-specs/pt/more-config-cli.pt.md
diff --git a/docs/tech-specs/multi-tenant-support.pt.md b/docs/tech-specs/pt/multi-tenant-support.pt.md
similarity index 100%
rename from docs/tech-specs/multi-tenant-support.pt.md
rename to docs/tech-specs/pt/multi-tenant-support.pt.md
diff --git a/docs/tech-specs/neo4j-user-collection-isolation.pt.md b/docs/tech-specs/pt/neo4j-user-collection-isolation.pt.md
similarity index 100%
rename from docs/tech-specs/neo4j-user-collection-isolation.pt.md
rename to docs/tech-specs/pt/neo4j-user-collection-isolation.pt.md
diff --git a/docs/tech-specs/ontology-extract-phase-2.pt.md b/docs/tech-specs/pt/ontology-extract-phase-2.pt.md
similarity index 100%
rename from docs/tech-specs/ontology-extract-phase-2.pt.md
rename to docs/tech-specs/pt/ontology-extract-phase-2.pt.md
diff --git a/docs/tech-specs/ontology.pt.md b/docs/tech-specs/pt/ontology.pt.md
similarity index 100%
rename from docs/tech-specs/ontology.pt.md
rename to docs/tech-specs/pt/ontology.pt.md
diff --git a/docs/tech-specs/ontorag.pt.md b/docs/tech-specs/pt/ontorag.pt.md
similarity index 100%
rename from docs/tech-specs/ontorag.pt.md
rename to docs/tech-specs/pt/ontorag.pt.md
diff --git a/docs/tech-specs/openapi-spec.pt.md b/docs/tech-specs/pt/openapi-spec.pt.md
similarity index 100%
rename from docs/tech-specs/openapi-spec.pt.md
rename to docs/tech-specs/pt/openapi-spec.pt.md
diff --git a/docs/tech-specs/pubsub.pt.md b/docs/tech-specs/pt/pubsub.pt.md
similarity index 100%
rename from docs/tech-specs/pubsub.pt.md
rename to docs/tech-specs/pt/pubsub.pt.md
diff --git a/docs/tech-specs/python-api-refactor.pt.md b/docs/tech-specs/pt/python-api-refactor.pt.md
similarity index 100%
rename from docs/tech-specs/python-api-refactor.pt.md
rename to docs/tech-specs/pt/python-api-refactor.pt.md
diff --git a/docs/tech-specs/query-time-explainability.pt.md b/docs/tech-specs/pt/query-time-explainability.pt.md
similarity index 100%
rename from docs/tech-specs/query-time-explainability.pt.md
rename to docs/tech-specs/pt/query-time-explainability.pt.md
diff --git a/docs/tech-specs/rag-streaming-support.pt.md b/docs/tech-specs/pt/rag-streaming-support.pt.md
similarity index 100%
rename from docs/tech-specs/rag-streaming-support.pt.md
rename to docs/tech-specs/pt/rag-streaming-support.pt.md
diff --git a/docs/tech-specs/schema-refactoring-proposal.pt.md b/docs/tech-specs/pt/schema-refactoring-proposal.pt.md
similarity index 100%
rename from docs/tech-specs/schema-refactoring-proposal.pt.md
rename to docs/tech-specs/pt/schema-refactoring-proposal.pt.md
diff --git a/docs/tech-specs/streaming-llm-responses.pt.md b/docs/tech-specs/pt/streaming-llm-responses.pt.md
similarity index 100%
rename from docs/tech-specs/streaming-llm-responses.pt.md
rename to docs/tech-specs/pt/streaming-llm-responses.pt.md
diff --git a/docs/tech-specs/structured-data-2.pt.md b/docs/tech-specs/pt/structured-data-2.pt.md
similarity index 100%
rename from docs/tech-specs/structured-data-2.pt.md
rename to docs/tech-specs/pt/structured-data-2.pt.md
diff --git a/docs/tech-specs/structured-data-descriptor.pt.md b/docs/tech-specs/pt/structured-data-descriptor.pt.md
similarity index 100%
rename from docs/tech-specs/structured-data-descriptor.pt.md
rename to docs/tech-specs/pt/structured-data-descriptor.pt.md
diff --git a/docs/tech-specs/structured-data-schemas.pt.md b/docs/tech-specs/pt/structured-data-schemas.pt.md
similarity index 100%
rename from docs/tech-specs/structured-data-schemas.pt.md
rename to docs/tech-specs/pt/structured-data-schemas.pt.md
diff --git a/docs/tech-specs/structured-data.pt.md b/docs/tech-specs/pt/structured-data.pt.md
similarity index 100%
rename from docs/tech-specs/structured-data.pt.md
rename to docs/tech-specs/pt/structured-data.pt.md
diff --git a/docs/tech-specs/structured-diag-service.pt.md b/docs/tech-specs/pt/structured-diag-service.pt.md
similarity index 100%
rename from docs/tech-specs/structured-diag-service.pt.md
rename to docs/tech-specs/pt/structured-diag-service.pt.md
diff --git a/docs/tech-specs/tool-group.pt.md b/docs/tech-specs/pt/tool-group.pt.md
similarity index 100%
rename from docs/tech-specs/tool-group.pt.md
rename to docs/tech-specs/pt/tool-group.pt.md
diff --git a/docs/tech-specs/tool-services.pt.md b/docs/tech-specs/pt/tool-services.pt.md
similarity index 100%
rename from docs/tech-specs/tool-services.pt.md
rename to docs/tech-specs/pt/tool-services.pt.md
diff --git a/docs/tech-specs/universal-decoder.pt.md b/docs/tech-specs/pt/universal-decoder.pt.md
similarity index 100%
rename from docs/tech-specs/universal-decoder.pt.md
rename to docs/tech-specs/pt/universal-decoder.pt.md
diff --git a/docs/tech-specs/vector-store-lifecycle.pt.md b/docs/tech-specs/pt/vector-store-lifecycle.pt.md
similarity index 100%
rename from docs/tech-specs/vector-store-lifecycle.pt.md
rename to docs/tech-specs/pt/vector-store-lifecycle.pt.md
diff --git a/docs/tech-specs/__TEMPLATE.ru.md b/docs/tech-specs/ru/__TEMPLATE.ru.md
similarity index 100%
rename from docs/tech-specs/__TEMPLATE.ru.md
rename to docs/tech-specs/ru/__TEMPLATE.ru.md
diff --git a/docs/tech-specs/agent-explainability.ru.md b/docs/tech-specs/ru/agent-explainability.ru.md
similarity index 100%
rename from docs/tech-specs/agent-explainability.ru.md
rename to docs/tech-specs/ru/agent-explainability.ru.md
diff --git a/docs/tech-specs/architecture-principles.ru.md b/docs/tech-specs/ru/architecture-principles.ru.md
similarity index 100%
rename from docs/tech-specs/architecture-principles.ru.md
rename to docs/tech-specs/ru/architecture-principles.ru.md
diff --git a/docs/tech-specs/cassandra-consolidation.ru.md b/docs/tech-specs/ru/cassandra-consolidation.ru.md
similarity index 100%
rename from docs/tech-specs/cassandra-consolidation.ru.md
rename to docs/tech-specs/ru/cassandra-consolidation.ru.md
diff --git a/docs/tech-specs/cassandra-performance-refactor.ru.md b/docs/tech-specs/ru/cassandra-performance-refactor.ru.md
similarity index 100%
rename from docs/tech-specs/cassandra-performance-refactor.ru.md
rename to docs/tech-specs/ru/cassandra-performance-refactor.ru.md
diff --git a/docs/tech-specs/collection-management.ru.md b/docs/tech-specs/ru/collection-management.ru.md
similarity index 100%
rename from docs/tech-specs/collection-management.ru.md
rename to docs/tech-specs/ru/collection-management.ru.md
diff --git a/docs/tech-specs/document-embeddings-chunk-id.ru.md b/docs/tech-specs/ru/document-embeddings-chunk-id.ru.md
similarity index 100%
rename from docs/tech-specs/document-embeddings-chunk-id.ru.md
rename to docs/tech-specs/ru/document-embeddings-chunk-id.ru.md
diff --git a/docs/tech-specs/embeddings-batch-processing.ru.md b/docs/tech-specs/ru/embeddings-batch-processing.ru.md
similarity index 100%
rename from docs/tech-specs/embeddings-batch-processing.ru.md
rename to docs/tech-specs/ru/embeddings-batch-processing.ru.md
diff --git a/docs/tech-specs/entity-centric-graph.ru.md b/docs/tech-specs/ru/entity-centric-graph.ru.md
similarity index 100%
rename from docs/tech-specs/entity-centric-graph.ru.md
rename to docs/tech-specs/ru/entity-centric-graph.ru.md
diff --git a/docs/tech-specs/explainability-cli.ru.md b/docs/tech-specs/ru/explainability-cli.ru.md
similarity index 100%
rename from docs/tech-specs/explainability-cli.ru.md
rename to docs/tech-specs/ru/explainability-cli.ru.md
diff --git a/docs/tech-specs/extraction-flows.ru.md b/docs/tech-specs/ru/extraction-flows.ru.md
similarity index 100%
rename from docs/tech-specs/extraction-flows.ru.md
rename to docs/tech-specs/ru/extraction-flows.ru.md
diff --git a/docs/tech-specs/extraction-provenance-subgraph.ru.md b/docs/tech-specs/ru/extraction-provenance-subgraph.ru.md
similarity index 100%
rename from docs/tech-specs/extraction-provenance-subgraph.ru.md
rename to docs/tech-specs/ru/extraction-provenance-subgraph.ru.md
diff --git a/docs/tech-specs/extraction-time-provenance.ru.md b/docs/tech-specs/ru/extraction-time-provenance.ru.md
similarity index 100%
rename from docs/tech-specs/extraction-time-provenance.ru.md
rename to docs/tech-specs/ru/extraction-time-provenance.ru.md
diff --git a/docs/tech-specs/flow-class-definition.ru.md b/docs/tech-specs/ru/flow-class-definition.ru.md
similarity index 100%
rename from docs/tech-specs/flow-class-definition.ru.md
rename to docs/tech-specs/ru/flow-class-definition.ru.md
diff --git a/docs/tech-specs/flow-configurable-parameters.ru.md b/docs/tech-specs/ru/flow-configurable-parameters.ru.md
similarity index 100%
rename from docs/tech-specs/flow-configurable-parameters.ru.md
rename to docs/tech-specs/ru/flow-configurable-parameters.ru.md
diff --git a/docs/tech-specs/graph-contexts.ru.md b/docs/tech-specs/ru/graph-contexts.ru.md
similarity index 100%
rename from docs/tech-specs/graph-contexts.ru.md
rename to docs/tech-specs/ru/graph-contexts.ru.md
diff --git a/docs/tech-specs/graphql-query.ru.md b/docs/tech-specs/ru/graphql-query.ru.md
similarity index 100%
rename from docs/tech-specs/graphql-query.ru.md
rename to docs/tech-specs/ru/graphql-query.ru.md
diff --git a/docs/tech-specs/graphrag-performance-optimization.ru.md b/docs/tech-specs/ru/graphrag-performance-optimization.ru.md
similarity index 100%
rename from docs/tech-specs/graphrag-performance-optimization.ru.md
rename to docs/tech-specs/ru/graphrag-performance-optimization.ru.md
diff --git a/docs/tech-specs/import-export-graceful-shutdown.ru.md b/docs/tech-specs/ru/import-export-graceful-shutdown.ru.md
similarity index 100%
rename from docs/tech-specs/import-export-graceful-shutdown.ru.md
rename to docs/tech-specs/ru/import-export-graceful-shutdown.ru.md
diff --git a/docs/tech-specs/jsonl-prompt-output.ru.md b/docs/tech-specs/ru/jsonl-prompt-output.ru.md
similarity index 100%
rename from docs/tech-specs/jsonl-prompt-output.ru.md
rename to docs/tech-specs/ru/jsonl-prompt-output.ru.md
diff --git a/docs/tech-specs/large-document-loading.ru.md b/docs/tech-specs/ru/large-document-loading.ru.md
similarity index 100%
rename from docs/tech-specs/large-document-loading.ru.md
rename to docs/tech-specs/ru/large-document-loading.ru.md
diff --git a/docs/tech-specs/logging-strategy.ru.md b/docs/tech-specs/ru/logging-strategy.ru.md
similarity index 100%
rename from docs/tech-specs/logging-strategy.ru.md
rename to docs/tech-specs/ru/logging-strategy.ru.md
diff --git a/docs/tech-specs/mcp-tool-arguments.ru.md b/docs/tech-specs/ru/mcp-tool-arguments.ru.md
similarity index 100%
rename from docs/tech-specs/mcp-tool-arguments.ru.md
rename to docs/tech-specs/ru/mcp-tool-arguments.ru.md
diff --git a/docs/tech-specs/mcp-tool-bearer-token.ru.md b/docs/tech-specs/ru/mcp-tool-bearer-token.ru.md
similarity index 100%
rename from docs/tech-specs/mcp-tool-bearer-token.ru.md
rename to docs/tech-specs/ru/mcp-tool-bearer-token.ru.md
diff --git a/docs/tech-specs/minio-to-s3-migration.ru.md b/docs/tech-specs/ru/minio-to-s3-migration.ru.md
similarity index 100%
rename from docs/tech-specs/minio-to-s3-migration.ru.md
rename to docs/tech-specs/ru/minio-to-s3-migration.ru.md
diff --git a/docs/tech-specs/more-config-cli.ru.md b/docs/tech-specs/ru/more-config-cli.ru.md
similarity index 100%
rename from docs/tech-specs/more-config-cli.ru.md
rename to docs/tech-specs/ru/more-config-cli.ru.md
diff --git a/docs/tech-specs/multi-tenant-support.ru.md b/docs/tech-specs/ru/multi-tenant-support.ru.md
similarity index 100%
rename from docs/tech-specs/multi-tenant-support.ru.md
rename to docs/tech-specs/ru/multi-tenant-support.ru.md
diff --git a/docs/tech-specs/neo4j-user-collection-isolation.ru.md b/docs/tech-specs/ru/neo4j-user-collection-isolation.ru.md
similarity index 100%
rename from docs/tech-specs/neo4j-user-collection-isolation.ru.md
rename to docs/tech-specs/ru/neo4j-user-collection-isolation.ru.md
diff --git a/docs/tech-specs/ontology-extract-phase-2.ru.md b/docs/tech-specs/ru/ontology-extract-phase-2.ru.md
similarity index 100%
rename from docs/tech-specs/ontology-extract-phase-2.ru.md
rename to docs/tech-specs/ru/ontology-extract-phase-2.ru.md
diff --git a/docs/tech-specs/ontology.ru.md b/docs/tech-specs/ru/ontology.ru.md
similarity index 100%
rename from docs/tech-specs/ontology.ru.md
rename to docs/tech-specs/ru/ontology.ru.md
diff --git a/docs/tech-specs/ontorag.ru.md b/docs/tech-specs/ru/ontorag.ru.md
similarity index 100%
rename from docs/tech-specs/ontorag.ru.md
rename to docs/tech-specs/ru/ontorag.ru.md
diff --git a/docs/tech-specs/openapi-spec.ru.md b/docs/tech-specs/ru/openapi-spec.ru.md
similarity index 100%
rename from docs/tech-specs/openapi-spec.ru.md
rename to docs/tech-specs/ru/openapi-spec.ru.md
diff --git a/docs/tech-specs/pubsub.ru.md b/docs/tech-specs/ru/pubsub.ru.md
similarity index 100%
rename from docs/tech-specs/pubsub.ru.md
rename to docs/tech-specs/ru/pubsub.ru.md
diff --git a/docs/tech-specs/python-api-refactor.ru.md b/docs/tech-specs/ru/python-api-refactor.ru.md
similarity index 100%
rename from docs/tech-specs/python-api-refactor.ru.md
rename to docs/tech-specs/ru/python-api-refactor.ru.md
diff --git a/docs/tech-specs/query-time-explainability.ru.md b/docs/tech-specs/ru/query-time-explainability.ru.md
similarity index 100%
rename from docs/tech-specs/query-time-explainability.ru.md
rename to docs/tech-specs/ru/query-time-explainability.ru.md
diff --git a/docs/tech-specs/rag-streaming-support.ru.md b/docs/tech-specs/ru/rag-streaming-support.ru.md
similarity index 100%
rename from docs/tech-specs/rag-streaming-support.ru.md
rename to docs/tech-specs/ru/rag-streaming-support.ru.md
diff --git a/docs/tech-specs/schema-refactoring-proposal.ru.md b/docs/tech-specs/ru/schema-refactoring-proposal.ru.md
similarity index 100%
rename from docs/tech-specs/schema-refactoring-proposal.ru.md
rename to docs/tech-specs/ru/schema-refactoring-proposal.ru.md
diff --git a/docs/tech-specs/streaming-llm-responses.ru.md b/docs/tech-specs/ru/streaming-llm-responses.ru.md
similarity index 100%
rename from docs/tech-specs/streaming-llm-responses.ru.md
rename to docs/tech-specs/ru/streaming-llm-responses.ru.md
diff --git a/docs/tech-specs/structured-data-2.ru.md b/docs/tech-specs/ru/structured-data-2.ru.md
similarity index 100%
rename from docs/tech-specs/structured-data-2.ru.md
rename to docs/tech-specs/ru/structured-data-2.ru.md
diff --git a/docs/tech-specs/structured-data-descriptor.ru.md b/docs/tech-specs/ru/structured-data-descriptor.ru.md
similarity index 100%
rename from docs/tech-specs/structured-data-descriptor.ru.md
rename to docs/tech-specs/ru/structured-data-descriptor.ru.md
diff --git a/docs/tech-specs/structured-data-schemas.ru.md b/docs/tech-specs/ru/structured-data-schemas.ru.md
similarity index 100%
rename from docs/tech-specs/structured-data-schemas.ru.md
rename to docs/tech-specs/ru/structured-data-schemas.ru.md
diff --git a/docs/tech-specs/structured-data.ru.md b/docs/tech-specs/ru/structured-data.ru.md
similarity index 100%
rename from docs/tech-specs/structured-data.ru.md
rename to docs/tech-specs/ru/structured-data.ru.md
diff --git a/docs/tech-specs/structured-diag-service.ru.md b/docs/tech-specs/ru/structured-diag-service.ru.md
similarity index 100%
rename from docs/tech-specs/structured-diag-service.ru.md
rename to docs/tech-specs/ru/structured-diag-service.ru.md
diff --git a/docs/tech-specs/tool-group.ru.md b/docs/tech-specs/ru/tool-group.ru.md
similarity index 100%
rename from docs/tech-specs/tool-group.ru.md
rename to docs/tech-specs/ru/tool-group.ru.md
diff --git a/docs/tech-specs/tool-services.ru.md b/docs/tech-specs/ru/tool-services.ru.md
similarity index 100%
rename from docs/tech-specs/tool-services.ru.md
rename to docs/tech-specs/ru/tool-services.ru.md
diff --git a/docs/tech-specs/universal-decoder.ru.md b/docs/tech-specs/ru/universal-decoder.ru.md
similarity index 100%
rename from docs/tech-specs/universal-decoder.ru.md
rename to docs/tech-specs/ru/universal-decoder.ru.md
diff --git a/docs/tech-specs/vector-store-lifecycle.ru.md b/docs/tech-specs/ru/vector-store-lifecycle.ru.md
similarity index 100%
rename from docs/tech-specs/vector-store-lifecycle.ru.md
rename to docs/tech-specs/ru/vector-store-lifecycle.ru.md
diff --git a/docs/tech-specs/__TEMPLATE.sw.md b/docs/tech-specs/sw/__TEMPLATE.sw.md
similarity index 100%
rename from docs/tech-specs/__TEMPLATE.sw.md
rename to docs/tech-specs/sw/__TEMPLATE.sw.md
diff --git a/docs/tech-specs/agent-explainability.sw.md b/docs/tech-specs/sw/agent-explainability.sw.md
similarity index 100%
rename from docs/tech-specs/agent-explainability.sw.md
rename to docs/tech-specs/sw/agent-explainability.sw.md
diff --git a/docs/tech-specs/architecture-principles.sw.md b/docs/tech-specs/sw/architecture-principles.sw.md
similarity index 100%
rename from docs/tech-specs/architecture-principles.sw.md
rename to docs/tech-specs/sw/architecture-principles.sw.md
diff --git a/docs/tech-specs/cassandra-consolidation.sw.md b/docs/tech-specs/sw/cassandra-consolidation.sw.md
similarity index 100%
rename from docs/tech-specs/cassandra-consolidation.sw.md
rename to docs/tech-specs/sw/cassandra-consolidation.sw.md
diff --git a/docs/tech-specs/cassandra-performance-refactor.sw.md b/docs/tech-specs/sw/cassandra-performance-refactor.sw.md
similarity index 100%
rename from docs/tech-specs/cassandra-performance-refactor.sw.md
rename to docs/tech-specs/sw/cassandra-performance-refactor.sw.md
diff --git a/docs/tech-specs/collection-management.sw.md b/docs/tech-specs/sw/collection-management.sw.md
similarity index 100%
rename from docs/tech-specs/collection-management.sw.md
rename to docs/tech-specs/sw/collection-management.sw.md
diff --git a/docs/tech-specs/document-embeddings-chunk-id.sw.md b/docs/tech-specs/sw/document-embeddings-chunk-id.sw.md
similarity index 100%
rename from docs/tech-specs/document-embeddings-chunk-id.sw.md
rename to docs/tech-specs/sw/document-embeddings-chunk-id.sw.md
diff --git a/docs/tech-specs/embeddings-batch-processing.sw.md b/docs/tech-specs/sw/embeddings-batch-processing.sw.md
similarity index 100%
rename from docs/tech-specs/embeddings-batch-processing.sw.md
rename to docs/tech-specs/sw/embeddings-batch-processing.sw.md
diff --git a/docs/tech-specs/entity-centric-graph.sw.md b/docs/tech-specs/sw/entity-centric-graph.sw.md
similarity index 100%
rename from docs/tech-specs/entity-centric-graph.sw.md
rename to docs/tech-specs/sw/entity-centric-graph.sw.md
diff --git a/docs/tech-specs/explainability-cli.sw.md b/docs/tech-specs/sw/explainability-cli.sw.md
similarity index 100%
rename from docs/tech-specs/explainability-cli.sw.md
rename to docs/tech-specs/sw/explainability-cli.sw.md
diff --git a/docs/tech-specs/extraction-flows.sw.md b/docs/tech-specs/sw/extraction-flows.sw.md
similarity index 100%
rename from docs/tech-specs/extraction-flows.sw.md
rename to docs/tech-specs/sw/extraction-flows.sw.md
diff --git a/docs/tech-specs/extraction-provenance-subgraph.sw.md b/docs/tech-specs/sw/extraction-provenance-subgraph.sw.md
similarity index 100%
rename from docs/tech-specs/extraction-provenance-subgraph.sw.md
rename to docs/tech-specs/sw/extraction-provenance-subgraph.sw.md
diff --git a/docs/tech-specs/extraction-time-provenance.sw.md b/docs/tech-specs/sw/extraction-time-provenance.sw.md
similarity index 100%
rename from docs/tech-specs/extraction-time-provenance.sw.md
rename to docs/tech-specs/sw/extraction-time-provenance.sw.md
diff --git a/docs/tech-specs/flow-class-definition.sw.md b/docs/tech-specs/sw/flow-class-definition.sw.md
similarity index 100%
rename from docs/tech-specs/flow-class-definition.sw.md
rename to docs/tech-specs/sw/flow-class-definition.sw.md
diff --git a/docs/tech-specs/flow-configurable-parameters.sw.md b/docs/tech-specs/sw/flow-configurable-parameters.sw.md
similarity index 100%
rename from docs/tech-specs/flow-configurable-parameters.sw.md
rename to docs/tech-specs/sw/flow-configurable-parameters.sw.md
diff --git a/docs/tech-specs/graph-contexts.sw.md b/docs/tech-specs/sw/graph-contexts.sw.md
similarity index 100%
rename from docs/tech-specs/graph-contexts.sw.md
rename to docs/tech-specs/sw/graph-contexts.sw.md
diff --git a/docs/tech-specs/graphql-query.sw.md b/docs/tech-specs/sw/graphql-query.sw.md
similarity index 100%
rename from docs/tech-specs/graphql-query.sw.md
rename to docs/tech-specs/sw/graphql-query.sw.md
diff --git a/docs/tech-specs/graphrag-performance-optimization.sw.md b/docs/tech-specs/sw/graphrag-performance-optimization.sw.md
similarity index 100%
rename from docs/tech-specs/graphrag-performance-optimization.sw.md
rename to docs/tech-specs/sw/graphrag-performance-optimization.sw.md
diff --git a/docs/tech-specs/import-export-graceful-shutdown.sw.md b/docs/tech-specs/sw/import-export-graceful-shutdown.sw.md
similarity index 100%
rename from docs/tech-specs/import-export-graceful-shutdown.sw.md
rename to docs/tech-specs/sw/import-export-graceful-shutdown.sw.md
diff --git a/docs/tech-specs/jsonl-prompt-output.sw.md b/docs/tech-specs/sw/jsonl-prompt-output.sw.md
similarity index 100%
rename from docs/tech-specs/jsonl-prompt-output.sw.md
rename to docs/tech-specs/sw/jsonl-prompt-output.sw.md
diff --git a/docs/tech-specs/large-document-loading.sw.md b/docs/tech-specs/sw/large-document-loading.sw.md
similarity index 100%
rename from docs/tech-specs/large-document-loading.sw.md
rename to docs/tech-specs/sw/large-document-loading.sw.md
diff --git a/docs/tech-specs/logging-strategy.sw.md b/docs/tech-specs/sw/logging-strategy.sw.md
similarity index 100%
rename from docs/tech-specs/logging-strategy.sw.md
rename to docs/tech-specs/sw/logging-strategy.sw.md
diff --git a/docs/tech-specs/mcp-tool-arguments.sw.md b/docs/tech-specs/sw/mcp-tool-arguments.sw.md
similarity index 100%
rename from docs/tech-specs/mcp-tool-arguments.sw.md
rename to docs/tech-specs/sw/mcp-tool-arguments.sw.md
diff --git a/docs/tech-specs/mcp-tool-bearer-token.sw.md b/docs/tech-specs/sw/mcp-tool-bearer-token.sw.md
similarity index 100%
rename from docs/tech-specs/mcp-tool-bearer-token.sw.md
rename to docs/tech-specs/sw/mcp-tool-bearer-token.sw.md
diff --git a/docs/tech-specs/minio-to-s3-migration.sw.md b/docs/tech-specs/sw/minio-to-s3-migration.sw.md
similarity index 100%
rename from docs/tech-specs/minio-to-s3-migration.sw.md
rename to docs/tech-specs/sw/minio-to-s3-migration.sw.md
diff --git a/docs/tech-specs/more-config-cli.sw.md b/docs/tech-specs/sw/more-config-cli.sw.md
similarity index 100%
rename from docs/tech-specs/more-config-cli.sw.md
rename to docs/tech-specs/sw/more-config-cli.sw.md
diff --git a/docs/tech-specs/multi-tenant-support.sw.md b/docs/tech-specs/sw/multi-tenant-support.sw.md
similarity index 100%
rename from docs/tech-specs/multi-tenant-support.sw.md
rename to docs/tech-specs/sw/multi-tenant-support.sw.md
diff --git a/docs/tech-specs/neo4j-user-collection-isolation.sw.md b/docs/tech-specs/sw/neo4j-user-collection-isolation.sw.md
similarity index 100%
rename from docs/tech-specs/neo4j-user-collection-isolation.sw.md
rename to docs/tech-specs/sw/neo4j-user-collection-isolation.sw.md
diff --git a/docs/tech-specs/ontology-extract-phase-2.sw.md b/docs/tech-specs/sw/ontology-extract-phase-2.sw.md
similarity index 100%
rename from docs/tech-specs/ontology-extract-phase-2.sw.md
rename to docs/tech-specs/sw/ontology-extract-phase-2.sw.md
diff --git a/docs/tech-specs/ontology.sw.md b/docs/tech-specs/sw/ontology.sw.md
similarity index 100%
rename from docs/tech-specs/ontology.sw.md
rename to docs/tech-specs/sw/ontology.sw.md
diff --git a/docs/tech-specs/ontorag.sw.md b/docs/tech-specs/sw/ontorag.sw.md
similarity index 100%
rename from docs/tech-specs/ontorag.sw.md
rename to docs/tech-specs/sw/ontorag.sw.md
diff --git a/docs/tech-specs/openapi-spec.sw.md b/docs/tech-specs/sw/openapi-spec.sw.md
similarity index 100%
rename from docs/tech-specs/openapi-spec.sw.md
rename to docs/tech-specs/sw/openapi-spec.sw.md
diff --git a/docs/tech-specs/pubsub.sw.md b/docs/tech-specs/sw/pubsub.sw.md
similarity index 100%
rename from docs/tech-specs/pubsub.sw.md
rename to docs/tech-specs/sw/pubsub.sw.md
diff --git a/docs/tech-specs/python-api-refactor.sw.md b/docs/tech-specs/sw/python-api-refactor.sw.md
similarity index 100%
rename from docs/tech-specs/python-api-refactor.sw.md
rename to docs/tech-specs/sw/python-api-refactor.sw.md
diff --git a/docs/tech-specs/query-time-explainability.sw.md b/docs/tech-specs/sw/query-time-explainability.sw.md
similarity index 100%
rename from docs/tech-specs/query-time-explainability.sw.md
rename to docs/tech-specs/sw/query-time-explainability.sw.md
diff --git a/docs/tech-specs/rag-streaming-support.sw.md b/docs/tech-specs/sw/rag-streaming-support.sw.md
similarity index 100%
rename from docs/tech-specs/rag-streaming-support.sw.md
rename to docs/tech-specs/sw/rag-streaming-support.sw.md
diff --git a/docs/tech-specs/schema-refactoring-proposal.sw.md b/docs/tech-specs/sw/schema-refactoring-proposal.sw.md
similarity index 100%
rename from docs/tech-specs/schema-refactoring-proposal.sw.md
rename to docs/tech-specs/sw/schema-refactoring-proposal.sw.md
diff --git a/docs/tech-specs/streaming-llm-responses.sw.md b/docs/tech-specs/sw/streaming-llm-responses.sw.md
similarity index 100%
rename from docs/tech-specs/streaming-llm-responses.sw.md
rename to docs/tech-specs/sw/streaming-llm-responses.sw.md
diff --git a/docs/tech-specs/structured-data-2.sw.md b/docs/tech-specs/sw/structured-data-2.sw.md
similarity index 100%
rename from docs/tech-specs/structured-data-2.sw.md
rename to docs/tech-specs/sw/structured-data-2.sw.md
diff --git a/docs/tech-specs/structured-data-descriptor.sw.md b/docs/tech-specs/sw/structured-data-descriptor.sw.md
similarity index 100%
rename from docs/tech-specs/structured-data-descriptor.sw.md
rename to docs/tech-specs/sw/structured-data-descriptor.sw.md
diff --git a/docs/tech-specs/structured-data-schemas.sw.md b/docs/tech-specs/sw/structured-data-schemas.sw.md
similarity index 100%
rename from docs/tech-specs/structured-data-schemas.sw.md
rename to docs/tech-specs/sw/structured-data-schemas.sw.md
diff --git a/docs/tech-specs/structured-data.sw.md b/docs/tech-specs/sw/structured-data.sw.md
similarity index 100%
rename from docs/tech-specs/structured-data.sw.md
rename to docs/tech-specs/sw/structured-data.sw.md
diff --git a/docs/tech-specs/structured-diag-service.sw.md b/docs/tech-specs/sw/structured-diag-service.sw.md
similarity index 100%
rename from docs/tech-specs/structured-diag-service.sw.md
rename to docs/tech-specs/sw/structured-diag-service.sw.md
diff --git a/docs/tech-specs/tool-group.sw.md b/docs/tech-specs/sw/tool-group.sw.md
similarity index 100%
rename from docs/tech-specs/tool-group.sw.md
rename to docs/tech-specs/sw/tool-group.sw.md
diff --git a/docs/tech-specs/tool-services.sw.md b/docs/tech-specs/sw/tool-services.sw.md
similarity index 100%
rename from docs/tech-specs/tool-services.sw.md
rename to docs/tech-specs/sw/tool-services.sw.md
diff --git a/docs/tech-specs/universal-decoder.sw.md b/docs/tech-specs/sw/universal-decoder.sw.md
similarity index 100%
rename from docs/tech-specs/universal-decoder.sw.md
rename to docs/tech-specs/sw/universal-decoder.sw.md
diff --git a/docs/tech-specs/vector-store-lifecycle.sw.md b/docs/tech-specs/sw/vector-store-lifecycle.sw.md
similarity index 100%
rename from docs/tech-specs/vector-store-lifecycle.sw.md
rename to docs/tech-specs/sw/vector-store-lifecycle.sw.md
diff --git a/docs/tech-specs/__TEMPLATE.tr.md b/docs/tech-specs/tr/__TEMPLATE.tr.md
similarity index 100%
rename from docs/tech-specs/__TEMPLATE.tr.md
rename to docs/tech-specs/tr/__TEMPLATE.tr.md
diff --git a/docs/tech-specs/agent-explainability.tr.md b/docs/tech-specs/tr/agent-explainability.tr.md
similarity index 100%
rename from docs/tech-specs/agent-explainability.tr.md
rename to docs/tech-specs/tr/agent-explainability.tr.md
diff --git a/docs/tech-specs/architecture-principles.tr.md b/docs/tech-specs/tr/architecture-principles.tr.md
similarity index 100%
rename from docs/tech-specs/architecture-principles.tr.md
rename to docs/tech-specs/tr/architecture-principles.tr.md
diff --git a/docs/tech-specs/cassandra-consolidation.tr.md b/docs/tech-specs/tr/cassandra-consolidation.tr.md
similarity index 100%
rename from docs/tech-specs/cassandra-consolidation.tr.md
rename to docs/tech-specs/tr/cassandra-consolidation.tr.md
diff --git a/docs/tech-specs/cassandra-performance-refactor.tr.md b/docs/tech-specs/tr/cassandra-performance-refactor.tr.md
similarity index 100%
rename from docs/tech-specs/cassandra-performance-refactor.tr.md
rename to docs/tech-specs/tr/cassandra-performance-refactor.tr.md
diff --git a/docs/tech-specs/collection-management.tr.md b/docs/tech-specs/tr/collection-management.tr.md
similarity index 100%
rename from docs/tech-specs/collection-management.tr.md
rename to docs/tech-specs/tr/collection-management.tr.md
diff --git a/docs/tech-specs/document-embeddings-chunk-id.tr.md b/docs/tech-specs/tr/document-embeddings-chunk-id.tr.md
similarity index 100%
rename from docs/tech-specs/document-embeddings-chunk-id.tr.md
rename to docs/tech-specs/tr/document-embeddings-chunk-id.tr.md
diff --git a/docs/tech-specs/embeddings-batch-processing.tr.md b/docs/tech-specs/tr/embeddings-batch-processing.tr.md
similarity index 100%
rename from docs/tech-specs/embeddings-batch-processing.tr.md
rename to docs/tech-specs/tr/embeddings-batch-processing.tr.md
diff --git a/docs/tech-specs/entity-centric-graph.tr.md b/docs/tech-specs/tr/entity-centric-graph.tr.md
similarity index 100%
rename from docs/tech-specs/entity-centric-graph.tr.md
rename to docs/tech-specs/tr/entity-centric-graph.tr.md
diff --git a/docs/tech-specs/explainability-cli.tr.md b/docs/tech-specs/tr/explainability-cli.tr.md
similarity index 100%
rename from docs/tech-specs/explainability-cli.tr.md
rename to docs/tech-specs/tr/explainability-cli.tr.md
diff --git a/docs/tech-specs/extraction-flows.tr.md b/docs/tech-specs/tr/extraction-flows.tr.md
similarity index 100%
rename from docs/tech-specs/extraction-flows.tr.md
rename to docs/tech-specs/tr/extraction-flows.tr.md
diff --git a/docs/tech-specs/extraction-provenance-subgraph.tr.md b/docs/tech-specs/tr/extraction-provenance-subgraph.tr.md
similarity index 100%
rename from docs/tech-specs/extraction-provenance-subgraph.tr.md
rename to docs/tech-specs/tr/extraction-provenance-subgraph.tr.md
diff --git a/docs/tech-specs/extraction-time-provenance.tr.md b/docs/tech-specs/tr/extraction-time-provenance.tr.md
similarity index 100%
rename from docs/tech-specs/extraction-time-provenance.tr.md
rename to docs/tech-specs/tr/extraction-time-provenance.tr.md
diff --git a/docs/tech-specs/flow-class-definition.tr.md b/docs/tech-specs/tr/flow-class-definition.tr.md
similarity index 100%
rename from docs/tech-specs/flow-class-definition.tr.md
rename to docs/tech-specs/tr/flow-class-definition.tr.md
diff --git a/docs/tech-specs/flow-configurable-parameters.tr.md b/docs/tech-specs/tr/flow-configurable-parameters.tr.md
similarity index 100%
rename from docs/tech-specs/flow-configurable-parameters.tr.md
rename to docs/tech-specs/tr/flow-configurable-parameters.tr.md
diff --git a/docs/tech-specs/graph-contexts.tr.md b/docs/tech-specs/tr/graph-contexts.tr.md
similarity index 100%
rename from docs/tech-specs/graph-contexts.tr.md
rename to docs/tech-specs/tr/graph-contexts.tr.md
diff --git a/docs/tech-specs/graphql-query.tr.md b/docs/tech-specs/tr/graphql-query.tr.md
similarity index 100%
rename from docs/tech-specs/graphql-query.tr.md
rename to docs/tech-specs/tr/graphql-query.tr.md
diff --git a/docs/tech-specs/graphrag-performance-optimization.tr.md b/docs/tech-specs/tr/graphrag-performance-optimization.tr.md
similarity index 100%
rename from docs/tech-specs/graphrag-performance-optimization.tr.md
rename to docs/tech-specs/tr/graphrag-performance-optimization.tr.md
diff --git a/docs/tech-specs/import-export-graceful-shutdown.tr.md b/docs/tech-specs/tr/import-export-graceful-shutdown.tr.md
similarity index 100%
rename from docs/tech-specs/import-export-graceful-shutdown.tr.md
rename to docs/tech-specs/tr/import-export-graceful-shutdown.tr.md
diff --git a/docs/tech-specs/jsonl-prompt-output.tr.md b/docs/tech-specs/tr/jsonl-prompt-output.tr.md
similarity index 100%
rename from docs/tech-specs/jsonl-prompt-output.tr.md
rename to docs/tech-specs/tr/jsonl-prompt-output.tr.md
diff --git a/docs/tech-specs/large-document-loading.tr.md b/docs/tech-specs/tr/large-document-loading.tr.md
similarity index 100%
rename from docs/tech-specs/large-document-loading.tr.md
rename to docs/tech-specs/tr/large-document-loading.tr.md
diff --git a/docs/tech-specs/logging-strategy.tr.md b/docs/tech-specs/tr/logging-strategy.tr.md
similarity index 100%
rename from docs/tech-specs/logging-strategy.tr.md
rename to docs/tech-specs/tr/logging-strategy.tr.md
diff --git a/docs/tech-specs/mcp-tool-arguments.tr.md b/docs/tech-specs/tr/mcp-tool-arguments.tr.md
similarity index 100%
rename from docs/tech-specs/mcp-tool-arguments.tr.md
rename to docs/tech-specs/tr/mcp-tool-arguments.tr.md
diff --git a/docs/tech-specs/mcp-tool-bearer-token.tr.md b/docs/tech-specs/tr/mcp-tool-bearer-token.tr.md
similarity index 100%
rename from docs/tech-specs/mcp-tool-bearer-token.tr.md
rename to docs/tech-specs/tr/mcp-tool-bearer-token.tr.md
diff --git a/docs/tech-specs/minio-to-s3-migration.tr.md b/docs/tech-specs/tr/minio-to-s3-migration.tr.md
similarity index 100%
rename from docs/tech-specs/minio-to-s3-migration.tr.md
rename to docs/tech-specs/tr/minio-to-s3-migration.tr.md
diff --git a/docs/tech-specs/more-config-cli.tr.md b/docs/tech-specs/tr/more-config-cli.tr.md
similarity index 100%
rename from docs/tech-specs/more-config-cli.tr.md
rename to docs/tech-specs/tr/more-config-cli.tr.md
diff --git a/docs/tech-specs/multi-tenant-support.tr.md b/docs/tech-specs/tr/multi-tenant-support.tr.md
similarity index 100%
rename from docs/tech-specs/multi-tenant-support.tr.md
rename to docs/tech-specs/tr/multi-tenant-support.tr.md
diff --git a/docs/tech-specs/neo4j-user-collection-isolation.tr.md b/docs/tech-specs/tr/neo4j-user-collection-isolation.tr.md
similarity index 100%
rename from docs/tech-specs/neo4j-user-collection-isolation.tr.md
rename to docs/tech-specs/tr/neo4j-user-collection-isolation.tr.md
diff --git a/docs/tech-specs/ontology-extract-phase-2.tr.md b/docs/tech-specs/tr/ontology-extract-phase-2.tr.md
similarity index 100%
rename from docs/tech-specs/ontology-extract-phase-2.tr.md
rename to docs/tech-specs/tr/ontology-extract-phase-2.tr.md
diff --git a/docs/tech-specs/ontology.tr.md b/docs/tech-specs/tr/ontology.tr.md
similarity index 100%
rename from docs/tech-specs/ontology.tr.md
rename to docs/tech-specs/tr/ontology.tr.md
diff --git a/docs/tech-specs/ontorag.tr.md b/docs/tech-specs/tr/ontorag.tr.md
similarity index 100%
rename from docs/tech-specs/ontorag.tr.md
rename to docs/tech-specs/tr/ontorag.tr.md
diff --git a/docs/tech-specs/openapi-spec.tr.md b/docs/tech-specs/tr/openapi-spec.tr.md
similarity index 100%
rename from docs/tech-specs/openapi-spec.tr.md
rename to docs/tech-specs/tr/openapi-spec.tr.md
diff --git a/docs/tech-specs/pubsub.tr.md b/docs/tech-specs/tr/pubsub.tr.md
similarity index 100%
rename from docs/tech-specs/pubsub.tr.md
rename to docs/tech-specs/tr/pubsub.tr.md
diff --git a/docs/tech-specs/python-api-refactor.tr.md b/docs/tech-specs/tr/python-api-refactor.tr.md
similarity index 100%
rename from docs/tech-specs/python-api-refactor.tr.md
rename to docs/tech-specs/tr/python-api-refactor.tr.md
diff --git a/docs/tech-specs/query-time-explainability.tr.md b/docs/tech-specs/tr/query-time-explainability.tr.md
similarity index 100%
rename from docs/tech-specs/query-time-explainability.tr.md
rename to docs/tech-specs/tr/query-time-explainability.tr.md
diff --git a/docs/tech-specs/rag-streaming-support.tr.md b/docs/tech-specs/tr/rag-streaming-support.tr.md
similarity index 100%
rename from docs/tech-specs/rag-streaming-support.tr.md
rename to docs/tech-specs/tr/rag-streaming-support.tr.md
diff --git a/docs/tech-specs/schema-refactoring-proposal.tr.md b/docs/tech-specs/tr/schema-refactoring-proposal.tr.md
similarity index 100%
rename from docs/tech-specs/schema-refactoring-proposal.tr.md
rename to docs/tech-specs/tr/schema-refactoring-proposal.tr.md
diff --git a/docs/tech-specs/streaming-llm-responses.tr.md b/docs/tech-specs/tr/streaming-llm-responses.tr.md
similarity index 100%
rename from docs/tech-specs/streaming-llm-responses.tr.md
rename to docs/tech-specs/tr/streaming-llm-responses.tr.md
diff --git a/docs/tech-specs/structured-data-2.tr.md b/docs/tech-specs/tr/structured-data-2.tr.md
similarity index 100%
rename from docs/tech-specs/structured-data-2.tr.md
rename to docs/tech-specs/tr/structured-data-2.tr.md
diff --git a/docs/tech-specs/structured-data-descriptor.tr.md b/docs/tech-specs/tr/structured-data-descriptor.tr.md
similarity index 100%
rename from docs/tech-specs/structured-data-descriptor.tr.md
rename to docs/tech-specs/tr/structured-data-descriptor.tr.md
diff --git a/docs/tech-specs/structured-data-schemas.tr.md b/docs/tech-specs/tr/structured-data-schemas.tr.md
similarity index 100%
rename from docs/tech-specs/structured-data-schemas.tr.md
rename to docs/tech-specs/tr/structured-data-schemas.tr.md
diff --git a/docs/tech-specs/structured-data.tr.md b/docs/tech-specs/tr/structured-data.tr.md
similarity index 100%
rename from docs/tech-specs/structured-data.tr.md
rename to docs/tech-specs/tr/structured-data.tr.md
diff --git a/docs/tech-specs/structured-diag-service.tr.md b/docs/tech-specs/tr/structured-diag-service.tr.md
similarity index 100%
rename from docs/tech-specs/structured-diag-service.tr.md
rename to docs/tech-specs/tr/structured-diag-service.tr.md
diff --git a/docs/tech-specs/tool-group.tr.md b/docs/tech-specs/tr/tool-group.tr.md
similarity index 100%
rename from docs/tech-specs/tool-group.tr.md
rename to docs/tech-specs/tr/tool-group.tr.md
diff --git a/docs/tech-specs/tool-services.tr.md b/docs/tech-specs/tr/tool-services.tr.md
similarity index 100%
rename from docs/tech-specs/tool-services.tr.md
rename to docs/tech-specs/tr/tool-services.tr.md
diff --git a/docs/tech-specs/universal-decoder.tr.md b/docs/tech-specs/tr/universal-decoder.tr.md
similarity index 100%
rename from docs/tech-specs/universal-decoder.tr.md
rename to docs/tech-specs/tr/universal-decoder.tr.md
diff --git a/docs/tech-specs/vector-store-lifecycle.tr.md b/docs/tech-specs/tr/vector-store-lifecycle.tr.md
similarity index 100%
rename from docs/tech-specs/vector-store-lifecycle.tr.md
rename to docs/tech-specs/tr/vector-store-lifecycle.tr.md
diff --git a/docs/tech-specs/__TEMPLATE.zh-cn.md b/docs/tech-specs/zh-cn/__TEMPLATE.zh-cn.md
similarity index 100%
rename from docs/tech-specs/__TEMPLATE.zh-cn.md
rename to docs/tech-specs/zh-cn/__TEMPLATE.zh-cn.md
diff --git a/docs/tech-specs/agent-explainability.zh-cn.md b/docs/tech-specs/zh-cn/agent-explainability.zh-cn.md
similarity index 100%
rename from docs/tech-specs/agent-explainability.zh-cn.md
rename to docs/tech-specs/zh-cn/agent-explainability.zh-cn.md
diff --git a/docs/tech-specs/architecture-principles.zh-cn.md b/docs/tech-specs/zh-cn/architecture-principles.zh-cn.md
similarity index 100%
rename from docs/tech-specs/architecture-principles.zh-cn.md
rename to docs/tech-specs/zh-cn/architecture-principles.zh-cn.md
diff --git a/docs/tech-specs/cassandra-consolidation.zh-cn.md b/docs/tech-specs/zh-cn/cassandra-consolidation.zh-cn.md
similarity index 100%
rename from docs/tech-specs/cassandra-consolidation.zh-cn.md
rename to docs/tech-specs/zh-cn/cassandra-consolidation.zh-cn.md
diff --git a/docs/tech-specs/cassandra-performance-refactor.zh-cn.md b/docs/tech-specs/zh-cn/cassandra-performance-refactor.zh-cn.md
similarity index 100%
rename from docs/tech-specs/cassandra-performance-refactor.zh-cn.md
rename to docs/tech-specs/zh-cn/cassandra-performance-refactor.zh-cn.md
diff --git a/docs/tech-specs/collection-management.zh-cn.md b/docs/tech-specs/zh-cn/collection-management.zh-cn.md
similarity index 100%
rename from docs/tech-specs/collection-management.zh-cn.md
rename to docs/tech-specs/zh-cn/collection-management.zh-cn.md
diff --git a/docs/tech-specs/document-embeddings-chunk-id.zh-cn.md b/docs/tech-specs/zh-cn/document-embeddings-chunk-id.zh-cn.md
similarity index 100%
rename from docs/tech-specs/document-embeddings-chunk-id.zh-cn.md
rename to docs/tech-specs/zh-cn/document-embeddings-chunk-id.zh-cn.md
diff --git a/docs/tech-specs/embeddings-batch-processing.zh-cn.md b/docs/tech-specs/zh-cn/embeddings-batch-processing.zh-cn.md
similarity index 100%
rename from docs/tech-specs/embeddings-batch-processing.zh-cn.md
rename to docs/tech-specs/zh-cn/embeddings-batch-processing.zh-cn.md
diff --git a/docs/tech-specs/entity-centric-graph.zh-cn.md b/docs/tech-specs/zh-cn/entity-centric-graph.zh-cn.md
similarity index 100%
rename from docs/tech-specs/entity-centric-graph.zh-cn.md
rename to docs/tech-specs/zh-cn/entity-centric-graph.zh-cn.md
diff --git a/docs/tech-specs/explainability-cli.zh-cn.md b/docs/tech-specs/zh-cn/explainability-cli.zh-cn.md
similarity index 100%
rename from docs/tech-specs/explainability-cli.zh-cn.md
rename to docs/tech-specs/zh-cn/explainability-cli.zh-cn.md
diff --git a/docs/tech-specs/extraction-flows.zh-cn.md b/docs/tech-specs/zh-cn/extraction-flows.zh-cn.md
similarity index 100%
rename from docs/tech-specs/extraction-flows.zh-cn.md
rename to docs/tech-specs/zh-cn/extraction-flows.zh-cn.md
diff --git a/docs/tech-specs/extraction-provenance-subgraph.zh-cn.md b/docs/tech-specs/zh-cn/extraction-provenance-subgraph.zh-cn.md
similarity index 100%
rename from docs/tech-specs/extraction-provenance-subgraph.zh-cn.md
rename to docs/tech-specs/zh-cn/extraction-provenance-subgraph.zh-cn.md
diff --git a/docs/tech-specs/extraction-time-provenance.zh-cn.md b/docs/tech-specs/zh-cn/extraction-time-provenance.zh-cn.md
similarity index 100%
rename from docs/tech-specs/extraction-time-provenance.zh-cn.md
rename to docs/tech-specs/zh-cn/extraction-time-provenance.zh-cn.md
diff --git a/docs/tech-specs/flow-class-definition.zh-cn.md b/docs/tech-specs/zh-cn/flow-class-definition.zh-cn.md
similarity index 100%
rename from docs/tech-specs/flow-class-definition.zh-cn.md
rename to docs/tech-specs/zh-cn/flow-class-definition.zh-cn.md
diff --git a/docs/tech-specs/flow-configurable-parameters.zh-cn.md b/docs/tech-specs/zh-cn/flow-configurable-parameters.zh-cn.md
similarity index 100%
rename from docs/tech-specs/flow-configurable-parameters.zh-cn.md
rename to docs/tech-specs/zh-cn/flow-configurable-parameters.zh-cn.md
diff --git a/docs/tech-specs/graph-contexts.zh-cn.md b/docs/tech-specs/zh-cn/graph-contexts.zh-cn.md
similarity index 100%
rename from docs/tech-specs/graph-contexts.zh-cn.md
rename to docs/tech-specs/zh-cn/graph-contexts.zh-cn.md
diff --git a/docs/tech-specs/graphql-query.zh-cn.md b/docs/tech-specs/zh-cn/graphql-query.zh-cn.md
similarity index 100%
rename from docs/tech-specs/graphql-query.zh-cn.md
rename to docs/tech-specs/zh-cn/graphql-query.zh-cn.md
diff --git a/docs/tech-specs/graphrag-performance-optimization.zh-cn.md b/docs/tech-specs/zh-cn/graphrag-performance-optimization.zh-cn.md
similarity index 100%
rename from docs/tech-specs/graphrag-performance-optimization.zh-cn.md
rename to docs/tech-specs/zh-cn/graphrag-performance-optimization.zh-cn.md
diff --git a/docs/tech-specs/import-export-graceful-shutdown.zh-cn.md b/docs/tech-specs/zh-cn/import-export-graceful-shutdown.zh-cn.md
similarity index 100%
rename from docs/tech-specs/import-export-graceful-shutdown.zh-cn.md
rename to docs/tech-specs/zh-cn/import-export-graceful-shutdown.zh-cn.md
diff --git a/docs/tech-specs/jsonl-prompt-output.zh-cn.md b/docs/tech-specs/zh-cn/jsonl-prompt-output.zh-cn.md
similarity index 100%
rename from docs/tech-specs/jsonl-prompt-output.zh-cn.md
rename to docs/tech-specs/zh-cn/jsonl-prompt-output.zh-cn.md
diff --git a/docs/tech-specs/large-document-loading.zh-cn.md b/docs/tech-specs/zh-cn/large-document-loading.zh-cn.md
similarity index 100%
rename from docs/tech-specs/large-document-loading.zh-cn.md
rename to docs/tech-specs/zh-cn/large-document-loading.zh-cn.md
diff --git a/docs/tech-specs/logging-strategy.zh-cn.md b/docs/tech-specs/zh-cn/logging-strategy.zh-cn.md
similarity index 100%
rename from docs/tech-specs/logging-strategy.zh-cn.md
rename to docs/tech-specs/zh-cn/logging-strategy.zh-cn.md
diff --git a/docs/tech-specs/mcp-tool-arguments.zh-cn.md b/docs/tech-specs/zh-cn/mcp-tool-arguments.zh-cn.md
similarity index 100%
rename from docs/tech-specs/mcp-tool-arguments.zh-cn.md
rename to docs/tech-specs/zh-cn/mcp-tool-arguments.zh-cn.md
diff --git a/docs/tech-specs/mcp-tool-bearer-token.zh-cn.md b/docs/tech-specs/zh-cn/mcp-tool-bearer-token.zh-cn.md
similarity index 100%
rename from docs/tech-specs/mcp-tool-bearer-token.zh-cn.md
rename to docs/tech-specs/zh-cn/mcp-tool-bearer-token.zh-cn.md
diff --git a/docs/tech-specs/minio-to-s3-migration.zh-cn.md b/docs/tech-specs/zh-cn/minio-to-s3-migration.zh-cn.md
similarity index 100%
rename from docs/tech-specs/minio-to-s3-migration.zh-cn.md
rename to docs/tech-specs/zh-cn/minio-to-s3-migration.zh-cn.md
diff --git a/docs/tech-specs/more-config-cli.zh-cn.md b/docs/tech-specs/zh-cn/more-config-cli.zh-cn.md
similarity index 100%
rename from docs/tech-specs/more-config-cli.zh-cn.md
rename to docs/tech-specs/zh-cn/more-config-cli.zh-cn.md
diff --git a/docs/tech-specs/multi-tenant-support.zh-cn.md b/docs/tech-specs/zh-cn/multi-tenant-support.zh-cn.md
similarity index 100%
rename from docs/tech-specs/multi-tenant-support.zh-cn.md
rename to docs/tech-specs/zh-cn/multi-tenant-support.zh-cn.md
diff --git a/docs/tech-specs/neo4j-user-collection-isolation.zh-cn.md b/docs/tech-specs/zh-cn/neo4j-user-collection-isolation.zh-cn.md
similarity index 100%
rename from docs/tech-specs/neo4j-user-collection-isolation.zh-cn.md
rename to docs/tech-specs/zh-cn/neo4j-user-collection-isolation.zh-cn.md
diff --git a/docs/tech-specs/ontology-extract-phase-2.zh-cn.md b/docs/tech-specs/zh-cn/ontology-extract-phase-2.zh-cn.md
similarity index 100%
rename from docs/tech-specs/ontology-extract-phase-2.zh-cn.md
rename to docs/tech-specs/zh-cn/ontology-extract-phase-2.zh-cn.md
diff --git a/docs/tech-specs/ontology.zh-cn.md b/docs/tech-specs/zh-cn/ontology.zh-cn.md
similarity index 100%
rename from docs/tech-specs/ontology.zh-cn.md
rename to docs/tech-specs/zh-cn/ontology.zh-cn.md
diff --git a/docs/tech-specs/ontorag.zh-cn.md b/docs/tech-specs/zh-cn/ontorag.zh-cn.md
similarity index 100%
rename from docs/tech-specs/ontorag.zh-cn.md
rename to docs/tech-specs/zh-cn/ontorag.zh-cn.md
diff --git a/docs/tech-specs/openapi-spec.zh-cn.md b/docs/tech-specs/zh-cn/openapi-spec.zh-cn.md
similarity index 100%
rename from docs/tech-specs/openapi-spec.zh-cn.md
rename to docs/tech-specs/zh-cn/openapi-spec.zh-cn.md
diff --git a/docs/tech-specs/pubsub.zh-cn.md b/docs/tech-specs/zh-cn/pubsub.zh-cn.md
similarity index 100%
rename from docs/tech-specs/pubsub.zh-cn.md
rename to docs/tech-specs/zh-cn/pubsub.zh-cn.md
diff --git a/docs/tech-specs/python-api-refactor.zh-cn.md b/docs/tech-specs/zh-cn/python-api-refactor.zh-cn.md
similarity index 100%
rename from docs/tech-specs/python-api-refactor.zh-cn.md
rename to docs/tech-specs/zh-cn/python-api-refactor.zh-cn.md
diff --git a/docs/tech-specs/query-time-explainability.zh-cn.md b/docs/tech-specs/zh-cn/query-time-explainability.zh-cn.md
similarity index 100%
rename from docs/tech-specs/query-time-explainability.zh-cn.md
rename to docs/tech-specs/zh-cn/query-time-explainability.zh-cn.md
diff --git a/docs/tech-specs/rag-streaming-support.zh-cn.md b/docs/tech-specs/zh-cn/rag-streaming-support.zh-cn.md
similarity index 100%
rename from docs/tech-specs/rag-streaming-support.zh-cn.md
rename to docs/tech-specs/zh-cn/rag-streaming-support.zh-cn.md
diff --git a/docs/tech-specs/schema-refactoring-proposal.zh-cn.md b/docs/tech-specs/zh-cn/schema-refactoring-proposal.zh-cn.md
similarity index 100%
rename from docs/tech-specs/schema-refactoring-proposal.zh-cn.md
rename to docs/tech-specs/zh-cn/schema-refactoring-proposal.zh-cn.md
diff --git a/docs/tech-specs/streaming-llm-responses.zh-cn.md b/docs/tech-specs/zh-cn/streaming-llm-responses.zh-cn.md
similarity index 100%
rename from docs/tech-specs/streaming-llm-responses.zh-cn.md
rename to docs/tech-specs/zh-cn/streaming-llm-responses.zh-cn.md
diff --git a/docs/tech-specs/structured-data-2.zh-cn.md b/docs/tech-specs/zh-cn/structured-data-2.zh-cn.md
similarity index 100%
rename from docs/tech-specs/structured-data-2.zh-cn.md
rename to docs/tech-specs/zh-cn/structured-data-2.zh-cn.md
diff --git a/docs/tech-specs/structured-data-descriptor.zh-cn.md b/docs/tech-specs/zh-cn/structured-data-descriptor.zh-cn.md
similarity index 100%
rename from docs/tech-specs/structured-data-descriptor.zh-cn.md
rename to docs/tech-specs/zh-cn/structured-data-descriptor.zh-cn.md
diff --git a/docs/tech-specs/structured-data-schemas.zh-cn.md b/docs/tech-specs/zh-cn/structured-data-schemas.zh-cn.md
similarity index 100%
rename from docs/tech-specs/structured-data-schemas.zh-cn.md
rename to docs/tech-specs/zh-cn/structured-data-schemas.zh-cn.md
diff --git a/docs/tech-specs/structured-data.zh-cn.md b/docs/tech-specs/zh-cn/structured-data.zh-cn.md
similarity index 100%
rename from docs/tech-specs/structured-data.zh-cn.md
rename to docs/tech-specs/zh-cn/structured-data.zh-cn.md
diff --git a/docs/tech-specs/structured-diag-service.zh-cn.md b/docs/tech-specs/zh-cn/structured-diag-service.zh-cn.md
similarity index 100%
rename from docs/tech-specs/structured-diag-service.zh-cn.md
rename to docs/tech-specs/zh-cn/structured-diag-service.zh-cn.md
diff --git a/docs/tech-specs/tool-group.zh-cn.md b/docs/tech-specs/zh-cn/tool-group.zh-cn.md
similarity index 100%
rename from docs/tech-specs/tool-group.zh-cn.md
rename to docs/tech-specs/zh-cn/tool-group.zh-cn.md
diff --git a/docs/tech-specs/tool-services.zh-cn.md b/docs/tech-specs/zh-cn/tool-services.zh-cn.md
similarity index 100%
rename from docs/tech-specs/tool-services.zh-cn.md
rename to docs/tech-specs/zh-cn/tool-services.zh-cn.md
diff --git a/docs/tech-specs/universal-decoder.zh-cn.md b/docs/tech-specs/zh-cn/universal-decoder.zh-cn.md
similarity index 100%
rename from docs/tech-specs/universal-decoder.zh-cn.md
rename to docs/tech-specs/zh-cn/universal-decoder.zh-cn.md
diff --git a/docs/tech-specs/vector-store-lifecycle.zh-cn.md b/docs/tech-specs/zh-cn/vector-store-lifecycle.zh-cn.md
similarity index 100%
rename from docs/tech-specs/vector-store-lifecycle.zh-cn.md
rename to docs/tech-specs/zh-cn/vector-store-lifecycle.zh-cn.md