@codigodoleo/wp-kit 1.0.0

package/.cspell.json

@@ -0,0 +1,104 @@
+{
+  "version": "0.2",
+  "language": "en,pt_BR",
+  "dictionaries": [
+    "php"
+  ],
+  "import": [
+    "@cspell/dict-php/cspell-ext.json",
+    "@cspell/dict-pt-br/cspell-ext.json"
+  ],
+  "words": [
+    "ACF",
+    "appserver",
+    "autofetch",
+    "azuretools",
+    "bitbucket",
+    "Blade",
+    "bmewburn",
+    "bradlc",
+    "catppuccin",
+    "Catppuccin",
+    "commitlint",
+    "commitlintrc",
+    "composer",
+    "conventionalchangelog",
+    "davidanson",
+    "dbaeumer",
+    "eamodio",
+    "esbenp",
+    "eslint",
+    "everforest",
+    "felixfbecker",
+    "filesize",
+    "formulahendry",
+    "formuylahendry",
+    "gitcz",
+    "gitlab",
+    "gitmessage",
+    "gitmoji",
+    "intelephense",
+    "johnbillion",
+    "junstyle",
+    "kohler",
+    "lando",
+    "laravel",
+    "lintstagedrc",
+    "lndo",
+    "mhutchie",
+    "nginx",
+    "nonce",
+    "phpcbf",
+    "phpcs",
+    "phpsab",
+    "pint",
+    "pkief",
+    "post_type",
+    "realpath",
+    "realpathcache",
+    "realpathcachettl",
+    "realpathttl",
+    "roots",
+    "Sage",
+    "sainnhe",
+    "southeners",
+    "stylelint",
+    "stylelintignore",
+    "taxonomies",
+    "tungvn",
+    "valeryanm",
+    "vhosts",
+    "vivaxy",
+    "webdevops",
+    "wordpresstoolbox",
+    "wp",
+    "wp_enqueue_script",
+    "wpackagist",
+    "wpdb",
+    "yzhang",
+    "zhuangtongfa"
+  ],
+  "ignorePaths": [
+    "node_modules/**",
+    "vendor/**",
+    "dist/**",
+    "public/**"
+  ],
+  "enableFiletypes": [
+    "php",
+    "js",
+    "ts",
+    "json",
+    "scss",
+    "md",
+    "html"
+  ],
+  "languageSettings": [
+    {
+      "languageId": "php",
+      "dictionaries": [
+        "php"
+      ]
+    }
+  ]
+}

package/.editorconfig

@@ -0,0 +1,13 @@
+# EditorConfig helps maintain consistent coding styles across editors
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+indent_size = 2
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false

package/.eslintignore

@@ -0,0 +1,3 @@
+node_modules/
+dist/
+__test-sandbox__/

package/.eslintrc.json

@@ -0,0 +1,24 @@
+{
+  "root": true,
+  "env": {
+    "es2022": true,
+    "node": true
+  },
+  "extends": ["eslint:recommended", "prettier"],
+  "plugins": ["import"],
+  "parserOptions": {
+    "ecmaVersion": "latest",
+    "sourceType": "module"
+  },
+  "rules": {
+    "no-unused-vars": ["warn", { "argsIgnorePattern": "^_" }],
+    "no-console": "off",
+    "import/order": [
+      "warn",
+      {
+        "groups": ["builtin", "external", "internal", "parent", "sibling", "index"],
+        "newlines-between": "always"
+      }
+    ]
+  }
+}

package/.github/workflows/publish-npm.yml

@@ -0,0 +1,32 @@
+name: publish-npm
+
+on:
+  release:
+    types: [published, released, created]
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install deps
+        run: npm ci --no-audit --no-fund
+
+      - name: Build (skip if not needed)
+        run: echo "No build step"
+
+      - name: Publish to npm
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: npm publish --access public

package/.github/workflows/release-please.yml

@@ -0,0 +1,25 @@
+name: release-please
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: google-github-actions/release-please-action@v4
+        with:
+          release-type: node
+          package-name: "@codigodoleo/wp-kit"
+          changelog-types: |
+            [{"type":"feat","section":"Features","hidden":false},
+             {"type":"fix","section":"Bug Fixes","hidden":false},
+             {"type":"docs","section":"Documentation","hidden":false},
+             {"type":"refactor","section":"Refactors","hidden":false},
+             {"type":"chore","section":"Chores","hidden":false}]

