@riligar/agents-kit 1.0.0

package/.agent/skills/riligar-design-system/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: riligar-design-system
+description: Especialista no Sistema Visual da RiLiGar. Use para: (1) Criação de interfaces web e mobile (Light/Dark Mode), (2) Implementação de componentes UI (Mantine Only), (3) Garantir estética minimalista "Content-First", (4) Aplicar tokens de design via Mantine Theme.
+license: Apache-2.0
+---
+
+# RiLiGar Design System Expert
+
+Você é um especialista em design e interface seguindo as diretrizes da RiLiGar. Sua missão é garantir que qualquer código gerado use **APENAS** a API do Mantine 8, sem CSS customizado ou inline.
+
+## Filosofia: "Content-First" & "Theme-Aware"
+
+A interface deve ser invisível e funcionar perfeitamente em Light e Dark Mode.
+
+-   **Estrutura:** Whitespace e alinhamento preciso.
+-   **Estética:** Monocromática, funcional, estilo Notion/Linear.
+-   **Técnica:** Zero CSS files. Zero `style={{}}`. Tudo via Props.
+
+## Guia de Referência
+
+Para atingir a excelência:
+
+-   **[Excellence Patterns](references/master-patterns.md)**: Código "Gold Standard" usando Mantine Props. **Sempre use como base.**
+-   **[Theme Config](assets/theme.js)**: Configuração do tema com suporte a Dark Mode automático.
+-   **[Visual references](references/visual-references.md)**: Mapeamento de nuances estéticas.
+-   **[Anti-patterns](references/anti-patterns.md)**: O que evitar (especialmente CSS inline).
+
+## Checklist de Lapidação (RiLiGar Excellence)
+
+Antes de entregar qualquer interface, o agente **DEVE** validar:
+
+1. [ ] Configurei `defaultProps` no theme.js para evitar repetição de props?
+2. [ ] O código do componente está "limpo"? (Ex: `<Button>Save</Button>` sem `radius/size`).
+3. [ ] Removi **TODO** o CSS inline (`style={{}}`)?
+4. [ ] Usei props semânticas do Mantine (`bd`, `bg`, `c`)?
+5. [ ] As cores são semânticas e theme-aware? (Ex: `c="dimmed"`).
+6. [ ] Removi todas as tags HTML nativas (`div`, `button`)?
+7. [ ] Usei Montserrat via font-family do tema?
+8. [ ] O padding vertical em listas e tabelas é compacto?
+9. [ ] Os ícones usam `stroke={1.5}`?
+10. [ ] O resultado é "Clean" e livre de ruído visual?
+
+## Princípios de Implementação
+
+1. **Theme First:** Se você está repetindo `size="sm"` em todo lugar, mova para `theme.components`.
+2. **Mantine Nativo:** Use APENAS a API do Mantine. Zero CSS files.
+3. **Semântica:** Use `bg="default"` ou `bg="body"` para superfícies que mudam com o tema.
+4. **Bordas:** Use `withBorder` em componentes ou `bd` em Caixas.
+5. **Tipografia:** Use `Title`, `Text` e `Code` do sistema.
+
+## Instruções de Geração
+
+Ao gerar UI, sempre prefira as estruturas em **[Master Patterns](references/master-patterns.md)**.
+
+**Atenção:** Código verboso com muitas props repetidas será considerado uma falha de design system.

package/.agent/skills/riligar-design-system/assets/theme.js

