okam 0.2.0

Framework de governança de IA, memória persistente e gestão de conhecimento

⬡ Okam

Pare de Redescobrir. Comece a Governar.

Framework open-source para governança de IA, memória persistente e gestão de conhecimento.

---

O Que É Isso?

Okam é um framework que resolve um problema simples: seus agentes de IA não têm memória.

Toda vez que você abre uma sessão com seu copilot, ele começa do zero. Sem contexto das decisões passadas, sem governança, sem reutilização de conhecimento.

Okam resolve isso com:

• 🏛️ Governança — Regras claras para seus agentes (AGENTS.md + pipeline de 4 fases)
• 🧩 Skills — Capacidades modulares reutilizáveis entre projetos
• 📚 Wiki de Conhecimento — Memória persistente no formato OKF (não é RAG)
• 🔍 Pipeline de Metadados — Extrai a "alma" dos seus projetos automaticamente

Quick Start (5 minutos)

# 1. Clone e instale localmente em modo de desenvolvimento
git clone https://github.com/juliano-ceconi/okam.git
cd okam
pip install -e .

# 2. Inicialize o wiki com seed pages
okam init

# 3. Customize o AGENTS.md com as regras do seu projeto
# (edite AGENTS.md com suas preferências)

# 4. Valide a conformidade
okam validate

# 5. Crie uma nova skill interativamente
okam new-skill

Nota: O script legado python knowledge/scripts/okf_manager.py continua funcionando como um wrapper de compatibilidade.

Para o guia completo, veja o QUICKSTART.md.

Conceitos Core

Conceito	O Que É	Doc
LLM Wiki	Memória persistente vs RAG tradicional	docs/concepts/llm-wiki.md
OKF	Formato padronizado de metadados para conhecimento	docs/concepts/okf-format.md
Deep Metadata	Pipeline de 4 fases para extrair contexto	docs/concepts/deep-metadata.md
Guided Tours	Padrão TOUR.md para onboarding de agentes	docs/concepts/guided-tours.md
Git Hooks	Governança automatizada via hooks pre-commit/push	docs/concepts/git-hooks.md

Estrutura do Projeto

okam/
├── .agents/
│   ├── rules/           # Padrões de governança
│   ├── skills/          # Capacidades modulares
│   │   ├── deep-metadata-analysis/
│   │   ├── knowledge-wiki/
│   │   └── memory-maintenance/
│   └── workflows/       # Pipelines de execução
├── hooks/               # Git hooks portáveis (POSIX sh)
│   ├── pre-commit       # Validação OKF + detecção de segredos
│   ├── commit-msg       # Conventional Commits
│   └── pre-push         # Validação OKF completa
├── knowledge/
│   ├── wiki/            # Páginas de síntese (OKF)
│   ├── raw-sources/     # Fontes brutas
│   └── scripts/         # Validador OKF
├── templates/           # Templates reutilizáveis
├── docs/
│   ├── concepts/        # Documentação de conceitos
│   └── diagrams/        # Diagramas Mermaid
├── landing/             # Landing page
├── AGENTS.md            # Governança central
├── QUICKSTART.md        # Guia rápido
└── LICENSE              # MIT

Construído Com

• Python — Validador OKF (zero dependências, stdlib only)
• Markdown — Documentação e Wiki
• YAML — Metadados estruturados

Contribuindo

1. Fork o repositório
2. Crie uma branch para sua feature (git checkout -b feat/minha-feature)
3. Instale os hooks de governança (okam hooks install)
4. Commit suas mudanças (git commit -m 'feat: adiciona minha feature')
5. Push para a branch (git push origin feat/minha-feature)
6. Abra um Pull Request

Licença

Este projeto está sob a licença MIT. Veja LICENSE para mais detalhes.

---

⬡ Feito por devs, para devs.

Landing Page · Quick Start · Documentação