CLI Made

CLI Made é uma ferramenta de linha de comando desenvolvida pela MadeInWeb para auxiliar no gerenciamento e configuração de projetos. A ferramenta oferece as seguintes funcionalidades:

• 🤖 Configuração de ambiente IA (Skills, Steering e Agents para o Kiro)
• 🔐 Autenticação integrada com o sistema MadeInWeb
• 📝 Geração automática de arquivos .env baseados na configuração do projeto
• 🔄 Gerenciamento de configurações de projeto via package.json
• 🛠️ Interface interativa via linha de comando

Tech Stacks

• Inquirer.js
• c12
• gray-matter

Requisitos

• Node.js na versão 22.14.0

🚀 Desenvolvendo

Instale as dependências

npm install

Builde o projeto

npm run build

📖 Guia de Uso

Instalação Global

Para utilizar o CLI Made em qualquer projeto, primeiro instale-o globalmente:

npm install -g cli-made-front

Executando o CLI

made-cli

Ao executar, o menu principal apresenta duas opções:

1. Montar ambiente IA — Configura o diretório .kiro com skills, steering e agents
2. Configurações de Projeto (envs, templates) — Gerador de ENV e outras configurações internas

🤖 Montar Ambiente IA

Essa funcionalidade instala assets de IA no diretório .kiro do seu projeto, permitindo que o Kiro (IDE com IA) utilize instruções especializadas durante o desenvolvimento.

Fluxo

1. Selecione a stack do projeto (Frontend, Backend, Android, iOS ou Flutter)
2. Escolha a categoria do asset (Skills, Steering ou Agents)
3. Selecione os itens disponíveis para instalação
4. Repita para outras categorias se desejar

O que é cada categoria?

Skills

Skills são documentos Markdown (.md) com instruções especializadas que ensinam a IA a trabalhar com tecnologias, padrões ou bibliotecas específicas. Cada skill possui um frontmatter YAML com metadados (name, description) e um corpo com regras, exemplos e anti-patterns.

O que acontece ao instalar:

• O CLI cria o diretório .kiro/skills/<nome-do-skill>/
• Copia o arquivo SKILL.md para dentro dessa pasta
• Valida que o frontmatter contém os campos obrigatórios (name e description)
• Valida que o campo name corresponde ao slug da pasta (kebab-case)

Estrutura gerada:

.kiro/
└── skills/
    ├── vue-made-ds/
    │   └── SKILL.md
    ├── vue-tanstack-query-cache/
    │   └── SKILL.md
    └── frontend-security-auth/
        └── SKILL.md

Quando a IA usa: Skills são ativados sob demanda quando o contexto da conversa corresponde ao domínio do skill (por palavras-chave ou referência explícita do usuário).

Steering

Steering são arquivos Markdown que fornecem instruções e padrões que a IA deve seguir durante toda a interação (ou condicionalmente, baseado em padrões de arquivo). Diferente de skills, steering files podem ser incluídos automaticamente em todas as conversas.

O que acontece ao instalar:

• O CLI cria o diretório .kiro/steering/ (se não existir)
• Copia o arquivo .md diretamente para essa pasta

Estrutura gerada:

.kiro/
└── steering/
    ├── vue3-frontend-technical-standards.md
    └── outro-padrao.md

Quando a IA usa: Por padrão, steering files são incluídos em todas as interações. Podem ser configurados como condicionais (ativados quando um arquivo com determinado padrão é lido) ou manuais (ativados via # no chat).

Agents

Agents são arquivos JSON que definem agentes customizados com instruções, ferramentas e comportamentos específicos para tarefas recorrentes (ex: revisão de código, geração de testes).

O que acontece ao instalar:

• O CLI cria o diretório .kiro/agents/ (se não existir)
• Valida que o arquivo contém JSON válido
• Copia o arquivo .json para a pasta

Estrutura gerada:

.kiro/
└── agents/
    └── frontend-reviewer.json

Quando a IA usa: Agents são invocados explicitamente pelo usuário ou por outros mecanismos de automação configurados no projeto.

Estrutura completa do .kiro após configuração

.kiro/
├── skills/
│   ├── vue-made-ds/
│   │   └── SKILL.md
│   └── vue-tanstack-query-cache/
│       └── SKILL.md
├── steering/
│   └── vue3-frontend-technical-standards.md
└── agents/
    └── frontend-reviewer.json

📝 Gerador de ENV

O CLI Made oferece uma forma simples e segura de gerar arquivos de ambiente (.env) para seus projetos.

Configuração

Adicione a chave do projeto no seu package.json:

{
  "name": "seu-projeto",
  "projectKey": "chave-do-seu-projeto"
}

Uso

1. Execute made-cli e selecione "Configurações de Projeto"
2. Na primeira execução, faça login com seu email e senha MadeInWeb
3. O token de acesso será armazenado automaticamente
4. O CLI valida suas credenciais, busca as configurações e gera o .env na raiz do projeto

✔️ Pre-Commit e Pre-Push Hooks

Este projeto utiliza hooks de pre-commit para garantir a qualidade e a consistência do código. Antes de cada commit, o código passa por formatação e verificação de lint.

npm run lintfix

🏗️ Estrutura do Projeto (assets de IA)

Os assets disponíveis para instalação ficam em src/ai-assets/ organizados por stack e categoria:

src/ai-assets/
├── Frontend/
│   ├── Skills/
│   │   ├── vue-made-ds/SKILL.md
│   │   ├── vue-tanstack-query-cache/SKILL.md
│   │   └── ...
│   ├── Steering/
│   │   └── vue3-frontend-technical-standards.md
│   └── Agents/
│       └── frontend-reviewer.json
├── Backend/
│   ├── Skills/
│   │   ├── nestjs-typeorm-backend-standards/SKILL.md
│   │   └── ...
│   ├── Steering/
│   └── Agents/
├── Android/
├── iOS/
└── Flutter/

Para adicionar novos assets, basta criar o arquivo na pasta correspondente seguindo a convenção:

• Skills: criar pasta com nome em kebab-case contendo SKILL.md com frontmatter válido
• Steering: criar arquivo .md diretamente na pasta Steering/
• Agents: criar arquivo .json válido na pasta Agents/

Idealizado por @RobertoC-fly 🚀🤖

API e revisão por @cpvasques 🎸🦇🤘