agentleFS
wgalletiwgalleti/wSkills/skills/novo-projeto/SKILL.md

novo-projeto

Skill0 starsChanged 3 months agoMITView on GitHub

Use quando alguém quer tirar uma ideia do papel e criar um projeto do zero — a porta de entrada única que orquestra as demais skills (sdd, prototipo-api, frontend-kickstart, prototipo-portal, wpvc) na ordem certa, sem o usuário precisar conhecê-las. Conduz por fases: entender a ideia e documentar, subir dados/API, montar o frontend, trabalhar por ondas e preparar a conversão. Dispare em pedidos como 'quero criar um sistema', 'tenho uma ideia de projeto', 'novo projeto', 'começar um app do zero', 'me ajuda a montar um protótipo'.

7 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use atualizar, relatorio-ads and 5 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • dobralabsSkill

    atualizar

    Fecha a sessão guardando o que aconteceu no lugar certo: diário do dia, onde paramos, decisões e os arquivos de contexto, roteando pela tabela de destinos do AGENTS.md. Trabalha com o que está na conversa; não varre o sistema (isso é a /faxina). Use quando o usuário chamar /atualizar, disser "salva o que a gente fez", "fecha a sessão", "atualiza o contexto", "guarda isso", ou quando você ofereceu e ele aceitou. Não manda pro GitHub (isso é /syncar).

    Also in 3 projects that use this

  • eumateusalexSkill

    relatorio-ads

    Relatório semanal de anúncios (Google Ads e Meta Ads) a partir dos CSVs ou prints: KPIs, top criativos, alertas e recomendações. Use para \"relatório de ads\", \"como foram os ads\", \"performance da semana\" ou /relatorio-ads.

    Also in 3 projects that use this

  • eumateusalexSkill

    responder-avaliacoes

    Escreve respostas curtas e humanas para avaliações do Perfil da Empresa no Google (antigo Google Meu Negócio). Use para \"responder avaliação\", \"resposta para o Google\", \"tem uma avaliação nova\" ou review colado em texto ou print.

    Also in 3 projects that use this

  • lucasenatmSkill

    salvar

    Salva o estado atual do workspace no GitHub (commit + push). Use quando quiser garantir que o trabalho está seguro, ao final de uma sessão produtiva, ou quando o usuário disser "salva no github", "faz commit", "salva", "salvar", "backup no github", "salva tudo", "manda pro github". Também configura o git pela primeira vez se ainda não estiver configurado.

    Also in 3 projects that use this

  • JohnsonChenxSkill

    instalar

    Instala, verifica e repara o Video AI Toolkit conduzindo o usuário passo a passo. Use quando pedirem para "instalar o toolkit", "configurar o video-ai-toolkit", "conserta a instalação", "o crv/yt-dlp parou de funcionar", "faz o check-up da instalação" ou quando um comando da suíte falhar por dependência ausente/mal configurada. Orquestra os scripts install.ps1/install.sh e diagnostica/corrige as falhas conhecidas automaticamente.

    Also in 3 projects that use this

  • juancodedevSkill

    carrossel

    Cria carrosséis completos para Instagram e TikTok com a identidade visual do usuário. Inclui setup guiado na primeira vez (checagem de marca, tom de voz, Playwright). Gera texto editorial, HTMLs estilizados, renderiza em PNG via Playwright. Suporta imagens do usuário, geração por IA ou design visual sem foto. Use quando o usuário mencionar "carrossel", "carousel", "slides instagram", "slides tiktok", "faz um carrossel", ou pedir pra transformar um tema em carrossel.

    Also in 3 projects that use this

  • +1 more from eumateusalex

The file

Files
SKILL.md

Novo projeto — a porta de entrada

O usuário tem uma ideia e não precisa conhecer skill nenhuma: esta skill descobre em que fase o projeto está e conduz, uma fase por vez. As outras skills são a fonte de verdade de cada fase — esta não duplica nada delas.

Regras de condução

  • Uma fase por vez. Termine e valide com o usuário antes de abrir a próxima.
  • Economize tokens: carregue só a skill/referência da fase atual — nunca leia tudo de uma vez. A tabela abaixo diz o que abrir quando.
  • Seja assertivo: proponha o caminho e siga; não apresente menus de opções técnicas a quem não pediu. Decisão técnica é sua; decisão de negócio é do usuário.
  • Linguagem de negócio com o usuário, sempre — pt-BR, sem jargão.
  • Versionamento é opcional — pergunte na fase 1. Se o usuário quiser: git init e um commit por onda fechada (mensagem simples em pt-BR, ex.: Onda 1 — pedir e acompanhar reembolso). Nunca um commit por tarefa — é protótipo, o commit existe para poder voltar atrás, não para publicar. Não assuma GitHub nem sugira push a menos que o usuário peça. Se não quiser versionar, respeite e não insista.
  • Economize contexto: não leia node_modules, lockfiles ou arquivos gerados; leia só o trecho necessário de arquivos grandes; não cole logs extensos na conversa. Ao fechar uma onda, sugira encerrar a sessão — os docs carregam o contexto da próxima.
  • Skill de fase não instalada? Instale antes: npx @wgalleti/wskills add <skill> (ou --all).