@@ -0,0 +1,113 @@
+/**
+ * RiLiGar Design System - Mantine 8 Theme
+ * Estética minimalista e adaptável (Light/Dark Mode).
+ *
+ * CENTRALIZAÇÃO TOTAL:
+ * Toda a configuração visual (sizes, borders, radius) DEVE estar aqui.
+ * O código do componente deve ser limpo.
+ */
+
+import { createTheme, rem } from '@mantine/core'
+
+export const rlgTheme = createTheme({
+    fontFamily: 'Montserrat, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif',
+
+    colors: {
+        // Escala Neutra Universal (Substitui o gray padrão)
+        gray: [
+            '#F9FAFB', // 0: App Background
+            '#F3F4F6', // 1: Hover/Subtle
+            '#E5E7EB', // 2: Borders
+            '#D1D5DB', // 3: Disabled
+            '#9CA3AF', // 4: Placeholder
+            '#6B7280', // 5: Text Secondary
+            '#4B5563', // 6: Text Primary Soft
+            '#374151', // 7: Text Primary
+            '#1F2937', // 8: Headers
+            '#11181C', // 9: Absolute Black
+        ],
+        // Semânticos
+        error: ['#FEF2F2', '#FEE2E2', '#FECACA', '#FCA5A5', '#F87171', '#EF4444', '#DC2626', '#B91C1C', '#991B1B', '#7F1D1D'],
+        success: ['#F0FDF4', '#DCFCE7', '#BBF7D0', '#86EFAC', '#4ADE80', '#22C55E', '#16A34A', '#15803D', '#166534', '#14532D'],
+    },
+
+    primaryColor: 'dark', // Escala dark mapeada para cinzas
+    autoContrast: true,
+
+    defaultRadius: 'md', // 6px
+
+    components: {
+        // --- LAYOUT & CONTAINERS ---
+        Paper: {
+            defaultProps: {
+                withBorder: true,
+                shadow: 'none',
+                radius: 'lg', // 8px para containers
+            },
+        },
+        Card: {
+            defaultProps: {
+                withBorder: true,
+                shadow: 'none',
+                radius: 'lg',
+                padding: 'md',
+            },
+        },
+
+        // --- DATA DISPLAY ---
+        Table: {
+            defaultProps: {
+                verticalSpacing: 'xs', // 8px density
+                horizontalSpacing: 'md',
+                withRowBorders: true,
+                highlightOnHover: true,
+            },
+        },
+        Badge: {
+            defaultProps: {
+                size: 'sm',
+                radius: 'sm',
+                variant: 'light',
+                fw: 500,
+            },
+        },
+
+        // --- INPUTS & ACTIONS ---
+        Button: {
+            defaultProps: {
+                size: 'sm', // 32px
+                fw: 500,
+                radius: 'md',
+            },
+            // Variações semânticas via theme vars se necessário
+        },
+        TextInput: {
+            defaultProps: {
+                size: 'sm', // 32px height
+                radius: 'md',
+            },
+            styles: theme => ({
+                input: {
+                    border: `1px solid ${theme.colors.gray[2]}`, // Garante borda 1px
+                    '&:focus': {
+                        borderColor: theme.colors.dark[8],
+                    },
+                },
+            }),
+        },
+        Select: {
+            defaultProps: {
+                size: 'sm',
+                radius: 'md',
+            },
+        },
+        ActionIcon: {
+            defaultProps: {
+                size: 'sm', // 26px context triggers
+                variant: 'subtle',
+                color: 'gray',
+                radius: 'md',
+            },
+        },
+    },
+})

package/.agent/skills/riligar-design-system/references/anti-patterns.md

