funifier-mcp 0.2.26 → 0.2.27

package/skills/acquire-funifier-knowledge/SKILL.md

@@ -0,0 +1,132 @@
+---
+name: acquire-funifier-knowledge
+description: Mapeia, documenta e audita uma instância Funifier EXISTENTE via MCP, produzindo documentação completa e rastreável em docs/funifier/ (overview, mecânicas de jogo, triggers, schedulers, endpoints, páginas, leaderboards, modelo de player, integrações, técnicas de jogo e inconsistências). Cada afirmação aponta para o objeto/ID que a sustenta. Use quando o usuário pedir para mapear, documentar, auditar ou fazer onboarding numa instância já configurada — por exemplo "mapeia essa gamificação", "documenta tudo que tem nessa instância Funifier", "preciso entender o que foi configurado aqui", "audita os triggers e schedulers", "map this Funifier instance", "document the gamification setup". NÃO use para criar ou editar elementos novos, debugging pontual de um único objeto, ou perguntas isoladas sobre a plataforma — para criar/editar/debugar use a skill funifier.
+license: CC-BY-4.0
+metadata:
+  author: Fernando Viana
+  version: 1.0.0
+---
+
+# Acquire Funifier Knowledge
+
+Varre uma instância Funifier existente via MCP e produz documentação completa, auditável e rastreável de toda a gamificação configurada. Esta skill é de DESCOBERTA e DOCUMENTAÇÃO — ela lê o estado vivo do servidor e o transcreve em arquivos versionáveis. Ela nunca cria, edita ou deleta nada na instância.
+
+## Quando usar / Quando NÃO usar
+
+- **Use** quando o objetivo é entender, mapear ou auditar uma instância já configurada (onboarding num projeto herdado, due diligence, documentação de handover).
+- **NÃO use** para criar/editar/deletar elementos, debugar um único objeto, ou responder uma pergunta pontual sobre a plataforma. Para isso, use a skill `funifier` (`skills/funifier/SKILL.md`), que é a base de conhecimento técnico (semântica de campos, enums, valores corretos).
+
+## Pré-requisitos
+
+1. **MCP Funifier disponível.** Esta skill depende das ferramentas `funifier_*`. Sem elas, pare e peça ao usuário para configurar o MCP.
+2. **Base de conhecimento técnico.** Para interpretar a semântica de cada objeto (o que significa `range`, `operator`, `limitPerType` num challenge, etc.), consulte a skill `funifier` e seus arquivos `references/`. Nunca aprenda a semântica a partir de um único objeto vivo — os docs são a autoridade.
+
+## Output Contract
+
+Produza esta estrutura em `docs/funifier/`. **Nenhum arquivo pode ficar vazio** (use `[TODO]`/`[ASK USER]` quando faltar dado, nunca deixe a seção em branco). Os templates de cada arquivo estão em `assets/templates/`.
+
+| Arquivo | Conteúdo |
+|---------|----------|
+| `OVERVIEW.md` | Identificação da instância, contagens agregadas por categoria, data do snapshot, escopo do mapeamento |
+| `GAME_MECHANICS.md` | Pontos, níveis, achievements/badges, challenges, missions, quizzes, virtual goods — com IDs, regras de atribuição e condições |
+| `TRIGGERS.md` | Todos os triggers: nome, ID, entidade/evento de origem, condições, ações, status |
+| `SCHEDULERS.md` | Cron jobs: nome, expressão cron, ação, próxima/última execução conhecida, status |
+| `CUSTOM_ENDPOINTS.md` | Public endpoints em Java/Groovy: rota, método, parâmetros, descrição, status |
+| `CUSTOM_PAGES.md` | Custom pages e widgets: nome, rota, propósito, integrações |
+| `LEADERBOARDS.md` | Rankings: nome, métrica base, escopo, período, regras de empate |
+| `PLAYER_MODEL.md` | Atributos custom de player, segmentações, teams/grupos, propriedades estendidas |
+| `INTEGRATIONS.md` | Webhooks de saída, websockets, auth modules, integrações externas |
+| `TECHNIQUES_AND_PATTERNS.md` | Técnicas de jogos inferidas dos elementos mapeados, com evidência por objeto |
+| `CONCERNS.md` | Inconsistências: triggers órfãos, schedulers desativados, achievements inatingíveis, endpoints sem uso, regras conflitantes |
+
+## Mapeamento documento → fonte MCP (CRÍTICO)
+
+O vocabulário de gamificação do usuário **não corresponde 1:1** ao enum de tipos do Funifier. Documentar um tipo que não existe é um erro grave. Use exatamente este mapeamento. Os **18 tipos listáveis** via `funifier_list`/`funifier_get` são: `trigger`, `scheduler`, `aggregate`, `websocket`, `widget`, `custom-page`, `public-endpoint`, `challenge-aggregate`, `auth-module`, `ai-knowledge`, `action`, `challenge`, `point`, `level`, `leaderboard`, `quiz`, `virtual-good-catalog`, `virtual-good-item`.
+
+| Documento | Fonte primária (MCP) |
+|-----------|----------------------|
+| `OVERVIEW.md` | Contagem de cada um dos 18 tipos via `funifier_list` + `funifier_database action=collections` |
+| `GAME_MECHANICS.md` | `point`, `level`, `challenge`, `action`, `quiz`, `virtual-good-catalog`, `virtual-good-item`, `challenge-aggregate`, `aggregate` |
+| `TRIGGERS.md` | `trigger` (+ `funifier_logs type=trigger` para saúde de execução) |
+| `SCHEDULERS.md` | `scheduler` (+ `funifier_logs type=scheduler`) |
+| `CUSTOM_ENDPOINTS.md` | `public-endpoint` |
+| `CUSTOM_PAGES.md` | `custom-page`, `widget` |
+| `LEADERBOARDS.md` | `leaderboard` |
+| `PLAYER_MODEL.md` | `funifier_database` (coleções `player`, `team`) + `auth-module` |
+| `INTEGRATIONS.md` | `websocket`, `auth-module`, `ai-knowledge` + coleções de webhook/notification via `funifier_database` + ações HTTP em triggers |
+| `TECHNIQUES_AND_PATTERNS.md` | Inferência cruzada (sem fonte nova; cita IDs já mapeados) |
+| `CONCERNS.md` | Análise cruzada (status `inactive`, órfãos, logs vazios, regras conflitantes) |
+
+**Mapeamentos de vocabulário que você DEVE respeitar:**
+
+- **"achievements/badges"** — não existe tipo próprio. São `challenge` (regras + recompensas) e/ou `virtual-good-item` (badges como itens de catálogo). Documente em `GAME_MECHANICS.md` e identifique qual mecanismo implementa o quê.
+- **"missions"** — não existe tipo próprio. São cadeias de `challenge` ou hierarquia de learning trail (folder). Registre a suposição com `[ASK USER]` quando a intenção não for óbvia.
+- **"webhooks / integrações de saída"** — não há tipo em `funifier_list`. Devem ser inferidos de coleções via `funifier_database` (ex.: coleção de webhook/notification) e de ações de `trigger` que chamam endpoints externos. `INTEGRATIONS.md` terá legitimamente vários `[TODO]`/`[ASK USER]` — isso é esperado, não um defeito.
+- **Learning trails (folders)** — não são listáveis por `funifier_list`. Use `funifier_folder operation=inside` a partir de um id raiz conhecido, ou `funifier_database`.
+
+## Restrições de ferramentas (read-only — regra dura)
+
+Esta é uma auditoria. **Nunca** modifique a instância:
+
+- `funifier_database`: use **somente** `action=query`, `action=aggregate`, `action=collections`. NUNCA `insert`/`update`/`delete`/`bulk`.
+- `funifier_folder`: use **somente** `operation=inside` e `operation=breadcrumb`. NUNCA `progress` — ele dispara o trigger `folder_progress` como efeito colateral.
+- NUNCA use `funifier_execute` (roda código no servidor), `funifier_save` ou `funifier_delete`.
+- `funifier_get`: use `mode=read` (inspeção inline, não cria arquivos temporários).
+
+**Economia de tokens:** faça o inventário com `funifier_list` (retorna resumo leve) primeiro; só use `funifier_get mode=read` nos objetos que precisam de detalhe (scripts Groovy, regras completas de challenge, pipelines). Não puxe o payload completo de tudo cegamente. Padrões de chamada detalhados em `references/mcp-call-patterns.md`.
+
+## Workflow
+
+Avance pelas fases em ordem. As fases 1 e 6 são sempre completas (mesmo em Modo Foco).
+
+1. **Validar conexão e identificar a instância.** Confirme que o MCP responde (uma chamada `funifier_database action=collections` ou um `funifier_list type=trigger limit=1` serve). Registre serverUrl/nome da conexão e a data do snapshot para o `OVERVIEW.md`.
+2. **Inventário bruto.** Para cada um dos 18 tipos, rode `funifier_list` e registre os IDs e nomes. Rode `funifier_database action=collections` para descobrir coleções que revelam elementos fora do enum (webhooks, notifications, competitions, custom `__c`, player, team). Consulte `references/funifier-inventory-checklist.md` para a lista de perguntas por categoria.
+3. **Detalhamento.** Para cada objeto que precisa de detalhe, rode `funifier_get mode=read` e extraia as regras, condições e ações. Amostre coleções relevantes com `funifier_database action=query` (limit pequeno) para entender o modelo de player/team.
+4. **Análise cruzada.** Relacione objetos: qual `trigger` alimenta qual `point`/`challenge`; qual `scheduler` chama qual `public-endpoint`; quais `action`s satisfazem as regras de cada `challenge`; quais `leaderboard`s usam quais `point`s. Anote as relações para `CONCERNS.md` e `TECHNIQUES_AND_PATTERNS.md`.
+5. **Inferência de técnicas de jogos.** Classifique as técnicas observadas usando `references/game-techniques-taxonomy.md`. Cada técnica DEVE ser ligada aos IDs concretos que a implementam. Sem objeto que a sustente, não afirme a técnica.
+6. **Validação.** Verifique: (a) cada claim aponta para um ID/objeto; (b) nenhuma seção obrigatória está vazia; (c) todo nome de ferramenta usado existe; (d) nenhum tipo inventado. Veja a checklist no fim deste arquivo.
+7. **Apresentar.** Mostre um sumário (contagens + onde está cada doc) e uma lista numerada de itens `[ASK USER]` e divergências encontradas, para o usuário resolver.
+
+## Regras de evidência (críticas)
+
+- **Toda afirmação aponta para um objeto Funifier identificável** — `_id`, nome único, rota de endpoint, ou nome de coleção. Sem isso, não escreva a afirmação.
+- Use **`[TODO]`** quando o dado existe mas não foi possível obtê-lo via MCP nesta execução (ex.: payload grande demais, coleção não amostrada).
+- Use **`[ASK USER]`** quando a resposta depende de intenção de produto/negócio — ex.: "esse trigger desativado foi intencional?", "essa cadeia de challenges é uma 'mission'?".
+- **Nunca infira comportamento sem um objeto que o sustente.** "Provavelmente dispara X" é proibido; cite a config do trigger e o evento exato.
+- **Toda seção termina com um bloco `## Evidence`** listando os IDs consultados e as chamadas MCP que produziram o conteúdo (ex.: `funifier_list type=trigger`, `funifier_get type=challenge id=...`).
+
+## Modo Foco (Focus Area Mode)
+
+Se o usuário pedir foco ("só triggers", "mecânicas e técnicas apenas"):
+
+- A **Fase 1** (validar/identificar) roda sempre, completa.
+- Os documentos do foco são preenchidos **completos**.
+- Os demais documentos obrigatórios **existem**, com suas seções presentes mas marcadas `[TODO]` (e uma nota indicando que ficaram fora do escopo desta execução).
+- A **Fase 6** (validação) roda em **todos** os documentos.
+
+## Anti-padrões
+
+| ❌ Não fazer | ✅ Fazer |
+|-------------|---------|
+| "Provavelmente este trigger dispara X" | Citar a configuração do trigger e o evento exato (`entity`/`event`) registrado |
+| Inferir técnica de jogo sem objeto que a implemente | Linkar cada técnica a IDs concretos no Funifier |
+| Documentar objetos com `status: inactive` como se estivessem ativos | Marcar o status explicitamente; mover para `CONCERNS.md` se órfão |
+| Confundir achievement com challenge ou mission | Respeitar a tipagem do Funifier; cada categoria no seu doc |
+| Inventar um tipo (ex.: tratar "webhook" como `funifier_list type=webhook`) | Usar só os 18 tipos reais; inferir o resto de coleções e ações |
+| Modificar a instância para "testar" um comportamento | Apenas ler; nunca `save`/`delete`/`execute`/`insert`/`update` |
+
+## Quando ler cada arquivo de referência
+
+- `references/funifier-inventory-checklist.md` — na **Fase 2**, para garantir que nenhuma categoria de objeto foi esquecida.
+- `references/mcp-call-patterns.md` — nas **Fases 2–4**, para os padrões corretos de chamada de cada ferramenta MCP.
+- `references/game-techniques-taxonomy.md` — na **Fase 5**, para classificar as técnicas com vocabulário consistente.
+
+## Checklist de validação (Fase 6)
+
+- [ ] Os 11 arquivos existem em `docs/funifier/` e nenhum está vazio.
+- [ ] Cada afirmação aponta para um ID/objeto/coleção identificável.
+- [ ] Todo objeto com status conhecido tem o status registrado.
+- [ ] Nenhum tipo inventado — só os 18 tipos reais + coleções via `funifier_database`.
+- [ ] Cada documento termina com um bloco `## Evidence`.
+- [ ] Itens dependentes de intenção estão marcados `[ASK USER]`, não adivinhados.
+- [ ] Nenhuma ferramenta de escrita foi usada (`save`/`delete`/`execute`/`insert`/`update`/`bulk`/`folder progress`).

