README.md

Documentation Index

This repository provides a reproducible macOS workstation bootstrap focused on speed, consistency, and domain-separated tooling.

Read in this order

1. System requirements
2. macOS quick start
3. Architecture
4. Module reference
5. Verification guide
6. Development guide
7. Maintenance guide
8. Release process
9. Roadmap v0.0.2
10. Governance
11. Community health
12. Discoverability playbook
13. Troubleshooting
14. Portability checklist
15. Release notes: v0.0.3
16. Release notes: v0.0.2
17. Wiki home (in-repo)
18. Wiki: System tools
19. Wiki: Containers
20. Wiki: Kubernetes
21. Wiki: JS/TS
22. Wiki: Python
23. Wiki: Rust
24. Wiki: Flutter
25. Wiki: Java
26. Wiki: C/C++
27. Wiki: AI CLI
28. Wiki: Terminal UX
29. Wiki: Verification and maintenance

Scope

• Fully supported now: macOS (darwin) flow.
• Placeholders: Linux and Windows modules exist and can be expanded later.

Wiki

• GitHub Wiki home: https://github.com/rldyourmnd/new-macos-dev-setup/wiki
• Local, versioned wiki: wiki/README.md

Entrypoints

• Main installer: ./install-macos.sh
• Core bootstrap: ./scripts/bootstrap/bootstrap.sh