@@ -0,0 +1,36 @@
+# Anti-Patterns: O que NÃO é RiLiGar
+
+Para atingir a excelência, devemos eliminar vícios de design comum que deixam a interface com cara de "genérica".
+
+| Erro Comum                  | Por que é ruim?                                         | A Solução RiLiGar                                   |
+| :-------------------------- | :------------------------------------------------------ | :-------------------------------------------------- |
+| **Sombras Drop (Pesadas)**  | Adiciona ruído visual e amadorismo.                     | `border: 1px solid #E5E7EB`.                        |
+| **Azul "Bootstrap"**        | Cor saturada demais para a estética minimalista.        | Use `#000000` (Preto) ou um azul marinho `#11181C`. |
+| **Pillings (Radius total)** | Lembra apps mobile infantis ou Google Material antigos. | `border-radius: 6px`. Retangular com quinas suaves. |
+| **Inputs Gigantes**         | Quebram a densidade de informação útil.                 | `height: 32px`. Compacto e focado.                  |
+| **Gradientes Lineares**     | Introduzem profundidade desnecessária.                  | Cores puras e sólidas (Flat).                       |
+| **Divisores Escuros**       | Chamam mais atenção que o próprio conteúdo.             | Use `#F3F4F6` para divisores internos.              |
+
+## Exemplo de Refatoração (Cérebro do Agente)
+
+**❌ Antes (Design Comum):**
+
+```html
+<div style="box-shadow: 0 4px 6px rgba(0,0,0,0.1); border-radius: 20px; padding: 20px; background: blue;">
+    <h1 style="color: white; font-weight: 800;">User Info</h1>
+    <button style="border-radius: 50px; padding: 10px 20px;">Click Me</button>
+</div>
+```
+
+**✅ Depois (RiLiGar Excellence):**
+
+```html
+<div style="border: 1px solid #E5E7EB; border-radius: 8px; padding: 16px; background: #FFF;">
+    <h3 style="color: #11181C; font-weight: 600; font-size: 14px; margin-bottom: 8px;">User Info</h3>
+    <button style="border-radius: 6px; height: 32px; padding: 0 12px; background: #000; color: #FFF; font-size: 12px;">Action</button>
+</div>
+```
+
+---
+
+_Lembre-se: O design RiLiGar é sobre **restrição**. Se você pode remover uma borda ou uma cor e o app ainda funciona, remova._

package/.agent/skills/riligar-design-system/references/design-system.md

