GuardianContext

Contexto em Git para a próxima sessão de programação

GuardianContext organiza regras, decisões e tarefas no seu repositório e ajuda agentes de programação a recuperar o contexto relevante antes de trabalhar. Use com pessoas e agentes que precisam dar continuidade ao mesmo projeto, inclusive em sessões separadas de Codex e Claude Code.

O contexto fica em arquivos Markdown versionados no Git. Você pode revisar uma decisão no diff, localizar sua origem e preparar um briefing para a próxima tarefa.

Manual de uso · Site do produto · Suporte

Uma decisão registrada volta ao contexto da tarefa

Você definiu como fazer migrations e quer que a próxima sessão consulte essa regra. Depois de inicializar o GuardianContext, crie o arquivo decisoes/0001-migrations.md com este exemplo:

# Migrations de banco

Toda migration deve incluir um plano de rollback e ser revisada antes do deploy.

Atualize o índice local e prepare um briefing:

guardian index rebuild --lexical
guardian brief "migrations" --tool agents --max-tokens 1500

O briefing inclui trechos encontrados e os caminhos dos arquivos de origem. Neste exemplo, a decisão sobre migrations pode ser consultada antes de alterar o banco. Entregue o briefing ao agente e revise as ações propostas.

O exemplo usa busca textual, disponível no pacote básico. A qualidade do contexto recuperado depende dos documentos registrados e dos termos da tarefa.

O que você pode fazer

As reservas e verificações ajudam a coordenar o trabalho. Sua eficácia depende da configuração e do uso pelos participantes. Continue revisando diffs, testes e commits; o GuardianContext não garante que agentes sigam as decisões registradas.

Instale e conecte seu repositório

O caminho recomendado instala o ambiente Python 3.11 e abre o Desktop Manager. O instalador usa o uv e inclui os componentes de busca semântica, desktop, MCP e atualização.

Windows (PowerShell)

irm https://api.ironstack.dev.br/install.ps1 | iex

macOS / Linux

curl -fsSL https://api.ironstack.dev.br/install.sh | sh

Os comandos baixam e executam o instalador oficial. Você pode abrir a URL para inspecionar o script antes de executar. A instalação pode baixar Python e componentes adicionais; a busca semântica baixa um modelo no primeiro uso. No Linux, a interface gráfica também requer as bibliotecas do Qt.

No Desktop Manager:

1. Crie sua conta com aceite dos Termos de Uso ou entre na conta existente.
2. Escolha a pasta de um repositório Git e o modo de trabalho da equipe.
3. Execute a configuração e confira o diagnóstico apresentado.

Se a janela não abrir, execute guardian-desktop em um terminal novo. A configuração MCP requer selecionar o cliente, registrar a integração e revisar sua solicitação de confiança em uma nova sessão nativa. Instalar o pacote, por si só, não conecta todos os agentes.

Alternativa pelo terminal

Para experimentar a estrutura e a busca textual local, instale o pacote básico com uv e abra seu repositório:

uv tool install --python 3.11 guardiancontext
cd meu-repositorio
guardian init
guardian doctor

Substitua meu-repositorio pela pasta do seu projeto. Esses passos criam e verificam a estrutura local; não instalam hooks nem registram MCP. Para conectar a conta ao serviço, use guardian signup ou guardian login nessa pasta. Senhas são solicitadas interativamente.

O pacote básico requer Python 3.9 ou superior; o ambiente recomendado para os componentes opcionais é Python 3.11. Consulte o manual para instalar os extras, configurar os hooks e escolher entre pasta compartilhada e worktrees separadas.

Arquivos, dados e atualização

• A estrutura padrão inclui router.md, quadro.md, wiki/, decisoes/, claims/, handoffs/ e docs/trabalho/. O estado e o índice local ficam em .guardian/. Revise os arquivos gerados antes de adicioná-los ao Git.
• Os comandos locais de estrutura e busca podem funcionar sem conexão com o serviço. Cadastro, sincronização e recursos sujeitos a licença têm requisitos próprios de conexão e autorização.
• O relatório de auditoria envia métricas e contagens. A sincronização de padrões envia metadados e vetores. Nas chamadas ao serviço, o cliente também informa versão, interface e um identificador aleatório do perfil de instalação.
• guardian contribute permite propor um documento à biblioteca curada. O texto passa por anonimização e é apresentado para revisão antes da confirmação do envio. Revise o conteúdo para evitar compartilhar informações sensíveis.
• A chave de API fica no perfil do usuário, fora do repositório. Configurações MCP contêm caminhos da máquina e devem seguir as orientações do manual.
• Instalações oficiais usam atualização automática com verificações de segurança e adiamento quando o runtime está em uso. Consulte guardian update status. Outras formas de instalação podem exigir atualização manual.

Manual e suporte

Consulte o manual completo. O manual incluído no pacote também pode ser lido sem conexão:

guardian manual --lang pt
guardian manual --lang en
guardian manual --lang es

Para reportar um problema, escreva para suporte@ironstack.dev.br. Informe sistema operacional, guardian --version, a ação executada e a mensagem de erro. Remova credenciais e dados privados dos logs.

GuardianContext é um produto da IronStack, distribuído sob licença proprietária de uso, incluída no pacote no arquivo LICENSE. As condições do serviço estão nos Termos de Uso.