custom-agents-boilerplate 0.1.0__tar.gz

custom_agents_boilerplate-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Custom Agents Boilerplate Authors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

custom_agents_boilerplate-0.1.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include README.md
+include LICENSE
+include pyproject.toml
+recursive-include src/custom_agents_boilerplate/templates *

custom_agents_boilerplate-0.1.0/PKG-INFO

@@ -0,0 +1,207 @@
+Metadata-Version: 2.4
+Name: custom-agents-boilerplate
+Version: 0.1.0
+Summary: CLI para gerar Custom Agents (VS Code + GitHub Copilot Chat) em qualquer projeto.
+Author: Agent Boilerplate
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/EngelRyan/agent-boilerplate
+Project-URL: Repository, https://github.com/EngelRyan/agent-boilerplate
+Project-URL: Issues, https://github.com/EngelRyan/agent-boilerplate/issues
+Keywords: vscode,copilot,agents,prompt,cli
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Agent Boilerplate 🤖
+
+Ambiente de **Custom Agents** para o **VS Code + GitHub Copilot Chat**, com variações por:
+
+- **Role (papel)**: Dev 🧑‍💻 | QA 🧪 | PO 📋 | Estudante 🎓
+- **Nível (mentoria)**: Iniciante 🌱 | Intermediário 🚀 | Avançado ⚡
+
+Objetivo: para a mesma tarefa, obter respostas **coerentes e visivelmente diferentes** dependendo do papel e do nível.
+
+## Uso profissional (sem clonar repo)
+
+Você pode instalar um CLI e gerar os agentes **dentro de qualquer projeto**.
+
+### Instalar
+
+Recomendado (instala o comando globalmente, sem sujar o Python do sistema):
+
+```bash
+pipx install custom-agents-boilerplate
+```
+
+Alternativa (instala no ambiente atual):
+
+```bash
+pip install custom-agents-boilerplate
+```
+
+### Gerar no seu projeto
+
+Dentro da pasta do seu projeto, rode o wizard:
+
+```bash
+custom-agents
+```
+
+Ele cria `.github/agents/` (e opcionalmente `chatmodes/`). Depois abra o projeto no VS Code → Copilot Chat → dropdown de Agents.
+
+### Usar sem menu (CI / comando direto)
+
+```bash
+custom-agents generate --roles dev,qa --levels iniciante,avancado --output .
+```
+
+Listar opções:
+
+```bash
+custom-agents list
+```
+
+### Publicar no PyPI
+
+Guia completo (manual + GitHub Actions com Trusted Publishing): veja `PUBLISHING.md`.
+
+## O que você ganha com cada role
+
+- **Dev**: implementação, arquitetura, debugging, qualidade de código.
+- **QA**: plano de testes, casos de teste, estratégia de automação, risco e severidade.
+- **PO**: user stories, critérios de aceite, métricas de sucesso, priorização.
+- **Estudante**: explicação didática, exemplos progressivos, exercícios.
+
+## O que muda em cada nível
+
+- **Iniciante**: define termos, passo a passo curto, exemplo completo.
+- **Intermediário**: trade-offs, perguntas de contexto, snippets relevantes.
+- **Avançado**: direto, crítico, edge cases, implicações de longo prazo.
+
+## Onde ficam os agentes (importante)
+
+O formato atual do VS Code chama isso de **Custom Agents** e o VS Code detecta automaticamente os arquivos em:
+
+- `.github/agents/*.agent.md`
+
+Este repo também mantém uma pasta `chatmodes/` com arquivos `*.chatmode.md` por compatibilidade/legado.
+
+> Nota: neste projeto, os arquivos em `.github/agents/` e `chatmodes/` são **gerados**.
+> Quem clonar o repo deve gerar pela primeira vez (passo abaixo).
+
+## Como usar no VS Code (passo a passo)
+
+1. Abra a pasta `agent-boilerplate/` no VS Code.
+2. Abra o Copilot Chat.
+3. No dropdown de **Agents**, selecione um agente (por exemplo `dev-iniciante`).
+4. Faça sua solicitação normalmente.
+
+Se você não enxergar os agentes:
+
+- Garanta que o workspace está **Trusted**.
+- Abra a tela de customizações do chat (ícone de engrenagem) e confira a lista de agentes carregados.
+
+## Agentes disponíveis (12 combinações)
+
+- `dev-iniciante`, `dev-intermediario`, `dev-avancado`
+- `qa-iniciante`, `qa-intermediario`, `qa-avancado`
+- `po-iniciante`, `po-intermediario`, `po-avancado`
+- `estudante-iniciante`, `estudante-intermediario`, `estudante-avancado`
+
+## Estrutura do projeto
+
+```
+agent-boilerplate/
+├── .github/
+│   └── agents/               # 12 custom agents (formato atual)
+├── src/custom_agents_boilerplate/templates/
+│   ├── config/               # Fonte da verdade de roles e níveis
+│   ├── agents/               # Prompts por role (+ base)
+│   └── levels/               # Ajuste de comportamento por nível
+├── chatmodes/                # Arquivos legacy (*.chatmode.md)
+├── examples/                 # Exemplos para demo (entrada/saída)
+└── scripts/                  # validate + list + regenerate
+```
+
+## Validar a instalação
+
+Primeiro clone/primeira vez:
+
+```bash
+bash scripts/generate-agents.sh
+```
+
+Depois valide:
+
+```bash
+bash scripts/validate.sh
+```
+
+Se você quiser validar apenas as “fontes” (sem exigir arquivos gerados), use:
+
+```bash
+bash scripts/validate.sh --source-only
+```
+
+## Regenerar os agentes após mudanças
+
+Quando você editar qualquer arquivo em `src/custom_agents_boilerplate/templates/agents/` ou `src/custom_agents_boilerplate/templates/levels/`, regenere:
+
+```bash
+bash scripts/generate-agents.sh
+bash scripts/validate.sh
+```
+
+## Gerar um pacote custom (baixar só o que escolher)
+
+Se você quer distribuir/usar **apenas algumas combinações** (por exemplo, só `dev-iniciante` e `qa-avancado`), use o empacotador:
+
+### Opção 1 (recomendado): menu guiado
+
+Rode e siga o passo a passo:
+
+```bash
+python scripts/package_agents.py
+```
+
+Ele vai perguntar quais **roles**, quais **níveis**, a **pasta de saída**, se é para **recriar** ou **adicionar mais**, e se gera `.zip`.
+
+### Opção 2: comando direto (sem menu)
+
+1) (Opcional) veja as opções disponíveis:
+
+```bash
+python scripts/package_agents.py --list
+```
+
+2) Gere uma pasta (e opcionalmente um `.zip`) com **apenas os agentes escolhidos**:
+
+```bash
+python scripts/package_agents.py --roles dev,qa --levels iniciante,avancado --zip
+```
+
+Isso cria `dist/agent-boilerplate-package/` contendo somente:
+
+- `.github/agents/*.agent.md` (os selecionados)
+- `README.md` (instruções rápidas)
+
+3) Para “baixar mais” depois (adicionar mais agentes no mesmo pacote), rode novamente com `--add` apontando para a mesma saída:
+
+```bash
+python scripts/package_agents.py --output dist/agent-boilerplate-package --add --roles po --levels intermediario --zip
+```
+
+Observação: para o VS Code detectar, basta abrir a pasta do pacote no VS Code; ele carrega o que estiver em `.github/agents/`.
+
+## Como customizar / evoluir
+
+- Regras universais: `src/custom_agents_boilerplate/templates/agents/_base/base-prompt.md` e `src/custom_agents_boilerplate/templates/agents/_base/rules.md`
+- Especialização por role: `src/custom_agents_boilerplate/templates/agents/<role>/prompt.md` e `src/custom_agents_boilerplate/templates/agents/<role>/tasks.md`
+- Ajuste por nível: `src/custom_agents_boilerplate/templates/levels/<nivel>.md`
+
+## Créditos
+
+Projeto acadêmico para a disciplina de Inteligência Artificial.