@@ -0,0 +1,113 @@
+# Diretrizes de Design & Sistema Visual
+
+> Baseado na análise de UI Minimalista/SaaS Premium (Notion)
+
+## 1. Filosofia Visual: "Content-First"
+
+A interface deve recuar para deixar o conteúdo brilhar. A estética é utilitária, limpa e focada na densidade de informação sem sacrificar a legibilidade.
+
+- **Minimalismo:** Remover ornamentos desnecessários (sombras pesadas, gradientes complexos).
+- **Estrutura:** O design depende de alinhamento preciso e espaço em branco (whitespace), não de caixas coloridas.
+
+## 2. Tipografia
+
+A tipografia é a principal ferramenta de estrutura da interface.
+**Família:** Montserrat (Geométrica e Moderna).
+
+| Função                 | Peso            | Cor                    | Tracking  |
+| :--------------------- | :-------------- | :--------------------- | :-------- |
+| **Corpo / Dados**      | Regular (400)   | `#11181C` (Primário)   | Normal    |
+| **Cabeçalhos Tabela**  | Medium (500)    | `#687076` (Secundário) | Normal    |
+| **Botões / Ações**     | Medium (500)    | Variável               | `-0.01em` |
+| **Títulos (H1, H2)**   | Semi-Bold (600) | `#11181C` (Primário)   | `-0.02em` |
+| **Labels / Metadados** | Regular (400)   | `#737373` (Terciário)  | Normal    |
+
+**Hierarquia de Cores de Texto:**
+
+1.  **Primária:** `#11181C` ou `#171717` (Quase preto, nunca `#000000`).
+2.  **Secundária:** `#687076` (Cinza neutro para suporte).
+3.  **Terciária:** `#B0B0B0` (Desabilitado ou placeholder).
+
+## 3. Paleta de Cores & Superfícies
+
+Uso estrito de monocromia com cores semânticas apenas quando necessário.
+
+- **Fundos (Backgrounds):**
+  - _App Base:_ `#FFFFFF` (Branco Puro).
+  - _Sidebars / Headers:_ `#FAFAFA` ou `#F9FAFB` (Cinza ultra-sútil).
+- **Bordas:**
+  - _Padrão:_ `#E5E7EB` ou `#E2E8F0` (Sutil, 1px).
+- **Acentos (Action Colors):**
+  - _Brand/Primary:_ `#000000` (Preto Sólido) ou Azul Índigo Profundo.
+  - _Feedback:_ Cores pastéis no fundo, texto saturado.
+    - _Erro:_ Bg `#FEF2F2` / Text `#991B1B`.
+    - _Sucesso:_ Bg `#F0FDF4` / Text `#166534`.
+
+## 4. Componentes (UI Kit)
+
+### Botões
+
+- **Altura:** `32px` (Small/Dense) ou `36px` (Regular).
+- **Border-Radius:** `6px` a `8px` (Suave, mas não "pill").
+- **Estilos:**
+  - _Primary:_ Fundo Preto, Texto Branco. Hover suave.
+  - _Secondary/Ghost:_ Fundo Transparente, Texto Cinza. Hover com bg `#F3F4F6`.
+
+### Tabelas & Listas
+
+- **Estilo:** "Clean Rows".
+- **Bordas:** Apenas linhas horizontais (`border-bottom`). Sem linhas verticais.
+- **Hover:** Linhas destacam com cinza pálido (`#F9FAFB`) ao passar o mouse.
+- **Padding:** Compacto (`py-2`, `px-4`) para alta densidade de dados.
+
+### Inputs
+
+- **Borda:** `1px solid #E5E5E5`.
+- **Foco:** Ring duplo sutil (ex: `ring-2 ring-gray-200`) ou borda escurecida. Nunca glow neon forte.
+
+## 5. Layout & Espaçamento
+
+- **Respiro:** Margens generosas ao redor do container principal, mas densidade alta dentro dos componentes de dados.
+- **Navegação:** Sidebar fixa para contexto global; Topbar simples para contexto local.
+
+## 6. Micro-interações
+
+- **Animações:** Rápidas e invisíveis (150ms - 200ms ease-out).
+- **Sombras:** Usadas apenas para elevação (Modais, Dropdowns).
+  - _Drop Shadow:_ Suave e difusa (`0 4px 20px rgba(0,0,0,0.05)`).
+
+## 7. Diretrizes para Geração via LLM (Prompting Helper)
+
+> Use estas instruções para garantir que a IA gere resultados fiéis ao design system.
+
+### Keywords Essenciais (Contexto)
+
+Sempre inclua estas palavras-chave no prompt de geração de UI:
+`"Linear-style interface"`, `"Notion-like aesthetic"`, `"High density data"`, `"Clean minimalist SaaS"`, `"Monochrome color palette with subtle borders"`, `"Inter/Montserrat typography"`, `"1px border separation"`.
+
+### Regras de Ouro (Constraints)
+
+1.  **NUNCA** use sombras coloridas ou "glow" efeitos.
+2.  **NUNCA** use fundos saturados para containers (apenas branco ou cinza muito claro).
+3.  **EVITE** cartões (cards) com sombras pesadas para agrupar conteúdo. Use **linhas e bordas sutis** para separar seções.
+4.  **Botões:** Evite botões grandes e chamativos. O botão primário deve ser discreto (preto/branco), e os secundários devem ser quase invisíveis até o hover.
+
+### Estrutura de Prompt Recomendada
+
+Ao pedir código ou design para uma IA, use este formato:
+
+> "Crie uma interface [Tela/Componente] seguindo uma estética estritamente minimalista (estilo Notion). Use a fonte Montserrat. O layout deve ser denso, focado em dados, sem sobras desnecessárias. Use bordas de 1px (#E5E5E5) para separação em vez de cards flutuantes. Cores: Preto (#11181C) para texto principal, Cinza (#687076) para secundário. Fundo branco puro."
+
+### Tratamento de Casos Especiais
+
+- **Empty States:** Devem ser minimalistas. Um ícone de linha fina (stroke 1.5px) em cinza claro, um título em H3 e um botão de ação. Nada de ilustrações 3D coloridas.
+- **Modais:** Devem ter um backdrop com blur (`backdrop-blur-sm`) e fundo branco sólido. Sem cabeçalhos coloridos.
+- **Dashboards:** Devem privilegiar números grandes (Big Numbers) em monocromia, com rótulos pequenos abaixo. Gráficos devem ser limpos, sem grid lines pesadas.
+
+---
+
+## 🤖 Integração com Gemini CLI
+
+Este repositório possui uma **Skill do Gemini CLI** configurada em [`riligar-design-system/SKILL.md`](../SKILL.md). Ao usar o Gemini CLI neste repositório, o agente aplicará automaticamente estas diretrizes a qualquer código ou design gerado.
+
+Para saber como usar, veja o [README principal](../../README.md).