package/skills/acquire-funifier-knowledge/assets/templates/CONCERNS.md

@@ -0,0 +1,25 @@
+# Funifier — Inconsistências e Concerns
+
+> Achados de auditoria. Cada item aponta para o(s) objeto(s) envolvido(s) por ID. Distinga fato observado (`[FATO]`) de pergunta de intenção (`[ASK USER]`).
+
+## Core (Obrigatório)
+
+| # | Tipo de problema | Objeto(s) (ID) | Observação | Severidade | Ação sugerida |
+|---|------------------|----------------|------------|------------|---------------|
+| 1 | {{trigger órfão / scheduler off / achievement inatingível / endpoint sem uso / regra conflitante}} | {{ids}} | {{o que se observou}} | {{baixa/média/alta}} | {{verificar/remover/ajustar | [ASK USER]}} |
+
+### Categorias a verificar
+- **Triggers órfãos:** ativos mas sem logs de execução, ou referenciam action/point inexistente.
+- **Schedulers desativados:** `active: false` que parecem importantes.
+- **Achievements inatingíveis:** challenges com regra impossível ou action que não existe.
+- **Endpoints sem uso:** public-endpoints não chamados por scheduler/trigger/página.
+- **Regras conflitantes:** dois objetos com efeitos contraditórios (ex.: dois triggers no mesmo evento creditando o mesmo point).
+- **Métricas órfãs:** points/levels sem leaderboard ou challenge que os utilize.
+
+## Extended (Opcional)
+- Riscos de manutenção (scripts longos, lógica duplicada entre triggers).
+- Itens que dependem de confirmação de intenção do usuário (consolidar os `[ASK USER]`).
+
+## Evidence
+- `funifier_logs type=trigger|scheduler id=<...>` (para silêncio/erros)
+- Referências cruzadas das Fases 3–4 (qual objeto referencia qual)

