@luanpdd/kit-mcp 1.20.0 → 1.21.0

package/kit/commands/listar-workspaces.md

@@ -1,19 +1,19 @@
----
-name: listar-workspaces
-description: Lista os workspaces framework ativos e seu status
-allowed-tools:
-  - Bash
-  - Read
----
-<objective>
-Escanear `~/workspaces/` por diretórios de workspace contendo manifestos `WORKSPACE.md`. Exibir uma tabela resumo com nome, caminho, contagem de repos, estratégia e status do projeto framework.
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/list-workspaces.md
-@./.claude/framework/references/ui-brand.md
-</execution_context>
-
-<process>
-Execute o workflow list-workspaces de @./.claude/framework/workflows/list-workspaces.md do início ao fim.
+---
+name: listar-workspaces
+description: Lista os workspaces framework ativos e seu status
+allowed-tools:
+  - Bash
+  - Read
+---
+<objective>
+Escanear `~/workspaces/` por diretórios de workspace contendo manifestos `WORKSPACE.md`. Exibir uma tabela resumo com nome, caminho, contagem de repos, estratégia e status do projeto framework.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/list-workspaces.md
+@./.claude/framework/references/ui-brand.md
+</execution_context>
+
+<process>
+Execute o workflow list-workspaces de @./.claude/framework/workflows/list-workspaces.md do início ao fim.
 </process>

package/kit/commands/mapear-codebase.md

