rodolpho.lopes/knowledge-base
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Knowledge base do projeto GLPI11 — registros técnicos e padrões
11 commits 1 branch 0 tags 351 KiB
Python 99%
Makefile 1%
Find a file
Rodolpho Lopes f072b1cde7 docs: marca bugs do mcprotocol como resolvidos em v1.2.0 
KB-024 (silent-success do delete): ambas correções implementadas — makeRequest
propaga 4xx/5xx (commit 09ce92c) e glpi_projecttask_delete via ORM (0ca94fc).
KB-023 (InputValidation): arquivos agora realmente implementados; corrige itens
do rascunho que não foram feitos (buildInputFromArgs, project_update estendido).
KB-026 (snapshot): atualizado para v1.2.0 — 19 tools, ProjectTask CRUD, métricas.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-22 22:16:02 +00:00
records docs: marca bugs do mcprotocol como resolvidos em v1.2.0 2026-06-22 22:16:02 +00:00
schemas Initial commit — knowledge base migrada do dev local 2026-05-26 15:11:41 +00:00
.gitignore kb: KB-PLUGIN-031 runbook de workflow dev/deploy de plugins + commit dos registros 021-030 pendentes 2026-06-11 17:59:47 +00:00
index.json docs(KB-026): reconcilia snapshot mcprotocol com estado real (v1.1.1) 2026-06-22 22:02:31 +00:00
kb_check.py chore: move kb_check.py para dentro da knowledge-base 2026-05-26 20:19:54 +00:00
Makefile chore: move kb_check.py para dentro da knowledge-base 2026-05-26 20:19:54 +00:00
README.md Initial commit — knowledge base migrada do dev local 2026-05-26 15:11:41 +00:00

README.md

Base de Conhecimento para Agentes de IA

Esta base foi projetada para leitura eficiente por agentes e humanos.

Arquitetura recomendada

  • index.json: catalogo central para busca semantica rapida por agente.
  • records/: um registro por arquivo Markdown, com metadados em front matter YAML.
  • schemas/: contrato JSON Schema para validar metadados e manter consistencia.

Por que esse formato e eficiente

  • JSON para roteamento: agentes localizam o registro certo sem ler toda a base.
  • Markdown para contexto: explica causa, impacto e procedimento com baixa ambiguidade.
  • Metadados padronizados: permite filtro por tags, severity, domain e status.
  • Versionamento simples: cada incidente vira um arquivo independente e auditavel no Git.

Convencao de registros

  • ID: KB-<DOMINIO>-NNN (ex.: KB-INFRA-001)
  • Nome de arquivo: <ID>-<slug>.md
  • Campos obrigatorios de metadados:
    • id
    • title
    • domain
    • tags
    • status
    • severity
    • created_at
    • updated_at
    • applies_to

Fluxo de atualizacao

  1. Criar novo registro em records/<dominio>/.
  2. Atualizar index.json com resumo e caminho.
  3. Validar aderencia ao schema em schemas/.
  4. Referenciar o registro em documentacao operacional quando necessario.

Validacao automatica

Use:

make kb-check
make kb-fix

A verificacao valida:

  • metadados obrigatorios conforme schema;
  • padrao de ID de registro;
  • sincronizacao entre index.json e arquivos em records/.

make kb-fix faz ajustes automaticos no index.json:

  • inclui registros faltantes;
  • remove entradas orfas;
  • sincroniza campos principais;
  • atualiza last_updated.