package/skills/acquire-funifier-knowledge/assets/templates/CUSTOM_ENDPOINTS.md

@@ -0,0 +1,24 @@
+# Funifier — Custom Endpoints
+
+> Public endpoints em Java/Groovy. Endpoint sem chamador aparente (scheduler/trigger/página) → `CONCERNS.md`.
+
+## Core (Obrigatório)
+
+| _id | Rota | Método | Parâmetros esperados | Descrição | Status |
+|-----|------|--------|----------------------|-----------|--------|
+| {{id}} | {{/rota}} | {{GET/POST/...}} | {{params}} | {{o que retorna/faz}} | {{ativo?}} |
+
+### Detalhe por endpoint (quando relevante)
+**{{title}}** (`{{_id}}`)
+- Rota / método: `{{método}} {{rota}}`
+- Entrada: {{parâmetros e formato}}
+- Saída / efeito: {{resumo do script}}
+- Consumido por: {{página/scheduler/trigger/sistema externo | [TODO]}}
+
+## Extended (Opcional)
+- Autenticação exigida (público vs. token).
+- Endpoints que escrevem em coleções (efeitos colaterais).
+
+## Evidence
+- `funifier_list type=public-endpoint`
+- `funifier_get mode=read type=public-endpoint id=<...>`

package/skills/acquire-funifier-knowledge/assets/templates/CUSTOM_PAGES.md

