Repositório central de provisionamento de sistema operacional, dotfiles estáticos de aplicativos de interface gráfica e configurações de estações de trabalho limpas.
Este repositório não é um amontoado caótico de dotfiles, mas a fundação arquitetural de uma estação de trabalho estrita e modular guiada pelos 17 Princípios UNIX (The Art of UNIX Programming, 2003) e pelas práticas de Clean Code:
- "Clean Host" (Isolamento Extremo): O sistema operacional nativo (o host) permanece o mais puro e leve possível. Ele provê apenas a interface gráfica (Wayland nativo via GNOME no Fedora ou KDE Plasma no FreeBSD), drivers de hardware, navegadores, editores de código e a camada de virtualização/hypervisor. Nenhum banco de dados ou ambiente de desenvolvimento de projeto polui o host.
- Modularidade da Tríade ("Uma coisa, um lugar"):
- Reprodutibilidade com ZFS & Idempotência: Adoção de ZFS como fundação para snapshots instantâneos e replicação rápida, aliada a scripts de bootstrap que podem ser executados repetidamente com segurança.
📖 Leituras Obrigatórias:
- Princípios de Engenharia (PRINCIPLES.md) — Os 17 Princípios UNIX e Clean Code detalhados.
- Filosofia do Ecossistema (docs/PHILOSOPHY.md)
- Containers & Jails (docs/CONTAINERS.md)
- Hypervisors & ZVOLs (docs/HYPERVISORS.md)
bootstrap/— Provisionamento e Automação de Sistema (O "COMO"): Catálogo modular de receitas (.sh,.cmde.ps1) com privilégios de sistema para instalar pacotes, drivers, containers e serviços:freebsd/— Infraestrutura base (common/), Containers (Jails & Bastille), Workstation Desktop (KDE Plasma) e Server KVM.linux/— Infraestrutura base (common/), Containers (Incus & Podman), Workstations Desktop (Fedora, Arch, Debian), Servidores Cloud e WSL2 (wsl/).windows/— Ferramentas nativas (native/) e subsistema MSYS2 (msys2/UCRT64).common/— Receitas universais multiplataforma compartilhadas entre Linux, FreeBSD e Windows (fontes, linters, editores, vcs).
software/— Dotfiles e Configurações Declarativas de Usuário (O "O QUÊ"): Arquivos estáticos puros (.json,.toml,.yaml,.profile) no espaço do usuário ($HOME):editors/— Antigravity, VS Code, VSCodium, Zed, Emacs (lite.el) e Vim (lite.vim).terminals/— Konsole (KDE), Windows Terminal, CMD (Clink), PowerShell e NuShell.tools/— Formatadores e linters globais (.clang-format,.prettierrc,.stylua.toml,clangd.yaml).browsers/— Ajustes de navegadores no host (Firefox).
skills/— Habilidades & Runbooks Portáteis para IA (O "COMO OPERAR"): Catálogo modular de skills e procedimentos para agentes de IA (Google Antigravity, Gemini, OpenAI, Claude) com ativação sob demanda via.agents/skills/.scripts/— Utilitários pontuais de compilação local (build), conversão de arquivos e modificações de registro do Windows.docs/— Documentação técnica abrangente da estação de trabalho.
Diferente do Vault (que você clona privadamente) ou do Shell (que você clona e faz source contínuo), o Configuration foi concebido como um Catálogo de Receitas Modular:
- Acesso Direto pelo GitHub: Não é necessário clonar este repositório para utilizá-lo. Navegue pelos arquivos diretamente na interface web do GitHub.
- Cópia e Cola / Download Pontual: Quando precisar de uma configuração de editor ou formatador, baixe ou copie os arquivos declarativos puros (
.json,.toml,.yaml) desoftware/. - Receitas Autônomas de Sistema: Quando estiver provisionando ou ajustando um software no Fedora, FreeBSD ou Windows, execute a receita específica correspondente em
bootstrap/.
Consulte PRINCIPLES.md para conhecer os 17 princípios UNIX, diretrizes Clean Code, permissões canônicas em 4 dígitos (0755/0644/0440) e o Template Canônico de Receitas.