fkrebs/docs
1
0
Fork 0
Code Issues 14 Pull Requests Actions Packages Projects Releases Wiki Activity

baseline: docs as of pre-reorg audit (2026-05-20)

Browse Source
This commit is contained in:
Florian Krebs
2026-05-20 23:23:31 +02:00
commit 04d54ac9b0
40 changed files with 7074 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+85
View File
@@ -0,0 +1,85 @@
# 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