@@ -0,0 +1,24 @@
+# Funifier — Custom Pages e Widgets
+
+> Páginas custom (Studio) e widgets embutíveis. Documente qual endpoint/aggregate cada um consome.
+
+## Core (Obrigatório)
+
+### Custom pages
+| _id | title | Rota | Propósito | Integrações (endpoints/aggregates) |
+|-----|-------|------|-----------|-------------------------------------|
+| {{id}} | {{título}} | {{rota}} | {{para quê serve}} | {{refs}} |
+
+### Widgets
+| _id | title | Propósito | Onde é embutido |
+|-----|-------|-----------|-----------------|
+| {{id}} | {{título}} | {{ranking/status/loja/...}} | {{intranet/CRM/LMS/... | [TODO]}} |
+
+## Extended (Opcional)
+- Tecnologia da página (AngularJS + Bootstrap, etc.), se relevante.
+- Páginas/widgets órfãos (sem rota de acesso aparente) → também citar em `CONCERNS.md`.
+
+## Evidence
+- `funifier_list type=custom-page`
+- `funifier_list type=widget`
+- `funifier_get mode=read type=custom-page id=<...>`

package/skills/acquire-funifier-knowledge/assets/templates/GAME_MECHANICS.md

@@ -0,0 +1,35 @@
+# Funifier — Mecânicas de Jogo
+
+> "achievements/badges" = `challenge` e/ou `virtual-good-item` (não há tipo próprio). "missions" = cadeias de challenge ou learning trail — marque `[ASK USER]`.
+
+## Core (Obrigatório)
+
+### Pontos (point categories)
+| _id | category | shortName | Tipo (XP/moeda/interna) |
+|-----|----------|-----------|-------------------------|
+| {{id}} | {{category}} | {{short}} | {{tipo}} |
+
+### Níveis (levels)
+| _id | level | position | minPoints | Categoria de ponto |
+|-----|-------|----------|-----------|--------------------|
+| {{id}} | {{nome}} | {{pos}} | {{min}} | {{point}} |
+
+### Challenges / Achievements
+| _id | challenge | Regras (resumo) | Recompensas | Status |
+|-----|-----------|-----------------|-------------|--------|
+| {{id}} | {{nome}} | {{condições}} | {{points/itens}} | {{ativo?}} |
+
+### Actions (comportamentos rastreáveis)
+| _id | action | Atributos | Usada por (challenge/trigger) |
+|-----|--------|-----------|-------------------------------|
+| {{id}} | {{action}} | {{attrs}} | {{refs}} |
+
+## Extended (Opcional)
+- **Quizzes:** {{_id, title, grade}} — `[TODO]` se não houver.
+- **Virtual goods:** catálogos e itens ({{_id, amount, active}}), indicando quais são badges.
+- **Missions:** cadeias de challenge identificadas — `[ASK USER]` para confirmar intenção.
+- **Aggregates:** pipelines que alimentam relatórios/dashboards de mecânicas.
+
+## Evidence
+- `funifier_list type=point|level|challenge|action|quiz|virtual-good-catalog|virtual-good-item`
+- `funifier_get mode=read type=challenge id=<...>` (para regras completas)