custom_agents_boilerplate-0.1.0/README.md

@@ -0,0 +1,190 @@
+# Agent Boilerplate 🤖
+
+Ambiente de **Custom Agents** para o **VS Code + GitHub Copilot Chat**, com variações por:
+
+- **Role (papel)**: Dev 🧑‍💻 | QA 🧪 | PO 📋 | Estudante 🎓
+- **Nível (mentoria)**: Iniciante 🌱 | Intermediário 🚀 | Avançado ⚡
+
+Objetivo: para a mesma tarefa, obter respostas **coerentes e visivelmente diferentes** dependendo do papel e do nível.
+
+## Uso profissional (sem clonar repo)
+
+Você pode instalar um CLI e gerar os agentes **dentro de qualquer projeto**.
+
+### Instalar
+
+Recomendado (instala o comando globalmente, sem sujar o Python do sistema):
+
+```bash
+pipx install custom-agents-boilerplate
+```
+
+Alternativa (instala no ambiente atual):
+
+```bash
+pip install custom-agents-boilerplate
+```
+
+### Gerar no seu projeto
+
+Dentro da pasta do seu projeto, rode o wizard:
+
+```bash
+custom-agents
+```
+
+Ele cria `.github/agents/` (e opcionalmente `chatmodes/`). Depois abra o projeto no VS Code → Copilot Chat → dropdown de Agents.
+
+### Usar sem menu (CI / comando direto)
+
+```bash
+custom-agents generate --roles dev,qa --levels iniciante,avancado --output .
+```
+
+Listar opções:
+
+```bash
+custom-agents list
+```
+
+### Publicar no PyPI
+
+Guia completo (manual + GitHub Actions com Trusted Publishing): veja `PUBLISHING.md`.
+
+## O que você ganha com cada role
+
+- **Dev**: implementação, arquitetura, debugging, qualidade de código.
+- **QA**: plano de testes, casos de teste, estratégia de automação, risco e severidade.
+- **PO**: user stories, critérios de aceite, métricas de sucesso, priorização.
+- **Estudante**: explicação didática, exemplos progressivos, exercícios.
+
+## O que muda em cada nível
+
+- **Iniciante**: define termos, passo a passo curto, exemplo completo.
+- **Intermediário**: trade-offs, perguntas de contexto, snippets relevantes.
+- **Avançado**: direto, crítico, edge cases, implicações de longo prazo.
+
+## Onde ficam os agentes (importante)
+
+O formato atual do VS Code chama isso de **Custom Agents** e o VS Code detecta automaticamente os arquivos em:
+
+- `.github/agents/*.agent.md`
+
+Este repo também mantém uma pasta `chatmodes/` com arquivos `*.chatmode.md` por compatibilidade/legado.
+
+> Nota: neste projeto, os arquivos em `.github/agents/` e `chatmodes/` são **gerados**.
+> Quem clonar o repo deve gerar pela primeira vez (passo abaixo).
+
+## Como usar no VS Code (passo a passo)
+
+1. Abra a pasta `agent-boilerplate/` no VS Code.
+2. Abra o Copilot Chat.
+3. No dropdown de **Agents**, selecione um agente (por exemplo `dev-iniciante`).
+4. Faça sua solicitação normalmente.
+
+Se você não enxergar os agentes:
+
+- Garanta que o workspace está **Trusted**.
+- Abra a tela de customizações do chat (ícone de engrenagem) e confira a lista de agentes carregados.
+
+## Agentes disponíveis (12 combinações)
+
+- `dev-iniciante`, `dev-intermediario`, `dev-avancado`
+- `qa-iniciante`, `qa-intermediario`, `qa-avancado`
+- `po-iniciante`, `po-intermediario`, `po-avancado`
+- `estudante-iniciante`, `estudante-intermediario`, `estudante-avancado`
+
+## Estrutura do projeto
+
+```
+agent-boilerplate/
+├── .github/
+│   └── agents/               # 12 custom agents (formato atual)
+├── src/custom_agents_boilerplate/templates/
+│   ├── config/               # Fonte da verdade de roles e níveis
+│   ├── agents/               # Prompts por role (+ base)
+│   └── levels/               # Ajuste de comportamento por nível
+├── chatmodes/                # Arquivos legacy (*.chatmode.md)
+├── examples/                 # Exemplos para demo (entrada/saída)
+└── scripts/                  # validate + list + regenerate
+```
+
+## Validar a instalação
+
+Primeiro clone/primeira vez:
+
+```bash
+bash scripts/generate-agents.sh
+```
+
+Depois valide:
+
+```bash
+bash scripts/validate.sh
+```
+
+Se você quiser validar apenas as “fontes” (sem exigir arquivos gerados), use:
+
+```bash
+bash scripts/validate.sh --source-only
+```
+
+## Regenerar os agentes após mudanças
+
+Quando você editar qualquer arquivo em `src/custom_agents_boilerplate/templates/agents/` ou `src/custom_agents_boilerplate/templates/levels/`, regenere:
+
+```bash
+bash scripts/generate-agents.sh
+bash scripts/validate.sh
+```
+
+## Gerar um pacote custom (baixar só o que escolher)
+
+Se você quer distribuir/usar **apenas algumas combinações** (por exemplo, só `dev-iniciante` e `qa-avancado`), use o empacotador:
+
+### Opção 1 (recomendado): menu guiado
+
+Rode e siga o passo a passo:
+
+```bash
+python scripts/package_agents.py
+```
+
+Ele vai perguntar quais **roles**, quais **níveis**, a **pasta de saída**, se é para **recriar** ou **adicionar mais**, e se gera `.zip`.
+
+### Opção 2: comando direto (sem menu)
+
+1) (Opcional) veja as opções disponíveis:
+
+```bash
+python scripts/package_agents.py --list
+```
+
+2) Gere uma pasta (e opcionalmente um `.zip`) com **apenas os agentes escolhidos**:
+
+```bash
+python scripts/package_agents.py --roles dev,qa --levels iniciante,avancado --zip
+```
+
+Isso cria `dist/agent-boilerplate-package/` contendo somente:
+
+- `.github/agents/*.agent.md` (os selecionados)
+- `README.md` (instruções rápidas)
+
+3) Para “baixar mais” depois (adicionar mais agentes no mesmo pacote), rode novamente com `--add` apontando para a mesma saída:
+
+```bash
+python scripts/package_agents.py --output dist/agent-boilerplate-package --add --roles po --levels intermediario --zip
+```
+
+Observação: para o VS Code detectar, basta abrir a pasta do pacote no VS Code; ele carrega o que estiver em `.github/agents/`.
+
+## Como customizar / evoluir
+
+- Regras universais: `src/custom_agents_boilerplate/templates/agents/_base/base-prompt.md` e `src/custom_agents_boilerplate/templates/agents/_base/rules.md`
+- Especialização por role: `src/custom_agents_boilerplate/templates/agents/<role>/prompt.md` e `src/custom_agents_boilerplate/templates/agents/<role>/tasks.md`
+- Ajuste por nível: `src/custom_agents_boilerplate/templates/levels/<nivel>.md`
+
+## Créditos
+
+Projeto acadêmico para a disciplina de Inteligência Artificial.

