Kodama Vault

O que faz

Base de conhecimento centralizada do projeto Kodama. Armazena documentação, specs de agentes, memória compartilhada e skills customizadas em arquivos Markdown. O conteúdo é servido como site estático via Astro Starlight, hospedado em VPS com deploy automatizado.

Stack principal

• Astro Starlight (site estático / documentação)
• Markdown (conteúdo)
• Docker + Nginx (container de produção)
• GitHub Actions (CI/CD via SSH para VPS)

Estrutura relevante

brain/
  projects/   # documentação por projeto
  agents/     # specs e configurações de agentes
  memory/     # memória compartilhada entre agentes
  skills/     # skills customizadas
  MOC.md      # mapa de conteúdo (índice geral)
site/         # código Astro Starlight
Dockerfile    # build estático + Nginx

O diretório brain/ é o núcleo operacional. O site/ apenas consome e exibe esse conteúdo.

Comandos comuns

# Dev local
cd site
npm install
npm run dev
# Acessa http://localhost:4321

# Deploy
git push  # dispara GitHub Actions automaticamente

Não há comandos manuais de deploy. O push na branch principal aciona o pipeline que reconstrói e reinicia o container no VPS.

Agents e skills notáveis

• brain/agents/ contém specs individuais de agentes, definindo comportamento, contexto e instruções de cada um.
• brain/skills/ armazena skills reutilizáveis que podem ser referenciadas por diferentes agentes.
• brain/memory/ funciona como memória persistente compartilhada, permitindo que agentes distintos acessem contexto comum sem duplicação.
• brain/MOC.md serve como ponto de entrada para navegação manual no vault, listando e linkando os principais documentos.

Fluxo geral

Edita Markdown em brain/, faz push, GitHub Actions conecta ao VPS via SSH, reconstrói o container Docker com o site Astro compilado, e o conteúdo fica disponível em vault.kodama.solutions. Simples e sem dependência de plataformas externas de hospedagem de docs.