package/skills/acquire-funifier-knowledge/assets/templates/INTEGRATIONS.md

@@ -0,0 +1,35 @@
+# Funifier — Integrações
+
+> Webhooks de saída não têm tipo em `funifier_list` — inferir de coleções (`funifier_database`) e de ações HTTP em triggers. É esperado e correto que este doc tenha vários `[TODO]`/`[ASK USER]`.
+
+## Core (Obrigatório)
+
+### Websockets
+| _id | title | Propósito | Status |
+|-----|-------|-----------|--------|
+| {{id}} | {{título}} | {{live update/chat/...}} | {{ativo?}} |
+
+### Webhooks de saída
+Fonte: coleção descoberta via `funifier_database action=collections` (ex.: `webhook`/`notification`).
+
+| Destino | Evento de origem | Coleção/fonte | Autenticação | Status |
+|---------|------------------|---------------|--------------|--------|
+| {{URL/sistema}} | {{evento}} | {{collection}} | {{tipo | [TODO]}} | {{ativo? | [TODO]}} |
+
+### Integrações via trigger
+Triggers cujo script chama URLs externas (descobertos no detalhamento):
+
+| Trigger _id | Chama | Quando |
+|-------------|-------|--------|
+| {{id}} | {{URL/serviço externo}} | {{entity/event}} |
+
+## Extended (Opcional)
+- Auth modules que integram com IdP externo.
+- `ai-knowledge` configurado (bases de conhecimento de IA).
+- Integrações citadas pelo usuário mas não verificáveis via MCP → `[ASK USER]`.
+
+## Evidence
+- `funifier_list type=websocket`
+- `funifier_list type=auth-module`
+- `funifier_list type=ai-knowledge`
+- `funifier_database action=collections`

package/skills/acquire-funifier-knowledge/assets/templates/LEADERBOARDS.md

@@ -0,0 +1,24 @@
+# Funifier — Leaderboards
+
+> Rankings configurados. Cite a métrica base por ID (qual `point`/action/atributo). Leaderboard sobre um point inexistente → `CONCERNS.md`.
+
+## Core (Obrigatório)
+
+| _id | title | Métrica base | Escopo | Período | Regra de empate |
+|-----|-------|--------------|--------|---------|-----------------|
+| {{id}} | {{título}} | {{point/action/attr + id}} | {{global/segmentado}} | {{período}} | {{regra | [TODO]}} |
+
+### Detalhe por leaderboard (quando relevante)
+**{{title}}** (`{{_id}}`)
+- Métrica: {{categoria de ponto / action / atributo}} (`{{id da métrica}}`)
+- Escopo: {{global | por team | por segmento}}
+- Janela de tempo: {{contínuo | semanal | mensal | ...}}
+- Critério de desempate: {{descrição | [TODO]}}
+
+## Extended (Opcional)
+- Leaderboards alimentados por aggregates específicos.
+- Relação com competições (ranking always-on vs. contest com data de fim).
+
+## Evidence
+- `funifier_list type=leaderboard`
+- `funifier_get mode=read type=leaderboard id=<...>`

package/skills/acquire-funifier-knowledge/assets/templates/OVERVIEW.md

@@ -0,0 +1,47 @@
+# Funifier — Overview da Instância
+
+> Snapshot gerado pela skill `acquire-funifier-knowledge`. Substitua todos os `{{...}}`. Não deixe seções vazias — use `[TODO]`/`[ASK USER]`.
+
+## Core (Obrigatório)
+
+### Identificação
+- **Instância:** {{nome/serverUrl}}
+- **Data do snapshot:** {{YYYY-MM-DD}}
+- **Escopo do mapeamento:** {{completo | foco em <área>}}
+
+### Contagens agregadas
+Contagem por tipo listável (preencha 0 quando não houver — não omita):
+
+| Tipo | Qtde |
+|------|------|
+| trigger | {{n}} |
+| scheduler | {{n}} |
+| action | {{n}} |
+| challenge | {{n}} |
+| point | {{n}} |
+| level | {{n}} |
+| leaderboard | {{n}} |
+| quiz | {{n}} |
+| virtual-good-catalog | {{n}} |
+| virtual-good-item | {{n}} |
+| public-endpoint | {{n}} |
+| custom-page | {{n}} |
+| widget | {{n}} |
+| websocket | {{n}} |
+| aggregate | {{n}} |
+| challenge-aggregate | {{n}} |
+| auth-module | {{n}} |
+| ai-knowledge | {{n}} |
+
+### Elementos fora do enum (via coleções)
+| Elemento | Coleção | Qtde aprox. |
+|----------|---------|-------------|
+| {{webhook/notification/competition/...}} | {{collection}} | {{n}} |
+
+## Extended (Opcional)
+- Versão/plano da instância, se conhecido.
+- Principais áreas funcionais identificadas (resumo de 2-3 linhas).
+
+## Evidence
+- `funifier_list type=<cada um dos 18 tipos>`
+- `funifier_database action=collections`