package/.agent/skills/riligar-design-system/references/master-patterns.md

@@ -0,0 +1,140 @@
+# Master Patterns: Mantine Clean Code
+
+O código deve ser limpo. A customização visual vive no **Tema**, não no componente.
+
+## 1. Sidebar (Clean)
+
+```jsx
+import { Stack, Box, Text, UnstyledButton, Group } from '@mantine/core'
+import { IconHome, IconSettings } from '@tabler/icons-react'
+
+function Sidebar() {
+    return (
+        // bg="gray.0" -> Layer 0 (Canvas) [Visual-Code Dictionary §2]
+        // bd="solid gray.2" -> Layer 1 Separation [Visual-Code Dictionary §2]
+        // p="sm" -> Layout Rhythm (Section) [Visual-Code Dictionary §1]
+        <Box
+            w={260}
+            h="100vh"
+            bg="gray.0"
+            bd={{ base: '1px solid gray.2' }}
+            p="sm"
+        >
+            <Stack gap={4}>
+                <NavItem
+                    icon={IconHome}
+                    label="Home"
+                    active
+                />
+                <NavItem
+                    icon={IconSettings}
+                    label="Settings"
+                />
+            </Stack>
+        </Box>
+    )
+}
+
+function NavItem({ icon: Icon, label, active }) {
+    return (
+        <UnstyledButton
+            data-active={active || undefined}
+            w="100%"
+            p="xs" // Component Rhythm (8px) [Visual-Code Dictionary §1]
+            // Radius md (6px) -> Defined in theme, enforced here for clarity
+            style={{ borderRadius: 'var(--mantine-radius-md)' }}
+            bg={active ? 'white' : 'transparent'}
+            c={active ? 'text' : 'dimmed'}
+        >
+            <Group gap="xs">
+                {/* Excellence Nuance #1: Stroke 1.5 [Visual-Code Dictionary §4] */}
+                <Icon
+                    size={16}
+                    stroke={1.5}
+                />
+                <Text
+                    size="sm"
+                    fw={500}
+                >
+                    {label}
+                </Text>
+            </Group>
+        </UnstyledButton>
+    )
+}
+```
+
+## 2. Tabela (Zero Props)
+
+```jsx
+import { Table, Text, Badge } from '@mantine/core'
+
+// Note a ausência de props de estilo.
+// O <Table> já vem com spacing e borders configurados no tema.
+// [Visual-Code Dictionary §3: Table Row Anatomy]
+function DenseTable({ data }) {
+    return (
+        <Table>
+            <Table.Thead>
+                <Table.Tr>
+                    <Table.Th>NAME</Table.Th>
+                    <Table.Th>STATUS</Table.Th>
+                </Table.Tr>
+            </Table.Thead>
+            <Table.Tbody>
+                {data.map(item => (
+                    <Table.Tr key={item.id}>
+                        <Table.Td>
+                            <Text fw={500}>{item.name}</Text>
+                        </Table.Td>
+                        <Table.Td>
+                            <Badge color="gray">{item.status}</Badge>
+                        </Table.Td>
+                    </Table.Tr>
+                ))}
+            </Table.Tbody>
+        </Table>
+    )
+}
+```
+
+## 3. Cards (Clean)
+
+```jsx
+import { Paper, Text, Group, Button, Stack, Box } from '@mantine/core'
+
+function ContentCard() {
+    return (
+        // <Paper> já vem com border e radius corretos do tema
+        // [Visual-Code Dictionary §2: Layer 1 Card]
+        <Paper overflow="hidden">
+            <Box
+                p="md"
+                py="xs"
+                bg="gray.0"
+                bd={{ bottom: '1px solid gray.2' }}
+            >
+                <Text fw={600}>Project Alpha</Text>
+            </Box>
+
+            <Stack
+                p="md"
+                gap="sm"
+            >
+                <Text
+                    c="dimmed"
+                    size="sm"
+                >
+                    Descrição limpa e focada.
+                </Text>
+
+                <Group justify="flex-end">
+                    {/* Variantes e tamanhos vêm do defaultProps do tema */}
+                    <Button variant="default">Cancel</Button>
+                    <Button>Save</Button>
+                </Group>
+            </Stack>
+        </Paper>
+    )
+}
+```

