From e0f1d74204f4807bee16794e33b38ed4a91cbd8a Mon Sep 17 00:00:00 2001 From: bQUARKz Date: Wed, 11 Mar 2026 05:22:15 +0000 Subject: [PATCH] clean up --- docs/{ => compiler}/general/README.md | 0 .../general/specs/13. Conformance Test Specification.md | 0 .../specs/14. Name Resolution and Module Linking Specification.md | 0 .../general/specs/15. Bytecode and PBX Mapping Specification.md | 0 .../16. Runtime Execution and Initialization Specification.md | 0 .../general/specs/17. Compatibility and Evolution Policy.md | 0 .../general/specs/18. Standard Library Surface Specification.md | 0 .../specs/19. Verification and Safety Checks Specification.md | 0 .../general/specs/20. IRBackend to IRVM Lowering Specification.md | 0 .../general/specs/21. IRVM Optimization Pipeline Specification.md | 0 .../general/specs/22. Backend Spec-to-Test Conformance Matrix.md | 0 docs/{ => compiler}/general/specs/README.md | 0 docs/{ => compiler}/pbs/README.md | 0 docs/{ => compiler}/pbs/agendas/README.md | 0 .../pbs/decisions/AST Contract and Root Model Decision.md | 0 .../pbs/decisions/AST Declarations and Type Surfaces Decision.md | 0 .../AST Diagnostics, Recovery, and Gate Evidence Decision.md | 0 .../pbs/decisions/AST Statements and Expressions Decision.md | 0 .../pbs/decisions/Allocation and Cost Visibility Decision.md | 0 .../Artifact-Level Conformance and Fixture Model Decision.md | 0 .../Compatibility Matrix and Published Claims Decision.md | 0 .../pbs/decisions/Conformance Claim Levels Decision.md | 0 .../{ => compiler}/pbs/decisions/Diagnostics Contract Decision.md | 0 .../decisions/Dynamic Semantics - Branch Selection Decision.md | 0 .../pbs/decisions/Dynamic Semantics - Effect Surfaces Decision.md | 0 .../pbs/decisions/Dynamic Semantics - Execution Model Decision.md | 0 docs/{ => compiler}/pbs/decisions/GC and Reachability Decision.md | 0 .../{ => compiler}/pbs/decisions/Host Memory Boundary Decision.md | 0 .../pbs/decisions/IRVM Optimization Stage Placement Decision.md | 0 .../decisions/Lifetime Control and Future Profiles Decision.md | 0 .../Name Resolution - Builtin Shells and Host Owners Decision.md | 0 ...esolution - Callable Sets and Cross-Module Linking Decision.md | 0 .../Name Resolution - Linking Phase Boundary Decision.md | 0 .../Name Resolution - Scope, Lookup, and Imports Decision.md | 0 docs/{ => compiler}/pbs/decisions/README.md | 0 .../pbs/decisions/SPAWN-YIELD v1 Claim Rescope Decision.md | 0 .../pbs/decisions/Value Representation and Identity Decision.md | 0 docs/{ => compiler}/pbs/pull-requests/INDEX.md | 0 .../PR-05.0.1-frontend-phase-shared-name-table-context.md | 0 .../PR-05.0.2-module-identity-dense-table-and-moduleid-wiring.md | 0 .../PR-05.0.3-irbackend-typed-callable-and-intrinsic-ids.md | 0 .../PR-05.0.4-callable-shape-and-signature-interning.md | 0 .../PR-05.0.5-synthetic-stdlib-fileid-via-filetable.md | 0 ...R-05.0.6-host-binding-key-interning-and-capability-identity.md | 0 .../PR-05.1-pbs-frontend-semantic-executable-lowering-cfg.md | 0 ...05.2-irbackend-callsite-classification-by-semantic-identity.md | 0 ...R-05.3-irvm-deterministic-function-id-and-entrypoint-policy.md | 0 .../PR-05.4-irvm-program-coherence-without-bypass.md | 0 ...R-05.5-irvm-validator-real-stack-effects-hostcall-intrinsic.md | 0 .../PR-05.6-optimize-irvm-real-deterministic-passes.md | 0 .../PR-05.7-gate-i-runtime-backed-mandatory-in-ci.md | 0 .../PR-05.8-backend-spec-to-test-conformance-matrix.md | 0 ...-06.1-source-attribution-and-diagnostics-evidence-hardening.md | 0 .../PR-06.2-optimize-irvm-semantic-equivalence-harness.md | 0 .../PR-06.3-irvm-ext-contract-and-elimination-fixtures.md | 0 .../pull-requests/PR-06.4-gate-i-runtime-line-repeatability-ci.md | 0 .../pull-requests/PR-06.5-conformance-matrix-hard-gate-policy.md | 0 .../pbs/pull-requests/PR-06.6-spawn-yield-v1-or-claim-rescope.md | 0 .../PR-07.1-optimize-irvm-span-source-hook-preservation.md | 0 ...07.2-pbs-callsite-category-no-textual-heuristics-regression.md | 0 .../PR-07.3-irvm-entrypoint-export-emission-for-runtime-loader.md | 0 .../PR-08.1-intrinsic-resolution-canonical-identity-keying.md | 0 .../PR-08.2-irbackend-moduleid-contract-and-modulepool.md | 0 .../PR-08.3-qualified-entrypoint-identity-contract.md | 0 .../PR-08.4-call-func-callee-module-identity-correctness.md | 0 .../PR-08.5-intrinsic-registry-single-source-sync-with-runtime.md | 0 .../PR-09.1-irbackend-modulekey-hard-removal-from-contract.md | 0 ...9.2-pbs-frontend-moduleid-only-lowering-and-import-surfaces.md | 0 ...irvm-moduleid-only-ordering-and-strict-qualified-entrypoint.md | 0 ...-refresh-moduleid-only-entrypointref-and-bytecode-alignment.md | 0 ....5-hard-gates-no-modulekey-regression-and-migration-cleanup.md | 0 .../PR-09.6-isa-intrinsic-registry-single-source-artifact.md | 0 .../PR-09.7-compiler-normalization-to-isa-registry-artifact.md | 0 .../PR-10.1-pbs-parser-shared-context-and-safe-delegation.md | 0 .../PR-10.2-pbs-parser-attribute-and-type-subparsers.md | 0 .../PR-10.3-pbs-parser-top-level-declaration-decomposition.md | 0 .../PR-10.4-pbs-parser-block-and-statement-decomposition.md | 0 ...10.5-pbs-parser-recovery-utilities-and-regression-hardening.md | 0 ...PR-11.1-pbs-expr-parser-shared-context-and-precedence-spine.md | 0 .../PR-11.2-pbs-expr-parser-control-flow-subparsers.md | 0 ...-expr-parser-postfix-primary-and-construction-decomposition.md | 0 ...bs-expr-parser-literals-patterns-and-shared-token-utilities.md | 0 ...11.5-pbs-expr-parser-regression-hardening-and-final-cleanup.md | 0 ....1-flow-expression-analyzer-context-and-dispatch-foundation.md | 0 ...ession-analyzer-literal-and-structural-expression-splitting.md | 0 ...xpression-analyzer-call-and-member-resolution-decomposition.md | 0 ....4-flow-expression-analyzer-switch-and-handle-decomposition.md | 0 ...-expression-analyzer-regression-hardening-and-final-cleanup.md | 0 ...R-13.1-flow-body-analyzer-context-and-entrypoint-foundation.md | 0 ...ow-body-analyzer-callable-body-and-completion-decomposition.md | 0 .../PR-13.3-flow-body-analyzer-statement-analysis-splitting.md | 0 ...ow-body-analyzer-assignment-target-resolution-decomposition.md | 0 ...5-flow-body-analyzer-regression-hardening-and-final-cleanup.md | 0 docs/{ => compiler}/pbs/pull-requests/README.md | 0 docs/{ => compiler}/pbs/specs/1. Language Charter.md | 0 .../pbs/specs/10. Memory and Lifetime Specification.md | 0 docs/{ => compiler}/pbs/specs/11. AST Specification.md | 0 docs/{ => compiler}/pbs/specs/12. Diagnostics Specification.md | 0 .../pbs/specs/13. Lowering IRBackend Specification.md | 0 docs/{ => compiler}/pbs/specs/2. Governance and Versioning.md | 0 docs/{ => compiler}/pbs/specs/3. Core Syntax Specification.md | 0 .../{ => compiler}/pbs/specs/4. Static Semantics Specification.md | 0 .../5. Manifest, Stdlib, and SDK Resolution Specification.md | 0 docs/{ => compiler}/pbs/specs/6. VM-owned vs Host-backed.md | 0 .../pbs/specs/6.1. Intrinsics and Builtin Types Specification.md | 0 .../6.2. Host ABI Binding and Loader Resolution Specification.md | 0 .... Cartridge Manifest and Runtime Capabilities Specification.md | 0 .../8. Stdlib Environment Packaging and Loading Specification.md | 0 .../pbs/specs/9. Dynamic Semantics Specification.md | 0 docs/{ => compiler}/pbs/specs/README.md | 0 docs/{roadmaps => }/packer/Prometeu Packer.md | 0 docs/roadmaps/packer/.gitkeep | 0 112 files changed, 0 insertions(+), 0 deletions(-) rename docs/{ => compiler}/general/README.md (100%) rename docs/{ => compiler}/general/specs/13. Conformance Test Specification.md (100%) rename docs/{ => compiler}/general/specs/14. Name Resolution and Module Linking Specification.md (100%) rename docs/{ => compiler}/general/specs/15. Bytecode and PBX Mapping Specification.md (100%) rename docs/{ => compiler}/general/specs/16. Runtime Execution and Initialization Specification.md (100%) rename docs/{ => compiler}/general/specs/17. Compatibility and Evolution Policy.md (100%) rename docs/{ => compiler}/general/specs/18. Standard Library Surface Specification.md (100%) rename docs/{ => compiler}/general/specs/19. Verification and Safety Checks Specification.md (100%) rename docs/{ => compiler}/general/specs/20. IRBackend to IRVM Lowering Specification.md (100%) rename docs/{ => compiler}/general/specs/21. IRVM Optimization Pipeline Specification.md (100%) rename docs/{ => compiler}/general/specs/22. Backend Spec-to-Test Conformance Matrix.md (100%) rename docs/{ => compiler}/general/specs/README.md (100%) rename docs/{ => compiler}/pbs/README.md (100%) rename docs/{ => compiler}/pbs/agendas/README.md (100%) rename docs/{ => compiler}/pbs/decisions/AST Contract and Root Model Decision.md (100%) rename docs/{ => compiler}/pbs/decisions/AST Declarations and Type Surfaces Decision.md (100%) rename docs/{ => compiler}/pbs/decisions/AST Diagnostics, Recovery, and Gate Evidence Decision.md (100%) rename docs/{ => compiler}/pbs/decisions/AST Statements and Expressions Decision.md (100%) rename docs/{ => compiler}/pbs/decisions/Allocation and Cost Visibility Decision.md (100%) rename docs/{ => compiler}/pbs/decisions/Artifact-Level Conformance and Fixture Model Decision.md (100%) rename docs/{ => compiler}/pbs/decisions/Compatibility Matrix and Published Claims Decision.md (100%) rename docs/{ => compiler}/pbs/decisions/Conformance Claim Levels Decision.md (100%) rename docs/{ => compiler}/pbs/decisions/Diagnostics Contract Decision.md (100%) rename docs/{ => compiler}/pbs/decisions/Dynamic Semantics - Branch Selection Decision.md (100%) rename docs/{ => compiler}/pbs/decisions/Dynamic Semantics - Effect Surfaces Decision.md (100%) rename docs/{ => compiler}/pbs/decisions/Dynamic Semantics - Execution Model Decision.md (100%) rename docs/{ => compiler}/pbs/decisions/GC and Reachability Decision.md (100%) rename docs/{ => compiler}/pbs/decisions/Host Memory Boundary Decision.md (100%) rename docs/{ => compiler}/pbs/decisions/IRVM Optimization Stage Placement Decision.md (100%) rename docs/{ => compiler}/pbs/decisions/Lifetime Control and Future Profiles Decision.md (100%) rename docs/{ => compiler}/pbs/decisions/Name Resolution - Builtin Shells and Host Owners Decision.md (100%) rename docs/{ => compiler}/pbs/decisions/Name Resolution - Callable Sets and Cross-Module Linking Decision.md (100%) rename docs/{ => compiler}/pbs/decisions/Name Resolution - Linking Phase Boundary Decision.md (100%) rename docs/{ => compiler}/pbs/decisions/Name Resolution - Scope, Lookup, and Imports Decision.md (100%) rename docs/{ => compiler}/pbs/decisions/README.md (100%) rename docs/{ => compiler}/pbs/decisions/SPAWN-YIELD v1 Claim Rescope Decision.md (100%) rename docs/{ => compiler}/pbs/decisions/Value Representation and Identity Decision.md (100%) rename docs/{ => compiler}/pbs/pull-requests/INDEX.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-05.0.1-frontend-phase-shared-name-table-context.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-05.0.2-module-identity-dense-table-and-moduleid-wiring.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-05.0.3-irbackend-typed-callable-and-intrinsic-ids.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-05.0.4-callable-shape-and-signature-interning.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-05.0.5-synthetic-stdlib-fileid-via-filetable.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-05.0.6-host-binding-key-interning-and-capability-identity.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-05.1-pbs-frontend-semantic-executable-lowering-cfg.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-05.2-irbackend-callsite-classification-by-semantic-identity.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-05.3-irvm-deterministic-function-id-and-entrypoint-policy.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-05.4-irvm-program-coherence-without-bypass.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-05.5-irvm-validator-real-stack-effects-hostcall-intrinsic.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-05.6-optimize-irvm-real-deterministic-passes.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-05.7-gate-i-runtime-backed-mandatory-in-ci.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-05.8-backend-spec-to-test-conformance-matrix.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-06.1-source-attribution-and-diagnostics-evidence-hardening.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-06.2-optimize-irvm-semantic-equivalence-harness.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-06.3-irvm-ext-contract-and-elimination-fixtures.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-06.4-gate-i-runtime-line-repeatability-ci.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-06.5-conformance-matrix-hard-gate-policy.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-06.6-spawn-yield-v1-or-claim-rescope.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-07.1-optimize-irvm-span-source-hook-preservation.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-07.2-pbs-callsite-category-no-textual-heuristics-regression.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-07.3-irvm-entrypoint-export-emission-for-runtime-loader.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-08.1-intrinsic-resolution-canonical-identity-keying.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-08.2-irbackend-moduleid-contract-and-modulepool.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-08.3-qualified-entrypoint-identity-contract.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-08.4-call-func-callee-module-identity-correctness.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-08.5-intrinsic-registry-single-source-sync-with-runtime.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-09.1-irbackend-modulekey-hard-removal-from-contract.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-09.2-pbs-frontend-moduleid-only-lowering-and-import-surfaces.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-09.3-lower-to-irvm-moduleid-only-ordering-and-strict-qualified-entrypoint.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-09.4-specs-refresh-moduleid-only-entrypointref-and-bytecode-alignment.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-09.5-hard-gates-no-modulekey-regression-and-migration-cleanup.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-09.6-isa-intrinsic-registry-single-source-artifact.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-09.7-compiler-normalization-to-isa-registry-artifact.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-10.1-pbs-parser-shared-context-and-safe-delegation.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-10.2-pbs-parser-attribute-and-type-subparsers.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-10.3-pbs-parser-top-level-declaration-decomposition.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-10.4-pbs-parser-block-and-statement-decomposition.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-10.5-pbs-parser-recovery-utilities-and-regression-hardening.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-11.1-pbs-expr-parser-shared-context-and-precedence-spine.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-11.2-pbs-expr-parser-control-flow-subparsers.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-11.3-pbs-expr-parser-postfix-primary-and-construction-decomposition.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-11.4-pbs-expr-parser-literals-patterns-and-shared-token-utilities.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-11.5-pbs-expr-parser-regression-hardening-and-final-cleanup.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-12.1-flow-expression-analyzer-context-and-dispatch-foundation.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-12.2-flow-expression-analyzer-literal-and-structural-expression-splitting.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-12.3-flow-expression-analyzer-call-and-member-resolution-decomposition.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-12.4-flow-expression-analyzer-switch-and-handle-decomposition.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-12.5-flow-expression-analyzer-regression-hardening-and-final-cleanup.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-13.1-flow-body-analyzer-context-and-entrypoint-foundation.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-13.2-flow-body-analyzer-callable-body-and-completion-decomposition.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-13.3-flow-body-analyzer-statement-analysis-splitting.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-13.4-flow-body-analyzer-assignment-target-resolution-decomposition.md (100%) rename docs/{ => compiler}/pbs/pull-requests/PR-13.5-flow-body-analyzer-regression-hardening-and-final-cleanup.md (100%) rename docs/{ => compiler}/pbs/pull-requests/README.md (100%) rename docs/{ => compiler}/pbs/specs/1. Language Charter.md (100%) rename docs/{ => compiler}/pbs/specs/10. Memory and Lifetime Specification.md (100%) rename docs/{ => compiler}/pbs/specs/11. AST Specification.md (100%) rename docs/{ => compiler}/pbs/specs/12. Diagnostics Specification.md (100%) rename docs/{ => compiler}/pbs/specs/13. Lowering IRBackend Specification.md (100%) rename docs/{ => compiler}/pbs/specs/2. Governance and Versioning.md (100%) rename docs/{ => compiler}/pbs/specs/3. Core Syntax Specification.md (100%) rename docs/{ => compiler}/pbs/specs/4. Static Semantics Specification.md (100%) rename docs/{ => compiler}/pbs/specs/5. Manifest, Stdlib, and SDK Resolution Specification.md (100%) rename docs/{ => compiler}/pbs/specs/6. VM-owned vs Host-backed.md (100%) rename docs/{ => compiler}/pbs/specs/6.1. Intrinsics and Builtin Types Specification.md (100%) rename docs/{ => compiler}/pbs/specs/6.2. Host ABI Binding and Loader Resolution Specification.md (100%) rename docs/{ => compiler}/pbs/specs/7. Cartridge Manifest and Runtime Capabilities Specification.md (100%) rename docs/{ => compiler}/pbs/specs/8. Stdlib Environment Packaging and Loading Specification.md (100%) rename docs/{ => compiler}/pbs/specs/9. Dynamic Semantics Specification.md (100%) rename docs/{ => compiler}/pbs/specs/README.md (100%) rename docs/{roadmaps => }/packer/Prometeu Packer.md (100%) delete mode 100644 docs/roadmaps/packer/.gitkeep diff --git a/docs/general/README.md b/docs/compiler/general/README.md similarity index 100% rename from docs/general/README.md rename to docs/compiler/general/README.md diff --git a/docs/general/specs/13. Conformance Test Specification.md b/docs/compiler/general/specs/13. Conformance Test Specification.md similarity index 100% rename from docs/general/specs/13. Conformance Test Specification.md rename to docs/compiler/general/specs/13. Conformance Test Specification.md diff --git a/docs/general/specs/14. Name Resolution and Module Linking Specification.md b/docs/compiler/general/specs/14. Name Resolution and Module Linking Specification.md similarity index 100% rename from docs/general/specs/14. Name Resolution and Module Linking Specification.md rename to docs/compiler/general/specs/14. Name Resolution and Module Linking Specification.md diff --git a/docs/general/specs/15. Bytecode and PBX Mapping Specification.md b/docs/compiler/general/specs/15. Bytecode and PBX Mapping Specification.md similarity index 100% rename from docs/general/specs/15. Bytecode and PBX Mapping Specification.md rename to docs/compiler/general/specs/15. Bytecode and PBX Mapping Specification.md diff --git a/docs/general/specs/16. Runtime Execution and Initialization Specification.md b/docs/compiler/general/specs/16. Runtime Execution and Initialization Specification.md similarity index 100% rename from docs/general/specs/16. Runtime Execution and Initialization Specification.md rename to docs/compiler/general/specs/16. Runtime Execution and Initialization Specification.md diff --git a/docs/general/specs/17. Compatibility and Evolution Policy.md b/docs/compiler/general/specs/17. Compatibility and Evolution Policy.md similarity index 100% rename from docs/general/specs/17. Compatibility and Evolution Policy.md rename to docs/compiler/general/specs/17. Compatibility and Evolution Policy.md diff --git a/docs/general/specs/18. Standard Library Surface Specification.md b/docs/compiler/general/specs/18. Standard Library Surface Specification.md similarity index 100% rename from docs/general/specs/18. Standard Library Surface Specification.md rename to docs/compiler/general/specs/18. Standard Library Surface Specification.md diff --git a/docs/general/specs/19. Verification and Safety Checks Specification.md b/docs/compiler/general/specs/19. Verification and Safety Checks Specification.md similarity index 100% rename from docs/general/specs/19. Verification and Safety Checks Specification.md rename to docs/compiler/general/specs/19. Verification and Safety Checks Specification.md diff --git a/docs/general/specs/20. IRBackend to IRVM Lowering Specification.md b/docs/compiler/general/specs/20. IRBackend to IRVM Lowering Specification.md similarity index 100% rename from docs/general/specs/20. IRBackend to IRVM Lowering Specification.md rename to docs/compiler/general/specs/20. IRBackend to IRVM Lowering Specification.md diff --git a/docs/general/specs/21. IRVM Optimization Pipeline Specification.md b/docs/compiler/general/specs/21. IRVM Optimization Pipeline Specification.md similarity index 100% rename from docs/general/specs/21. IRVM Optimization Pipeline Specification.md rename to docs/compiler/general/specs/21. IRVM Optimization Pipeline Specification.md diff --git a/docs/general/specs/22. Backend Spec-to-Test Conformance Matrix.md b/docs/compiler/general/specs/22. Backend Spec-to-Test Conformance Matrix.md similarity index 100% rename from docs/general/specs/22. Backend Spec-to-Test Conformance Matrix.md rename to docs/compiler/general/specs/22. Backend Spec-to-Test Conformance Matrix.md diff --git a/docs/general/specs/README.md b/docs/compiler/general/specs/README.md similarity index 100% rename from docs/general/specs/README.md rename to docs/compiler/general/specs/README.md diff --git a/docs/pbs/README.md b/docs/compiler/pbs/README.md similarity index 100% rename from docs/pbs/README.md rename to docs/compiler/pbs/README.md diff --git a/docs/pbs/agendas/README.md b/docs/compiler/pbs/agendas/README.md similarity index 100% rename from docs/pbs/agendas/README.md rename to docs/compiler/pbs/agendas/README.md diff --git a/docs/pbs/decisions/AST Contract and Root Model Decision.md b/docs/compiler/pbs/decisions/AST Contract and Root Model Decision.md similarity index 100% rename from docs/pbs/decisions/AST Contract and Root Model Decision.md rename to docs/compiler/pbs/decisions/AST Contract and Root Model Decision.md diff --git a/docs/pbs/decisions/AST Declarations and Type Surfaces Decision.md b/docs/compiler/pbs/decisions/AST Declarations and Type Surfaces Decision.md similarity index 100% rename from docs/pbs/decisions/AST Declarations and Type Surfaces Decision.md rename to docs/compiler/pbs/decisions/AST Declarations and Type Surfaces Decision.md diff --git a/docs/pbs/decisions/AST Diagnostics, Recovery, and Gate Evidence Decision.md b/docs/compiler/pbs/decisions/AST Diagnostics, Recovery, and Gate Evidence Decision.md similarity index 100% rename from docs/pbs/decisions/AST Diagnostics, Recovery, and Gate Evidence Decision.md rename to docs/compiler/pbs/decisions/AST Diagnostics, Recovery, and Gate Evidence Decision.md diff --git a/docs/pbs/decisions/AST Statements and Expressions Decision.md b/docs/compiler/pbs/decisions/AST Statements and Expressions Decision.md similarity index 100% rename from docs/pbs/decisions/AST Statements and Expressions Decision.md rename to docs/compiler/pbs/decisions/AST Statements and Expressions Decision.md diff --git a/docs/pbs/decisions/Allocation and Cost Visibility Decision.md b/docs/compiler/pbs/decisions/Allocation and Cost Visibility Decision.md similarity index 100% rename from docs/pbs/decisions/Allocation and Cost Visibility Decision.md rename to docs/compiler/pbs/decisions/Allocation and Cost Visibility Decision.md diff --git a/docs/pbs/decisions/Artifact-Level Conformance and Fixture Model Decision.md b/docs/compiler/pbs/decisions/Artifact-Level Conformance and Fixture Model Decision.md similarity index 100% rename from docs/pbs/decisions/Artifact-Level Conformance and Fixture Model Decision.md rename to docs/compiler/pbs/decisions/Artifact-Level Conformance and Fixture Model Decision.md diff --git a/docs/pbs/decisions/Compatibility Matrix and Published Claims Decision.md b/docs/compiler/pbs/decisions/Compatibility Matrix and Published Claims Decision.md similarity index 100% rename from docs/pbs/decisions/Compatibility Matrix and Published Claims Decision.md rename to docs/compiler/pbs/decisions/Compatibility Matrix and Published Claims Decision.md diff --git a/docs/pbs/decisions/Conformance Claim Levels Decision.md b/docs/compiler/pbs/decisions/Conformance Claim Levels Decision.md similarity index 100% rename from docs/pbs/decisions/Conformance Claim Levels Decision.md rename to docs/compiler/pbs/decisions/Conformance Claim Levels Decision.md diff --git a/docs/pbs/decisions/Diagnostics Contract Decision.md b/docs/compiler/pbs/decisions/Diagnostics Contract Decision.md similarity index 100% rename from docs/pbs/decisions/Diagnostics Contract Decision.md rename to docs/compiler/pbs/decisions/Diagnostics Contract Decision.md diff --git a/docs/pbs/decisions/Dynamic Semantics - Branch Selection Decision.md b/docs/compiler/pbs/decisions/Dynamic Semantics - Branch Selection Decision.md similarity index 100% rename from docs/pbs/decisions/Dynamic Semantics - Branch Selection Decision.md rename to docs/compiler/pbs/decisions/Dynamic Semantics - Branch Selection Decision.md diff --git a/docs/pbs/decisions/Dynamic Semantics - Effect Surfaces Decision.md b/docs/compiler/pbs/decisions/Dynamic Semantics - Effect Surfaces Decision.md similarity index 100% rename from docs/pbs/decisions/Dynamic Semantics - Effect Surfaces Decision.md rename to docs/compiler/pbs/decisions/Dynamic Semantics - Effect Surfaces Decision.md diff --git a/docs/pbs/decisions/Dynamic Semantics - Execution Model Decision.md b/docs/compiler/pbs/decisions/Dynamic Semantics - Execution Model Decision.md similarity index 100% rename from docs/pbs/decisions/Dynamic Semantics - Execution Model Decision.md rename to docs/compiler/pbs/decisions/Dynamic Semantics - Execution Model Decision.md diff --git a/docs/pbs/decisions/GC and Reachability Decision.md b/docs/compiler/pbs/decisions/GC and Reachability Decision.md similarity index 100% rename from docs/pbs/decisions/GC and Reachability Decision.md rename to docs/compiler/pbs/decisions/GC and Reachability Decision.md diff --git a/docs/pbs/decisions/Host Memory Boundary Decision.md b/docs/compiler/pbs/decisions/Host Memory Boundary Decision.md similarity index 100% rename from docs/pbs/decisions/Host Memory Boundary Decision.md rename to docs/compiler/pbs/decisions/Host Memory Boundary Decision.md diff --git a/docs/pbs/decisions/IRVM Optimization Stage Placement Decision.md b/docs/compiler/pbs/decisions/IRVM Optimization Stage Placement Decision.md similarity index 100% rename from docs/pbs/decisions/IRVM Optimization Stage Placement Decision.md rename to docs/compiler/pbs/decisions/IRVM Optimization Stage Placement Decision.md diff --git a/docs/pbs/decisions/Lifetime Control and Future Profiles Decision.md b/docs/compiler/pbs/decisions/Lifetime Control and Future Profiles Decision.md similarity index 100% rename from docs/pbs/decisions/Lifetime Control and Future Profiles Decision.md rename to docs/compiler/pbs/decisions/Lifetime Control and Future Profiles Decision.md diff --git a/docs/pbs/decisions/Name Resolution - Builtin Shells and Host Owners Decision.md b/docs/compiler/pbs/decisions/Name Resolution - Builtin Shells and Host Owners Decision.md similarity index 100% rename from docs/pbs/decisions/Name Resolution - Builtin Shells and Host Owners Decision.md rename to docs/compiler/pbs/decisions/Name Resolution - Builtin Shells and Host Owners Decision.md diff --git a/docs/pbs/decisions/Name Resolution - Callable Sets and Cross-Module Linking Decision.md b/docs/compiler/pbs/decisions/Name Resolution - Callable Sets and Cross-Module Linking Decision.md similarity index 100% rename from docs/pbs/decisions/Name Resolution - Callable Sets and Cross-Module Linking Decision.md rename to docs/compiler/pbs/decisions/Name Resolution - Callable Sets and Cross-Module Linking Decision.md diff --git a/docs/pbs/decisions/Name Resolution - Linking Phase Boundary Decision.md b/docs/compiler/pbs/decisions/Name Resolution - Linking Phase Boundary Decision.md similarity index 100% rename from docs/pbs/decisions/Name Resolution - Linking Phase Boundary Decision.md rename to docs/compiler/pbs/decisions/Name Resolution - Linking Phase Boundary Decision.md diff --git a/docs/pbs/decisions/Name Resolution - Scope, Lookup, and Imports Decision.md b/docs/compiler/pbs/decisions/Name Resolution - Scope, Lookup, and Imports Decision.md similarity index 100% rename from docs/pbs/decisions/Name Resolution - Scope, Lookup, and Imports Decision.md rename to docs/compiler/pbs/decisions/Name Resolution - Scope, Lookup, and Imports Decision.md diff --git a/docs/pbs/decisions/README.md b/docs/compiler/pbs/decisions/README.md similarity index 100% rename from docs/pbs/decisions/README.md rename to docs/compiler/pbs/decisions/README.md diff --git a/docs/pbs/decisions/SPAWN-YIELD v1 Claim Rescope Decision.md b/docs/compiler/pbs/decisions/SPAWN-YIELD v1 Claim Rescope Decision.md similarity index 100% rename from docs/pbs/decisions/SPAWN-YIELD v1 Claim Rescope Decision.md rename to docs/compiler/pbs/decisions/SPAWN-YIELD v1 Claim Rescope Decision.md diff --git a/docs/pbs/decisions/Value Representation and Identity Decision.md b/docs/compiler/pbs/decisions/Value Representation and Identity Decision.md similarity index 100% rename from docs/pbs/decisions/Value Representation and Identity Decision.md rename to docs/compiler/pbs/decisions/Value Representation and Identity Decision.md diff --git a/docs/pbs/pull-requests/INDEX.md b/docs/compiler/pbs/pull-requests/INDEX.md similarity index 100% rename from docs/pbs/pull-requests/INDEX.md rename to docs/compiler/pbs/pull-requests/INDEX.md diff --git a/docs/pbs/pull-requests/PR-05.0.1-frontend-phase-shared-name-table-context.md b/docs/compiler/pbs/pull-requests/PR-05.0.1-frontend-phase-shared-name-table-context.md similarity index 100% rename from docs/pbs/pull-requests/PR-05.0.1-frontend-phase-shared-name-table-context.md rename to docs/compiler/pbs/pull-requests/PR-05.0.1-frontend-phase-shared-name-table-context.md diff --git a/docs/pbs/pull-requests/PR-05.0.2-module-identity-dense-table-and-moduleid-wiring.md b/docs/compiler/pbs/pull-requests/PR-05.0.2-module-identity-dense-table-and-moduleid-wiring.md similarity index 100% rename from docs/pbs/pull-requests/PR-05.0.2-module-identity-dense-table-and-moduleid-wiring.md rename to docs/compiler/pbs/pull-requests/PR-05.0.2-module-identity-dense-table-and-moduleid-wiring.md diff --git a/docs/pbs/pull-requests/PR-05.0.3-irbackend-typed-callable-and-intrinsic-ids.md b/docs/compiler/pbs/pull-requests/PR-05.0.3-irbackend-typed-callable-and-intrinsic-ids.md similarity index 100% rename from docs/pbs/pull-requests/PR-05.0.3-irbackend-typed-callable-and-intrinsic-ids.md rename to docs/compiler/pbs/pull-requests/PR-05.0.3-irbackend-typed-callable-and-intrinsic-ids.md diff --git a/docs/pbs/pull-requests/PR-05.0.4-callable-shape-and-signature-interning.md b/docs/compiler/pbs/pull-requests/PR-05.0.4-callable-shape-and-signature-interning.md similarity index 100% rename from docs/pbs/pull-requests/PR-05.0.4-callable-shape-and-signature-interning.md rename to docs/compiler/pbs/pull-requests/PR-05.0.4-callable-shape-and-signature-interning.md diff --git a/docs/pbs/pull-requests/PR-05.0.5-synthetic-stdlib-fileid-via-filetable.md b/docs/compiler/pbs/pull-requests/PR-05.0.5-synthetic-stdlib-fileid-via-filetable.md similarity index 100% rename from docs/pbs/pull-requests/PR-05.0.5-synthetic-stdlib-fileid-via-filetable.md rename to docs/compiler/pbs/pull-requests/PR-05.0.5-synthetic-stdlib-fileid-via-filetable.md diff --git a/docs/pbs/pull-requests/PR-05.0.6-host-binding-key-interning-and-capability-identity.md b/docs/compiler/pbs/pull-requests/PR-05.0.6-host-binding-key-interning-and-capability-identity.md similarity index 100% rename from docs/pbs/pull-requests/PR-05.0.6-host-binding-key-interning-and-capability-identity.md rename to docs/compiler/pbs/pull-requests/PR-05.0.6-host-binding-key-interning-and-capability-identity.md diff --git a/docs/pbs/pull-requests/PR-05.1-pbs-frontend-semantic-executable-lowering-cfg.md b/docs/compiler/pbs/pull-requests/PR-05.1-pbs-frontend-semantic-executable-lowering-cfg.md similarity index 100% rename from docs/pbs/pull-requests/PR-05.1-pbs-frontend-semantic-executable-lowering-cfg.md rename to docs/compiler/pbs/pull-requests/PR-05.1-pbs-frontend-semantic-executable-lowering-cfg.md diff --git a/docs/pbs/pull-requests/PR-05.2-irbackend-callsite-classification-by-semantic-identity.md b/docs/compiler/pbs/pull-requests/PR-05.2-irbackend-callsite-classification-by-semantic-identity.md similarity index 100% rename from docs/pbs/pull-requests/PR-05.2-irbackend-callsite-classification-by-semantic-identity.md rename to docs/compiler/pbs/pull-requests/PR-05.2-irbackend-callsite-classification-by-semantic-identity.md diff --git a/docs/pbs/pull-requests/PR-05.3-irvm-deterministic-function-id-and-entrypoint-policy.md b/docs/compiler/pbs/pull-requests/PR-05.3-irvm-deterministic-function-id-and-entrypoint-policy.md similarity index 100% rename from docs/pbs/pull-requests/PR-05.3-irvm-deterministic-function-id-and-entrypoint-policy.md rename to docs/compiler/pbs/pull-requests/PR-05.3-irvm-deterministic-function-id-and-entrypoint-policy.md diff --git a/docs/pbs/pull-requests/PR-05.4-irvm-program-coherence-without-bypass.md b/docs/compiler/pbs/pull-requests/PR-05.4-irvm-program-coherence-without-bypass.md similarity index 100% rename from docs/pbs/pull-requests/PR-05.4-irvm-program-coherence-without-bypass.md rename to docs/compiler/pbs/pull-requests/PR-05.4-irvm-program-coherence-without-bypass.md diff --git a/docs/pbs/pull-requests/PR-05.5-irvm-validator-real-stack-effects-hostcall-intrinsic.md b/docs/compiler/pbs/pull-requests/PR-05.5-irvm-validator-real-stack-effects-hostcall-intrinsic.md similarity index 100% rename from docs/pbs/pull-requests/PR-05.5-irvm-validator-real-stack-effects-hostcall-intrinsic.md rename to docs/compiler/pbs/pull-requests/PR-05.5-irvm-validator-real-stack-effects-hostcall-intrinsic.md diff --git a/docs/pbs/pull-requests/PR-05.6-optimize-irvm-real-deterministic-passes.md b/docs/compiler/pbs/pull-requests/PR-05.6-optimize-irvm-real-deterministic-passes.md similarity index 100% rename from docs/pbs/pull-requests/PR-05.6-optimize-irvm-real-deterministic-passes.md rename to docs/compiler/pbs/pull-requests/PR-05.6-optimize-irvm-real-deterministic-passes.md diff --git a/docs/pbs/pull-requests/PR-05.7-gate-i-runtime-backed-mandatory-in-ci.md b/docs/compiler/pbs/pull-requests/PR-05.7-gate-i-runtime-backed-mandatory-in-ci.md similarity index 100% rename from docs/pbs/pull-requests/PR-05.7-gate-i-runtime-backed-mandatory-in-ci.md rename to docs/compiler/pbs/pull-requests/PR-05.7-gate-i-runtime-backed-mandatory-in-ci.md diff --git a/docs/pbs/pull-requests/PR-05.8-backend-spec-to-test-conformance-matrix.md b/docs/compiler/pbs/pull-requests/PR-05.8-backend-spec-to-test-conformance-matrix.md similarity index 100% rename from docs/pbs/pull-requests/PR-05.8-backend-spec-to-test-conformance-matrix.md rename to docs/compiler/pbs/pull-requests/PR-05.8-backend-spec-to-test-conformance-matrix.md diff --git a/docs/pbs/pull-requests/PR-06.1-source-attribution-and-diagnostics-evidence-hardening.md b/docs/compiler/pbs/pull-requests/PR-06.1-source-attribution-and-diagnostics-evidence-hardening.md similarity index 100% rename from docs/pbs/pull-requests/PR-06.1-source-attribution-and-diagnostics-evidence-hardening.md rename to docs/compiler/pbs/pull-requests/PR-06.1-source-attribution-and-diagnostics-evidence-hardening.md diff --git a/docs/pbs/pull-requests/PR-06.2-optimize-irvm-semantic-equivalence-harness.md b/docs/compiler/pbs/pull-requests/PR-06.2-optimize-irvm-semantic-equivalence-harness.md similarity index 100% rename from docs/pbs/pull-requests/PR-06.2-optimize-irvm-semantic-equivalence-harness.md rename to docs/compiler/pbs/pull-requests/PR-06.2-optimize-irvm-semantic-equivalence-harness.md diff --git a/docs/pbs/pull-requests/PR-06.3-irvm-ext-contract-and-elimination-fixtures.md b/docs/compiler/pbs/pull-requests/PR-06.3-irvm-ext-contract-and-elimination-fixtures.md similarity index 100% rename from docs/pbs/pull-requests/PR-06.3-irvm-ext-contract-and-elimination-fixtures.md rename to docs/compiler/pbs/pull-requests/PR-06.3-irvm-ext-contract-and-elimination-fixtures.md diff --git a/docs/pbs/pull-requests/PR-06.4-gate-i-runtime-line-repeatability-ci.md b/docs/compiler/pbs/pull-requests/PR-06.4-gate-i-runtime-line-repeatability-ci.md similarity index 100% rename from docs/pbs/pull-requests/PR-06.4-gate-i-runtime-line-repeatability-ci.md rename to docs/compiler/pbs/pull-requests/PR-06.4-gate-i-runtime-line-repeatability-ci.md diff --git a/docs/pbs/pull-requests/PR-06.5-conformance-matrix-hard-gate-policy.md b/docs/compiler/pbs/pull-requests/PR-06.5-conformance-matrix-hard-gate-policy.md similarity index 100% rename from docs/pbs/pull-requests/PR-06.5-conformance-matrix-hard-gate-policy.md rename to docs/compiler/pbs/pull-requests/PR-06.5-conformance-matrix-hard-gate-policy.md diff --git a/docs/pbs/pull-requests/PR-06.6-spawn-yield-v1-or-claim-rescope.md b/docs/compiler/pbs/pull-requests/PR-06.6-spawn-yield-v1-or-claim-rescope.md similarity index 100% rename from docs/pbs/pull-requests/PR-06.6-spawn-yield-v1-or-claim-rescope.md rename to docs/compiler/pbs/pull-requests/PR-06.6-spawn-yield-v1-or-claim-rescope.md diff --git a/docs/pbs/pull-requests/PR-07.1-optimize-irvm-span-source-hook-preservation.md b/docs/compiler/pbs/pull-requests/PR-07.1-optimize-irvm-span-source-hook-preservation.md similarity index 100% rename from docs/pbs/pull-requests/PR-07.1-optimize-irvm-span-source-hook-preservation.md rename to docs/compiler/pbs/pull-requests/PR-07.1-optimize-irvm-span-source-hook-preservation.md diff --git a/docs/pbs/pull-requests/PR-07.2-pbs-callsite-category-no-textual-heuristics-regression.md b/docs/compiler/pbs/pull-requests/PR-07.2-pbs-callsite-category-no-textual-heuristics-regression.md similarity index 100% rename from docs/pbs/pull-requests/PR-07.2-pbs-callsite-category-no-textual-heuristics-regression.md rename to docs/compiler/pbs/pull-requests/PR-07.2-pbs-callsite-category-no-textual-heuristics-regression.md diff --git a/docs/pbs/pull-requests/PR-07.3-irvm-entrypoint-export-emission-for-runtime-loader.md b/docs/compiler/pbs/pull-requests/PR-07.3-irvm-entrypoint-export-emission-for-runtime-loader.md similarity index 100% rename from docs/pbs/pull-requests/PR-07.3-irvm-entrypoint-export-emission-for-runtime-loader.md rename to docs/compiler/pbs/pull-requests/PR-07.3-irvm-entrypoint-export-emission-for-runtime-loader.md diff --git a/docs/pbs/pull-requests/PR-08.1-intrinsic-resolution-canonical-identity-keying.md b/docs/compiler/pbs/pull-requests/PR-08.1-intrinsic-resolution-canonical-identity-keying.md similarity index 100% rename from docs/pbs/pull-requests/PR-08.1-intrinsic-resolution-canonical-identity-keying.md rename to docs/compiler/pbs/pull-requests/PR-08.1-intrinsic-resolution-canonical-identity-keying.md diff --git a/docs/pbs/pull-requests/PR-08.2-irbackend-moduleid-contract-and-modulepool.md b/docs/compiler/pbs/pull-requests/PR-08.2-irbackend-moduleid-contract-and-modulepool.md similarity index 100% rename from docs/pbs/pull-requests/PR-08.2-irbackend-moduleid-contract-and-modulepool.md rename to docs/compiler/pbs/pull-requests/PR-08.2-irbackend-moduleid-contract-and-modulepool.md diff --git a/docs/pbs/pull-requests/PR-08.3-qualified-entrypoint-identity-contract.md b/docs/compiler/pbs/pull-requests/PR-08.3-qualified-entrypoint-identity-contract.md similarity index 100% rename from docs/pbs/pull-requests/PR-08.3-qualified-entrypoint-identity-contract.md rename to docs/compiler/pbs/pull-requests/PR-08.3-qualified-entrypoint-identity-contract.md diff --git a/docs/pbs/pull-requests/PR-08.4-call-func-callee-module-identity-correctness.md b/docs/compiler/pbs/pull-requests/PR-08.4-call-func-callee-module-identity-correctness.md similarity index 100% rename from docs/pbs/pull-requests/PR-08.4-call-func-callee-module-identity-correctness.md rename to docs/compiler/pbs/pull-requests/PR-08.4-call-func-callee-module-identity-correctness.md diff --git a/docs/pbs/pull-requests/PR-08.5-intrinsic-registry-single-source-sync-with-runtime.md b/docs/compiler/pbs/pull-requests/PR-08.5-intrinsic-registry-single-source-sync-with-runtime.md similarity index 100% rename from docs/pbs/pull-requests/PR-08.5-intrinsic-registry-single-source-sync-with-runtime.md rename to docs/compiler/pbs/pull-requests/PR-08.5-intrinsic-registry-single-source-sync-with-runtime.md diff --git a/docs/pbs/pull-requests/PR-09.1-irbackend-modulekey-hard-removal-from-contract.md b/docs/compiler/pbs/pull-requests/PR-09.1-irbackend-modulekey-hard-removal-from-contract.md similarity index 100% rename from docs/pbs/pull-requests/PR-09.1-irbackend-modulekey-hard-removal-from-contract.md rename to docs/compiler/pbs/pull-requests/PR-09.1-irbackend-modulekey-hard-removal-from-contract.md diff --git a/docs/pbs/pull-requests/PR-09.2-pbs-frontend-moduleid-only-lowering-and-import-surfaces.md b/docs/compiler/pbs/pull-requests/PR-09.2-pbs-frontend-moduleid-only-lowering-and-import-surfaces.md similarity index 100% rename from docs/pbs/pull-requests/PR-09.2-pbs-frontend-moduleid-only-lowering-and-import-surfaces.md rename to docs/compiler/pbs/pull-requests/PR-09.2-pbs-frontend-moduleid-only-lowering-and-import-surfaces.md diff --git a/docs/pbs/pull-requests/PR-09.3-lower-to-irvm-moduleid-only-ordering-and-strict-qualified-entrypoint.md b/docs/compiler/pbs/pull-requests/PR-09.3-lower-to-irvm-moduleid-only-ordering-and-strict-qualified-entrypoint.md similarity index 100% rename from docs/pbs/pull-requests/PR-09.3-lower-to-irvm-moduleid-only-ordering-and-strict-qualified-entrypoint.md rename to docs/compiler/pbs/pull-requests/PR-09.3-lower-to-irvm-moduleid-only-ordering-and-strict-qualified-entrypoint.md diff --git a/docs/pbs/pull-requests/PR-09.4-specs-refresh-moduleid-only-entrypointref-and-bytecode-alignment.md b/docs/compiler/pbs/pull-requests/PR-09.4-specs-refresh-moduleid-only-entrypointref-and-bytecode-alignment.md similarity index 100% rename from docs/pbs/pull-requests/PR-09.4-specs-refresh-moduleid-only-entrypointref-and-bytecode-alignment.md rename to docs/compiler/pbs/pull-requests/PR-09.4-specs-refresh-moduleid-only-entrypointref-and-bytecode-alignment.md diff --git a/docs/pbs/pull-requests/PR-09.5-hard-gates-no-modulekey-regression-and-migration-cleanup.md b/docs/compiler/pbs/pull-requests/PR-09.5-hard-gates-no-modulekey-regression-and-migration-cleanup.md similarity index 100% rename from docs/pbs/pull-requests/PR-09.5-hard-gates-no-modulekey-regression-and-migration-cleanup.md rename to docs/compiler/pbs/pull-requests/PR-09.5-hard-gates-no-modulekey-regression-and-migration-cleanup.md diff --git a/docs/pbs/pull-requests/PR-09.6-isa-intrinsic-registry-single-source-artifact.md b/docs/compiler/pbs/pull-requests/PR-09.6-isa-intrinsic-registry-single-source-artifact.md similarity index 100% rename from docs/pbs/pull-requests/PR-09.6-isa-intrinsic-registry-single-source-artifact.md rename to docs/compiler/pbs/pull-requests/PR-09.6-isa-intrinsic-registry-single-source-artifact.md diff --git a/docs/pbs/pull-requests/PR-09.7-compiler-normalization-to-isa-registry-artifact.md b/docs/compiler/pbs/pull-requests/PR-09.7-compiler-normalization-to-isa-registry-artifact.md similarity index 100% rename from docs/pbs/pull-requests/PR-09.7-compiler-normalization-to-isa-registry-artifact.md rename to docs/compiler/pbs/pull-requests/PR-09.7-compiler-normalization-to-isa-registry-artifact.md diff --git a/docs/pbs/pull-requests/PR-10.1-pbs-parser-shared-context-and-safe-delegation.md b/docs/compiler/pbs/pull-requests/PR-10.1-pbs-parser-shared-context-and-safe-delegation.md similarity index 100% rename from docs/pbs/pull-requests/PR-10.1-pbs-parser-shared-context-and-safe-delegation.md rename to docs/compiler/pbs/pull-requests/PR-10.1-pbs-parser-shared-context-and-safe-delegation.md diff --git a/docs/pbs/pull-requests/PR-10.2-pbs-parser-attribute-and-type-subparsers.md b/docs/compiler/pbs/pull-requests/PR-10.2-pbs-parser-attribute-and-type-subparsers.md similarity index 100% rename from docs/pbs/pull-requests/PR-10.2-pbs-parser-attribute-and-type-subparsers.md rename to docs/compiler/pbs/pull-requests/PR-10.2-pbs-parser-attribute-and-type-subparsers.md diff --git a/docs/pbs/pull-requests/PR-10.3-pbs-parser-top-level-declaration-decomposition.md b/docs/compiler/pbs/pull-requests/PR-10.3-pbs-parser-top-level-declaration-decomposition.md similarity index 100% rename from docs/pbs/pull-requests/PR-10.3-pbs-parser-top-level-declaration-decomposition.md rename to docs/compiler/pbs/pull-requests/PR-10.3-pbs-parser-top-level-declaration-decomposition.md diff --git a/docs/pbs/pull-requests/PR-10.4-pbs-parser-block-and-statement-decomposition.md b/docs/compiler/pbs/pull-requests/PR-10.4-pbs-parser-block-and-statement-decomposition.md similarity index 100% rename from docs/pbs/pull-requests/PR-10.4-pbs-parser-block-and-statement-decomposition.md rename to docs/compiler/pbs/pull-requests/PR-10.4-pbs-parser-block-and-statement-decomposition.md diff --git a/docs/pbs/pull-requests/PR-10.5-pbs-parser-recovery-utilities-and-regression-hardening.md b/docs/compiler/pbs/pull-requests/PR-10.5-pbs-parser-recovery-utilities-and-regression-hardening.md similarity index 100% rename from docs/pbs/pull-requests/PR-10.5-pbs-parser-recovery-utilities-and-regression-hardening.md rename to docs/compiler/pbs/pull-requests/PR-10.5-pbs-parser-recovery-utilities-and-regression-hardening.md diff --git a/docs/pbs/pull-requests/PR-11.1-pbs-expr-parser-shared-context-and-precedence-spine.md b/docs/compiler/pbs/pull-requests/PR-11.1-pbs-expr-parser-shared-context-and-precedence-spine.md similarity index 100% rename from docs/pbs/pull-requests/PR-11.1-pbs-expr-parser-shared-context-and-precedence-spine.md rename to docs/compiler/pbs/pull-requests/PR-11.1-pbs-expr-parser-shared-context-and-precedence-spine.md diff --git a/docs/pbs/pull-requests/PR-11.2-pbs-expr-parser-control-flow-subparsers.md b/docs/compiler/pbs/pull-requests/PR-11.2-pbs-expr-parser-control-flow-subparsers.md similarity index 100% rename from docs/pbs/pull-requests/PR-11.2-pbs-expr-parser-control-flow-subparsers.md rename to docs/compiler/pbs/pull-requests/PR-11.2-pbs-expr-parser-control-flow-subparsers.md diff --git a/docs/pbs/pull-requests/PR-11.3-pbs-expr-parser-postfix-primary-and-construction-decomposition.md b/docs/compiler/pbs/pull-requests/PR-11.3-pbs-expr-parser-postfix-primary-and-construction-decomposition.md similarity index 100% rename from docs/pbs/pull-requests/PR-11.3-pbs-expr-parser-postfix-primary-and-construction-decomposition.md rename to docs/compiler/pbs/pull-requests/PR-11.3-pbs-expr-parser-postfix-primary-and-construction-decomposition.md diff --git a/docs/pbs/pull-requests/PR-11.4-pbs-expr-parser-literals-patterns-and-shared-token-utilities.md b/docs/compiler/pbs/pull-requests/PR-11.4-pbs-expr-parser-literals-patterns-and-shared-token-utilities.md similarity index 100% rename from docs/pbs/pull-requests/PR-11.4-pbs-expr-parser-literals-patterns-and-shared-token-utilities.md rename to docs/compiler/pbs/pull-requests/PR-11.4-pbs-expr-parser-literals-patterns-and-shared-token-utilities.md diff --git a/docs/pbs/pull-requests/PR-11.5-pbs-expr-parser-regression-hardening-and-final-cleanup.md b/docs/compiler/pbs/pull-requests/PR-11.5-pbs-expr-parser-regression-hardening-and-final-cleanup.md similarity index 100% rename from docs/pbs/pull-requests/PR-11.5-pbs-expr-parser-regression-hardening-and-final-cleanup.md rename to docs/compiler/pbs/pull-requests/PR-11.5-pbs-expr-parser-regression-hardening-and-final-cleanup.md diff --git a/docs/pbs/pull-requests/PR-12.1-flow-expression-analyzer-context-and-dispatch-foundation.md b/docs/compiler/pbs/pull-requests/PR-12.1-flow-expression-analyzer-context-and-dispatch-foundation.md similarity index 100% rename from docs/pbs/pull-requests/PR-12.1-flow-expression-analyzer-context-and-dispatch-foundation.md rename to docs/compiler/pbs/pull-requests/PR-12.1-flow-expression-analyzer-context-and-dispatch-foundation.md diff --git a/docs/pbs/pull-requests/PR-12.2-flow-expression-analyzer-literal-and-structural-expression-splitting.md b/docs/compiler/pbs/pull-requests/PR-12.2-flow-expression-analyzer-literal-and-structural-expression-splitting.md similarity index 100% rename from docs/pbs/pull-requests/PR-12.2-flow-expression-analyzer-literal-and-structural-expression-splitting.md rename to docs/compiler/pbs/pull-requests/PR-12.2-flow-expression-analyzer-literal-and-structural-expression-splitting.md diff --git a/docs/pbs/pull-requests/PR-12.3-flow-expression-analyzer-call-and-member-resolution-decomposition.md b/docs/compiler/pbs/pull-requests/PR-12.3-flow-expression-analyzer-call-and-member-resolution-decomposition.md similarity index 100% rename from docs/pbs/pull-requests/PR-12.3-flow-expression-analyzer-call-and-member-resolution-decomposition.md rename to docs/compiler/pbs/pull-requests/PR-12.3-flow-expression-analyzer-call-and-member-resolution-decomposition.md diff --git a/docs/pbs/pull-requests/PR-12.4-flow-expression-analyzer-switch-and-handle-decomposition.md b/docs/compiler/pbs/pull-requests/PR-12.4-flow-expression-analyzer-switch-and-handle-decomposition.md similarity index 100% rename from docs/pbs/pull-requests/PR-12.4-flow-expression-analyzer-switch-and-handle-decomposition.md rename to docs/compiler/pbs/pull-requests/PR-12.4-flow-expression-analyzer-switch-and-handle-decomposition.md diff --git a/docs/pbs/pull-requests/PR-12.5-flow-expression-analyzer-regression-hardening-and-final-cleanup.md b/docs/compiler/pbs/pull-requests/PR-12.5-flow-expression-analyzer-regression-hardening-and-final-cleanup.md similarity index 100% rename from docs/pbs/pull-requests/PR-12.5-flow-expression-analyzer-regression-hardening-and-final-cleanup.md rename to docs/compiler/pbs/pull-requests/PR-12.5-flow-expression-analyzer-regression-hardening-and-final-cleanup.md diff --git a/docs/pbs/pull-requests/PR-13.1-flow-body-analyzer-context-and-entrypoint-foundation.md b/docs/compiler/pbs/pull-requests/PR-13.1-flow-body-analyzer-context-and-entrypoint-foundation.md similarity index 100% rename from docs/pbs/pull-requests/PR-13.1-flow-body-analyzer-context-and-entrypoint-foundation.md rename to docs/compiler/pbs/pull-requests/PR-13.1-flow-body-analyzer-context-and-entrypoint-foundation.md diff --git a/docs/pbs/pull-requests/PR-13.2-flow-body-analyzer-callable-body-and-completion-decomposition.md b/docs/compiler/pbs/pull-requests/PR-13.2-flow-body-analyzer-callable-body-and-completion-decomposition.md similarity index 100% rename from docs/pbs/pull-requests/PR-13.2-flow-body-analyzer-callable-body-and-completion-decomposition.md rename to docs/compiler/pbs/pull-requests/PR-13.2-flow-body-analyzer-callable-body-and-completion-decomposition.md diff --git a/docs/pbs/pull-requests/PR-13.3-flow-body-analyzer-statement-analysis-splitting.md b/docs/compiler/pbs/pull-requests/PR-13.3-flow-body-analyzer-statement-analysis-splitting.md similarity index 100% rename from docs/pbs/pull-requests/PR-13.3-flow-body-analyzer-statement-analysis-splitting.md rename to docs/compiler/pbs/pull-requests/PR-13.3-flow-body-analyzer-statement-analysis-splitting.md diff --git a/docs/pbs/pull-requests/PR-13.4-flow-body-analyzer-assignment-target-resolution-decomposition.md b/docs/compiler/pbs/pull-requests/PR-13.4-flow-body-analyzer-assignment-target-resolution-decomposition.md similarity index 100% rename from docs/pbs/pull-requests/PR-13.4-flow-body-analyzer-assignment-target-resolution-decomposition.md rename to docs/compiler/pbs/pull-requests/PR-13.4-flow-body-analyzer-assignment-target-resolution-decomposition.md diff --git a/docs/pbs/pull-requests/PR-13.5-flow-body-analyzer-regression-hardening-and-final-cleanup.md b/docs/compiler/pbs/pull-requests/PR-13.5-flow-body-analyzer-regression-hardening-and-final-cleanup.md similarity index 100% rename from docs/pbs/pull-requests/PR-13.5-flow-body-analyzer-regression-hardening-and-final-cleanup.md rename to docs/compiler/pbs/pull-requests/PR-13.5-flow-body-analyzer-regression-hardening-and-final-cleanup.md diff --git a/docs/pbs/pull-requests/README.md b/docs/compiler/pbs/pull-requests/README.md similarity index 100% rename from docs/pbs/pull-requests/README.md rename to docs/compiler/pbs/pull-requests/README.md diff --git a/docs/pbs/specs/1. Language Charter.md b/docs/compiler/pbs/specs/1. Language Charter.md similarity index 100% rename from docs/pbs/specs/1. Language Charter.md rename to docs/compiler/pbs/specs/1. Language Charter.md diff --git a/docs/pbs/specs/10. Memory and Lifetime Specification.md b/docs/compiler/pbs/specs/10. Memory and Lifetime Specification.md similarity index 100% rename from docs/pbs/specs/10. Memory and Lifetime Specification.md rename to docs/compiler/pbs/specs/10. Memory and Lifetime Specification.md diff --git a/docs/pbs/specs/11. AST Specification.md b/docs/compiler/pbs/specs/11. AST Specification.md similarity index 100% rename from docs/pbs/specs/11. AST Specification.md rename to docs/compiler/pbs/specs/11. AST Specification.md diff --git a/docs/pbs/specs/12. Diagnostics Specification.md b/docs/compiler/pbs/specs/12. Diagnostics Specification.md similarity index 100% rename from docs/pbs/specs/12. Diagnostics Specification.md rename to docs/compiler/pbs/specs/12. Diagnostics Specification.md diff --git a/docs/pbs/specs/13. Lowering IRBackend Specification.md b/docs/compiler/pbs/specs/13. Lowering IRBackend Specification.md similarity index 100% rename from docs/pbs/specs/13. Lowering IRBackend Specification.md rename to docs/compiler/pbs/specs/13. Lowering IRBackend Specification.md diff --git a/docs/pbs/specs/2. Governance and Versioning.md b/docs/compiler/pbs/specs/2. Governance and Versioning.md similarity index 100% rename from docs/pbs/specs/2. Governance and Versioning.md rename to docs/compiler/pbs/specs/2. Governance and Versioning.md diff --git a/docs/pbs/specs/3. Core Syntax Specification.md b/docs/compiler/pbs/specs/3. Core Syntax Specification.md similarity index 100% rename from docs/pbs/specs/3. Core Syntax Specification.md rename to docs/compiler/pbs/specs/3. Core Syntax Specification.md diff --git a/docs/pbs/specs/4. Static Semantics Specification.md b/docs/compiler/pbs/specs/4. Static Semantics Specification.md similarity index 100% rename from docs/pbs/specs/4. Static Semantics Specification.md rename to docs/compiler/pbs/specs/4. Static Semantics Specification.md diff --git a/docs/pbs/specs/5. Manifest, Stdlib, and SDK Resolution Specification.md b/docs/compiler/pbs/specs/5. Manifest, Stdlib, and SDK Resolution Specification.md similarity index 100% rename from docs/pbs/specs/5. Manifest, Stdlib, and SDK Resolution Specification.md rename to docs/compiler/pbs/specs/5. Manifest, Stdlib, and SDK Resolution Specification.md diff --git a/docs/pbs/specs/6. VM-owned vs Host-backed.md b/docs/compiler/pbs/specs/6. VM-owned vs Host-backed.md similarity index 100% rename from docs/pbs/specs/6. VM-owned vs Host-backed.md rename to docs/compiler/pbs/specs/6. VM-owned vs Host-backed.md diff --git a/docs/pbs/specs/6.1. Intrinsics and Builtin Types Specification.md b/docs/compiler/pbs/specs/6.1. Intrinsics and Builtin Types Specification.md similarity index 100% rename from docs/pbs/specs/6.1. Intrinsics and Builtin Types Specification.md rename to docs/compiler/pbs/specs/6.1. Intrinsics and Builtin Types Specification.md diff --git a/docs/pbs/specs/6.2. Host ABI Binding and Loader Resolution Specification.md b/docs/compiler/pbs/specs/6.2. Host ABI Binding and Loader Resolution Specification.md similarity index 100% rename from docs/pbs/specs/6.2. Host ABI Binding and Loader Resolution Specification.md rename to docs/compiler/pbs/specs/6.2. Host ABI Binding and Loader Resolution Specification.md diff --git a/docs/pbs/specs/7. Cartridge Manifest and Runtime Capabilities Specification.md b/docs/compiler/pbs/specs/7. Cartridge Manifest and Runtime Capabilities Specification.md similarity index 100% rename from docs/pbs/specs/7. Cartridge Manifest and Runtime Capabilities Specification.md rename to docs/compiler/pbs/specs/7. Cartridge Manifest and Runtime Capabilities Specification.md diff --git a/docs/pbs/specs/8. Stdlib Environment Packaging and Loading Specification.md b/docs/compiler/pbs/specs/8. Stdlib Environment Packaging and Loading Specification.md similarity index 100% rename from docs/pbs/specs/8. Stdlib Environment Packaging and Loading Specification.md rename to docs/compiler/pbs/specs/8. Stdlib Environment Packaging and Loading Specification.md diff --git a/docs/pbs/specs/9. Dynamic Semantics Specification.md b/docs/compiler/pbs/specs/9. Dynamic Semantics Specification.md similarity index 100% rename from docs/pbs/specs/9. Dynamic Semantics Specification.md rename to docs/compiler/pbs/specs/9. Dynamic Semantics Specification.md diff --git a/docs/pbs/specs/README.md b/docs/compiler/pbs/specs/README.md similarity index 100% rename from docs/pbs/specs/README.md rename to docs/compiler/pbs/specs/README.md diff --git a/docs/roadmaps/packer/Prometeu Packer.md b/docs/packer/Prometeu Packer.md similarity index 100% rename from docs/roadmaps/packer/Prometeu Packer.md rename to docs/packer/Prometeu Packer.md diff --git a/docs/roadmaps/packer/.gitkeep b/docs/roadmaps/packer/.gitkeep deleted file mode 100644 index e69de29b..00000000