package/skills/acquire-funifier-knowledge/assets/templates/PLAYER_MODEL.md

@@ -0,0 +1,31 @@
+# Funifier — Modelo de Player
+
+> Derivado de amostragem das coleções `player`/`team` (read-only) e dos auth modules. Não invente atributos — liste só os que aparecem nos documentos amostrados. Intenção de negócio → `[ASK USER]`.
+
+## Core (Obrigatório)
+
+### Atributos custom de player
+Campos além dos padrão observados na amostra de `collection=player`:
+
+| Campo | Tipo observado | Exemplo (anonimizado) | Propósito inferido |
+|-------|----------------|-----------------------|--------------------|
+| {{campo}} | {{string/number/bool/...}} | {{ex}} | {{para quê | [ASK USER]}} |
+
+### Segmentações / Teams
+| Segmentação | Fonte (campo/coleção) | Valores observados |
+|-------------|-----------------------|--------------------|
+| {{team/hierarquia/extra}} | {{collection.field}} | {{valores}} |
+
+### Auth modules
+| _id | title | Propósito | Status |
+|-----|-------|-----------|--------|
+| {{id}} | {{título}} | {{login/SSO/...}} | {{ativo?}} |
+
+## Extended (Opcional)
+- Volume aproximado de players (via `funifier_database`).
+- Propriedades estendidas usadas por challenges/leaderboards como filtro.
+
+## Evidence
+- `funifier_database action=query collection=player limit=3`
+- `funifier_database action=query collection=team limit=5`
+- `funifier_list type=auth-module`

package/skills/acquire-funifier-knowledge/assets/templates/SCHEDULERS.md

@@ -0,0 +1,25 @@
+# Funifier — Schedulers
+
+> Tarefas agendadas (cron, Groovy). Scheduler `active: false` que parece importante → `CONCERNS.md` + `[ASK USER]`.
+
+## Core (Obrigatório)
+
+| _id | name | cron | Ação executada | Última execução | Status |
+|-----|------|------|----------------|-----------------|--------|
+| {{id}} | {{nome}} | {{expr cron}} | {{o que faz}} | {{via funifier_logs | [TODO]}} | {{active?}} |
+
+### Detalhe por scheduler (quando relevante)
+**{{name}}** (`{{_id}}`)
+- Cron: `{{expressão}}` ({{interpretação em linguagem natural}})
+- O que faz: {{resumo do script}}
+- Chama endpoint/coleção: {{refs, se houver}}
+- Saúde: {{logs recentes? erros? | [TODO]}}
+
+## Extended (Opcional)
+- Próxima execução estimada (se derivável do cron).
+- Schedulers que dependem de dados produzidos por triggers/aggregates.
+
+## Evidence
+- `funifier_list type=scheduler`
+- `funifier_get mode=read type=scheduler id=<...>`
+- `funifier_logs type=scheduler id=<...>`

package/skills/acquire-funifier-knowledge/assets/templates/TECHNIQUES_AND_PATTERNS.md

@@ -0,0 +1,26 @@
+# Funifier — Técnicas e Padrões de Jogo
+
+> Inferência cruzada — NÃO introduz dados novos. Cada técnica afirmada DEVE listar os IDs que a implementam. Sem objeto que a sustente, a técnica está ausente. Use a taxonomia em `references/game-techniques-taxonomy.md`.
+
+## Core (Obrigatório)
+
+Para cada técnica presente, use este formato:
+
+### {{Nome da técnica}}
+{{Presente | Parcial | Ausente}}. {{Como é implementada nesta instância}}
+- {{Objeto e ID que implementa}}
+- {{Objeto e ID que implementa}}
+
+(Repita para cada técnica observada: loops de feedback, progressão, competição, colaboração, recompensas/economia, conquistas/status, escassez/urgência, surpresa/sorte, narrativa, onboarding.)
+
+### Técnicas ausentes (notáveis)
+Liste técnicas comuns que NÃO foram encontradas, se relevante para o diagnóstico — ex.: "Colaboração: ausente — nenhum team ou challenge coletivo configurado."
+
+## Extended (Opcional)
+- Padrões de design observados (ex.: signup flow, daily streak) com os triggers/schedulers que os compõem.
+- Lacunas: técnicas iniciadas mas incompletas (ex.: points sem leaderboard que os exiba).
+
+## Evidence
+Liste, por técnica, as chamadas/IDs que sustentam a inferência. Ex.:
+- Progressão → `funifier_list type=level`; `funifier_get type=point id=<...>`
+- Competição → `funifier_list type=leaderboard`