package/.prettierignore

@@ -0,0 +1,4 @@
+node_modules/
+dist/
+__test-sandbox__/
+coverage/

package/.prettierrc

@@ -0,0 +1,8 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "printWidth": 100,
+  "trailingComma": "es5",
+  "arrowParens": "always"
+}

package/.vscode/settings.json

@@ -0,0 +1,19 @@
+{
+  "editor.formatOnSave": false,
+  "editor.defaultFormatter": "esbenp.prettier-vscode",
+  "files.trimTrailingWhitespace": true,
+  "files.insertFinalNewline": true,
+  "editor.codeActionsOnSave": {
+    "source.fixAll": "explicit"
+  },
+  "files.associations": {
+    "*.hbs": "plaintext",
+    "*.yml.hbs": "yaml",
+    "*.json.hbs": "jsonc",
+    "*.php.hbs": "php",
+    "*.js.hbs": "javascript",
+    "*.css.hbs": "css",
+    "*.scss.hbs": "scss",
+    "*.vue.hbs": "vue"
+  }
+}

package/CHANGELOG.md

@@ -0,0 +1,47 @@
+# Changelog
+
+## 1.0.0 (2025-09-27)
+
+
+### Features
+
+* add build templates for GitLab CI/CD ([4880c40](https://github.com/lgobatto/wp-kit/commit/4880c40d9c39925e1d112aa617001cd3b1a546f7))
+* **cli:** implementar CLI para scaffolding de projetos WordPress DevOps com comandos de inicialização e prompts interativos ([a65dd0c](https://github.com/lgobatto/wp-kit/commit/a65dd0c6c1f8552b68b4de9e4e17da6c629f134b))
+* **config:** adicionar arquivo .editorconfig e atualizar composer.json e cspell.json com novas configurações e palavras-chave ([fadae79](https://github.com/lgobatto/wp-kit/commit/fadae7950b78c37cf946999bee756e7953cbd629))
+* **config:** adicionar arquivos de configuração do PHP, NGINX e templates para instalação do WordPress, incluindo suporte a variáveis de ambiente e otimizações de cache ([ae4a66d](https://github.com/lgobatto/wp-kit/commit/ae4a66d3223fa2fdcba29228eb7fbeb3607804c8))
+* **config:** adicionar arquivos de configuração para ESLint, Prettier e CSpell, além de recomendações de extensões para VSCode ([e487f54](https://github.com/lgobatto/wp-kit/commit/e487f5451f12df5643ffedf623dedce9ffffa84c))
+* **copy-directory:** implementar funcionalidade de cópia de diretórios com controle de sobrescrita, incluindo testes e documentação atualizada ([baf1eb6](https://github.com/lgobatto/wp-kit/commit/baf1eb6a96539bab656bcb82fcdcc4e0c68ace22))
+* **cspell:** adicionar arquivo de configuração .cspell.json e atualizar associações de arquivos no VSCode ([314a83d](https://github.com/lgobatto/wp-kit/commit/314a83dcb5fbf9de2601734b17998670dfd41987))
+* **cspell:** adicionar novas palavras ao dicionário de verificação ortográfica ([50ab73c](https://github.com/lgobatto/wp-kit/commit/50ab73c39c1d7c72be6359de5e661d75bee652f5))
+* **cspell:** adicionar novas palavras ao dicionário no arquivo .cspell.json para melhorar a verificação ortográfica ([f2f22ed](https://github.com/lgobatto/wp-kit/commit/f2f22edd463e6b57e8eeb4010a65b1732c7e83e7))
+* **cspell:** atualizar configurações do arquivo .cspell.json, adicionando novas palavras e organizando dicionários e tipos de arquivo ([a23ee3b](https://github.com/lgobatto/wp-kit/commit/a23ee3bc458fcbe135cb7c1d57280db8ab7a3c23))
+* **deploy:** adicionar script git-deploy.sh para inicialização de repositório, configuração de remote e push forçado, além de implementar templates de CI/CD para validação e segurança no GitLab ([ad5a37a](https://github.com/lgobatto/wp-kit/commit/ad5a37a9e98489cd0bd18704cad7b8c882a6c0d7))
+* **deploy:** adicionar suporte a configurações de implantação com Docker, incluindo prompts para seleção de estratégia e provedor, além de criar arquivos de configuração necessários ([d42e269](https://github.com/lgobatto/wp-kit/commit/d42e26964748769a79853e465d268f84eaf75a30))
+* **docs:** adicionar documentação completa sobre arquitetura, desenvolvimento, infraestrutura e monitoramento do site Pipefy, incluindo guias de configuração e melhores práticas ([9ed8521](https://github.com/lgobatto/wp-kit/commit/9ed85211b8a378403ef0a31e039879e7c79b54df))
+* **docs:** adicionar novos templates de documentação para configuração, desenvolvimento, infraestrutura e monitoramento do site Pipefy, incluindo guias detalhados e melhores práticas ([ac4653c](https://github.com/lgobatto/wp-kit/commit/ac4653c3a7550e31e90d243cf33c3d13045e86a7))
+* **editorconfig:** adicionar arquivo .editorconfig para padronização de estilos de codificação ([669cbf4](https://github.com/lgobatto/wp-kit/commit/669cbf46d3fd4cfd5cc0c0f12e60b801ecbda421))
+* enhance GitLab CI/CD pipeline with advanced features ([0436062](https://github.com/lgobatto/wp-kit/commit/0436062433d14c694368aafee31d57f3cdb71ba6))
+* **generator:** atualizar a função de geração de arquivos para usar lodash.mergewith e adicionar suporte a estratégias de merge de arrays ([eb5d701](https://github.com/lgobatto/wp-kit/commit/eb5d701dbfcc008dd2229ab558d3446bd1f1851f))
+* **git-workspace:** adicionar suporte para geração de arquivo de workspace do VSCode e novos prompts de configuração para Git ([55670af](https://github.com/lgobatto/wp-kit/commit/55670af798d98f0177f5118fc04e079aa4ee3e78))
+* **git:** adicionar arquivo .gitkeep para manter diretório vazio no repositório ([8bab8e6](https://github.com/lgobatto/wp-kit/commit/8bab8e6d5d87507749df39f12db5f0a5933f7ff7))
+* **git:** adicionar documentação e templates para Conventional Commits, incluindo instruções de uso, configurações do VS Code e melhorias no sistema de hooks para commits automáticos. ([9603051](https://github.com/lgobatto/wp-kit/commit/96030513a607845e894aaa396171c187cf22e2c9))
+* **git:** adicionar suporte a configuração de Git com commitlint, lint-staged e husky, incluindo templates e scripts necessários ([64fa435](https://github.com/lgobatto/wp-kit/commit/64fa435c43371eecd3151801b40a195a469aa547))
+* **git:** adicionar templates e configurações para Conventional Commits, incluindo snippets, documentação e validação de mensagens ([77897ce](https://github.com/lgobatto/wp-kit/commit/77897ce3ed67eb01979e6b6e09c6a6bd242f1877))
+* **hooks:** implementar sistema de hooks para execução de callbacks em momentos específicos, incluindo a adição de um gerenciador de hooks e execução de hooks pós-configuração. ([8ca5679](https://github.com/lgobatto/wp-kit/commit/8ca567986a386b5c5934943daf27ca113da59045))
+* **init:** adicionar arquivo .gitignore e atualizar templates de configuração do Lando para suporte a linting com Yarn ([f697fe2](https://github.com/lgobatto/wp-kit/commit/f697fe22ae268b35f0e4e6a8a2256bea7f1941c7))
+* **init:** adicionar arquivos de configuração do WordPress, incluindo index.php e wp-config.php, com suporte a variáveis de ambiente e configuração para Docker ([d2d8b51](https://github.com/lgobatto/wp-kit/commit/d2d8b51de08abaace6cccf337d3dce79ac816ae9))
+* **init:** adicionar opção de debug e suporte a estratégia de merge 'concat' na geração de arquivos ([b7ea6a2](https://github.com/lgobatto/wp-kit/commit/b7ea6a29b47d2660a9e54a528e594703cdb07a90))
+* **lando:** adicionar instalação do Node.js e Yarn no template .lando.yml.hbs, além de executar script de instalação do WordPress durante o build ([4e6c5fd](https://github.com/lgobatto/wp-kit/commit/4e6c5fd5300d37b0aabdd376a81619e8a85ee55b))
+* **lando:** atualizar configuração do Lando para incluir comandos de build e otimização do tema Sage ([c1125c3](https://github.com/lgobatto/wp-kit/commit/c1125c3461caa6fe98dca127844281904ea6ee6f))
+* **lando:** reorganizar scripts de build e instalação no template .lando.yml.hbs, unificando comandos para o appserver e removendo dependências desnecessárias do serviço node. ([bbe44d9](https://github.com/lgobatto/wp-kit/commit/bbe44d9813b83b1386e80c5aabb6d4e9bab6bcfd))
+* **lint:** adicionar suporte a ferramentas de linting e formatação com ESLint, Prettier e Stylelint, incluindo templates e prompts de configuração ([f8e1823](https://github.com/lgobatto/wp-kit/commit/f8e182383f1ebeaef897f6e13e2a2e4eeb6fdac7))
+* **lint:** atualizar configurações de linting e formatação no workspace.json.hbs, substituir scripts PHP por Pint, e remover wrappers desnecessários, além de adicionar novas tarefas para o Lando. ([59ed719](https://github.com/lgobatto/wp-kit/commit/59ed719676f91ee21f9b2bf02ee54ce3e3deb46a))
+* **lint:** atualizar scripts de linting no package.json e adicionar novo arquivo wp-translation-downloader.lock ao .gitignore ([13db50b](https://github.com/lgobatto/wp-kit/commit/13db50b22f7068f97152ff87529be7edec5ed311))
+* **php:** adicionar scripts wrapper para suporte a ferramentas PHP e configuração no ambiente Lando, incluindo documentação no README.md ([d4bb95e](https://github.com/lgobatto/wp-kit/commit/d4bb95e5b26542a8df4e2f4b615ef637be5fbc51))
+* **setup:** adicionar suporte a CLI com wp-devops-setup, incluindo README.md, configuração do package.json e melhorias nos comandos de inicialização ([514c1e5](https://github.com/lgobatto/wp-kit/commit/514c1e50000434b682495d4d2c6bc66dee1c7a47))
+* **tests:** adicionar script 'open-cursor' ao package.json para abrir o workspace do projeto de teste após a configuração ([481d729](https://github.com/lgobatto/wp-kit/commit/481d7296063889aeef35d890b1dc7013d4a6d195))
+* **tests:** adicionar scripts de configuração e limpeza para testes automatizados ([a376538](https://github.com/lgobatto/wp-kit/commit/a376538a5b725e5433cc5530a6ca5e024b0827c1))
+* **vscode:** adicionar associações de arquivos para suporte a diferentes tipos de templates no settings.json ([f38a1db](https://github.com/lgobatto/wp-kit/commit/f38a1db61e75961b94ba1f3717de9f52baa4c19f))
+* **workspace:** adicionar configurações de busca e salvamento automático no template workspace.json.hbs ([fcbe381](https://github.com/lgobatto/wp-kit/commit/fcbe381a20f6a202f49b4069069dd29d64c1a2ac))
+* **workspace:** adicionar configurações de formatação para Blade, JavaScript, TypeScript, CSS e SCSS no template workspace.json.hbs ([62548c2](https://github.com/lgobatto/wp-kit/commit/62548c2fce183ef0d1717cc49f477dfb1fde202e))
+* **workspace:** adicionar configurações de GitLens no template de workspace ([1c7f39b](https://github.com/lgobatto/wp-kit/commit/1c7f39b4691758a66499b3f7115660ca7173585a))

package/README.md

@@ -0,0 +1,115 @@
+# @codigodoleo/wp-kit (CLI: leo-wp)
+
+Simplifique e padronize seus projetos WordPress em minutos. Este CLI cria um esqueleto moderno, opinativo e pronto para CI/CD, com integração a temas (Sage), qualidade de código e fluxos de deploy — tudo com escolhas inteligentes e mínima fricção.
+
+## Por que usar
+- Padronização entre projetos e equipes
+- Onboarding rápido (menos passos manuais, menos erros)
+- CI/CD dinâmico que se adapta às suas escolhas (GitLab, GitHub ou Bitbucket)
+- Convenções modernas (Conventional Commits, linters, hooks)
+
+## Requisitos
+- Node.js 18+ (recomendado 22+)
+- npm
+- Git
+- PHP 8.2+ e Composer (necessário para tema Sage e ferramentas PHP)
+
+## Quickstart (1 minuto)
+- Criar projeto interativo:
+```bash
+npx @codigodoleo/wp-kit init --output meu-projeto
+```
+- Projeto padrão (sem perguntas):
+```bash
+npx @codigodoleo/wp-kit init --output meu-projeto --defaults
+```
+- Instalação global (opcional):
+```bash
+npm install -g @codigodoleo/wp-kit
+leo-wp init --output meu-projeto
+```
+
+## O que é gerado
+- Estrutura WordPress com `content/` (temas, plugins, uploads)
+- Configurações úteis em `server/` e arquivos base (`.env`, `.editorconfig`, etc.)
+- Workspace do VSCode (opcional)
+- Pipelines de CI prontos, conforme o provedor escolhido:
+  - GitLab: `.gitlab-ci.yml`
+  - GitHub: `.github/workflows/ci.yml`
+  - Bitbucket: `bitbucket-pipelines.yml`
+- Convenções de Git e qualidade (husky, commitlint, lint-staged, ESLint, Prettier, Stylelint, Pint)
+- Integração opcional com tema Sage (v10/v11), com build automatizado
+
+## Como funciona (visão rápida)
+1. Você roda `init` e responde às perguntas (ou usa `--defaults`).
+2. O CLI infere capacidades (Composer, Node, Sage, Docker) e monta `context.ci`.
+3. O módulo `deploy` gera o pipeline certo para seu provedor (GitLab/GitHub/Bitbucket) com jobs somente do que faz sentido para o seu projeto.
+
+Exemplo: Se você ativar Sage 11, ajustamos versões automaticamente (PHP/Node/WP) e incluímos o job de build do tema no CI.
+
+## Fluxo recomendado
+1. Execute o comando (interativo):
+```bash
+npx @codigodoleo/wp-kit init --output meu-wp
+```
+2. Escolha o provedor de Git (ex.: GitLab ou GitHub) no prompt do módulo "git".
+3. Ative o módulo "deploy" (gera a pipeline automática).
+4. Se desejar, habilite o tema Sage (o build entra na pipeline automaticamente).
+5. Faça o primeiro commit e suba o repositório. O CI já estará pronto para rodar.
+
+## Comandos disponíveis
+- `init [options]` — Inicializa um novo projeto WordPress com DevOps
+- `--help` — Ajuda
+- `--version` — Versão
+
+### Opções do `init`
+- `--output <path>` — Diretório de saída do projeto
+- `--defaults` — Usa configurações padrão sem interação
+
+## Exemplos práticos
+- Interativo, escolhendo tudo pelo prompt:
+```bash
+npx @codigodoleo/wp-kit init --output site-corporativo
+```
+
+- Projeto padrão, sem prompts (padrões inteligentes):
+```bash
+npx @codigodoleo/wp-kit init --output blog-interno --defaults
+```
+
+## Estrutura essencial de pastas
+```
+meu-projeto/
+  content/
+    themes/
+    plugins/
+    uploads/
+  server/
+  .gitlab-ci.yml | .github/workflows/ci.yml | bitbucket-pipelines.yml
+  .env, .editorconfig, README.md, etc.
+```
+
+## CI Dinâmico (como decidimos o que rodar)
+Detectamos automaticamente:
+- `composer.json` (root/tema) → job de Composer
+- `package.json` (root/tema) → job de Node
+- Tema Sage ativo → job de build do tema
+- Deploy Docker escolhido → job de deploy Docker
+
+Provedores suportados:
+- GitLab CI, GitHub Actions, Bitbucket Pipelines
+
+## Convenções e qualidade
+- Commits: Conventional Commits (ex.: `feat:`, `fix:`, `docs:`)
+- Hooks: Husky + lint-staged
+- Linters: ESLint, Prettier, Stylelint, Pint
+
+## Dicas e solução de problemas
+- Pipeline não foi gerado? Verifique se habilitou o módulo `deploy` e qual provedor selecionou no módulo `git`.
+- Tema Sage não compilou? Garanta Composer/Node instalados e que o tema existe em `content/themes/<projectName>`.
+
+## Contribuição
+Pull Requests são muito bem-vindos! Use commits convencionais, escreva mudanças pequenas e inclua atualizações na documentação quando necessário.
+
+—
+Se quiser entender a fundo (arquitetura, módulos e CI dinâmico), veja a wiki em `docs/` deste repositório.

package/VSCODE_EXTENSIONS.md

@@ -0,0 +1,11 @@
+# 🔌 Recommended VSCode Extensions
+
+These extensions ensure consistency and formatting in this project:
+
+- [Prettier – Code formatter](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode)
+- [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint)
+- [EditorConfig for VS Code](https://marketplace.visualstudio.com/items?itemName=EditorConfig.EditorConfig)
+
+Optional:
+
+- [Stylelint](https://marketplace.visualstudio.com/items?itemName=stylelint.vscode-stylelint)

package/bin/index.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { runCli } from '../lib/cli.js';
+
+runCli();

package/docs/HOOKS-SYSTEM.md

@@ -0,0 +1,172 @@
+# Sistema de Hooks e Utilitários
+
+O wp-devops-setup inclui um sistema de hooks inspirado no WordPress e utilitários para cópia de arquivos e pastas.
+
+## Sistema de Hooks
+
+O sistema de hooks do wp-devops-setup é inspirado no sistema de hooks do WordPress e permite que módulos registrem callbacks para serem executados em momentos específicos durante o processo de setup.
+
+## Hooks Disponíveis
+
+### `after_setup_complete`
+Executado após todo o setup dos módulos ser concluído. Útil para operações que dependem de todos os arquivos terem sido criados.
+
+**Parâmetros:**
+- `context` - Contexto do projeto com todas as configurações
+- `generator` - Instância do Generator
+
+**Exemplo:**
+```javascript
+// No seu módulo (modules/seu-modulo/index.js)
+export async function setupModule(context, generator) {
+  // ... seu setup normal ...
+
+  // Registra um hook para executar após todo o setup
+  generator.hooks.addAction('after_setup_complete', async (context, generator) => {
+    // Seu código aqui será executado após todo o setup
+    console.log('Setup completo!');
+  }, 10); // Prioridade 10
+}
+```
+
+## Métodos do HookManager
+
+### addAction(hookName, callback, priority, acceptedArgs)
+Registra uma função para ser executada em um hook específico.
+
+**Parâmetros:**
+- `hookName` (string) - Nome do hook
+- `callback` (Function) - Função a ser executada
+- `priority` (number) - Prioridade (padrão: 10, menor número = maior prioridade)
+- `acceptedArgs` (number) - Número de argumentos aceitos pela função
+
+### addFilter(hookName, callback, priority, acceptedArgs)
+Registra uma função que retorna um valor (filtro).
+
+### doAction(hookName, ...args)
+Executa todos os callbacks registrados para um hook.
+
+### applyFilters(hookName, value, ...args)
+Executa um filtro e retorna o valor modificado.
+
+### removeAction(hookName, callback, priority)
+Remove um callback de um hook.
+
+### hasAction(hookName)
+Verifica se um hook tem callbacks registrados.
+
+## Prioridades
+
+As prioridades funcionam da seguinte forma:
+- **Menor número = Maior prioridade**
+- Prioridade padrão: 10
+- Hooks com prioridade menor são executados primeiro
+
+**Exemplos de prioridades:**
+- `1` - Muito alta prioridade (executa primeiro)
+- `5` - Alta prioridade
+- `10` - Prioridade padrão
+- `15` - Baixa prioridade
+- `20` - Muito baixa prioridade (executa por último)
+
+## Exemplos de Uso
+
+### Exemplo 1: Commit Git Inicial
+```javascript
+generator.hooks.addAction('after_setup_complete', async (context, generator) => {
+  // Faz commit inicial após todo o setup
+  execSync('git add .', { cwd: generator.cwd });
+  execSync('git commit -m "feat: initial setup"', { cwd: generator.cwd });
+}, 10);
+```
+
+### Exemplo 2: Instalação de Dependências
+```javascript
+generator.hooks.addAction('after_setup_complete', async (context, generator) => {
+  // Instala dependências após todo o setup
+  execSync('npm install', { cwd: generator.cwd });
+}, 5); // Alta prioridade
+```
+
+### Exemplo 3: Configuração Final
+```javascript
+generator.hooks.addAction('after_setup_complete', async (context, generator) => {
+  // Configurações finais que dependem de tudo estar pronto
+  console.log('Projeto configurado com sucesso!');
+}, 20); // Baixa prioridade - executa por último
+```
+
+### Exemplo 4: Usando Filtros
+```javascript
+// Registra um filtro
+generator.hooks.addFilter('project_name', (name) => {
+  return name.toUpperCase();
+}, 10);
+
+// Aplica o filtro
+const finalName = generator.hooks.applyFilters('project_name', 'meu-projeto');
+// Resultado: 'MEU-PROJETO'
+```
+
+## Boas Práticas
+
+1. **Use prioridades adequadas**: Hooks que dependem de outros devem ter prioridade menor
+2. **Trate erros**: Sempre use try/catch nos seus callbacks
+3. **Logs informativos**: Use o sistema de logs para informar o que está acontecendo
+4. **Verificações**: Sempre verifique se as condições necessárias estão atendidas antes de executar
+
+## Hooks Futuros
+
+Outros hooks que podem ser adicionados no futuro:
+- `before_setup_start` - Antes de qualquer setup
+- `after_module_setup` - Após cada módulo individual
+- `before_file_generation` - Antes de gerar arquivos
+- `after_file_generation` - Após gerar arquivos
+
+## Utilitários de Cópia
+
+### copyFile(sourcePathRelative, moduleName, outputName)
+Copia um arquivo individual.
+
+**Parâmetros:**
+- `sourcePathRelative` (string) - Caminho relativo do arquivo de origem
+- `moduleName` (string|null) - Nome do módulo (opcional)
+- `outputName` (string) - Nome do arquivo de destino (opcional)
+
+**Exemplo:**
+```javascript
+await generator.copyFile('.gitignore');
+await generator.copyFile('config.json', 'meu-modulo', 'custom-config.json');
+```
+
+### copyDirectory(sourcePathRelative, moduleName, outputName, overwrite)
+Copia uma pasta inteira com controle sobre sobrescrita.
+
+**Parâmetros:**
+- `sourcePathRelative` (string) - Caminho relativo da pasta de origem
+- `moduleName` (string|null) - Nome do módulo (opcional)
+- `outputName` (string) - Nome da pasta de destino (opcional)
+- `overwrite` (boolean) - Se deve sobrescrever arquivos existentes (padrão: true)
+
+**Comportamento:**
+- Se a pasta de destino não existe: copia toda a pasta
+- Se a pasta de destino existe e `overwrite = true`: mescla conteúdo (sobrescreve arquivos)
+- Se a pasta de destino existe e `overwrite = false`: pula a cópia
+
+**Exemplo:**
+```javascript
+// Copia pasta simples (sobrescreve por padrão)
+await generator.copyDirectory('assets', 'meu-modulo');
+
+// Copia pasta com nome personalizado
+await generator.copyDirectory('assets', 'meu-modulo', 'custom-assets');
+
+// Copia pasta sem sobrescrever
+await generator.copyDirectory('assets', 'meu-modulo', 'protected-assets', false);
+
+// Copia pasta de um módulo específico
+await generator.copyDirectory('assets', 'meu-modulo', 'module-assets');
+```
+
+**Recursividade:**
+A função copia recursivamente todas as subpastas e arquivos, mantendo a estrutura de diretórios.