From 17c84e103a5712f042d17f823b9eea21c2e88b83 Mon Sep 17 00:00:00 2001 From: kemuel Date: Wed, 29 Jul 2026 13:38:37 -0300 Subject: [PATCH] =?UTF-8?q?chore(knowledge):=20fia=C3=A7=C3=A3o=20dos=20ag?= =?UTF-8?q?entes=20+=20bump=20(guia=20de=20uso=20e=20dicion=C3=A1rio=20de?= =?UTF-8?q?=20siglas)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit CLAUDE.md/AGENTS.md agora apontam para knowledge/AGENTS.md com regras anti-alucinação explícitas (vale para Claude Code, Codex e Cursor): não inventar regra/contrato, dizer quando não está documentado, citar o doc governante, knowledge/ prevalece sobre doc local divergente. Co-Authored-By: Claude Opus 5 --- AGENTS.md | 25 +++++++++++++++++++++++++ CLAUDE.md | 1 + knowledge | 2 +- 3 files changed, 27 insertions(+), 1 deletion(-) create mode 100644 AGENTS.md create mode 100644 CLAUDE.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 000000000..a95a38449 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,25 @@ +# AGENTS.md + +## Fonte oficial de conhecimento (knowledge/) — leia antes de qualquer tarefa + +Este repositório consome o Knowledge Workspace da Move System como **submodule em `knowledge/`**. +Pasta vazia? `git submodule update --init`. Docs novas? `git -C knowledge pull origin main`. + +Este repo pertence ao produto **SAPL (fork Interlegis, rebrandeado SGVP)** e roda na stack **Python 3.12 + Django 2.2**. +A ordem de leitura obrigatória está em `knowledge/AGENTS.md`. Atalhos: + +- `knowledge/governance/indexes/Mapa_Repos_Produtos.md` — o mapa dos 7 repositórios +- `knowledge/engineering/stacks/stack-django-python.md` — convenções DESTA stack (não aplique padrão de outra) +- `knowledge/domain/Glossario_Legislativo.md` — obrigatório antes de mexer em proposição/matéria/protocolo/tramitação +- `knowledge/governance/knowledge-architecture/Dicionario_Siglas.md` — siglas (ADR, PRD, spec…) + +### Regras anti-alucinação (Claude Code, Codex, Cursor — qualquer agente) + +1. **Não invente** regra de negócio, contrato de API, endpoint, campo ou nome de entidade: verifique no `knowledge/` e no código antes de afirmar. +2. Não encontrou nem na doc nem no código? **Diga "não está documentado" e pergunte** — nunca presuma. +3. Toda decisão relevante **cita o documento que a governou** (ADR, spec, glossário) — princípio de honestidade epistêmica da `knowledge/ai-framework/constitution/AI_Constitution.md`. +4. Conflito entre doc local deste repo e o `knowledge/`? **O `knowledge/` prevalece** — sinalize a divergência em vez de escolher em silêncio. +5. Decisão nova tomada durante a tarefa → **registrar no `knowledge/`** (ADR ou spec), não só no código. + + +Convenções completas do repositório: ver `CLAUDE.md` (se existir) e o perfil de stack no `knowledge/`. diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 000000000..43c994c2d --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1 @@ +@AGENTS.md diff --git a/knowledge b/knowledge index c6f174912..0d1c1b7c4 160000 --- a/knowledge +++ b/knowledge @@ -1 +1 @@ -Subproject commit c6f174912b89b11c5769b87d16dffeeb6b03e06a +Subproject commit 0d1c1b7c4a08a732fecf529202f721478b27e89e