package/skills/acquire-funifier-knowledge/assets/templates/TRIGGERS.md

@@ -0,0 +1,27 @@
+# Funifier — Triggers
+
+> Eventos que disparam ações server-side (Groovy). Não escreva "provavelmente dispara X" — cite `entity`/`event` exatos. Trigger ativo sem logs → mova para `CONCERNS.md`.
+
+## Core (Obrigatório)
+
+| _id | name | entity | event | Condições | Ações executadas | Status |
+|-----|------|--------|-------|-----------|------------------|--------|
+| {{id}} | {{nome}} | {{entity}} | {{event}} | {{condições do script}} | {{o que faz}} | {{ativo/inativo}} |
+
+### Detalhe por trigger (quando relevante)
+Para triggers com lógica não-trivial, documente o resumo do script:
+
+**{{name}}** (`{{_id}}`)
+- Origem: `{{entity}}` / `{{event}}`
+- O que faz: {{resumo do comportamento, baseado no script Groovy}}
+- Objetos afetados: {{point/challenge/coleção que ele toca}}
+- Última execução conhecida: {{timestamp via funifier_logs | [TODO]}}
+
+## Extended (Opcional)
+- Triggers agrupados por evento de origem.
+- Dependências entre triggers (um cria um log que outro consome).
+
+## Evidence
+- `funifier_list type=trigger`
+- `funifier_get mode=read type=trigger id=<...>`
+- `funifier_logs type=trigger id=<...>`

package/skills/acquire-funifier-knowledge/references/funifier-inventory-checklist.md

@@ -0,0 +1,81 @@
+# Checklist de inventário Funifier
+
+Use na Fase 2 para garantir cobertura. Para cada categoria, faça a chamada MCP indicada e responda as perguntas. Marque `[TODO]` se a chamada falhar e `[ASK USER]` se a resposta depender de intenção de negócio. Cada categoria indica em qual documento o resultado entra.
+
+## Mecânicas de jogo → `GAME_MECHANICS.md`
+
+**Pontos** (`funifier_list type=point`)
+- Quantas categorias de ponto existem? Quais `category` e `shortName`?
+- Cada categoria é XP, moeda resgatável, ou métrica interna?
+
+**Níveis** (`funifier_list type=level`)
+- Quantos níveis? Qual `minPoints` e `position` de cada um?
+- A qual categoria de ponto a progressão está atrelada?
+
+**Challenges / achievements** (`funifier_list type=challenge` → `funifier_get mode=read`)
+- Quantos challenges? Quais regras (`rules`) e recompensas (`points`) de cada um?
+- Algum é inatingível (regra impossível, ação inexistente)? → `CONCERNS.md`
+- Há cadeias que representam "missions"? → marque `[ASK USER]`
+
+**Actions** (`funifier_list type=action`)
+- Quais comportamentos rastreáveis existem? Quais `attributes`?
+- Alguma action está definida mas não é referenciada por nenhum challenge/trigger? → `CONCERNS.md`
+
+**Quizzes** (`funifier_list type=quiz`)
+- Quantos quizzes? Qual o critério de aprovação (`grade`)?
+
+**Virtual goods** (`funifier_list type=virtual-good-catalog` e `type=virtual-good-item`)
+- Quais catálogos e itens? Itens `active`? Preço (`amount`) e categoria de ponto usada?
+- Algum item funciona como badge (recompensa simbólica)?
+
+**Aggregates** (`funifier_list type=aggregate`, `type=challenge-aggregate`)
+- Quais pipelines alimentam dashboards/relatórios? Sobre qual `collection`?
+
+## Triggers → `TRIGGERS.md`
+
+`funifier_list type=trigger` → `funifier_get mode=read` nos relevantes → `funifier_logs type=trigger`
+- Para cada trigger: `name`, `_id`, `entity`, `event`, `status`.
+- Quais condições e quais ações executa (resumo do script Groovy)?
+- Está ativo? Tem logs de execução recentes? → silêncio = `CONCERNS.md`
+
+## Schedulers → `SCHEDULERS.md`
+
+`funifier_list type=scheduler` → `funifier_get mode=read` → `funifier_logs type=scheduler`
+- Para cada scheduler: `name`, `_id`, expressão `cron`, `active`/`status`.
+- Qual ação executa? Última execução conhecida (via logs)?
+- Está `active: false` mas parece importante? → `CONCERNS.md` + `[ASK USER]`
+
+## Custom endpoints → `CUSTOM_ENDPOINTS.md`
+
+`funifier_list type=public-endpoint` → `funifier_get mode=read`
+- Para cada endpoint: rota, método, parâmetros esperados, descrição, status.
+- Algum endpoint não é chamado por nenhum scheduler/trigger/página? → `CONCERNS.md`
+
+## Custom pages e widgets → `CUSTOM_PAGES.md`
+
+`funifier_list type=custom-page` e `type=widget`
+- Para cada um: `title`, rota, propósito, integrações (quais endpoints/aggregates consome).
+
+## Leaderboards → `LEADERBOARDS.md`
+
+`funifier_list type=leaderboard` → `funifier_get mode=read`
+- Para cada ranking: nome, métrica base (qual `point`/action/atributo), escopo (global/segmentado), período, regra de empate.
+
+## Modelo de player → `PLAYER_MODEL.md`
+
+`funifier_database action=query collection=player limit=3` (amostra) + `funifier_list type=auth-module`
+- Quais atributos custom aparecem nos documentos de player (campos além dos padrão)?
+- Há segmentações (`team`, hierarquia, extras)? Amostre `collection=team`.
+- Quais auth modules estão configurados?
+
+## Integrações → `INTEGRATIONS.md`
+
+`funifier_list type=websocket`, `type=ai-knowledge` + `funifier_database action=collections`
+- Há websockets configurados? Para quê?
+- Existe coleção de webhook/notification? Quais destinos externos?
+- Há triggers cujo script chama URLs externas? (descoberto no detalhamento)
+- Auth/integração externa configurada? → muitos itens aqui serão `[TODO]`/`[ASK USER]`.
+
+## Cobertura final
+
+Antes de sair da Fase 2, confirme que rodou `funifier_list` para **todos os 18 tipos** e `funifier_database action=collections` ao menos uma vez. Qualquer tipo com zero resultados deve ser registrado no `OVERVIEW.md` como contagem 0 (não omitido).

