Architecture

Architecture

domus-captures is the captures Antora component — one spoke in a 15-spoke documentation ecosystem aggregated by the domus-docs hub and deployed to Cloudflare Pages. Every push to this repository triggers an automatic rebuild. The architecture prioritizes single-source-of-truth partials, machine-parseable metadata, and a governance hierarchy that scales without restructuring.

Component Identity

Field Value

Name

captures

Title

Work Chronicles

start_page

ROOT:index.adoc

Nav Order

2

Category

Core

Deploy URL

docs.domusdigitalis.dev/captures/

Spoke-Hub Model

Fifteen spoke repositories publish independently. The domus-docs hub aggregates them via antora-playbook.yml. Cloudflare Pages auto-builds on any spoke push — the hub is only re-pushed when the playbook or UI bundle changes.

 domus-captures ──┐
 domus-infra-ops ─┤
 domus-ise-linux ─┤
 domus-netapi-docs┤
 domus-secrets-ops┤                  ┌──────────────────┐
 domus-antora-ui ─┼── domus-docs ──▶│ Cloudflare Pages  │
 domus-homelab ───┤    (hub)         │ docs.domus...dev  │
 domus-pki ───────┤                  └──────────────────┘
 domus-firewall ──┤
 domus-dns ───────┤
 domus-dhcp ──────┤
 domus-monitoring─┤
 domus-backup ────┤
 domus-vault ─────┤
 domus-identity ──┘

Directory Skeleton

Twenty top-level page directories organize content by function:

Directory Purpose

YYYY/MM/

Chronological captures — worklogs, meeting notes, daily documents

case-studies/tac/

Vendor TAC cases with timelines and resolution

case-studies/incidents/

Unplanned outages and security events

case-studies/changes/

Planned change requests with implementation phases

case-studies/rca/

Root cause analyses linked back to incidents

case-studies/deployments/

Deployment records with validation checklists

codex/

CLI reference library — the Arsenal

education/

Certification tracks, languages, literature, RHCSA

education/rhcsa/

Red Hat Certified System Administrator study

education/literature/

Technical and classical reading notes

patterns/

Reusable patterns with Aristotelian taxonomy

projects/

Project documentation following STD-001

projects/personal/

Personal infrastructure and tooling projects

projects/work/

Workplace projects and deployments

trackers/

Progress tracking dashboards

standards/

STD-001 through STD-020 governance documents

sessions/

Claude Code collaboration session logs

training/

Training session records and exercises

templates/

Document templates for each file prefix

drafts/

Work in progress not yet categorized

Partials Architecture

Partials hold the content; pages are thin shells with a single include:: directive. Fifteen subdirectories contain the bulk of authored material:

Directory Files Purpose

standards/

20

One partial per STD document

projects/

602

All project content — phases, features, appendices, metadata

trackers/

189

Work, personal, and education tracking tables

reference/

86

Reference material and quick-lookup content

nav/

8

Navigation partials included by nav.adoc

worklog/

21

Section templates for daily worklogs

reports/

15

Monthly summaries and periodic reports

codex/

15

CLI codex content partials

runbooks/

12

Operational runbook content

tasks/

10

Task list partials

math/

10

Mathematics study content

discoveries/

8

Discovery and exploration notes

education/

4

Education track content

objectives/

2

Strategic objective definitions

attributes.adoc

1

All shared attributes — included globally

Examples Library

The examples/ directory holds 389 files of executable code, diagrams, and drill content. Code blocks in partials reference these via include::example$category/name.ext[] to maintain a single source of truth.

Category Files Content

api/

 — 

API interaction scripts and payloads

codex/

 — 

CLI reference code snippets

commands/

 — 

Command examples for codex entries

diagrams/

 — 

D2 and ASCII diagram source files

terminal/

 — 

Terminal session recordings and output

math/

 — 

Mathematical notation and computation examples

music/

 — 

Music theory notation files

monad/

 — 

Functional programming monad examples

navigation/

 — 

Nav structure examples

regex-drills/

 — 

Regular expression practice exercises

jq-drills/

 — 

jq filter and transformation drills

python-drills/

 — 

Python practice exercises

lua-drills/

 — 

Lua scripting drills

etl-drills/

 — 

ETL pipeline practice

lab/

 — 

Lab environment scripts and configs

claude/

28

AI context files for Claude Code agents

outputs/

 — 

Generated output samples