# AGENTS.md

Instrucoes para agentes trabalhando neste repositorio.

## Escopo
- Este repo guarda configuracoes do NixOS e componentes relacionados.
- Priorize mudancas simples, pequenas e revisaveis.

## Estrutura
- `nixos/configuration.nix`: configuracao principal do sistema.
- `nixos/hardware-configuration.nix`: gerado pelo NixOS; edite somente se solicitado.
- `nixos/secrets.nix`: contem segredos; nao exibir nem registrar valores.
- `hypr/hyprland.conf`: configuracao do Hyprland.
- `hypr/hyprpaper.conf`: wallpaper do Hyprpaper.
- `doom/config.el`: configuracao do Doom Emacs (edite este arquivo).
- `doom/config.org`: atualmente nao esta funcionando; nao usar como fonte.
- `doom/init.el`: modulos do Doom Emacs.
- `doom/packages.el`: pacotes adicionais do Doom Emacs.
- `doom/custom.el`: customizacoes do Emacs (gerado).

## Boas praticas
- Evite alterar `hardware-configuration.nix` sem pedido explicito.
- Nao imprimir segredos, tokens ou chaves.
- Prefira blocos Nix claros e agrupados por topico.
- Ao adicionar servicos, habilite apenas o necessario.

## Waybar (AC)
- `waybar/air_control.py` usa apenas stdlib (`urllib`) para falar com o Home Assistant.
- Alteracoes de setpoint/modo/fan sao imediatas na UI, com envio real atrasado (debounce) via arquivos em `~/.cache/`.
- `fan_only` e `dry` mostram sempre a temperatura atual (room) no display.
- Indicador pequeno de fan speed aparece como subscrito ao lado do icone.
- `waybar/config` (modulo `custom/ac`): clique alterna on/off, clique direito cicla modos (sem `off`), clique do meio cicla fan; `interval` esta em 3s.

## Aplicar mudancas
- Rebuild: `sudo nixos-rebuild switch`
- Validar sintaxe basica: `nix-instantiate --parse nixos/configuration.nix`

## Commits
- Use mensagens curtas e descritivas em ingles.
- Desative assinatura se o GPG falhar.