package/skills/acquire-funifier-knowledge/references/game-techniques-taxonomy.md

@@ -0,0 +1,62 @@
+# Taxonomia de técnicas de jogos
+
+Use na Fase 5 para classificar as técnicas observadas com vocabulário consistente. **Regra de ouro:** uma técnica só pode ser afirmada se houver um ou mais objetos Funifier concretos que a implementem. Para cada técnica que você reportar em `TECHNIQUES_AND_PATTERNS.md`, liste os IDs que a sustentam. Se não há objeto, a técnica não está presente — não a invente.
+
+## Como classificar
+
+Para cada técnica abaixo, pergunte: "Quais objetos mapeados (com ID) implementam isto?" Se a resposta for vazia, marque a técnica como **ausente** (ou omita). Se houver evidência parcial, marque `[ASK USER]` para confirmar a intenção.
+
+## Catálogo de técnicas
+
+### Loops de feedback (feedback loops)
+Resposta imediata a uma ação do jogador.
+- **Evidência típica:** `trigger` que credita `point` ao registrar uma `action`; notificações `on_win`; widgets de status que atualizam.
+- **Sinal de ausência:** actions registradas sem nenhum trigger/point reagindo.
+
+### Progressão (progression)
+Senso de avanço ao longo do tempo.
+- **Evidência típica:** `level` com `minPoints` crescentes; learning trail (folder) com desbloqueio condicional; cadeias de `challenge`.
+
+### Competição (competition)
+Comparação de desempenho entre jogadores.
+- **Evidência típica:** `leaderboard` (global ou segmentado); competições com prêmio por posição; ranking por `team`.
+
+### Colaboração (collaboration)
+Objetivos coletivos.
+- **Evidência típica:** `team`/grupos no modelo de player; challenges com `limitPerType=team`; leaderboards de time.
+
+### Recompensas e economia (rewards & economy)
+Incentivos tangíveis e moeda interna.
+- **Evidência típica:** `point` resgatável; `virtual-good-catalog`/`virtual-good-item`; mecânicas de troca/loja.
+
+### Conquistas e status (achievement & status)
+Marcos simbólicos.
+- **Evidência típica:** `challenge` de conclusão única; itens-badge no catálogo; títulos por nível.
+
+### Escassez e urgência (scarcity & urgency)
+Tempo ou quantidade limitados.
+- **Evidência típica:** challenges com janela de tempo (`limitTimeScale`); competições com data de fim; `scheduler` que abre/fecha temporadas.
+
+### Surpresa e sorte (surprise & chance)
+Recompensa aleatória.
+- **Evidência típica:** mystery box / sorteios (descobertos via `funifier_database`, fora do enum de `funifier_list`).
+
+### Narrativa (narrative)
+Contexto de história que dá sentido às ações.
+- **Evidência típica:** interactive story; nomenclatura temática de challenges/folders; conteúdo de páginas custom.
+
+### Onboarding e tutorial
+Condução dos primeiros passos.
+- **Evidência típica:** trigger no evento de cadastro/primeiro login; primeira etapa de uma learning trail; challenge introdutório.
+
+## Bloco de evidência por técnica
+
+Em `TECHNIQUES_AND_PATTERNS.md`, formate cada técnica assim:
+
+```
+### Progressão
+Presente. Implementada por:
+- Níveis L1–L5 (level _id: lvl_01..lvl_05), atrelados à categoria de ponto "xp" (point _id: pts_xp).
+- Trilha "Onboarding" (folder root: fld_onboarding) com desbloqueio sequencial.
+Evidence: funifier_list type=level; funifier_get type=point id=pts_xp; funifier_folder operation=inside folder=fld_onboarding
+```