package/.agent/skills/riligar-design-system/references/visual-references.md

@@ -0,0 +1,71 @@
+# Dicionário Visual (Visual-Code Dictionary)
+
+Este documento traduz "Sensação Visual" em "Regras de Código". Use-o para eliminar a subjetividade.
+
+## 1. Ritmo & Espaçamento (Layout Rhythms)
+
+A densidade do RiLiGar é definida matematicamente. Não adivinhe, use estas medidas.
+
+| Nível         | Medida  | Token Mantine        | Onde Usar                                                           |
+| :------------ | :------ | :------------------- | :------------------------------------------------------------------ |
+| **Micro**     | `4px`   | `gap="xs"` (half)    | Espaço entre Ícone e Texto.                                         |
+| **Component** | `8px`   | `p="xs"`, `gap="xs"` | Padding interno de Botões, Inputs, Table Cells.                     |
+| **Flow**      | `12px`  | `gap={12}`           | Espaço entre elementos de um formulário ou lista vertical de cards. |
+| **Section**   | `16px`  | `p="md"`, `gap="md"` | Padding padrão de Cards, Modais e Sidebars.                         |
+| **Layout**    | `24px+` | `p="lg"`, `gap="lg"` | Margens da página, separação de grandes blocos.                     |
+
+## 2. Regra das 3 Camadas (Depth Stacking)
+
+Para evitar o visual "chapado", use esta hierarquia estrita de cores e bordas.
+
+### Layer 0: O Canvas (Fundo)
+
+-   **Cor:** `bg="gray.0"` (`#F9FAFB` Light / Dark Auto-adapt).
+-   **Uso:** O fundo de toda a aplicação. Nunca use branco puro (`#FFF`) no fundo da página.
+
+### Layer 1: O Conteúdo (Cards/Surface)
+
+-   **Cor:** `bg="white"` (Light) / `bg="gray.9"` (Dark).
+-   **Borda:** `bd="1px solid gray.2"` (Essencial para recorte).
+-   **Sombra:** `shadow="none"` (A borda faz o trabalho de separação).
+-   **Radius:** `radius="lg"` (8px).
+
+### Layer 2: O Feedback (Hover/Overlay)
+
+-   **Hover:** `bg="gray.0"` (Interação sutil).
+-   **Active:** `bg="gray.1"` (Seleção).
+-   **Overlay:** `shadow="lg"` + `bd="gray.2"` (Apenas para Popovers e Modais).
+
+## 3. Anatomia Atômica (Component Specifications)
+
+Se você for criar um destes componentes, ele **DEVE** seguir estas medidas exatas.
+
+### Sidebar Item (Linear Style)
+
+-   **Altura:** `32px` ou `28px` (Ultra-denso).
+-   **Padding:** `px="xs"` (8px horizontal).
+-   **Radius:** `radius="md"` (6px).
+-   **Fonte:** `size="sm"` (13px), `fw={500}`.
+-   **Cor:** Default `c="dimmed"`, Active `c="text"`, Hover `bg="gray.1"`.
+
+### Table Row (Notion Style)
+
+-   **Altura:** `36px` (Conteúdo + Padding).
+-   **Borda:** `borderBottom: '1px solid gray.1'` (Nota: gray.1, mais sutil que a borda do card).
+-   **Header:** `c="dimmed"`, `fw={600}`, `fz="xs"` (12px), `textTransform="uppercase"`.
+-   **Cell:** `fz="sm"` (13px ou 14px).
+
+### Page Header
+
+-   **Altura:** `48px` ou `56px`.
+-   **Fundo:** `bg="gray.0"` (Transparente/Blur opcional).
+-   **Borda:** `borderBottom: '1px solid gray.2'`.
+-   **Conteúdo:** Título `h4` (`fw={600}`), Ações à direita.
+
+## 4. Nuances de "Excellence"
+
+1.  **Ícones:** Sempre use `stroke={1.5}`. Ícones mais grossos (2px) parecem "infantis" neste design system. Tamanho padrão `16px` ou `18px`.
+2.  **Tracking:**
+    -   Títulos (H1-H3): `letter-spacing: -0.02em` (Aperta o título, visual premium).
+    -   Botões/Labels: `letter-spacing: -0.005em` (Leve toque de densidade).
+3.  **Bordas:** Nunca use `#000` ou `#DDD`. Use sempre o token `gray.2` do tema, que é calibrado para ser visível mas não intrusivo.

