Skip to content

Commit 721b828

Browse files
author
MarceloClaro
committed
principle: INTEGRIDADE.md — auditabilidade como principio obrigatorio transversal
Novo documento INTEGRIDADE.md com: - 8 Raciocinios de Integridade (R-I1 a R-I8): Empirico-Verificacionista, Falsificabilidade, Distincao Medido-vs-Projetado, Rastreabilidade Forense, Contraprova Independente, Origem de Dados, Nivel de Confianca Explicito, Correcao por Vies de Auto-Avaliacao - 25 regras distribuidas em 5 faces: Analise, Producao, Documentacao, Comunicacao, Evolucao - Matriz de conformidade com auditor e frequencia - Checklist de integridade pre-commit - AGENTS_PTBR.md e AGENTS.md atualizados com principio como obrigatorio - README.md com link para INTEGRIDADE.md
1 parent 907b7ad commit 721b828

4 files changed

Lines changed: 245 additions & 4 deletions

File tree

‎AGENTS.md‎

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,13 @@
77
88
---
99

10-
# OPENCODE 统一生态系统 v4.2 (MiroFish/BettaFish + PhD Auditor + 204 raciocínios (25 cat))
10+
# OPENCODE 统一生态系统 v4.6.1
11+
12+
## ⚠️ 诚信与可审计性原则 (v1.0 新增 — 强制性)
13+
- **完整文件:** [INTEGRIDADE.md](INTEGRIDADE.md)
14+
- 核心规则: 所有断言必须可验证。任何数字必须能追溯到代码或外部源。
15+
- 8 项诚信推理 (R-I1 ~ R-I8): 经验验证 · 可证伪性 · 实测vs预测 · 可追溯性 · 独立验证 · 数据来源 · 置信度 · 自评偏差修正
16+
- 适用于: 分析 · 生产 · 文档 · 通信 · 演进
1117

1218
## 环境
1319
- Windows 11, Node.js v25, Bun 1.3, OpenCode CLI 1.14

‎AGENTS_PTBR.md‎

Lines changed: 34 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,38 @@
1-
# Ecossistema Unificado OpenCode v4.2 (MiroFish/BettaFish + PhD Auditor + 38 Raciocínios)
1+
# Ecossistema Unificado OpenCode v4.6.1
22

3-
> **Idioma de saída obrigatório:** Português Brasileiro Formal.
4-
> Este documento é a versão em PT-BR do [AGENTS.md](AGENTS.md).
3+
> **Idioma de saida obrigatorio:** Portugues Brasileiro Formal.
4+
> Este documento e a versao em PT-BR do [AGENTS.md](AGENTS.md).
5+
6+
---
7+
8+
## Principio de Integridade e Auditabilidade (OBRIGATORIO — v1.0)
9+
10+
> **Documento completo:** [INTEGRIDADE.md](INTEGRIDADE.md)
11+
12+
**Regra fundamental:** Toda afirmacao deve ser verificavel. Nenhum numero pode ser apresentado sem que sua origem seja rastreavel contra o codigo ou fontes externas.
13+
14+
### Regras de Aplicacao Imediata
15+
16+
1. **Metricas verificaveis:** Todo numero citado em documentacao, resposta ou artigo DEVE ser verificavel contra arquivos no repositorio
17+
2. **Auto-avaliacao explicitada:** Scores gerados pelo proprio sistema (Qualis A1, Cora-Debate, confianca) DEVEM ser rotulados como `[auto-reportado]`
18+
3. **Origem de dados:** Toda tabela/metica DEVE indicar proveniencia (script, commit, fonte externa com data)
19+
4. **Superlativos proibidos:** "excelente", "revolucionario", "incrivel", "melhor" e similares sao proibidos em documentacao
20+
5. **Limitacoes visiveis:** Documentacao DEVE conter secao de limitacoes conhecidas
21+
6. **Falsificabilidade:** Afirmacoes devem ser estruturadas de forma que possam ser verificadas ou refutadas
22+
7. **Distincao medido-vs-projetado:** Separar explicitamente o que foi medido do que foi estimado ou auto-avaliado
23+
8. **Rastreabilidade:** Um terceiro deve conseguir reproduzir o caminho dos dados brutos ao resultado
24+
25+
### 8 Raciocinios de Integridade
26+
| ID | Nome | Funcao |
27+
|:--:|------|--------|
28+
| R-I1 | Empirico-Verificacionista | Toda afirmacao ancorada em evidencia rastreavel |
29+
| R-I2 | Falsificabilidade | Afirmacoes estruturadas para serem refutaveis |
30+
| R-I3 | Distincao Medido-vs-Projetado | Separar medicoes de estimativas |
31+
| R-I4 | Rastreabilidade Forense | Caminho completo reproduzivel por terceiros |
32+
| R-I5 | Contraprova Independente | Resultados validados por metodo alternativo |
33+
| R-I6 | Origem de Dados (Provenance) | Metadados de origem em todo numero |
34+
| R-I7 | Nivel de Confianca Explicito | Toda afirmacao com confidence score |
35+
| R-I8 | Correcao por Vies de Auto-Avaliacao | Fator de correcao para metricas internas |
536