@@ -1,71 +1,71 @@
----
-name: mapear-codebase
-description: Analisa a base de código com agentes mapeadores paralelos para produzir documentos em .planning/codebase/
-argument-hint: "[opcional: área específica para mapear, ex: 'api' ou 'auth']"
-allowed-tools:
-  - Read
-  - Bash
-  - Glob
-  - Grep
-  - Write
-  - Task
----
-
-<objective>
-Analisar a base de código existente usando agentes codebase-mapper paralelos para produzir documentos estruturados.
-
-Cada agente mapeador explora uma área de foco e **escreve documentos diretamente** em `.planning/codebase/`. O orquestrador recebe apenas confirmações, mantendo o uso de contexto mínimo.
-
-Saída: pasta .planning/codebase/ com 7 documentos estruturados sobre o estado da base de código.
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/map-codebase.md
-</execution_context>
-
-<context>
-Área de foco: $ARGUMENTS (opcional - se fornecido, orienta os agentes a focar em um subsistema específico)
-
-**Carregar estado do projeto se existir:**
-Verificar .planning/STATE.md - carrega contexto se o projeto já foi inicializado
-
-**Este comando pode rodar:**
-- Antes de /novo-projeto (bases de código brownfield) - cria mapa da base de código primeiro
-- Após /novo-projeto (bases de código greenfield) - atualiza o mapa conforme o código evolui
-- A qualquer momento para atualizar a compreensão da base de código
-</context>
-
-<when_to_use>
-**Use mapear-codebase para:**
-- Projetos brownfield antes da inicialização (entender o código existente primeiro)
-- Atualizar mapa da base de código após mudanças significativas
-- Onboarding em uma base de código desconhecida
-- Antes de grandes refatorações (entender o estado atual)
-- Quando STATE.md referencia informações desatualizadas da base de código
-
-**Pule mapear-codebase para:**
-- Projetos greenfield sem código ainda (nada a mapear)
-- Bases de código triviais (menos de 5 arquivos)
-</when_to_use>
-
-<process>
-1. Verificar se .planning/codebase/ já existe (oferecer para atualizar ou pular)
-2. Criar estrutura de diretório .planning/codebase/
-3. Invocar 4 agentes codebase-mapper paralelos:
-   - Agente 1: foco tech → escreve STACK.md, INTEGRATIONS.md
-   - Agente 2: foco arch → escreve ARCHITECTURE.md, STRUCTURE.md
-   - Agente 3: foco quality → escreve CONVENTIONS.md, TESTING.md
-   - Agente 4: foco concerns → escreve CONCERNS.md
-4. Aguardar conclusão dos agentes, coletar confirmações (NÃO o conteúdo dos documentos)
-5. Verificar se todos os 7 documentos existem com contagem de linhas
-6. Commitar mapa da base de código
-7. Oferecer próximos passos (tipicamente: /novo-projeto ou /planejar-fase)
-</process>
-
-<success_criteria>
-- [ ] Diretório .planning/codebase/ criado
-- [ ] Todos os 7 documentos da base de código escritos pelos agentes mapeadores
-- [ ] Documentos seguem estrutura de template
-- [ ] Agentes paralelos concluíram sem erros
-- [ ] Usuário conhece próximos passos
+---
+name: mapear-codebase
+description: Analisa a base de código com agentes mapeadores paralelos para produzir documentos em .planning/codebase/
+argument-hint: "[opcional: área específica para mapear, ex: 'api' ou 'auth']"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Write
+  - Task
+---
+
+<objective>
+Analisar a base de código existente usando agentes codebase-mapper paralelos para produzir documentos estruturados.
+
+Cada agente mapeador explora uma área de foco e **escreve documentos diretamente** em `.planning/codebase/`. O orquestrador recebe apenas confirmações, mantendo o uso de contexto mínimo.
+
+Saída: pasta .planning/codebase/ com 7 documentos estruturados sobre o estado da base de código.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/map-codebase.md
+</execution_context>
+
+<context>
+Área de foco: $ARGUMENTS (opcional - se fornecido, orienta os agentes a focar em um subsistema específico)
+
+**Carregar estado do projeto se existir:**
+Verificar .planning/STATE.md - carrega contexto se o projeto já foi inicializado
+
+**Este comando pode rodar:**
+- Antes de /novo-projeto (bases de código brownfield) - cria mapa da base de código primeiro
+- Após /novo-projeto (bases de código greenfield) - atualiza o mapa conforme o código evolui
+- A qualquer momento para atualizar a compreensão da base de código
+</context>
+
+<when_to_use>
+**Use mapear-codebase para:**
+- Projetos brownfield antes da inicialização (entender o código existente primeiro)
+- Atualizar mapa da base de código após mudanças significativas
+- Onboarding em uma base de código desconhecida
+- Antes de grandes refatorações (entender o estado atual)
+- Quando STATE.md referencia informações desatualizadas da base de código
+
+**Pule mapear-codebase para:**
+- Projetos greenfield sem código ainda (nada a mapear)
+- Bases de código triviais (menos de 5 arquivos)
+</when_to_use>
+
+<process>
+1. Verificar se .planning/codebase/ já existe (oferecer para atualizar ou pular)
+2. Criar estrutura de diretório .planning/codebase/
+3. Invocar 4 agentes codebase-mapper paralelos:
+   - Agente 1: foco tech → escreve STACK.md, INTEGRATIONS.md
+   - Agente 2: foco arch → escreve ARCHITECTURE.md, STRUCTURE.md
+   - Agente 3: foco quality → escreve CONVENTIONS.md, TESTING.md
+   - Agente 4: foco concerns → escreve CONCERNS.md
+4. Aguardar conclusão dos agentes, coletar confirmações (NÃO o conteúdo dos documentos)
+5. Verificar se todos os 7 documentos existem com contagem de linhas
+6. Commitar mapa da base de código
+7. Oferecer próximos passos (tipicamente: /novo-projeto ou /planejar-fase)
+</process>
+
+<success_criteria>
+- [ ] Diretório .planning/codebase/ criado
+- [ ] Todos os 7 documentos da base de código escritos pelos agentes mapeadores
+- [ ] Documentos seguem estrutura de template
+- [ ] Agentes paralelos concluíram sem erros
+- [ ] Usuário conhece próximos passos
 </success_criteria>

package/kit/commands/multi-tenant.md

