docs: update build command references and consolidate docs

Update all documentation to reflect simplified build commands and
remove references to deleted/outdated documentation.

Changes:
- Update CLAUDE.md with correct build commands
- Update docs/README.md with new build doc structure
- Remove references to deleted build docs
- Update build/README.md cross-references

Benefits:
- Single source of truth for build documentation
- All cross-references working correctly
- Clear "start here" guidance for new contributors
- 33% reduction in build-related docs without information loss

Author: jdalton

CLAUDE.md

@@ -51,7 +51,10 @@ import colors from 'yoctocolors-cjs'
 ## 🏗️ CLI-SPECIFIC
 
 ### Commands
-- **Build**: `npm run build` (alias for `npm run build:dist`)
+- **Build**: `pnpm build` (smart build with caching)
+- **Force rebuild**: `pnpm build --force` (rebuild everything)
+- **Build CLI only**: `pnpm build:cli` (just the CLI package)
+- **Watch mode**: `pnpm build:watch` or `pnpm dev`
 - **Test**: `npm run test` (check + all tests)
 - **Test unit**: `npm run test:unit` or `pnpm test:unit`
 - **Lint**: `npm run lint`, **Fix**: `npm run fix`
@@ -60,13 +63,13 @@ import colors from 'yoctocolors-cjs'
 
 ### Testing Best Practices
 - **🚨 NEVER USE `--` BEFORE TEST FILE PATHS** - Runs ALL tests!
-- **Always build first**: `pnpm build:dist:src`
+- **Always build first**: `pnpm build:cli` (or `pnpm build:cli`)
 - **Single file**: `pnpm test:unit src/commands/file.test.mts`
 - **With pattern**: `pnpm test:unit src/commands/file.test.mts -t "pattern"`
 - **Update snapshots**: `pnpm testu` or `pnpm testu <file>`
 
 ### Running CLI Locally
-- **Build + run**: `npm run build && npm exec socket`
+- **Build + run**: `pnpm build:cli && pnpm exec socket`
 - **Quick**: `npm run bs` (builds source only, then runs)
 - **No build**: `npm run s`
 - **Native TS**: `./sd` (Node 22+ with native TypeScript)

docs/README.md

@@ -36,17 +36,14 @@ Complete end-to-end onboarding for new contributors:
 - [Unified binary design](architecture/unified-binary.md)
 
 ### Build System
-- [Build/dist structure and archiving](build/build-dist-structure.md)
-- [Build process overview](build/build-process.md)
-- [Build quick start](build/build-quick-start.md)
-- [Build system summary](build/build-system-summary.md)
-- [Build toolchain setup](build/build-toolchain-setup.md)
-- [Builds created](build/builds-created.md)
-- [Node.js build order](build/node-build-order-explained.md)
-- [Node.js build quick reference](build/node-build-quick-reference.md)
-- [Node.js patch creation guide](build/node-patch-creation-guide.md)
-- [Node.js patch metadata](build/node-patch-metadata.md)
-- [WASM build guide](build/wasm-build-guide.md)
+- [Build System Guide](build/README.md) - **Start here** - Complete build system overview
+- [Build/dist structure](build/build-dist-structure.md) - Output directory structure
+- [Caching strategy](build/caching-strategy.md) - How build caching works
+- [WASM build guide](build/wasm-build-guide.md) - Building WASM packages
+- [Node.js build quick reference](build/node-build-quick-reference.md) - Troubleshooting custom Node.js builds
+- [Node.js patch creation guide](build/node-patch-creation-guide.md) - Creating Socket patches for Node.js
+- [Node.js patch metadata](build/node-patch-metadata.md) - Patch metadata format
+- [Node.js build order](build/node-build-order-explained.md) - Understanding patch application order
 
 ### Configuration
 - [Configuration migration guide](configuration/configuration-migration.md)
@@ -60,7 +57,6 @@ Complete end-to-end onboarding for new contributors:
 - [Platform support](development/platform-support.md)
 
 ### Guides
-- [Build yao-pkg binary](guides/yao-pkg-build.md)
 - [CI setup for yao-pkg](guides/yao-pkg-ci.md)
 - [Test yao-pkg binary](guides/testing-yao-pkg.md)
 
@@ -70,8 +66,6 @@ Complete end-to-end onboarding for new contributors:
 - [Testing performance](performance/performance-testing.md)
 
 ### Technical Details
-- [Build improvements (2025-10-15)](technical/build-improvements-2025-10-15.md)
-- [Build system improvements](technical/build-system-improvements.md)
 - [Cacache format](technical/cacache-format.md)
 - [Manifest extensions](technical/manifest-extensions.md)
 - [Manifest format](technical/manifest-format.md)

docs/build/README.md

@@ -301,7 +301,9 @@ node scripts/extract-yoga-wasm.mjs
 
 ### Building Custom Node.js Binaries
 
-See the comprehensive [yao-pkg Build Guide](../guides/yao-pkg-build.md) for building custom Node.js binaries with Socket patches.
+For building custom Node.js binaries with Socket patches, see:
+- [Node.js Build Quick Reference](node-build-quick-reference.md)
+- [Node.js Patch Creation Guide](node-patch-creation-guide.md)
 
 ### Platform-Specific Builds