Addon Studio Claude Code
snk-devcenter/addon-studio
21 skills + 6 agents para desenvolvimento Sankhya Addon Studio 2.0
Ver no GitHubSkill para Claude Code com 21 funcionalidades focadas + 6 sub-agents inteligentes que guiam a implementação em projetos Sankhya Addon Studio 2.0 (Wildfly/EJB + SDK Java JAPE). Cobre todo o ciclo: entidades, controllers, repositórios, testes, scripts de banco e troubleshooting.
Instalação
npx convez-ai snk-devcenter/addon-studio1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Scaffolding de entidades @JapeEntity com data dictionary automático
- Geração de controllers REST + DTOs + MapStruct mappers
- Criação de dbscripts dual MSSQL/Oracle com validação
- Escrita de testes JUnit 5 + Mockito com mocks automáticos
- Debug de erros comuns e troubleshooting de projeto
- Injeção de dependências com Guice DI
Veredito

Skill robusto e bem estruturado para o ecossistema Sankhya, com cobertura completa do stack JAPE/EJB. Requer conhecimento prévio profundo em Java Enterprise, mas automatiza boilerplate e reduz erros em padrões complexos. Implementação madura, mantida oficialmente pelo DevCenter.
README
A tradução para o português deste README ainda está na fila.
Addon Studio Plugin
Plugin com 21 skills focadas + 6 sub-agents — orienta implementacao em projetos Sankhya Addon Studio 2.0 (Wildfly/EJB + SDK Java JAPE). Mantido pelo setor DevCenter.
Compativel nativamente com Claude Code e OpenAI Codex CLI (padrao aberto Agent Skills / agentskills.io).
Conteudo
.
├── .claude-plugin/
│ └── marketplace.json # catalogo Claude Code (raiz)
├── .agents/
│ └── plugins/
│ └── marketplace.json # catalogo Codex CLI (raiz)
└── plugins/
└── addon-studio/
├── .claude-plugin/plugin.json # manifest plugin Claude Code
├── .codex-plugin/plugin.json # manifest plugin Codex CLI
├── hooks/hooks.json # hook PostToolUse encoding (Claude-only)
├── agents/ # 6 sub-agents (Claude Code only)
│ ├── addon-reviewer.md # review pre-commit (sonnet)
│ ├── entity-architect.md # modela trio CRUD (sonnet)
│ ├── controller-designer.md # @Controller + DTOs + Mapper (sonnet)
│ ├── test-writer.md # JUnit 5 + Mockito 4.11 (sonnet)
│ ├── troubleshooter.md # debug erros comuns (haiku)
│ └── dbscript-builder.md # dbscripts dual MSSQL/Oracle (haiku)
└── skills/
├── addon-studio/ # overview + regras universais + naming + fluxo CRUD
│ ├── SKILL.md
│ ├── agents/openai.yaml # metadata Codex desta skill
│ └── assets/ADDON.md # template de instrucoes injetado no projeto consumidor
├── init/SKILL.md # setup: copia ADDON.md pra docs/ + @import no CLAUDE.md
├── action-button/SKILL.md # @ActionButton (AcaoRotinaJava)
├── before-load-listener/SKILL.md # @BeforeLoadListener (FinderListener)
├── build/SKILL.md # gradle deployAddon
├── business-rule/SKILL.md # @BusinessRule (Regra)
├── controller/SKILL.md # @Controller REST
├── controller-advice/SKILL.md # @ControllerAdvice + @ExceptionHandler
├── data-dictionary/SKILL.md # XML datadictionary/<TABELA>.xml
├── database/SKILL.md # dbscripts/V<NNN>-*.xml dual MSSQL/Oracle
├── dependency-injection/SKILL.md # Guice DI
├── encoding/SKILL.md # ISO-8859-1 conversao
├── entity/SKILL.md # @JapeEntity
├── job/SKILL.md # @Job (IJob)
├── macros/SKILL.md # MacroTranslator SQL macros
├── mapstruct/SKILL.md # MapStruct mappers
├── repository/SKILL.md # @Repository / JapeRepository
├── retrofit/SKILL.md # Retrofit + Moshi + OkHttp (HTTP externo)
├── test/SKILL.md # JUnit 5 + Mockito 4.11
├── type-adapter/SKILL.md # @GlobalTypeAdapter
└── value/SKILL.md # @Value / ValueType
Layout multi-plugin: o repo serve como marketplace + plugin. Cada plugin futuro vai ganhar pasta propria em
plugins/<nome>/. Exigencia do Codex CLI (path local tem que apontar pra subpasta do marketplace root, nao pra raiz).
Cobertura (21 skills)
| Skill | Escopo |
|---|---|
addon-studio | Overview, regras universais (Java 8 strict, Lombok, ISO-8859-1), naming <PRX><MOD3><CTX>, fluxo CRUD |
init | Setup do projeto: copia ADDON.md pra docs/ADDON.md + garante @docs/ADDON.md no CLAUDE.md. Re-rodar = upgrade idempotente |
entity | @JapeEntity (Lombok, PK simples/composta, relacionamentos) |
data-dictionary | XML dicionario de dados |
database | dbscripts/V<NNN>-*.xml dual MSSQL/Oracle |
repository | @Repository, @Criteria, @NativeQuery, @Modifying |
retrofit | Retrofit + Moshi + OkHttp (deps moduleLib, interface client, wiring Guice, interceptors) |
controller | @Controller(serviceName SP), DTO + @Valid, @Transactional |
controller-advice | @ControllerAdvice + @ExceptionHandler, rollback automatico |
dependency-injection | Guice (@Component, @CustomModule, Multibinder, @Singleton, Provider<T>) |
mapstruct | componentModel=jakarta, injectionStrategy=CONSTRUCTOR, padrao create/merge |
test | JUnit 5 + Mockito 4.11 (mock estatico, JapeRepository quirks) |
action-button | @ActionButton (AcaoRotinaJava, @Form, ContextoAcao) |
business-rule | @BusinessRule (Regra, ContextoRegra, barramento) |
before-load-listener | @BeforeLoadListener (FinderListener, beforeExecute, filtro transversal no Finder) |
job | @Job (IJob, onSchedule, CRON, migracao XML) |
type-adapter | @GlobalTypeAdapter (TypeAdapter, JsonSerializer/JsonDeserializer) |
value | @Value / ValueType (Provider<T>, SANKHYA_PARAM) |
macros | MacroTranslator SQL (dbDate, nullValue, ignorecase, etc.) |
encoding | ISO-8859-1 obrigatorio em .java/.xml/.kt |
build | gradle deployAddon |
Convencao de nomenclatura (parametrizada por projeto)
Padrao parametrizado por <PRX> (prefixo) + <MOD3> (modulo). Skill detecta padrao existente no projeto; se ausente, pergunta ao dev antes de gerar artefatos.
| Artefato | Padrao | Exemplo (PRX=TDC, MOD3=XYZ) |
|---|---|---|
| Tabela do addon | <PRX><MOD3><CTX> UPPER | TDCXYZCAB |
@JapeEntity(entity = "...") | <Prx><Mod><Ctx> Pascal | TdcXyzCabecalho |
| Coluna custom em tabela nativa | <MOD3>_NOMECAMPO UPPER | XYZ_STATUS |
Sub-agents (Claude Code only)
Agents sao especialistas com workflow ativo, tools restritas e modelo proprio. Diferente de skills (conhecimento/instrucao textual), agents executam decisao + acao.
| Agent | Modelo | Escopo |
|---|---|---|
addon-reviewer | sonnet | Review pre-commit: encoding, Java 8, Lombok, Guice DI, @JapeEntity, anti-patterns. Saida em Blockers/Warnings/Suggestions. |
entity-architect | sonnet | Modela trio CRUD end-to-end: XML dicionario + dbscript migration + entidade @JapeEntity Java. |
controller-designer | sonnet | Desenha endpoint REST: @Controller + Request/Response DTOs + MapStruct Mapper + (se aplicavel) @ControllerAdvice. |
test-writer | sonnet | Escreve JUnit 5 + Mockito 4.11 com quirks de JapeRepository. Roda ./gradlew test pra validar. |
troubleshooter | haiku | Diagnostica erros: encoding, Guice DI, JPA misturada com JAPE, Java 8 violations, build/deploy. |
dbscript-builder | haiku | Gera dbscripts V<NNN>-*.xml dual MSSQL/Oracle (CREATE_TABLE minimo + ALTER por coluna). |
Codex CLI: agents sao feature exclusiva do Claude Code. As 21 skills funcionam em ambos harnesses; os 6 agents sao ignorados pelo Codex CLI (sem perda — usuarios do Codex usam invocacao explicita das skills).
Sem opiniao arquitetural
Skills cobrem regras do SDK e do framework. Organizacao de pacotes, camadas e padroes de design (Clean Arch, Hexagonal, MVC, DDD) sao decisoes do dev/projeto.
Como configurar no projeto consumidor
Skill discovery e semantica — agente so dispara skill quando o prompt do dev casa com algum trigger da description. Em projeto onde o dev pede so "implementa essa spec", agente pode pular o overview e perder regras universais (Java 8 strict, ISO-8859-1, JAPE nao JPA).
Pra forcar discovery + alinhamento, o plugin entrega o arquivo ADDON.md (instrucoes pro agente) e o setup automatizado via a skill init.
Setup em um comando
Na raiz do projeto Sankhya, peca ao agente:
/addon-studio:init
A skill:
- Confere que o projeto e mesmo Addon Studio (procura
br.com.sankhya.addonstudioembuild.gradle/build.gradle.kts). - Copia
ADDON.md(fonte canonica:<plugin-root>/skills/addon-studio/assets/ADDON.md) paradocs/ADDON.mdno projeto. - Cria ou atualiza o
CLAUDE.mdda raiz inserindo a linha@docs/ADDON.md(idempotente — nao duplica se ja existir, nao mexe em customizacoes do dev).
Resultado:
projeto/
├── docs/
│ └── ADDON.md # gerado pelo plugin — nao editar
├── CLAUDE.md # do dev — contem `@docs/ADDON.md` + customizacoes
├── build.gradle
└── ...
Atualizar o ADDON.md
Apos atualizar o plugin (/plugin update addon-studio@snk-devcenter), rode /addon-studio:init de novo. A skill faz overwrite do docs/ADDON.md (versao nova entra) sem tocar no CLAUDE.md do dev.
Customizacoes do projeto
Regras especificas do projeto (override de convencao, padrao de pacotes, etc.) vao no CLAUDE.md da raiz, fora do docs/ADDON.md. O plugin nunca regenera o CLAUDE.md — so insere o @docs/ADDON.md se ausente.
Codex CLI (AGENTS.md)
Codex CLI usa AGENTS.md e nao suporta sintaxe @import nativa. Como workaround temporario:
cp docs/ADDON.md AGENTS.md
(re-rodar quando atualizar o docs/ADDON.md). Setup automatico do AGENTS.md esta no roadmap.
Instalacao
A skill funciona nativamente em Claude Code e em OpenAI Codex CLI. Use o fluxo do harness que voce ja tem instalado.
Claude Code
/plugin marketplace add snk-devcenter/addon-studio
/plugin install addon-studio@snk-devcenter
Apos instalado, skills ficam disponiveis via auto-trigger (descrições específicas) ou invocacao explicita: /addon-studio:entity, /addon-studio:repository, etc. Sub-agents aparecem em /agents e sao auto-invocados conforme contexto (ou explicitamente via comando).
OpenAI Codex CLI
Atencao: o repo
snk-devcenter/addon-studioe privado. O Codex CLI nao respeita credenciaisgh/git/SSH do usuario ao resolverowner/repo(libgit2 interno ignora credential helpers). Use o fluxo de clone local abaixo.
-
Clone o repo manualmente (usa seu
gh authou chave SSH ja configurada):mkdir -p ~/.codex/marketplaces git clone git@github.com:snk-devcenter/addon-studio.git ~/.codex/marketplaces/addon-studio -
Adicione o marketplace apontando para o caminho local:
codex plugin marketplace add ~/.codex/marketplaces/addon-studio -
Abra a TUI e instale:
/pluginsEscolha
snk-devcenter->addon-studio-> Install.
Atualizar
Claude Code:
/plugin update addon-studio@snk-devcenter
Codex CLI (atualizar o clone local + recarregar marketplace):
git -C ~/.codex/marketplaces/addon-studio pull
codex plugin marketplace update snk-devcenter
E reinstalar via /plugins se necessario.
Limitacoes por harness
| Recurso | Claude Code | Codex CLI |
|---|---|---|
Auto-trigger por description da skill | sim | sim |
| Hook PostToolUse encoding ISO-8859-1 | sim | nao (rodar iconv apos editar — ver skill encoding) |
| Invocacao explicita por skill | /addon-studio:<skill> | $addon-studio:<skill> |
Sub-agents (agents/*.md) | sim (6 agents disponiveis) | nao (feature exclusiva Claude Code) |
Repo privado via owner/repo | sim (usa gh/git auth do user) | nao (libgit2 interno; usar clone local + path) |
Versionamento
Versoes seguem SemVer. Tag git por release: v1.0.0, v1.1.0, etc.