@@ -0,0 +1,163 @@
+---
+name: multi-tenant
+description: Orquestrador da Suíte Multi-Tenant SaaS B2B — dispatch para agents especializados (architect, rls, onboarding, invite, super-admin, audit-log, whatsapp, crm, lgpd, isolation-audit) com sinônimos PT/EN.
+argument-hint: "<subcomando> [args...]"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Grep
+  - Glob
+  - Task
+  - AskUserQuestion
+---
+
+<objective>
+Orquestrador único da Suíte Multi-Tenant SaaS B2B v1.21. Recebe um subcomando e args, faz dispatch via `Task(subagent_type=<multi-tenant-agent>)` para o agent especializado correto. É o **único ponto de chain de agents da Suíte Multi-Tenant** — agents permanecem função pura (anti-pitfall A10 v1.8).
+
+**Cross-Suite Invocation Pattern (introduzido v1.21):** Agents da Suíte Multi-Tenant **delegam para agents da Suíte Supabase v1.8** quando precisam materializar SQL, Edge Functions, RLS policies, Realtime, Storage. Padrão canônico:
+- `b2b-saas-architect` → delega plano de migration para `supabase-migration-writer`
+- `multi-tenant-rls-writer` → herda anti-pitfalls de `supabase-rls-writer` via cross-ref
+- `evolution-go-integrator` → delega Edge Function code para `supabase-edge-fn-writer`
+- `audit-log-implementer` → usa skill `supabase-cron-queues` para retention scheduling
+- `org-onboarding-implementer` → invoca `supabase-migration-writer` para migration + `supabase-edge-fn-writer` para wizard
+
+**Cria/Atualiza:** o que cada agent invocado cria/atualiza (skills consultadas, migrations propostas, Edge Functions, agents implementers).
+
+**Após:** o usuário tem o output do agent (plano, código, SQL, ou veredito de auditoria).
+</objective>
+
+<execution_context>
+Skills consultadas pelos agents: `kit/skills/{b2b-saas-architecture,multi-tenant-rls-hierarchy,rbac-permissions-matrix-supabase,multi-tenant-performance-scaling,org-onboarding-flow,member-invite-flow,super-admin-platform-pattern,audit-log-multi-tenant,lgpd-multi-tenant-compliance,evolution-go-whatsapp-integration,whatsapp-conversation-state-machine,crm-lead-pipeline-patterns,org-switcher-react-pattern,permission-gate-react-pattern,member-management-react-shadcn}/SKILL.md` + `kit/skills/_shared-multi-tenant/glossary.md` + cross-ref ATIVO para `kit/skills/_shared-supabase/glossary.md`.
+
+Agents disponíveis (Suíte Multi-Tenant v1.21): `kit/agents/{b2b-saas-architect,multi-tenant-rls-writer,multi-tenant-isolation-auditor,lgpd-compliance-auditor,org-onboarding-implementer,invite-flow-implementer,super-admin-implementer,audit-log-implementer,evolution-go-integrator,crm-pipeline-implementer}.md`.
+
+Agents Suíte Supabase v1.8 invocados via cross-suite delegation: `supabase-architect`, `supabase-migration-writer`, `supabase-rls-writer`, `supabase-edge-fn-writer`, `supabase-realtime-implementer`, `supabase-storage-implementer`, `supabase-auth-bootstrapper`.
+</execution_context>
+
+<context>
+**Argumentos:** `$ARGUMENTS` — primeiro token é o subcomando; restante é passado para o agent como prompt.
+
+**Subcomandos suportados (sinônimos PT-BR/EN):**
+
+| Subcomando | Sinônimos | Agent dispatched |
+|---|---|---|
+| `arquiteto` | `architect`, `arch` | `b2b-saas-architect` |
+| `rls-tenant` | `rls`, `policies` | `multi-tenant-rls-writer` |
+| `isolation-audit` | `audit-tenancy`, `auditar-tenancy` | `multi-tenant-isolation-auditor` |
+| `lgpd-audit` | `lgpd`, `compliance`, `compliance-audit` | `lgpd-compliance-auditor` |
+| `onboarding` | `org`, `onboard` | `org-onboarding-implementer` |
+| `convite` | `invite`, `invitation` | `invite-flow-implementer` |
+| `super-admin` | `admin`, `platform-admin` | `super-admin-implementer` |
+| `audit-log` | `audit`, `auditoria-log` | `audit-log-implementer` |
+| `whatsapp` | `evolution-go`, `wpp`, `evolution` | `evolution-go-integrator` |
+| `crm` | `pipeline`, `crm-pipeline`, `leads` | `crm-pipeline-implementer` |
+| `help` | `ajuda`, `?` | exibe esta tabela inline |
+
+**Aliases globais para o nome da suíte:** `multi-tenant`, `b2b`, `tenant`, `escritorio`, `tenancy` (todos roteiam para este orquestrador via `/multi-tenant`).
+
+**Detect `supabase/config.toml`:** se presente, extrai `project_id` e passa como contexto para o agent (mesmo pattern de `/supabase` v1.8).
+</context>
+
+<process>
+
+## 1. Parsear Subcomando
+
+```bash
+SUBCMD=$(echo "$ARGUMENTS" | awk '{print $1}')
+ARGS=$(echo "$ARGUMENTS" | cut -d' ' -f2-)
+```
+
+**Se `$ARGUMENTS` for vazio ou `SUBCMD` for `help`/`ajuda`/`?`:** exibir tabela de subcomandos inline + exemplo de uso. Sair.
+
+## 2. Resolver Sinônimos
+
+Mapear `SUBCMD` para agent name canônico:
+
+```
+arquiteto, architect, arch                     → b2b-saas-architect
+rls-tenant, rls, policies                      → multi-tenant-rls-writer
+isolation-audit, audit-tenancy, auditar-tenancy → multi-tenant-isolation-auditor
+lgpd-audit, lgpd, compliance, compliance-audit → lgpd-compliance-auditor
+onboarding, org, onboard                       → org-onboarding-implementer
+convite, invite, invitation                    → invite-flow-implementer
+super-admin, admin, platform-admin             → super-admin-implementer
+audit-log, audit, auditoria-log                → audit-log-implementer
+whatsapp, evolution-go, wpp, evolution         → evolution-go-integrator
+crm, pipeline, crm-pipeline, leads             → crm-pipeline-implementer
+```
+
+**Se subcomando não resolve:** exibir erro inline com lista de subcomandos válidos. Sair.
+
+```
+✗ Subcomando desconhecido: '<SUBCMD>'
+
+Subcomandos válidos:
+  arquiteto / architect       → projetar schema multi-tenant + RLS hierarchy + RBAC matrix antes de implementar
+  rls-tenant / rls            → gerar policies RLS hierárquicas (org/dept/role/permission/super-admin)
+  isolation-audit / audit-tenancy → auditar gaps de isolamento cross-tenant (RLS missing, JOIN cross-tenant)
+  lgpd / compliance           → auditar gaps LGPD per-tenant (DSR, consent, erasure, retention)
+  onboarding / org            → fluxo signup → criar org → primeiro admin → setup wizard
+  convite / invite            → token-based invite + accept flow + role assignment
+  super-admin / admin         → cross-tenant view + impersonation + audit obrigatório
+  audit-log / audit           → tabela append-only + retention pg_cron + PII sanitization
+  whatsapp / evolution-go     → webhooks Evolution Go + Meta Cloud + HMAC + idempotency
+  crm / pipeline              → state machine PG triggers + ownership transfer + lead dedup
+  help / ajuda / ?            → exibe tabela de subcomandos
+
+Uso: /multi-tenant <subcomando> <args...>
+Exemplos:
+  /multi-tenant arquiteto "app B2B advocacia com escritorios + departamentos"
+  /multi-tenant rls "gerar policies hierárquicas para tabela leads"
+  /multi-tenant whatsapp "webhook Evolution Go para org acme"
+  /multi-tenant lgpd "auditar gaps LGPD do projeto"
+```
+
+## 3. Detectar `supabase/config.toml`
+
+```bash
+if [ -f supabase/config.toml ]; then
+  PROJECT_ID=$(grep -E '^project_id\s*=' supabase/config.toml | sed 's/.*= *"\(.*\)".*/\1/' | head -1)
+fi
+```
+
+Se presente, anexar `project_id=<value>` ao prompt do agent. Se ausente, agent funciona sem.
+
+## 4. Dispatch
+
+Invocar `Task(subagent_type=<agent_name>, prompt=<built_prompt>)`.
+
+**Prompt construído:**
+
+```
+{ARGS}
+
+{Se project_id detectado:}
+project_id: {PROJECT_ID}
+
+{Para arquiteto: tier upfront via AskUserQuestion}
+{caller: pergunte ao user via AskUserQuestion sobre tier (Free/Pro/Team) e branches antes de produzir o plano — mesmo pattern do supabase-architect Step 1}
+```
+
+**Subcomando `arquiteto`:** antes de dispatch, faça `AskUserQuestion` perguntando tier (Free/Pro/Team/Enterprise) e se vai usar branches Supabase. Inclua resposta no prompt. (Cross-suite delegation: o `b2b-saas-architect` invoca `supabase-architect` no final via Task() handoff para a parte tier/branches/realtime.)
+
+**Subcomando `isolation-audit`:** dispatch para `multi-tenant-isolation-auditor` que requer MCP Supabase ativo. Se MCP indisponível, agent declara modo offline e produz checklist baseado apenas em arquivos do repo (sem `pg_class` query).
+
+**Subcomando `lgpd`:** mesma lógica — agent funciona offline mas perde precisão sem MCP.
+
+## 5. Output
+
+Output do agent é o output do command. Sem post-processing — agent já formata estruturado.
+
+</process>
+
+<success_criteria>
+- [ ] Subcomando resolvido para agent canônico (10 subcomandos × seus sinônimos)
+- [ ] `project_id` extraído de `supabase/config.toml` se presente
+- [ ] Subcomando `arquiteto` faz `AskUserQuestion` upfront sobre tier + branches
+- [ ] Dispatch via `Task(subagent_type=...)` — único ponto de chain de agents da Suíte Multi-Tenant
+- [ ] Subcomando inválido → mensagem clara com lista
+- [ ] Subcomando `help`/`ajuda`/`?` → exibe tabela inline
+- [ ] Args após subcomando passam transparentemente para o agent
+- [ ] Cross-suite invocation documentada (agents v1.21 → agents v1.8)
+</success_criteria>

