# Init

> Setup inicial do projeto Sankhya Addon Studio para colaboração com o agente. Copia o template `ADDON.md` (instruções do plugin) para `docs/ADDON.md` no projeto e garante que o `CLAUDE.md` da raiz importe esse arquivo via `@docs/ADDON.md`. Use quando o dev pedir "setup do projeto", "configurar CLAUDE.md", "instalar instruções do addon-studio", "atualizar ADDON.md", ou rodar `/addon-studio:init`. O…

- **Type:** Skill
- **Install:** `agentstack add skill-snk-devcenter-addon-studio-init`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [snk-devcenter](https://agentstack.voostack.com/s/snk-devcenter)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [snk-devcenter](https://github.com/snk-devcenter)
- **Source:** https://github.com/snk-devcenter/addon-studio/tree/main/plugins/addon-studio/skills/init

## Install

```sh
agentstack add skill-snk-devcenter-addon-studio-init
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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.

```bash
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

```bash
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](https://github.com/snk-devcenter)
- **Source:** [snk-devcenter/addon-studio](https://github.com/snk-devcenter/addon-studio)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-snk-devcenter-addon-studio-init
- Seller: https://agentstack.voostack.com/s/snk-devcenter
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.