novo-projeto · diff
git:20260723.a05ac1d to git:20260908.31d173b
81 added, 101 removed. Audit A to A.
---
name: novo-projeto
description: >
- Cria uma nova pasta de projeto com AGENTS.md personalizado (+ CLAUDE.md ponteiro). Entrevista o usuário
- sobre o projeto, gera a estrutura e referencia no AGENTS.md principal.
- Use quando o usuário chamar /novo-projeto, disser "novo cliente", "novo projeto",
- "criar pasta pro cliente X", "vou começar um projeto novo", ou quando precisar
- organizar um trabalho novo em pasta separada.
+ Cria a pasta de um projeto ou cliente com contexto próprio (AGENTS.md, contexto.md,
+ andamento.md) e registra no mapa de pastas da raiz. Ou liga uma pasta que já existe ao
+ sistema ("/novo-projeto link <pasta>"). Antes de criar, confere se vale pasta mesmo.
+ Use quando o usuário chamar /novo-projeto, disser "novo cliente", "novo projeto", "cria a
+ pasta do X", "vou começar um projeto", ou quiser organizar um trabalho novo em pasta separada.
---
- # /novo-projeto — Criar novo projeto com contexto
-
- Cria uma pasta de projeto com AGENTS.md dedicado (+ CLAUDE.md ponteiro), entrevistando o usuário sobre o que é o projeto.
-
- ## Quando usar
-
- - Novo cliente entrando
- - Novo site ou app pra desenvolver
- - Novo produto ou lançamento
- - Qualquer trabalho que merece pasta própria e contexto separado
-
- ## Fluxo
-
- ### Passo 1: Entender o projeto
-
- Perguntar em conversa natural (uma pergunta por vez):
-
- **Pergunta 1:** "Qual é o nome do projeto? (pode ser nome do cliente, do produto ou do site)"
-
- **Pergunta 2:** "Que tipo de projeto é?"
- - Cliente (entrega de serviço pra alguém)
- - Produto próprio (site, app, curso, loja)
- - Conteúdo (canal, série, newsletter)
- - Interno (processo, ferramenta, organização)
+ # /novo-projeto · pasta de projeto com contexto
- **Pergunta 3:** "Me explica em poucas palavras o que é o projeto e o que tu precisa entregar."
+ Toda pasta nasce **simples**: `AGENTS.md` curto + `CLAUDE.md` ponteiro + `contexto.md` +
+ `andamento.md` + o trabalho. Ninguém escolhe "nível" na criação. Quando a pasta precisar sair
+ daqui (cliente, sócio, parceiro), o `/compartilhar` completa ela pra viajar.
- **Pergunta 4:** "Tem prazo, orçamento ou ferramenta específica que eu precise saber?"
+ ## Passo 1 · vale uma pasta?
- Se o usuário der respostas completas logo na primeira, pular as perguntas já respondidas.
+ Antes de criar, três perguntas, respondidas por você a partir do que o usuário contou (só
+ perguntar o que não dá pra deduzir):
- ### Passo 2: Definir a pasta
+ 1. Vai ter mais de um arquivo?
+ 2. Vai durar mais que uma sessão?
+ 3. Alguém (você incluso, daqui a um mês) precisa achar isso sem lembrar onde está?
- Sugerir o local baseado no tipo de projeto e na estrutura atual:
+ Menos de dois "sim": não é pasta, é um arquivo dentro de uma pasta que já existe. Dizer isso e
+ propor o lugar: *"isso cabe num arquivo em `conteudo/`, não precisa de pasta. Quer que eu crie
+ só o arquivo?"*.
- - **Cliente** → `clientes/nome-do-cliente/`
- - **Produto** → `projetos/nome-do-projeto/`
- - **Conteúdo** → `conteudo/nome-do-projeto/`
- - **Interno** → `projetos/nome-do-projeto/`
+ ## Passo 2 · entender o projeto
- Verificar a estrutura de pastas que já existe (ler AGENTS.md principal) pra manter consistência.
+ Uma pergunta por vez, pulando o que já foi respondido:
- Apresentar a sugestão:
+ 1. "Qual é o nome do projeto? (cliente, produto ou site)"
+ 2. "Que tipo é?" cliente (entrega pra alguém) · produto próprio (site, app, curso, loja) ·
+ conteúdo (canal, série, newsletter) · interno (processo, ferramenta)
+ 3. "Me explica em poucas palavras o que é e o que precisa ser entregue."
+ 4. "Tem prazo, orçamento ou ferramenta específica?"
+ 5. "Esse projeto tem identidade visual ou tom de voz próprios, diferentes da sua marca?" (cliente
+ costuma ter; produto próprio costuma herdar)
- > "Sugiro criar em `clientes/nome-do-cliente/`. Faz sentido ou prefere outro lugar?"
+ ## Passo 3 · onde fica
- Aguardar confirmação.
+ Sugerir pelo tipo e pelo mapa de pastas do `AGENTS.md` da raiz (respeitar a estrutura que o
+ `/setup` criou): cliente → `clientes/<nome>/` · produto ou interno → `projetos/<nome>/` ·
+ conteúdo → `conteudo/<nome>/`. Nome em minúsculas, sem espaço nem acento.
- ### Passo 3: Criar a pasta e o AGENTS.md do projeto
+ > "Sugiro `clientes/acme/`. Faz sentido ou prefere outro lugar?"
- Pra funcionar no Claude Code e no Codex, cada projeto segue o mesmo padrão da raiz:
- o conteúdo vai num `AGENTS.md`, e um `CLAUDE.md` com uma linha só (`@AGENTS.md`) aponta pra ele.
+ ## Passo 4 · criar
- 1. Criar a pasta do projeto.
- 2. Gerar `<pasta>/AGENTS.md` com o conteúdo abaixo.
- 3. Gerar `<pasta>/CLAUDE.md` com exatamente uma linha: `@AGENTS.md`.
+ `mkdir -p` na pasta e quatro arquivos. Nada de subpasta que o usuário não pediu; nada nasce vazio.
- Conteúdo do `AGENTS.md`:
+ **`AGENTS.md`** (curto, cresce com o uso, menos de 30 linhas):
```markdown
- # [Nome do Projeto]
-
- ## O que é
- [descrição curta do projeto, 1-2 frases]
-
- ## Tipo
- [Cliente / Produto / Conteúdo / Interno]
-
- ## Escopo
- [o que precisa ser entregue, baseado nas respostas]
-
- ## Contexto
- [prazo, orçamento, ferramentas, qualquer detalhe relevante]
-
- ## Arquivos importantes
- - (será preenchido conforme o projeto avança)
+ # [Nome do projeto]
- ## Regras específicas
- - (será preenchido conforme o projeto avança)
- ```
+ Quem abre esta pasta de dentro do sistema: as regras da raiz continuam valendo. Os gatilhos
+ abaixo dizem o que ler antes de agir.
- Se for **cliente**, adicionar também:
+ ## O que é
+ [1-2 frases] · **Tipo:** [cliente / produto / conteúdo / interno]
- ```markdown
- ## Contato
- [nome do contato, se mencionou]
+ ## Antes de agir
+ - Pra saber do projeto: `contexto.md` (o que ele é, quem é quem, o que foi combinado) e
+ `andamento.md` (onde está, pendências).
+ - Antes de escrever texto ou peça que sai pra fora: a marca em `../../_contexto/marca/`
+ [ou, se tem própria: `marca/` desta pasta].
+ - Antes de salvar arquivo: a tabela de destinos em `../../AGENTS.md`. Trabalho deste projeto
+ fica aqui; fato sobre o negócio e decisão vão pros lugares da raiz (o `/atualizar` cuida).
+ - Habilidades desta pasta, se houver: `.claude/skills/<nome>/SKILL.md` (ler antes de usar quando
+ a sessão foi aberta na raiz).
- ## Entregas
- - [ ] [entrega 1]
- - [ ] [entrega 2]
+ ## Regras deste projeto
+ - (cresce com o uso)
```
- ### Passo 4: Atualizar o AGENTS.md principal
-
- Ler o AGENTS.md da raiz do workspace. Encontrar a seção de **estrutura de pastas** e adicionar a nova pasta.
+ `CLAUDE.md`: exatamente uma linha, `@AGENTS.md`.
- Exemplo:
+ **`contexto.md`**: escopo, o que precisa ser entregue, prazo/orçamento/ferramentas, contato (se
+ cliente), o que foi combinado. É onde material bruto (transcrição, PDF, email) é destilado depois.
- > Adicionei `clientes/fabio-haag/` na estrutura de pastas do AGENTS.md principal.
+ **`andamento.md`**:
- Se a seção de estrutura não existir ou não fizer sentido editar, pular e informar:
+ ```markdown
+ # Andamento · [nome]
- > "Criei a pasta e o AGENTS.md do projeto. Se quiser, adiciona na estrutura de pastas do AGENTS.md principal depois."
+ ## Onde está (AAAA-MM-DD)
+ Pasta criada. Próximo passo: [o primeiro passo que o usuário citou].
- ### Passo 5: Atualizar contexto (se aplicável)
+ ## Pendências
+ - [ ] [entrega 1]
- Se o projeto é um **cliente novo**, perguntar:
+ ## Feito
+ ```
- > "Quer que eu adicione esse cliente em `_contexto/empresa.md` também?"
+ Se tem marca própria (pergunta 5): criar `marca/design-guide.md` **dentro da pasta** (mesmo modelo do
+ guia de design da raiz, em branco; o mapa diz onde ele mora) e o gatilho do `AGENTS.md` aponta pra ela.
- Se sim, adicionar uma linha na seção de clientes do empresa.md.
+ ## Passo 5 · registrar na raiz
- ### Passo 6: Confirmar
+ Acrescentar uma linha no **mapa de pastas** (seção 9) do `AGENTS.md` da raiz, embaixo da pasta-mãe
+ ou no fim: ``- `clientes/acme/` · [uma frase do que é]``. Só isso: cliente novo em `empresa.md` e
+ a decisão de abrir o projeto são coisa do `/atualizar`, no fim da sessão.
- Mostrar o resumo:
+ ## Passo 6 · confirmar
- ```
- Projeto criado!
+ > "Criado: `clientes/acme/` com AGENTS.md, contexto.md e andamento.md, e a linha no mapa da raiz.
+ > Pra trabalhar nele, é só falar: eu leio a pasta quando tocar nela."
- Pasta: clientes/fabio-haag/
- AGENTS.md: clientes/fabio-haag/AGENTS.md (+ CLAUDE.md apontando pra ele)
- Referência: adicionado na estrutura de pastas do AGENTS.md principal
+ ## Modo link · pasta que já existe
- Pra trabalhar nesse projeto, é só falar. O agente já vai ler o contexto da pasta.
- ```
+ `/novo-projeto link <pasta>` (ou o usuário dizendo "essa pasta já existe, liga ela"): não criar
+ nada por cima. Ler o que tem, gerar só o que falta (`AGENTS.md`, `CLAUDE.md`, `contexto.md`,
+ `andamento.md`), preencher o `contexto.md` com o que dá pra deduzir dos arquivos, mostrar antes de
+ salvar, e registrar no mapa da raiz. Nunca mover nem renomear o que está dentro.
## Regras
- - Tom direto, sem cerimônia
- - Não criar subpastas dentro do projeto a menos que o usuário peça
- - O AGENTS.md do projeto deve ser curto (menos de 30 linhas no início). Vai crescer com o uso
- - Nunca mover pastas existentes sem perguntar
- - Se o usuário já criou a pasta manualmente, só gerar o AGENTS.md (+ CLAUDE.md ponteiro) dentro dela
- - Respeitar a estrutura de pastas que o `/setup` criou pra aquele perfil
+ - Tom direto, sem cerimônia.
+ - Nunca mover pasta existente sem perguntar.
+ - Não criar `.claude/skills/` vazia: a pasta de skills nasce com a primeira skill.
+ - Caminho de marca, scripts e modelos vem do mapa da raiz, não de memória.