Polish README structure and documentation map

[billybox1926-jpg]

Summary

Gives the README a final quality pass so the template is easier to scan and navigate.

Changes

• Replaces overlapping sections with a tighter What is included overview
• Adds a documentation map for setup, DevEx, architecture, examples, standards, contribution, and security docs
• Updates repository layout to include current docs and scripts
• Consolidates automation guidance into a concise section
• Keeps repository settings, versioning, and next steps focused

Notes

This keeps the README generic and reusable while making the important docs easier to find quickly.

Closes #15