# nuclide.systems — Infrastructure Docs

Central documentation for the `nuc` Proxmox homelab and all hosted services.  
**Source of truth:** `/docs/` on the Proxmox host (`192.168.1.20`).  
This directory is the entry point — docs generated anywhere else should land here.

---

## Infrastructure

| File | Contents |
|------|----------|
| [proxmox-optimizations.md](proxmox-optimizations.md) | Full audit, sizing decisions, action log, pending tasks |

---

## Docker Stacks (CT 104 / 192.168.1.40)

### Service docs (`stacks/docs/`)

| File | Contents |
|------|----------|
| [homelab-architecture.md](stacks/docs/homelab-architecture.md) | Overall architecture overview |
| [mcp-gateway.md](stacks/docs/mcp-gateway.md) | MCP gateway design and endpoints |
| [mcp-gateway-requirements.md](stacks/docs/mcp-gateway-requirements.md) | MCP gateway requirements |
| [zoraxy-setup.md](stacks/docs/zoraxy-setup.md) | Zoraxy reverse proxy setup notes |
| [AdGuard-DNS-writes.md](stacks/docs/AdGuard-DNS-writes.md) | AdGuard DNS rewrite rules |
| [comfyui-mcp.md](stacks/docs/comfyui-mcp.md) | ComfyUI MCP integration |
| [dev-environment.md](stacks/docs/dev-environment.md) | CT 111 Coder + Gitea dev platform |
| [traefik-migration.md](stacks/docs/traefik-migration.md) | Traefik → Zoraxy migration notes |
| [traefik-migration-docker-labels.md](stacks/docs/traefik-migration-docker-labels.md) | Label mapping reference |
| [cloud-gpu-extension.md](stacks/docs/cloud-gpu-extension.md) | Cloud GPU burst setup |
| [scrubbing-list.md](stacks/docs/scrubbing-list.md) | Services to clean up / decommission |
| [stack-ideas.md](stacks/docs/stack-ideas.md) | Backlog of stack ideas |
| [case-study.md](stacks/docs/case-study.md) | Case study writeup |

### Operational (`stacks/`)

| File | Contents |
|------|----------|
| [PORTMAP.md](stacks/PORTMAP.md) | Port assignments for all services |
| [storage.md](stacks/storage.md) | Volume and storage layout |
| [volumes.md](stacks/volumes.md) | Docker volume inventory |
| [docker-networks.md](stacks/docker-networks.md) | Docker network topology |
| [todo.md](stacks/todo.md) | Outstanding stack tasks |
| [CLAUDE.md](stacks/CLAUDE.md) | Agent breadcrumbs (migrated stacks, dormant services) |

---

## Nexa Project (`stacks/nexa/`)

| File | Contents |
|------|----------|
| [README.md](stacks/nexa/README.md) | Project overview |
| [docs/01-vision-and-scope.md](stacks/nexa/docs/01-vision-and-scope.md) | Vision and scope |
| [docs/02-roadmap.md](stacks/nexa/docs/02-roadmap.md) | Roadmap |
| [docs/03-architecture.md](stacks/nexa/docs/03-architecture.md) | Architecture |
| [docs/04-integration-matrix.md](stacks/nexa/docs/04-integration-matrix.md) | Integration matrix |
| [docs/05-command-system.md](stacks/nexa/docs/05-command-system.md) | Command system |
| [docs/06-classification-logic.md](stacks/nexa/docs/06-classification-logic.md) | Classification logic |
| [docs/07-workflow-spec.md](stacks/nexa/docs/07-workflow-spec.md) | Workflow spec |
| [docs/08-graphrag-architecture.md](stacks/nexa/docs/08-graphrag-architecture.md) | GraphRAG architecture |
| [docs/09-deployment.md](stacks/nexa/docs/09-deployment.md) | Deployment |
| [docs/10-operations.md](stacks/nexa/docs/10-operations.md) | Operations |
| [docs/11-open-questions.md](stacks/nexa/docs/11-open-questions.md) | Open questions |
| [docs/12-optimization-opportunities.md](stacks/nexa/docs/12-optimization-opportunities.md) | Optimization opportunities |
| [docs/13-information-wishlist.md](stacks/nexa/docs/13-information-wishlist.md) | Information wishlist |

---

## AI Agents (`stacks/ai/`)

| File | Contents |
|------|----------|
| [home-info.md](stacks/ai/home-info.md) | Home context for agents |
| [morning-briefing-agent.md](stacks/ai/morning-briefing-agent.md) | Morning briefing agent config |
| [PROMPTING-2026.md](stacks/ai/PROMPTING-2026.md) | Prompting guide 2026 |

---

## Contributing

- Drop new docs in the appropriate subdirectory
- Update this README when adding a new section
- When CT 109 (management LXC) is built, the docs platform will serve this directory