package/kit/commands/nota.md

@@ -1,34 +1,34 @@
----
-name: nota
-description: Captura de ideias sem fricção. Adicionar, listar ou promover notas para todos.
-argument-hint: "<text> | list | promote <N> [--global]"
-allowed-tools:
-  - Read
-  - Write
-  - Glob
-  - Grep
----
-<objective>
-Captura de ideia sem fricção — uma chamada Write, uma linha de confirmação.
-
-Três subcomandos:
-- **append** (padrão): Salva um arquivo de nota com timestamp. Sem perguntas, sem formatação.
-- **list**: Mostra todas as notas dos escopos do projeto e global.
-- **promote**: Converte uma nota em um todo estruturado.
-
-Roda inline — sem Task, sem AskUserQuestion, sem Bash.
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/note.md
-@./.claude/framework/references/ui-brand.md
-</execution_context>
-
-<context>
-$ARGUMENTS
-</context>
-
-<process>
-Execute o workflow note de @./.claude/framework/workflows/note.md do início ao fim.
-Capturar a nota, listar notas ou promover para todo — dependendo dos argumentos.
+---
+name: nota
+description: Captura de ideias sem fricção. Adicionar, listar ou promover notas para todos.
+argument-hint: "<text> | list | promote <N> [--global]"
+allowed-tools:
+  - Read
+  - Write
+  - Glob
+  - Grep
+---
+<objective>
+Captura de ideia sem fricção — uma chamada Write, uma linha de confirmação.
+
+Três subcomandos:
+- **append** (padrão): Salva um arquivo de nota com timestamp. Sem perguntas, sem formatação.
+- **list**: Mostra todas as notas dos escopos do projeto e global.
+- **promote**: Converte uma nota em um todo estruturado.
+
+Roda inline — sem Task, sem AskUserQuestion, sem Bash.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/note.md
+@./.claude/framework/references/ui-brand.md
+</execution_context>
+
+<context>
+$ARGUMENTS
+</context>
+
+<process>
+Execute o workflow note de @./.claude/framework/workflows/note.md do início ao fim.
+Capturar a nota, listar notas ou promover para todo — dependendo dos argumentos.
 </process>

