Init

Init — Setup do projeto Sankhya para o agente

Skill instala/atualiza no projeto consumidor o docs/ADDON.md (instruções do plugin para o agente) e garante que o CLAUDE.md da raiz importe esse arquivo via @docs/ADDON.md.

Quando usar

• Primeira vez configurando o projeto pra colaboração com o agente.
• Após atualizar o plugin (/plugin update addon-studio) — re-rodar pega a versão mais recente do ADDON.md.
• Dev pediu "setup", "configurar CLAUDE.md", "instalar instruções", "atualizar ADDON.md".

Pré-requisito (sanity check)

Antes de copiar nada, confirme que o projeto é mesmo Sankhya Addon Studio. Procure por br.com.sankhya.addonstudio em build.gradle ou build.gradle.kts na raiz. Se ausente, pare e alerte o dev — o ADDON.md injetaria contexto errado num projeto não-Sankhya.

grep -l "br.com.sankhya.addonstudio" build.gradle build.gradle.kts 2>/dev/null

Fluxo da skill

1. Localizar o ADDON.md canônico

O template fica no diretório assets/ da skill addon-studio (convenção Agent Skills). Use a variável de ambiente ${CLAUDE_PLUGIN_ROOT} (disponível para skills de plugin — aponta para a raiz do plugin instalado):

• ${CLAUDE_PLUGIN_ROOT}/skills/addon-studio/assets/ADDON.md

2. Copiar ADDON.md para docs/ no projeto

mkdir -p docs
cp "${CLAUDE_PLUGIN_ROOT}/skills/addon-studio/assets/ADDON.md" ./docs/ADDON.md

Overwrite é esperado — re-rodar a skill upgrade o arquivo pra versão mais nova. Dev nunca edita docs/ADDON.md à mão (override do projeto vai no CLAUDE.md, não aqui).

3. Garantir @docs/ADDON.md no CLAUDE.md da raiz

Claude Code suporta sintaxe de import de arquivo via @ no CLAUDE.md. Garanta que o CLAUDE.md da raiz contenha a linha @docs/ADDON.md.

Caso A — CLAUDE.md não existe: crie com o seguinte template mínimo:

````markdown

CLAUDE.md

@docs/ADDON.md

Customizações deste projeto

> Regras específicas do projeto que sobrescrevem as skills do plugin (ex.: convenção de pacotes, padrão de nomenclatura customizada, restrições de design adicionais).

• Sem customizações declaradas.

````

Caso B — CLAUDE.md já existe e já contém @docs/ADDON.md: não faça nada (idempotente).

Caso C — CLAUDE.md já existe mas não contém @docs/ADDON.md: insira a linha @docs/ADDON.md no topo (após o título #, se houver), preservando o resto do conteúdo intacto. Avise o dev em uma linha que o import foi adicionado.

4. Confirmar para o dev

Reporte em 2-3 linhas:

• docs/ADDON.md copiado (ou atualizado).
• CLAUDE.md criado / import adicionado / já estava OK.
• Próximo passo opcional: dev adiciona regras específicas do projeto na seção "Customizações" do CLAUDE.md.

Idempotência — checklist

• [ ] docs/ADDON.md é overwrite seguro (conteúdo todo gerado pelo plugin).
• [ ] @docs/ADDON.md no CLAUDE.md só é inserido se ausente — nunca duplica.
• [ ] Não toca em customizações que o dev escreveu no CLAUDE.md.

O que NÃO fazer

• Não regenerar o conteúdo do ADDON.md do zero — sempre copie do assets/. Fonte de verdade é o plugin.
• Não inserir conteúdo do ADDON.md direto no CLAUDE.md (era o approach antigo, agora deprecated em favor de @import).

Skills relacionadas

• addon-studio — overview que o ADDON.md instrui o agente a carregar
• encoding — ADDON.md deve ficar em UTF-8 (é arquivo de instrução, não código Sankhya); ignore a regra ISO-8859-1 para este arquivo específico

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: snk-devcenter
• Source: snk-devcenter/addon-studio
• License: MIT

Install and usage instructions live in the source repository linked above.