637
---
738

‎INTEGRIDADE.md‎

Lines changed: 203 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,203 @@
1+
---
2+
title: "Principio de Integridade e Auditabilidade"
3+
version: "1.0"
4+
status: "OBRIGATORIO — Transversal a todo o Ecossistema"
5+
scope: "Analise, Producao, Documentacao, Comunicacao, Evolucao"
6+
last_updated: "2026-05-30"
7+
---
8+
9+
# Integridade e Auditabilidade — Principio Transversal Obrigatorio
10+
11+
## Fundamentacao
12+
13+
A credibilidade do OpenCode Ecosystem depende de uma unica coisa: **toda afirmacao deve ser verificavel**. Sem verificabilidade, nao ha ciencia. Sem transparencia, nao ha confianca. Este documento estabelece o principio de integridade como obrigacao transversal a todas as faces do projeto.
14+
15+
---
16+
17+
## Os 8 Raciocinios de Integridade
18+
19+
Aplicaveis a toda analise, producao, documentacao e comunicacao do ecossistema.
20+
21+
### R-I1 — Empirico-Verificacionista
22+
**Definicao:** Toda afirmacao factual deve estar ancorada em evidencia verificavel. Nenhum numero pode ser apresentado sem que sua origem seja rastreavel.
23+
24+
**Aplicacao:**
25+
- Documentacao: cada metrica cita o arquivo/script que a produziu
26+
- Artigos: cada alegacao referencia fonte com DOI ou caminho no repositorio
27+
- README: todos os numeros sao verificaveis contra o codigo
28+
29+
**Violacao tipica:** "O sistema tem 125 agentes" sem especificar onde estao definidos.
30+
31+
### R-I2 — Falsificabilidade
32+
**Definicao:** Toda afirmacao deve ser estruturada de forma que possa ser falseada. "O sistema melhora continuamente" nao e falseavel. "O score medio subiu de 85 para 96 em 17 iteracoes" e falseavel.
33+
34+
**Aplicacao:**
35+
- Hipotesses sao declaradas com condicoes de refutacao explicitas
36+
- Scores incluem intervalo de confianca ou desvio padrao
37+
- Afirmacoes qualitativas requerem criterio de verificacao
38+
39+
**Violacao tipica:** "O ecossistema produz artigos de excelencia internacional."
40+
41+
### R-I3 — Distincao Medido-vs-Projetado
42+
**Definicao:** Separar explicitamente o que foi medido do que foi projetado, estimado ou auto-avaliado.
43+
44+
**Aplicacao:**
45+
- Metricas auto-reportadas usam o rotulo `[auto-reportado]`
46+
- Metricas externas citam a fonte com data de acesso
47+
- Projecoes usam o rotulo `[projetado]` com metodologia
48+
49+
**Violacao tipica:** Apresentar score Qualis A1 96/100 como se fosse avaliacao externa da CAPES.
50+
51+
### R-I4 — Rastreabilidade Forense
52+
**Definicao:** Um terceiro deve conseguir reproduzir o caminho completo de qualquer resultado — dos dados brutos ao numero final.
53+
54+
**Aplicacao:**
55+
- Pipeline outputs incluem hash dos inputs
56+
- Seeds aleatorias sao documentadas
57+
- Comandos de execucao sao explicitos e reproduziveis
58+
59+
**Violacao tipica:** Reportar um score sem explicar como ele foi calculado.
60+
61+
### R-I5 — Contraprova Independente
62+
**Definicao:** Resultados criticos devem ser validados por metodo independente. Se o Cora-Debate atribui confianca 0.98, uma segunda abordagem (ex: validacao humana em amostra) deve existir.
63+
64+
**Aplicacao:**
65+
- Scores do Cora-Debate: amostra de 10% validada manualmente
66+
- Correlacoes Pearson: comparadas com Spearman para robustez
67+
- AutoEvolve scores: validadas por revisao humana periodica
68+
69+
**Violacao tipica:** Confiar exclusivamente em metricas auto-geradas.
70+
71+
### R-I6 — Origem de Dados (Provenance)
72+
**Definicao:** Todo numero carrega metadados de origem: quem gerou, quando, com qual metodo, com quais parametros.
73+
74+
**Aplicacao:**
75+
- Tabelas incluem coluna `[Origem]` com caminho do script ou fonte
76+
- Graficos incluem nota de rodape sobre proveniencia dos dados
77+
- JSON outputs incluem campo `provenance` com timestamp e hash
78+
79+
**Violacao tipica:** Tabela de metricas sem indicacao de como foram obtidas.
80+
81+
### R-I7 — Nivel de Confianca Explicito
82+
**Definicao:** Toda afirmacao carrega um nivel de confianca explicito (escala 0-1), com justificativa.
83+
84+
**Aplicacao:**
85+
- `[confianca: 0.98]` — verificado por 2 metodos independentes
86+
- `[confianca: 0.70]` — auto-reportado, sem verificacao externa
87+
- `[confianca: 0.50]` — estimativa baseada em extrapolacao
88+
89+
**Violacao tipica:** Apresentar todos os numeros com mesma aparencia de certeza.
90+
91+
### R-I8 — Correcao por Vies de Auto-Avaliacao
92+
**Definicao:** Quando o sistema avalia a si mesmo, um fator de correcao deve ser aplicado ou a limitacao deve ser explicitamente declarada.
93+
94+
**Aplicacao:**
95+
- Scores de auto-avaliacao incluem nota: "Este score e gerado pelo proprio sistema e nao constitui validacao externa."
96+
- Comparacoes com benchmarks externos sao preferidas sobre scores internos
97+
- Metricas de performance usam benchmarks estabelecidos quando disponiveis
98+
99+
**Violacao tipica:** Badge "Qualis A1 96/100" sem contexto de que e auto-atribuido.
100+
101+
---
102+
103+
## Regras de Aplicacao por Face do Projeto
104+
105+
### Face 1 — Analise (SEEKER, pesquisas, dados)
106+
107+
| Regra | Descricao |
108+
|-------|-----------|
109+
| A1 | Toda analise cita a fonte dos dados (DOI, URL, arquivo) com data de acesso |
110+
| A2 | Correlacoes reportam p-valor e intervalo de confianca, nao apenas r |
111+
| A3 | Outliers sao documentados, nao removidos silenciosamente |
112+
| A4 | Seeds aleatorias sao explicitas nos scripts de analise |
113+
| A5 | Resultados negativos sao reportados com o mesmo destaque que positivos |
114+
115+
### Face 2 — Producao (MASWOS, artigos, codigo)
116+
117+
| Regra | Descricao |
118+
|-------|-----------|
119+
| P1 | Toda alegacao no texto referencia fonte via TSAC |
120+
| P2 | Palavras banidas (87) sao detectadas e removidas automaticamente |
121+
| P3 | Score Qualis A1 e rotulado como `[auto-reportado]` |
122+
| P4 | Figuras e tabelas incluem proveniencia dos dados |
123+
| P5 | O metodo de geracao e documentado no proprio artigo |
124+
125+
### Face 3 — Documentacao (README, docs/, tdd-docs/)
126+
127+
| Regra | Descricao |
128+
|-------|-----------|
129+
| D1 | Numeros no README sao verificaveis contra arquivos no repositorio |
130+
| D2 | Badges e metricas incluem nota sobre metodo de medicao |
131+
| D3 | Toda secao de documentacao cita o commit/versao a que se refere |
132+
| D4 | Superlativos ("excelente", "revolucionario", "melhor") sao proibidos |
133+
| D5 | Limitacoes conhecidas sao declaradas em secao dedicada |
134+
135+
### Face 4 — Comunicacao (CLI, outputs, respostas ao usuario)
136+
137+
| Regra | Descricao |
138+
|-------|-----------|
139+
| C1 | Respostas ao usuario sao factuais, sem hipoteses nao declaradas |
140+
| C2 | Incertezas sao comunicadas explicitamente ("Nao tenho certeza, mas...") |
141+
| C3 | Outputs incluem proveniencia quando relevante |
142+
| C4 | Nenhum caractere CJK na saida ao usuario (regra existente) |
143+
| C5 | Autoconfianca do sistema nao e superestimada na comunicacao |
144+
145+
### Face 5 — Evolucao (AutoEvolve, ciclos, registro historico)
146+
147+
| Regra | Descricao |
148+
|-------|-----------|
149+
| E1 | Cada ciclo documenta: o que mudou, por que, com qual evidencia de melhoria |
150+
| E2 | Scores de evolucao incluem metodo de calculo e limitacoes |
151+
| E3 | Regressoes sao documentadas com a mesma transparencia que melhorias |
152+
| E4 | O registro historico e imutavel — correcoes sao aditivas, nao substitutivas |
153+
| E5 | Skills geradas automaticamente sao rotuladas como `[auto-gerada]` |
154+
155+
---
156+
157+
## Matriz de Conformidade
158+
159+
| Face | Regras | Auditor | Frequencia |
160+
|------|:------:|---------|:----------:|
161+
| Analise | 5 (A1-A5) | Cora-Debate V3 + V5 | A cada execucao |
162+
| Producao | 5 (P1-P5) | TSAC + ptbr_corrector + Banca | A cada artigo |
163+
| Documentacao | 5 (D1-D5) | Revisao manual | A cada release |
164+
| Comunicacao | 5 (C1-C5) | ptbr_corrector + self-check | A cada resposta |
165+
| Evolucao | 5 (E1-E5) | Auditoria de ciclo | A cada iteracao |
166+
167+
---
168+
169+
## Implementacao
170+
171+
### Checklist de Integridade (aplicar antes de qualquer commit publico)
172+
173+
```
174+
[ ] Numeros no README conferem com arquivos no repositorio?
175+
[ ] Scores auto-reportados estao explicitamente rotulados?
176+
[ ] Badges incluem contexto sobre metodo de medicao?
177+
[ ] Secao de Limitacoes esta atualizada?
178+
[ ] Superlativos foram removidos ou justificados?
179+
[ ] Toda alegacao factual tem origem rastreavel?
180+
[ ] Dados de fontes externas tem data de acesso?
181+
[ ] Seeds e parametros de execucao estao documentados?
182+
[ ] Resultados negativos ou limitacoes estao visiveis?
183+
[ ] ptbr_corrector.py executado (0 CJK)?
184+
```
185+
186+
### Script de Verificacao
187+
188+
```bash
189+
# Executar antes de cada commit publico
190+
python criador-artigo/banca/ptbr_corrector.py # CJK check
191+
python scripts/audit_integridade.py # Integrity audit (a criar)
192+
grep -r "excelente\|revolucionario\|incrivel\|melhor" README.md docs/ # Superlativos
193+
```
194+
195+
---
196+
197+
<div align="center">
198+
199+
**Principio de Integridade e Auditabilidade v1.0** · Obrigatorio para todo o ecossistema
200+
201+
*"Toda afirmacao deve ser verificavel. Sem verificabilidade, nao ha ciencia."*
202+
203+
</div>

‎README.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -296,6 +296,7 @@ O ciclo de desenvolvimento do ecossistema e incremental: cada iteracao adiciona
296296
| [Projetos](PROJECTS.md) | Painel de projetos |
297297
| [Diagramas](diagrams/) | 11 diagramas SVG |
298298
| [Doc. Tecnica Completa](OPENCODE_ECOSYSTEM.md) | 1.289 linhas de documentacao |
299+
| [Integridade e Auditabilidade](INTEGRIDADE.md) | Principio obrigatorio — 8 raciocinios, 5 faces, 25 regras |
299300

300301
---
301302

0 commit comments

Comments
 (0)