custom_agents_boilerplate-0.1.0/pyproject.toml

@@ -0,0 +1,35 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "custom-agents-boilerplate"
+version = "0.1.0"
+description = "CLI para gerar Custom Agents (VS Code + GitHub Copilot Chat) em qualquer projeto."
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{name = "Agent Boilerplate"}]
+keywords = ["vscode", "copilot", "agents", "prompt", "cli"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Operating System :: OS Independent",
+]
+
+[project.urls]
+Homepage = "https://github.com/EngelRyan/agent-boilerplate"
+Repository = "https://github.com/EngelRyan/agent-boilerplate"
+Issues = "https://github.com/EngelRyan/agent-boilerplate/issues"
+
+[project.scripts]
+custom-agents = "custom_agents_boilerplate.cli:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+custom_agents_boilerplate = ["templates/**/*"]

custom_agents_boilerplate-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

custom_agents_boilerplate-0.1.0/src/custom_agents_boilerplate/__init__.py

@@ -0,0 +1,3 @@
+__all__ = ["__version__"]
+
+__version__ = "0.1.0"

custom_agents_boilerplate-0.1.0/src/custom_agents_boilerplate/cli.py

@@ -0,0 +1,212 @@
+from __future__ import annotations
+
+import argparse
+import sys
+from pathlib import Path
+
+from .generator import generate_agents, load_catalog_from_templates
+from .templates_loader import templates_root
+
+
+def _prompt_yes_no(question: str, *, default: bool) -> bool:
+    hint = "Y/n" if default else "y/N"
+    while True:
+        raw = input(f"{question} [{hint}]: ").strip().lower()
+        if not raw:
+            return default
+        if raw in {"y", "yes", "s", "sim"}:
+            return True
+        if raw in {"n", "no", "nao", "não"}:
+            return False
+        print("Entrada inválida. Responda com 'y' ou 'n'.")
+
+
+def _choose_multi(kind: str, options: list[str]) -> list[str]:
+    print(f"\nSelecione {kind}:")
+    for idx, opt in enumerate(options, start=1):
+        print(f"  {idx}) {opt}")
+    print("  all) todos")
+    print("  (Enter) todos")
+
+    while True:
+        raw = input("Digite números separados por vírgula (ex: 1,3) ou 'all':\n> ").strip().lower()
+        if not raw or raw in {"all", "*"}:
+            return list(options)
+
+        parts = [p.strip() for p in raw.split(",") if p.strip()]
+        try:
+            indexes = [int(p) for p in parts]
+        except ValueError:
+            print("Entrada inválida. Use números separados por vírgula, ou 'all'.")
+            continue
+
+        if any(i < 1 or i > len(options) for i in indexes):
+            print("Algum número está fora da lista. Tente novamente.")
+            continue
+
+        chosen = [options[i - 1] for i in indexes]
+        # keep deterministic order
+        return [o for o in options if o in set(chosen)]
+
+
+def _wizard_generate(template_root: Path) -> dict:
+    catalog = load_catalog_from_templates(template_root)
+    role_keys = sorted(catalog.roles.keys())
+    level_keys = sorted(catalog.levels.keys())
+
+    print("\n=== custom-agents — Gerar agentes do Copilot Chat ===")
+    print("Saída: vai criar .github/agents/ dentro do seu projeto.")
+
+    roles = _choose_multi("roles", role_keys)
+    levels = _choose_multi("níveis", level_keys)
+
+    default_output = str(Path.cwd())
+    output_raw = input(f"\nPasta do projeto (output) [{default_output}]: ").strip()
+    output = Path(output_raw or default_output).expanduser().resolve()
+
+    include_chatmodes = _prompt_yes_no("Gerar também chatmodes/ (legado)?", default=False)
+
+    agents_dir = output / ".github" / "agents"
+    chatmodes_dir = output / "chatmodes"
+
+    force = False
+    if agents_dir.exists() or (include_chatmodes and chatmodes_dir.exists()):
+        print("\nDetectei saída existente:")
+        if agents_dir.exists():
+            print(f"- {agents_dir}")
+        if include_chatmodes and chatmodes_dir.exists():
+            print(f"- {chatmodes_dir}")
+        force = _prompt_yes_no("Apagar e recriar esses diretórios?", default=False)
+        if not force:
+            print("Cancelado.")
+            raise SystemExit(1)
+
+    return {
+        "roles": roles,
+        "levels": levels,
+        "output": output,
+        "include_chatmodes": include_chatmodes,
+        "force": force,
+    }
+
+
+def _cmd_list(template_root: Path) -> int:
+    catalog = load_catalog_from_templates(template_root)
+
+    print("Roles disponíveis:")
+    for key in sorted(catalog.roles.keys()):
+        role = catalog.roles[key]
+        label = f"{role.emoji} {role.label}".strip()
+        print(f"- {key} ({label})")
+
+    print("\nNíveis disponíveis:")
+    for key in sorted(catalog.levels.keys()):
+        level = catalog.levels[key]
+        label = f"{level.emoji} {level.label}".strip()
+        print(f"- {key} ({label})")
+
+    return 0
+
+
+def _csv(value: str | None) -> list[str] | None:
+    if value is None:
+        return None
+    value = value.strip()
+    if not value:
+        return None
+    if value.lower() in {"all", "*"}:
+        return ["*"]
+    return [p.strip() for p in value.split(",") if p.strip()]
+
+
+def _normalize(selected: list[str] | None, options: list[str]) -> list[str]:
+    if not selected or selected == ["*"]:
+        return options
+    invalid = [x for x in selected if x not in options]
+    if invalid:
+        raise SystemExit(f"ERRO: inválido(s): {', '.join(invalid)}")
+    return selected
+
+
+def _cmd_generate(template_root: Path, args: argparse.Namespace) -> int:
+    catalog = load_catalog_from_templates(template_root)
+    role_keys = sorted(catalog.roles.keys())
+    level_keys = sorted(catalog.levels.keys())
+
+    roles = _normalize(_csv(args.roles), role_keys)
+    levels = _normalize(_csv(args.levels), level_keys)
+
+    output = Path(args.output).expanduser().resolve()
+
+    generate_agents(
+        template_root=template_root,
+        output_root=output,
+        roles=roles,
+        levels=levels,
+        include_chatmodes=bool(args.chatmodes),
+        force=bool(args.force),
+    )
+
+    print(f"OK: gerado em {output / '.github' / 'agents'}")
+    if args.chatmodes:
+        print(f"OK: gerado em {output / 'chatmodes'}")
+
+    return 0
+
+
+def main(argv: list[str] | None = None) -> int:
+    argv = list(sys.argv[1:] if argv is None else argv)
+
+    parser = argparse.ArgumentParser(prog="custom-agents")
+    sub = parser.add_subparsers(dest="cmd")
+
+    sub.add_parser("list", help="Lista roles e níveis disponíveis")
+
+    p_gen = sub.add_parser("generate", help="Gera .github/agents (e opcionalmente chatmodes)")
+    p_gen.add_argument("--roles", help="CSV (ex: dev,qa) ou all", default=None)
+    p_gen.add_argument("--levels", help="CSV (ex: iniciante,avancado) ou all", default=None)
+    p_gen.add_argument("--output", help="Pasta do projeto (default: .)", default=str(Path.cwd()))
+    p_gen.add_argument("--chatmodes", action="store_true", help="Também gera chatmodes/ (legado)")
+    p_gen.add_argument("--force", action="store_true", help="Apaga e recria diretórios de saída")
+
+    # default: wizard generate
+    args = parser.parse_args(argv)
+
+    with templates_root() as template_root:
+        if args.cmd == "list":
+            return _cmd_list(template_root)
+
+        if args.cmd == "generate":
+            return _cmd_generate(template_root, args)
+
+        # no subcommand -> wizard
+        if not sys.stdin.isatty():
+            # non-interactive default
+            return _cmd_generate(
+                template_root,
+                argparse.Namespace(
+                    roles="all",
+                    levels="all",
+                    output=str(Path.cwd()),
+                    chatmodes=False,
+                    force=False,
+                ),
+            )
+
+        wiz = _wizard_generate(template_root)
+        generate_agents(
+            template_root=template_root,
+            output_root=wiz["output"],
+            roles=wiz["roles"],
+            levels=wiz["levels"],
+            include_chatmodes=wiz["include_chatmodes"],
+            force=wiz["force"],
+        )
+
+        print("\nOK: agentes gerados com sucesso.")
+        print("Abra o projeto no VS Code → Copilot Chat → Agents.")
+        return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())