docs: consolidate canonical specs and preserve PBS reference IDs

This commit is contained in:
2026-10-28 15:11:00 +00:00
parent 9504f4694a
commit 3a3417eb44
74 changed files with 3231 additions and 270 deletions
+5 -2
View File
@@ -260,8 +260,11 @@ If you are new to the codebase, this order is usually the fastest path:
Important reference surfaces:
- `docs/specs/compiler/`: shared compiler specifications
- `docs/specs/packer/`: packer specifications
- [Specification guide](docs/specs/README.md): domain ownership and reading order
- [General compiler](docs/specs/compiler/README.md): shared compiler specifications
- [PBS](docs/specs/compiler-languages/pbs/README.md): language and SDK specifications
- [Studio](docs/specs/studio/README.md): shell, workspaces and integration contracts
- [Packer](docs/specs/packer/README.md): packer specifications
- `docs/vm-arch/`: VM and ISA architecture references
These documents are the long-term normative source for behavior and contracts. When code and docs diverge, fix the divergence explicitly instead of relying on tribal knowledge.