This changelog records significant documentation changes to the homelab repository.
Entries reflect:
- What changed
- When it changed
- Which sections were affected
This file tracks documentation evolution, not runtime changes.
- Only completed and committed work is recorded
- No speculative or future changes are listed
- Entries describe documentation scope, not implementation detail
- New architectural decisions are logged when documented
Added the Pass 3 automation readiness layer for Pantheon.
Automation remains documentation/scaffold-only. No live infrastructure changes, Ansible runs, Pulumi updates, Terraform/OpenTofu applies, production state, credentials, or secrets were introduced.
- Added root [[automation/README|Automation]] documentation for repo-wide tooling, shared assets, and policies.
- Added [[automation/pantheonctl/README|pantheonctl]] as a minimal C# control-plane scaffold for future read-only validation and generation workflows.
- Added shared Ansible, Pulumi, and Terraform/OpenTofu scaffold folders under
automation/shared/. - Added automation policies for classification, secrets, and state handling.
- Added guardrail-only Network automation under
systems/network/automation/. - Added guardrail-only Atlas automation under
systems/atlas/automation/. - Added Prometheus automation under
systems/prometheus/automation/as the first safe Ansible candidate.
- Marked Prometheus as
Automation ready / Ansible candidate. - Marked Network as
Do not automate yet. - Marked Atlas storage as
Do not automate storage yet. - Marked secrets and state decisions as
Needs decision.
Reallocated Pantheon documentation into system-owned domains after validating TODO.md against current repository structure and open GitHub issues.
Future work that remains open is tracked in GitHub issues or the branch validation queue. TODO.md now preserves the branch validation queue instead of duplicating issue-tracked backlog items.
- Moved network architecture under
systems/network/architecture/ - Moved Atlas storage and media architecture under
systems/atlas/architecture/ - Added placeholder Prometheus architecture index under
systems/prometheus/architecture/ - Removed redundant root architecture indexes after all architecture docs were allocated
- Established
systems/networkas the domain for Cerberus, Axon, access points, VLANs, DNS, DHCP, ingress, and remote access - Kept
systems/atlasas the data and storage system - Kept
systems/prometheusas the compute, runtime, and AI system
- Moved Atlas services under
systems/atlas/services/ - Moved Prometheus services under
systems/prometheus/services/ - Removed redundant root service indexes after service docs were allocated
- Moved network procedures under
systems/network/procedures/ - Moved Atlas procedures under
systems/atlas/procedures/ - Moved Prometheus procedures under
systems/prometheus/procedures/ - Copied the branch validation queue into
TODO.md - Removed redundant root procedure indexes after procedure docs were allocated
- Updated README, REFERENCES, AGENTS, template references, and ADR references for the system-domain structure
- Preserved unresolved branch work as
Needs validation
##[2026-01] Added remaining HDD drives
Added missing HDD to Atlas.
- 1 x 4tb is used as the parity drive.
- 1x 4tb added for storage.
- Atlas
Initial normalization of existing homelab documentation into a structured, reproducible repository layout.
No new architecture was introduced. All content was sourced from existing notes and build records.
- Created [[systems/atlas/architecture/data-strategy]]
- Created architecture/media-architecture.md
- Formalized zero-trust, data authority, and storage boundaries
- Documented Cerberus (OPNsense firewall)
- Documented Axon (Cisco SG350 core switch)
- Documented Atlas (Unraid NAS)
- Documented Prometheus (compute node)
- Documented wireless access points
- Documented Nextcloud (migration-safe deployment model)
- Documented AI services (compute-only workloads)
- Documented 3D scanning services (capture vs processing model)
- Documented media data flow and service boundaries
- Added Nextcloud deployment procedure
- Added Nextcloud migration procedure
- Added network rebuild procedure
- Added Atlas recovery procedure
- Introduced structured directory layout:
- architecture/
- systems/
- services/
- procedures/
- Added TODO.md to track future documentation work
- Established changelog framework
Brief description of the documentation change.
This changelog reflects the current state of documented work.
Future updates should append new entries using the template above.