mirror of https://github.com/interlegis/sapl.git
Browse Source
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 <noreply@anthropic.com>pull/3858/head
3 changed files with 27 additions and 1 deletions
@ -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/`. |
||||
@ -0,0 +1 @@ |
|||||
|
@AGENTS.md |
||||
@ -1 +1 @@ |
|||||
Subproject commit c6f174912b89b11c5769b87d16dffeeb6b03e06a |
Subproject commit 0d1c1b7c4a08a732fecf529202f721478b27e89e |
||||
Loading…
Reference in new issue