Descobrir a fase

Olhe o diretório e enquadre — não pergunte o que dá para ver:

SituaçãoFase
Projeto existente sem docs/ do sdd0 — Organizar
Pasta vazia / só ideia na conversa1 — Ideia
docs/ do sdd existe, sem server/2 — Dados
server/db.json existe, sem frontend3 — Telas
Frontend + servidor rodando4 — Ondas
Usuário fala em "virar portal", "integrar"5 — Conversão

As fases

0. Projeto já em andamento → organizar

Projeto bagunçado, sem docs, sessões estourando contexto. Nesta ordem:

  1. Backup antes de tudo — confirme com o usuário que existe uma cópia (zip ou pasta duplicada; comandos no guia docs/novo-projeto.md do wSkills). Sem backup, não mexa.
  2. Diagnóstico sem mudar nada: leia a estrutura (não os arquivos inteiros — ignore node_modules, lockfiles, gerados) e devolva em linguagem de negócio: o que o projeto faz, o que está pela metade, o que não deu para entender.
  3. Limpeza combinada: liste o que parece lixo (cópias antigas, arquivos soltos, experimentos mortos) e só apague com aval do usuário.
  4. Docs retroativos pela skill sdd: gere os quatro arquivos a partir do que existe + entrevista curta só para o que o código não conta (problema, quem usa, rumo). O que já funciona vira tarefa concluída; o que está pela metade vira a onda atual. Rascunho → aprovação → gravar + linha no CLAUDE.md.
  5. Enquadre na fase certa da tabela e siga o fluxo normal — dali em diante o projeto é igual a um nascido no padrão.

1. Ideia → documentação — skill sdd

Invoque a skill sdd e siga o fluxo dela: plan mode, entrevista com perguntas simples de negócio (uma por vez), rascunho dos quatro arquivos de docs/, aprovação, gravação + linha no CLAUDE.md. Capriche nas seções "Dados:" do notes.md — elas alimentam a fase 2 — e em "Para quem" no context.md — vira permissão na conversão.

2. Dados e API — skill prototipo-api

Invoque prototipo-api: copie o servidor, gere o server/db.json a partir das seções "Dados:" do docs/notes.md, semeie 2–3 registros por entidade e rode. Mostre ao usuário um dado respondendo no navegador — é o primeiro "está vivo" do projeto.

3. Telas — skills frontend-kickstart + prototipo-portal (+ wpvc)

Bootstrap pela frontend-kickstart (o VITE_API_URL default já aponta para o servidor da fase 2). Visual e padrões de tela pela prototipo-portal (guias 01-identidade-visual e 02-padroes-frontend — o guia 03 de dados a fase 2 já cumpriu). Componentes e CRUD pela wpvc. Comece pela tela que resolve o problema do context.md, não pela mais fácil. Ao criar ou ajustar qualquer tela, siga o processo da skill ui-rica (direção de design, inventário de componentes, auto-revisão antes de entregar) — vale aqui e em toda a fase 4.

4. Trabalho por ondas — de volta ao sdd

Daqui em diante o ciclo é: pegar a próxima tarefa de docs/tasks.md, fazer, marcar, conferir validation.md; onda fechada desce para "Concluídas" e valida com o usuário antes de abrir a próxima. Detalhe novo → notes.md; mudança de rumo → context.md. Nunca trabalhe fora do tasks.md.

5. Conversão — prototipo-api/references/conversao.md

Quando o protótipo for virar portal (API Django/DRF, auth, permissões), o mapa é conversao.md da prototipo-api + os docs do sdd (context.md → papéis, validation.md → aceite). Essa fase normalmente é conduzida pelo time técnico — o papel aqui é garantir que a documentação chegou completa.

Guia para humanos

Existe um guia de uso detalhado, com exemplos de conversa fase a fase: docs/novo-projeto.md no repositório wSkills (linkado no README). Indique-o quando o usuário quiser entender o processo antes de começar.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.