package/kit/commands/novo-marco.md

@@ -1,44 +1,44 @@
----
-name: novo-marco
-description: Inicia um novo ciclo de milestone — atualiza PROJECT.md e encaminha para requisitos
-argument-hint: "[nome do milestone, ex: 'v1.1 Notificações']"
-allowed-tools:
-  - Read
-  - Write
-  - Bash
-  - Task
-  - AskUserQuestion
----
-<objective>
-Iniciar um novo milestone: questionamento → pesquisa (opcional) → requisitos → roadmap.
-
-Equivalente brownfield do novo-projeto. O projeto existe, PROJECT.md tem histórico. Reúne "o que vem a seguir", atualiza PROJECT.md, então executa o ciclo requisitos → roadmap.
-
-**Cria/Atualiza:**
-- `.planning/PROJECT.md` — atualizado com novos objetivos do milestone
-- `.planning/research/` — pesquisa de domínio (opcional, apenas para NOVOS recursos)
-- `.planning/REQUIREMENTS.md` — requisitos com escopo para este milestone
-- `.planning/ROADMAP.md` — estrutura de fases (continua numeração)
-- `.planning/STATE.md` — reiniciado para novo milestone
-
-**Após:** `/planejar-fase [N]` para iniciar a execução.
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/new-milestone.md
-@./.claude/framework/references/questioning.md
-@./.claude/framework/references/ui-brand.md
-@./.claude/framework/templates/project.md
-@./.claude/framework/templates/requirements.md
-</execution_context>
-
-<context>
-Nome do milestone: $ARGUMENTS (opcional - solicitará se não fornecido)
-
-Arquivos de contexto do projeto e milestone são resolvidos dentro do workflow (`init new-milestone`) e delegados via blocos `<files_to_read>` onde subagentes são usados.
-</context>
-
-<process>
-Execute o workflow new-milestone de @./.claude/framework/workflows/new-milestone.md do início ao fim.
-Preserve todos os checkpoints do workflow (validação, questionamento, pesquisa, requisitos, aprovação do roadmap, commits).
+---
+name: novo-marco
+description: Inicia um novo ciclo de milestone — atualiza PROJECT.md e encaminha para requisitos
+argument-hint: "[nome do milestone, ex: 'v1.1 Notificações']"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Task
+  - AskUserQuestion
+---
+<objective>
+Iniciar um novo milestone: questionamento → pesquisa (opcional) → requisitos → roadmap.
+
+Equivalente brownfield do novo-projeto. O projeto existe, PROJECT.md tem histórico. Reúne "o que vem a seguir", atualiza PROJECT.md, então executa o ciclo requisitos → roadmap.
+
+**Cria/Atualiza:**
+- `.planning/PROJECT.md` — atualizado com novos objetivos do milestone
+- `.planning/research/` — pesquisa de domínio (opcional, apenas para NOVOS recursos)
+- `.planning/REQUIREMENTS.md` — requisitos com escopo para este milestone
+- `.planning/ROADMAP.md` — estrutura de fases (continua numeração)
+- `.planning/STATE.md` — reiniciado para novo milestone
+
+**Após:** `/planejar-fase [N]` para iniciar a execução.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/new-milestone.md
+@./.claude/framework/references/questioning.md
+@./.claude/framework/references/ui-brand.md
+@./.claude/framework/templates/project.md
+@./.claude/framework/templates/requirements.md
+</execution_context>
+
+<context>
+Nome do milestone: $ARGUMENTS (opcional - solicitará se não fornecido)
+
+Arquivos de contexto do projeto e milestone são resolvidos dentro do workflow (`init new-milestone`) e delegados via blocos `<files_to_read>` onde subagentes são usados.
+</context>
+
+<process>
+Execute o workflow new-milestone de @./.claude/framework/workflows/new-milestone.md do início ao fim.
+Preserve todos os checkpoints do workflow (validação, questionamento, pesquisa, requisitos, aprovação do roadmap, commits).
 </process>

