Sema is a semantic governance layer for AI agents operating real software, workflows, operations, research, legal material, games, and narrative systems.
It exists to make an agent stop guessing. Before action comes contract. Before release comes validation. Before trust comes evidence. A .sema contract declares intent, inputs, outputs, rules, effects, forbidden behavior, guarantees, linked implementation, and the checks an agent must satisfy before it continues.
Current public version: 1.5.29.
LLMs are good at producing answers and dangerously good at sounding confident. Sema gives agents an operational boundary:
- create or update the contract before changing behavior;
- run validation, drift, impact, and finalization gates;
- compare contracts against real artifacts when the profile supports it;
- return structured findings with severity, readiness, and next action;
- govern vendor-first persistence when database behavior is part of the contract;
- keep humans as authors, reviewers, approvers, and escalation points.
The primary reader is the agent. Humans remain in control.
- Software: code changes, drift, impact, tests, unsafe artifact checks.
- Workflow/Ops: runtime targets, adapters, idempotency, retries, rollback, runbooks.
- Author: narrative intent, clichés, forbidden elements, continuity, semantic drift.
- Game: state, rules, loops, pacing, economy, playtest requirements.
- Legal: jurisdiction, scope, sources, human review, audit, legal risk boundaries.
- Research: question, hypothesis, method, evidence, uncertainty, reproducibility.
npm install -g @semacode/cli
sema --version
sema iniciar
sema validar contratos/pedidos.sema --json
sema drift contratos/pedidos.sema --escopo modulo --jsonTypical agent flow:
sema inspecionar contratos/pedidos.sema --json
sema impacto contratos/pedidos.sema --alvo pedido_id --mudanca "replace pedido_id with pedido_uuid" --json
sema contexto-ia contratos/pedidos.sema --saida ./.tmp/contexto --json
sema finalizar-mudanca --intencao "alterar pedidos" --doc-lida README.md --jsonThe public npm package is the local CLI and contract tooling. The remote MCP surface, hosted panels, OAuth flows, audit trails, and commercial governance runtime are operated as authorized services, not as a public npm server package.
Sema é uma camada de governança semântica para agentes de IA operarem software real, workflows, operação, pesquisa, material jurídico, jogos e sistemas narrativos.
Ela existe para fazer o agente parar de adivinhar. Antes da ação vem o contrato. Antes do release vem a validação. Antes da confiança vem a evidência. Um contrato .sema declara intenção, entradas, saídas, regras, efeitos, comportamentos proibidos, garantias, implementação vinculada e os checks que o agente precisa cumprir antes de continuar.
Versão pública atual: 1.5.29.
LLMs são boas em produzir respostas e perigosamente boas em soar confiantes. A Sema dá ao agente um limite operacional:
- criar ou atualizar o contrato antes de mudar comportamento;
- rodar validação, drift, impacto e portões de finalização;
- comparar contratos contra artefatos reais quando o profile suporta isso;
- retornar achados estruturados com severidade, prontidão e próxima ação;
- governar persistência vendor-first quando o comportamento de banco faz parte do contrato;
- manter humanos como autores, revisores, aprovadores e pontos de escalação.
O leitor principal é o agente. Humanos continuam no controle.
- Software: mudanças de código, drift, impacto, testes e checks de artefato inseguro.
- Workflow/Ops: runtimes, adapters, idempotência, retries, rollback e runbooks.
- Author: intenção narrativa, clichês, elementos proibidos, continuidade e drift semântico.
- Game: estado, regras, loops, pacing, economia e requisitos de playtest.
- Legal: jurisdição, escopo, fontes, revisão humana, auditoria e limites de risco jurídico.
- Research: pergunta, hipótese, método, evidência, incerteza e reprodutibilidade.
npm install -g @semacode/cli
sema --version
sema iniciar
sema validar contratos/pedidos.sema --json
sema drift contratos/pedidos.sema --escopo modulo --jsonFluxo típico de agente:
sema inspecionar contratos/pedidos.sema --json
sema impacto contratos/pedidos.sema --alvo pedido_id --mudanca "trocar pedido_id por pedido_uuid" --json
sema contexto-ia contratos/pedidos.sema --saida ./.tmp/contexto --json
sema finalizar-mudanca --intencao "alterar pedidos" --doc-lida README.md --jsonO pacote público no npm é a CLI local e o ferramental de contratos. A superfície MCP remota, painéis hospedados, fluxos OAuth, trilhas de auditoria e runtime comercial de governança operam como serviços autorizados, não como pacote npm público de servidor.
- Índice da documentação
- Guia da CLI
- Guia MCP
- Profiles
- Sema Author
- Política de idiomas da documentação
Sema es una capa de gobernanza semántica para agentes de IA que operan software real, workflows, operaciones, investigación, material legal, juegos y sistemas narrativos.
Existe para hacer que el agente deje de adivinar. Antes de la acción viene el contrato. Antes del release viene la validación. Antes de la confianza viene la evidencia. Un contrato .sema declara intención, entradas, salidas, reglas, efectos, comportamientos prohibidos, garantías, implementación vinculada y los checks que el agente debe cumplir antes de continuar.
Versión pública actual: 1.5.29.
Los LLMs son buenos produciendo respuestas y peligrosamente buenos sonando confiados. Sema le da al agente un límite operativo:
- crear o actualizar el contrato antes de cambiar comportamiento;
- ejecutar validación, drift, impacto y gates de finalización;
- comparar contratos contra artefactos reales cuando el profile lo soporta;
- devolver hallazgos estructurados con severidad, preparación y próxima acción;
- gobernar persistencia vendor-first cuando el comportamiento de base de datos forma parte del contrato;
- mantener a los humanos como autores, revisores, aprobadores y puntos de escalamiento.
El lector principal es el agente. Los humanos siguen en control.
- Software: cambios de código, drift, impacto, pruebas y checks de artefactos inseguros.
- Workflow/Ops: runtimes, adapters, idempotencia, retries, rollback y runbooks.
- Author: intención narrativa, clichés, elementos prohibidos, continuidad y drift semántico.
- Game: estado, reglas, loops, pacing, economía y requisitos de playtest.
- Legal: jurisdicción, alcance, fuentes, revisión humana, auditoría y límites de riesgo legal.
- Research: pregunta, hipótesis, método, evidencia, incertidumbre y reproducibilidad.
npm install -g @semacode/cli
sema --version
sema iniciar
sema validar contratos/pedidos.sema --json
sema drift contratos/pedidos.sema --escopo modulo --jsonFlujo típico de agente:
sema inspecionar contratos/pedidos.sema --json
sema impacto contratos/pedidos.sema --alvo pedido_id --mudanca "cambiar pedido_id por pedido_uuid" --json
sema contexto-ia contratos/pedidos.sema --saida ./.tmp/contexto --json
sema finalizar-mudanca --intencao "alterar pedidos" --doc-lida README.md --jsonEl paquete público en npm es la CLI local y el tooling de contratos. La superficie MCP remota, paneles hospedados, flujos OAuth, auditoría y runtime comercial de gobernanza operan como servicios autorizados, no como paquete npm público de servidor.