package/.agent/skills/riligar-dev-autopilot/SKILL.md

@@ -0,0 +1,63 @@
+---
+name: riligar-dev-autopilot
+description: Automação do ciclo de vida de desenvolvimento: Validação com Bun, Auto-correção, Commit Semântico e Deploy.
+license: Apache-2.0
+metadata:
+    author: riligar
+    version: '1.0'
+---
+
+# RiLiGar Dev-Autopilot Expert
+
+Você é responsável por garantir que cada interação do chat resulte em código funcional e entregue. Sua missão é fechar o ciclo entre o "escrever código" e o "código em produção".
+
+## 1. Filosofia do Loop
+
+-   **Confiança:** O código não é considerado pronto até ser validado.
+-   **Autonomia:** Corrigir erros triviais (lint, build, testes simples) sem onerar o usuário.
+-   **Velocidade:** Uso intensivo do Bun para ciclos de feedback instantâneos.
+-   **Transparência:** Commits claros que explicam a evolução da história/bug.
+
+## 2. Fluxo de Trabalho Obrigatório
+
+Toda vez que uma alteração de código for finalizada, você deve seguir este fluxo:
+
+### Passo 1: Validação (Bun)
+
+-   **Check:** Executar `bun run lint` ou `bun x eslint .` para garantir padrões.
+-   **Testes:** Rodar testes unitários/integração com `bun test`.
+-   **Build:** Se for um projeto compilado (Vite), rodar `bun run build`.
+-   **Auto-Correção:** Se houver erros, ANALISE a stack trace, CORRIJA o código e RE-VALIDE. Tente até 2 vezes antes de pedir ajuda ao usuário.
+
+### Passo 2: Versionamento (Commit Semântico)
+
+-   Se a validação passar, gere uma mensagem de commit seguindo o padrão **Conventional Commits**:
+    -   `feat:` para novas histórias.
+    -   `fix:` para correções de bugs.
+    -   `refactor:` para melhorias de código sem mudança de comportamento.
+    -   `docs:` para documentação.
+
+### Passo 3: Publicação & Deploy
+
+-   **Push:** Executar o comando `git-publish` (ou o atalho `gcp`).
+-   **Deploy:**
+    -   Se for infra Fly.io: Executar `fly deploy`.
+    -   Se for via GitHub Actions: O push para a branch principal deve disparar o fluxo.
+
+## 3. Regras de Interface com o Usuário
+
+Ao concluir o loop com sucesso, apresente um resumo:
+
+-   ✅ **Validado:** [Comando executado] (ex: `bun test` passou).
+-   📦 **Commit:** `[mensagem de commit]`
+-   🚀 **Status:** Deploy iniciado/concluído.
+
+Se falhar após as tentativas de auto-correção:
+
+-   ❌ **Erro:** Explique detalhadamente o que falhou e mostre o log.
+-   💡 **Ação:** Pergunte como o usuário deseja proceder.
+
+## 4. Integração com Tech Stack
+
+-   **Bun First:** Sempre prefira `bun` como gerenciador de pacotes e runtime.
+-   **Mantine/React:** Verifique se as novas bibliotecas seguem o `riligar-design-system`.