docs: update repo structure across READMEs

Author: DivitMittal

README.md

@@ -134,90 +134,18 @@ The repository is organized using [flake-parts](https://github.com/hercules-ci/f
 
 ```
 .
-├── .claude/                  # Claude AI assistant configuration
-│   ├── commands/
-│   │   └── openspec/
-│   ├── .mcp.json
-│   ├── CLAUDE.md
-│   └── settings.json
-├── .github/                  # GitHub Actions workflows & funding
-│   ├── workflows/
-│   └── FUNDING.yml
-├── assets/                   # Images and visual assets
-│   ├── topology/
-│   │   ├── main.svg
-│   │   └── network.svg
-│   ├── home_graph.png
-│   ├── qezta.gif
-│   └── qezta.png
-├── common/                   # Shared configurations across all platforms
-│   ├── all/                  # Common to all configurations
-│   ├── home/                 # Common home-manager configurations
-│   └── hosts/                # Common host configurations
-│       ├── all/
-│       ├── darwin/
-│       ├── droid/
-│       ├── iso/
-│       └── nixos/
-├── flake/                    # Flake-parts module definitions
-│   ├── actions/              # GitHub Actions definitions
-│   ├── topology/             # Network topology configuration
-│   ├── checks.nix
-│   ├── devshells.nix
-│   ├── formatters.nix
-│   ├── iso-packages.nix
-│   └── mkCfg.nix             # Universal host builder
-├── home/                     # Home-manager modules by category
-│   ├── comms/                # Communication (email, IRC, newsboat)
-│   ├── dev/                  # Development tools (JS, Python, cloud)
-│   ├── gui/                  # GUI applications and desktop managers
-│   ├── media/                # Media tools (image, video, music)
-│   ├── tools/                # Utilities (privacy, productivity, keyboard)
-│   ├── tty/                  # Terminal tools (editors, shells, multiplexers)
-│   └── web/                  # Web browsers and related tools
-├── hosts/                    # Platform-specific host configurations
-│   ├── darwin/               # macOS hosts (nix-darwin)
-│   │   └── L1/
-│   ├── droid/                # Android hosts (nix-on-droid)
-│   │   └── M1/
-│   ├── iso/                  # ISO configurations
-│   │   ├── iso/
-│   │   └── t2-iso/
-│   └── nixos/                # NixOS hosts
-│       ├── L2/
-│       └── WSL/
-├── lib/                      # Custom Nix utility functions
-│   └── custom.nix
-├── modules/                  # Custom NixOS/home-manager modules
-│   ├── home/
-│   └── hosts/
-│       └── darwin/
-├── openspec/                 # OpenSpec project documentation
-│   ├── AGENTS.md
-│   └── project.md
-├── overlays/                 # Nix package overlays
-│   └── custom.nix
-├── pkgs/                     # Custom package derivations
-│   ├── custom/               # Custom derivations
-│   └── darwin/               # macOS-specific packages
-├── templates/                # Nix flake templates
-│   └── vanilla/
-├── utils/                    # Build and rebuild scripts
-│   ├── common.sh
-│   ├── home_rebuild.sh
-│   └── hosts_rebuild.sh
-├── .editorconfig
-├── .envrc
-├── .gitattributes
-├── .gitignore
-├── AGENTS.md                 # AI agent instructions
-├── CODEOWNERS
-├── flake.lock
-├── flake.nix                 # Main flake entry point
-├── LICENSE
-├── README.md
-├── SECURITY.md
-└── shell.nix
+├── flake/      # flake-parts modules — mkCfg, devshells, checks, actions, topology
+├── common/     # shared layers: all/, home/, hosts/{all,darwin,droid,iso,nixos}/
+├── hosts/      # per-host overrides: darwin/L1, nixos/{L2,T2,WSL}, droid/M1, iso/
+├── home/       # home-manager modules by domain: tty/ gui/ tools/ media/ comms/ dev/ web/
+├── modules/    # reusable NixOS/HM/darwin modules
+├── overlays/   # nixpkgs overlays (custom, customDarwin)
+├── pkgs/       # derivations: custom/ and darwin/
+├── lib/        # custom Nix utility functions (palette, scanPaths, …)
+├── utils/      # rebuild wrapper scripts
+├── templates/  # flake templates (vanilla)
+├── assets/     # topology SVGs, wallpapers, profile graph
+└── flake.nix   # entry point — inputs, nixConfig, flake-parts wiring
 ```
 
 ## Theme Pipeline

flake/README.md

@@ -38,14 +38,13 @@ The pkgs handed to each config is extended with `master` / `stable` channels (an
 
 ## Contents
 
+- **apps.nix** - Runnable flake app outputs (`tty`, `desktop` shells)
+- **checks.nix** - Pre-commit hooks
 - **devshells.nix** - Development environment (`nix develop`)
 - **formatters.nix** - Code formatting (`nix fmt`: alejandra, deadnix, statix)
-- **checks.nix** - Pre-commit hooks
-- **mkCfg.nix** - Universal host builder (nixos/darwin/droid/home)
 - **iso-packages.nix** - ISO build packages
-- **topology/** - Infrastructure visualization (nix-topology)
-  - default.nix - Topology module exports
-  - global.nix - Global topology definitions
+- **mkCfg.nix** - Universal host builder (nixos/darwin/droid/home)
+- **topology.nix** - Infrastructure visualization (nix-topology)
 - **actions/** - GitHub Actions workflows
   - default.nix - Actions module exports
   - darwin-build.nix - macOS build actions

home/README.md

@@ -6,7 +6,6 @@ Home-manager modules organized by category.
 
 ```
 home/
-├── ai/           # AI/ML tools
 ├── comms/        # Email, IRC, RSS
 ├── dev/          # Development (JS, Python, cloud)
 ├── gui/          # GUI apps, desktop managers

hosts/README.md

@@ -10,6 +10,7 @@ hosts/
 │   └── L1/       # x86_64-darwin workstation
 ├── nixos/         # NixOS systems
 │   ├── L2/       # x86_64-linux desktop
+│   ├── T2/       # x86_64-linux T2 MacBook (Apple T2 chip)
 │   └── WSL/      # x86_64-linux WSL2
 ├── droid/         # Android (nix-on-droid)
 │   └── M1/