Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 22 additions & 2 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
"name": "fluig",
"source": "./fluig",
"description": "Plugin para desenvolvimento TOTVS Fluig — ciclo completo: design (brainstorm), scaffolding (widget/dataset/form/workflow), revisão estática + testes (review) e deploy (verify).",
"version": "2.1.0",
"version": "2.1.1",
"author": {
"name": "DataAgile"
},
Expand All @@ -30,7 +30,7 @@
"name": "protheus",
"source": "./protheus",
"description": "Plugin para desenvolvimento TOTVS Protheus — ciclo completo: brainstorm → plan → implement (Agent Teams) → deploy TDS-CLI → qa E2E → verify, geradores MVC/REST/query, dicionário de dados, SmartView/TReports e Knowledge Base remota (155k+ registros).",
"version": "2.13.0",
"version": "2.14.1",
"author": {
"name": "DataAgile"
},
Expand Down Expand Up @@ -76,6 +76,26 @@
"test-agents",
"automation"
]
},
{
"name": "andrej-karpathy-skills",
"source": {
"source": "github",
"repo": "multica-ai/andrej-karpathy-skills",
"sha": "2c606141936f1eeef17fa3043a72095b4765b9c2"
},
"description": "Guidelines comportamentais para reduzir erros comuns de LLM em código: pensar antes de codar, simplicidade primeiro, mudanças cirúrgicas, execução orientada a critério verificável. Upstream de terceiro (MIT, forrestchang) — listado aqui só para distribuição, sem fork; sha pinado.",
"version": "1.0.0",
"author": {
"name": "forrestchang"
},
"category": "workflow",
"tags": [
"guidelines",
"best-practices",
"code-quality",
"karpathy"
]
}
]
}
25 changes: 25 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,31 @@ Histórico das versões públicas do `dataagile-agent-kit`.

---

## [2.6.1] — 2026-07-21

### O implementer parou de adivinhar e de "melhorar" código alheio (protheus 2.14.1 · fluig 2.1.1)

Os agentes `protheus-implementer` e `fluig-implementer` rodam em **contexto isolado** dentro do
Agent Team: não herdam o `CLAUDE.md` do dev nem skill nenhuma. Era exatamente ali que nasciam o
over-engineering e o chute de campo/API — o agente inferia o comportamento pelo nome e seguia.

- **Quatro regras de execução agora fazem parte do prompt dos dois agentes:** *nunca adivinhar*
(chave, campo, função ou comportamento desconhecido → consultar o MCP ou reportar
`NEEDS_CONTEXT`; inferir pelo nome está proibido), *código mínimo que resolve a task* (sem
feature além da pedida, sem abstração de uso único, sem configurabilidade não solicitada),
*mudança cirúrgica* (não reformatar nem "melhorar" código adjacente; código morto pré-existente
se reporta, não se apaga) e *toda linha alterada rastreia até a task*.
- **Nova entrada no marketplace: `andrej-karpathy-skills`.** Guidelines comportamentais para
reduzir erros comuns de LLM em código, apontando para o upstream
`multica-ai/andrej-karpathy-skills` (MIT, forrestchang) com **sha pinado** — sem fork e sem
cópia de texto, então não há drift e a licença fica com o autor. Instalação:
`/plugin install andrej-karpathy-skills@claude-skills-dataagile`.
- **Correção de release:** `protheus/.claude-plugin/plugin.json` estava em `2.14.0` enquanto o
`marketplace.json` ainda dizia `2.13.0` — o release da 2.14.0 bumpou só um dos dois arquivos.
Os dois voltaram a bater, como o `RELEASING.md` exige.

---

## [2.6.0] — 2026-07-14

### Regras do SonarQube EngPro agora são gate na hora da gravação (protheus 2.14.0)
Expand Down
2 changes: 1 addition & 1 deletion fluig/.claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "fluig",
"description": "Plugin Claude Code para desenvolvimento TOTVS Fluig — ciclo completo: brainstorm, planejamento, implementação com teammates (TDD), deploy, QA (E2E Playwright), verificação. Scaffolding de formulários, datasets, widgets Angular 19 + PO-UI, workflows BPM.",
"version": "2.1.0",
"version": "2.1.1",
"author": {
"name": "TBC - Time de Desenvolvimento"
},
Expand Down
13 changes: 13 additions & 0 deletions fluig/agents/fluig-implementer.md
Original file line number Diff line number Diff line change
Expand Up @@ -150,3 +150,16 @@ PRÓXIMOS PASSOS:

- **Nunca ficar preso silenciosamente** — se bloqueado, reportar imediatamente
- Se receber feedback de reviewer, corrigir e re-reportar sem necessidade de redespacho

### Execução

- **Nunca adivinhar** — API Fluig, assinatura de dataset, evento de workflow ou componente
PO-UI que você não conhece: consultar o MCP (`searchFluigApi` / `searchFluigPatterns` /
`searchKnowledge`, MCP `po-ui` para componentes) ou reportar `NEEDS_CONTEXT`. Inferir pelo
nome está proibido.
- **Código mínimo que resolve a task** — sem feature além da pedida, sem abstração de uso
único, sem configurabilidade não solicitada, sem tratamento de erro para cenário impossível.
- **Mudança cirúrgica** — não "melhorar" código adjacente, comentário ou formatação; manter o
estilo do arquivo existente mesmo que você faria diferente. Código morto pré-existente:
reportar, não apagar. Órfão criado pela SUA mudança: remover.
- **Toda linha alterada rastreia até a task** — se não rastreia, não entra.
2 changes: 1 addition & 1 deletion protheus/.claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "protheus",
"description": "Plugin Claude Code para desenvolvimento TOTVS Protheus — ciclo completo: brainstorm → plan → implement (teammates haiku/sonnet) → deploy (TDS-CLI) → qa (E2E Playwright) → verify. Geração ADVPL/TLPP, SQL embarcado, migração TLPP, diagnóstico, compilação, revisão, testes E2E Playwright (test-web), Knowledge Base MCP, integração TDN, geradores MVC/REST/query, dicionário de dados e geração de relatórios SmartView/TReports (smartview-relatorio).",
"version": "2.14.0",
"version": "2.14.1",
"author": {
"name": "TBC - Time de Desenvolvimento"
},
Expand Down
13 changes: 13 additions & 0 deletions protheus/agents/protheus-implementer.md
Original file line number Diff line number Diff line change
Expand Up @@ -110,3 +110,16 @@ Impacto: [o que muda dependendo da resposta]
- ProtheusDoc em toda User Function pública
- Código completo e compilável — nunca pseudo-código
- **Nunca ficar preso silenciosamente** — se bloqueado, reportar imediatamente

### Execução

- **Nunca adivinhar** — chave de `appserver.ini`, campo, função, parâmetro ou comportamento
Protheus que você não conhece: consultar o MCP (`searchKnowledge` / `ragSearchDocs` /
`searchFunction`) ou reportar `NEEDS_CONTEXT`. Inferir pelo nome está proibido — o que
"parece óbvio" em Protheus costuma estar errado.
- **Código mínimo que resolve a task** — sem feature além da pedida, sem abstração de uso
único, sem configurabilidade não solicitada, sem tratamento de erro para cenário impossível.
- **Mudança cirúrgica** — não "melhorar" código adjacente, comentário ou formatação; manter o
estilo do fonte existente mesmo que você faria diferente. Código morto pré-existente:
reportar, não apagar. Órfão criado pela SUA mudança: remover.
- **Toda linha alterada rastreia até a task** — se não rastreia, não entra.
Loading