package/kit/commands/novo-projeto.md

@@ -1,42 +1,42 @@
----
-name: novo-projeto
-description: Inicializa um novo projeto com coleta profunda de contexto e PROJECT.md
-argument-hint: "[--auto]"
-allowed-tools:
-  - Read
-  - Bash
-  - Write
-  - Task
-  - AskUserQuestion
----
-<context>
-**Flags:**
-- `--auto` — Modo automático. Após perguntas de configuração, executa pesquisa → requisitos → roadmap sem mais interação. Espera documento de ideia via referência @.
-</context>
-
-<objective>
-Inicializar um novo projeto através do fluxo unificado: questionamento → pesquisa (opcional) → requisitos → roadmap.
-
-**Cria:**
-- `.planning/PROJECT.md` — contexto do projeto
-- `.planning/config.json` — preferências de workflow
-- `.planning/research/` — pesquisa de domínio (opcional)
-- `.planning/REQUIREMENTS.md` — requisitos com escopo
-- `.planning/ROADMAP.md` — estrutura de fases
-- `.planning/STATE.md` — memória do projeto
-
-**Após este comando:** Execute `/planejar-fase 1` para iniciar a execução.
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/new-project.md
-@./.claude/framework/references/questioning.md
-@./.claude/framework/references/ui-brand.md
-@./.claude/framework/templates/project.md
-@./.claude/framework/templates/requirements.md
-</execution_context>
-
-<process>
-Execute o workflow new-project de @./.claude/framework/workflows/new-project.md do início ao fim.
-Preserve todos os checkpoints do workflow (validação, aprovações, commits, roteamento).
+---
+name: novo-projeto
+description: Inicializa um novo projeto com coleta profunda de contexto e PROJECT.md
+argument-hint: "[--auto]"
+allowed-tools:
+  - Read
+  - Bash
+  - Write
+  - Task
+  - AskUserQuestion
+---
+<context>
+**Flags:**
+- `--auto` — Modo automático. Após perguntas de configuração, executa pesquisa → requisitos → roadmap sem mais interação. Espera documento de ideia via referência @.
+</context>
+
+<objective>
+Inicializar um novo projeto através do fluxo unificado: questionamento → pesquisa (opcional) → requisitos → roadmap.
+
+**Cria:**
+- `.planning/PROJECT.md` — contexto do projeto
+- `.planning/config.json` — preferências de workflow
+- `.planning/research/` — pesquisa de domínio (opcional)
+- `.planning/REQUIREMENTS.md` — requisitos com escopo
+- `.planning/ROADMAP.md` — estrutura de fases
+- `.planning/STATE.md` — memória do projeto
+
+**Após este comando:** Execute `/planejar-fase 1` para iniciar a execução.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/new-project.md
+@./.claude/framework/references/questioning.md
+@./.claude/framework/references/ui-brand.md
+@./.claude/framework/templates/project.md
+@./.claude/framework/templates/requirements.md
+</execution_context>
+
+<process>
+Execute o workflow new-project de @./.claude/framework/workflows/new-project.md do início ao fim.
+Preserve todos os checkpoints do workflow (validação, aprovações, commits, roteamento).
 </process>