invos 1.0.0 → 2.0.2

package/kit/.agents/skills/frontend-design/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: frontend-design
+description: Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.
+license: Complete terms in LICENSE.txt
+---
+
+# Frontend Design
+
+Approach this as the design lead at a small studio known for giving every client a visual identity that could not be mistaken for anyone else's. This client has already rejected proposals that felt templated, and is paying for a distinctive point of view: make deliberate, opinionated choices about palette, typography, and layout that are specific to this brief, and take one real aesthetic risk you can justify.
+
+## Ground it in the subject
+
+If the brief does not pin down what the product or subject is, pin it yourself before designing: name one concrete subject, its audience, and the page's single job, and state your choice. If there's any information in your memory about the human's preferences, context about what they're building, or designs you've made before – use that as a hint. The subject's own world, its materials, instruments, artifacts, and vernacular, is where distinctive choices come from. Build with the brief's real content and subject matter throughout.
+
+## Design principles
+
+For web designs, the hero is a thesis. Open with the most characteristic thing in the subject's world, in whatever form makes sense for it: a headline, an image, an animation, a live demo, an interactive moment. Be deliberate with your choice: a big number with a small label, supporting stats, and a gradient accent is the template answer, only use if that's truly the best option.
+
+Typography carries the personality of the page. Pair the display and body faces deliberately, not the same families you would reach for on any other project, and set a clear type scale with intentional weights, widths, and spacing. Make the type treatment itself a memorable part of the design, not a neutral delivery vehicle for the content.
+
+Structure is information. Structural devices, numbering, eyebrows, dividers, labels, should encode something true about the content, not decorate it. Many generic designs use numbered markers (01 / 02 / 03), but that's only appropriate if the content actually is a sequence - like a real process or a typed timeline where order carries information the reader needs. Question if choices like numbered markers actually make sense before incorporating them.
+
+Leverage motion deliberately. Think about where and if animation can serve the subject: a page-load sequence, a scroll-triggered reveal, hover micro-interactions, ambient atmosphere. An orchestrated moment usually lands harder than scattered effects; choose what the direction calls for. However, sometimes less is more, and extra animation contributes to the feeling that the design is AI-generated.
+
+Match complexity to the vision. Maximalist directions need elaborate execution; minimal directions need precision in spacing, type, and detail. Elegance is executing the chosen vision well.
+
+Consider written content carefully. Often a design brief may not contain real content, and it's up to you to come up with copy. Copy can make a design feel as templated as the design itself. See the below section on writing for more guidance.
+
+## Process: brainstorm, explore, plan, critique, build, critique again
+
+For calibration: AI-generated design right now clusters around three looks: (1) a warm cream background (near #F4F1EA) with a high-contrast serif display and a terracotta accent; (2) a near-black background with a single bright acid-green or vermilion accent; (3) a broadsheet-style layout with hairline rules, zero border-radius, and dense newspaper-like columns. All three are legitimate for some briefs, but they are defaults rather than choices, and they appear regardless of subject. Where the brief pins down a visual direction, follow it exactly — the brief's own words always win, including when it asks for one of these looks. Where it leaves an axis free, don't spend that freedom on one of these defaults. Just like a human designer who's hired, there's often a careful balance between doing what you're good at and taking each project as a chance to experiment and learn.
+
+Work in two passes. First, brainstorm a short design plan based on the human's design brief: create a compact token system with color, type, layout, and signature. Color: describe the palette as 4–6 named hex values. Type: the typefaces for 2+ roles (a characterful display face that's used with restraint, a complementary body face, and a utility face for captions or data if needed). Layout: a layout concept, using one-sentence prose descriptions and ASCII wireframes to ideate and compare. Signature: the single unique element this page will be remembered by that embodies the brief in an appropriate way.
+
+Then review that plan against the brief before building: if any part of it reads like the generic default you would produce for any similar page (work through a similar prompt to see if you arrive somewhere similar) rather than a choice made for this specific brief — revise that part, say what you changed and why. Only after you've confirmed the relative uniqueness of your design plan should you start to write the code, following the revised plan exactly and deriving every color and type decision from it.
+
+When writing the code, be careful of structuring your CSS selector specificities. It's easy to generate CSS classes that cancel each other out (especially with a type-based selector like .section and a element-based selector like .cta). This can happen often with paddings/margins between sections.
+
+Try to do a lot of this planning and iteration in your thinking, and only show ideas to the user when you have higher confidence it'll delight them.
+
+## Restraint and self-critique
+
+Spend your boldness in one place. Let the signature element be the one memorable thing, keep everything around it quiet and disciplined, and cut any decoration that does not serve the brief. Not taking a risk can be a risk itself! Build to a quality floor without announcing it: responsive down to mobile, visible keyboard focus, reduced motion respected. Critique your own work as you build, taking screenshots if your environment supports it – a picture is worth 1000 tokens. Consider Chanel's advice: before leaving the house, take a look in the mirror and remove one accessory. Human creators have memory and always try to do something new, so if you have a space to quickly jot down notes about what you've tried, it can help you in future passes.
+
+## More on writing in design
+
+Words appear in a design for one reason: to make it easier to understand, and therefore easier to use. They are design material, not decoration. Bring the same intentionality to copy that you would bring to spacing and color. Before writing anything, ask what the design needs to say, and how it can best be said to help the person navigate the experience.
+
+Write from the end user's side of the screen. Name things by what people control and recognize, never by how the system is built. A person manages notifications, not webhook config. Describe what something does in plain terms rather than selling it. Being specific is always better than being clever.
+
+Use active voice as default. A control should say exactly what happens when it's used: "Save changes," not "Submit." An action keeps the same name through the whole flow, so the button that says "Publish" produces a toast that says "Published." The vocabulary of an interface is the signposting for someone navigating the product. Cohesion and consistency are how people learn their way around.
+
+Treat failure and emptiness as moments for direction, not mood. Explain what went wrong and how to fix it, in the interface's voice rather than a person's. Errors don't apologize, and they are never vague about what happened. An empty screen is an invitation to act.
+
+Keep the register conversational and tuned: plain verbs, sentence case, no filler, with tone matched to the brand and the audience. Let each element do exactly one job. A label labels, an example demonstrates, and nothing quietly does double duty.

package/kit/.agents/skills/instalar/SKILL.md

@@ -0,0 +1,170 @@
+---
+name: instalar
+description: >
+  Instala o INVOS no negócio do usuário. Entrevista sobre empresa, tom de voz,
+  foco atual e identidade visual, e preenche `_memoria/empresa.md`, `_memoria/preferencias.md`,
+  `_memoria/estrategia.md`, `marca/design-guide.md` e anexa o perfil no final do `AGENTS.md`.
+  Use quando o usuário acabou de clonar o repositório e quer instalar o sistema, ou quando
+  pedir explicitamente "rodar /instalar", "instalar o INVOS", "primeiro setup".
+---
+
+# /instalar — Instalação inicial do INVOS
+
+Esse é o primeiro comando que o usuário roda depois de clonar o repositório. Não pode falhar e não pode soar burocrático. Trata como conversa de descoberta — pergunta uma coisa por vez, escuta de verdade, não enfileira tudo. O objetivo é o sistema sair daqui sabendo quem é a empresa, como ela fala, e onde tá o atrito do dia a dia.
+
+## Pré-checagem
+
+### 1. Nome da pasta
+
+Conferir o nome da pasta atual (`basename "$(pwd)"`). Se for `invos`, `INVOS`, `invos-main`, `INVOS-main`, `MazyOS-main` ou variação genérica do kit:
+
+> "Notei que a pasta atual ainda tem nome genérico ('<nome-atual>'). O ideal é a pasta ter o nome do seu negócio, não 'invos'. Quando terminarmos o setup, te lembro de renomear (é rápido — fechar VS Code, renomear a pasta no Finder/Explorer, abrir de novo). Seguimos?"
+
+Registrar mentalmente o nome atual pra usar na Fase 5.
+
+### 2. Arquivos de contexto
+
+Conferir se algum arquivo de memória já está preenchido (não é placeholder):
+- `_memoria/empresa.md`
+- `_memoria/preferencias.md`
+- `_memoria/estrategia.md`
+- `marca/design-guide.md`
+
+Se algum já tiver conteúdo real, perguntar:
+> "Já tem algum contexto preenchido aqui. Quer que eu sobrescreva (recomeçar do zero) ou complemente o que falta?"
+
+Se for setup limpo, seguir direto.
+
+---
+
+## Fase 1 — Escolha do perfil
+
+Perguntar qual perfil mais combina com o negócio:
+
+1. **Solopreneur / criador solo** — uma pessoa só, mistura de marca pessoal e negócio
+2. **Freelancer** — atende clientes, organiza por projeto/cliente
+3. **Agência / consultoria** — equipe pequena entregando pra vários clientes
+4. **Empresa** — empresa estabelecida com setores (marketing, comercial, financeiro, etc.)
+
+A resposta determina qual template de perfil colar no final do `AGENTS.md` (ver `templates/perfis/agents-*.md`).
+
+---
+
+## Fase 2 — Entrevista
+
+Fazer essas perguntas em ordem, esperando a resposta de cada uma antes de seguir. Se vier resposta vaga, repetir uma vez pedindo concretude. Não insistir mais que isso — registrar o que vier.
+
+**Sobre o negócio:**
+1. "Como você chama o que você faz? (nome da empresa, ou seu nome se for marca pessoal)"
+2. "O que sua empresa entrega, em uma frase do jeito que você falaria pro vizinho?"
+3. "Quem te paga? (perfil de cliente real — descreve em uma ou duas frases, sem persona genérica)"
+4. "Você toca sozinho ou tem equipe? Se tem, quantos e cada um fazendo o quê?"
+
+**Sobre voz:**
+5. "Me cola um exemplo da tua escrita — uma legenda do Insta, um email pra cliente, qualquer coisa real e recente. Assim eu calibro o jeito de escrever sem precisar adivinhar."
+6. "O que te dá ranço quando alguém escreve assim? (ex: 'vamos juntos!', emoji em email formal, 'caro cliente', jargão de guru, 'alavancar', 'sinergia')"
+
+**Sobre foco:**
+7. "Qual o gargalo do teu negócio hoje? O que tá segurando ele de crescer?"
+8. "Se eu pudesse tirar UMA coisa que você repete toda semana das tuas costas, qual seria?"
+
+**Sobre identidade visual:**
+9. "Tem identidade visual definida ou tá no zero? Se tem, me passa as cores principais e a fonte."
+10. "Tem logo? Se sim, joga o arquivo em `marca/logo.png` (ou `.svg`) e me confirma."
+
+---
+
+## Fase 3 — Preenchimento dos arquivos
+
+### `_memoria/empresa.md`
+Preencher com base nas perguntas 1-4. Manter formato simples — nome, o que faz, perfil de cliente, equipe.
+
+### `_memoria/preferencias.md`
+Preencher com base nas perguntas 5-6. Estrutura:
+- **Tom de voz:** derivar do exemplo de escrita real da pergunta 5 (descrever em 2-3 frases o jeito de escrever, com referência ao exemplo)
+- **O que evitar:** lista direta da resposta 6
+- **Estilo geral:** síntese do que combina e o que destoa
+
+### `_memoria/estrategia.md`
+Preencher com base nas perguntas 7-8. Estrutura:
+- **Gargalo atual:** [resposta da 7]
+- **Pra tirar das costas:** [resposta da 8] — registrar como candidata a virar skill via `/mapear-rotinas`
+- **Próximas prioridades:** derivar do gargalo (o que ataca o gargalo direto)
+
+### `marca/design-guide.md`
+Se o usuário forneceu cores/fontes/logo (perguntas 9-10), preencher os campos correspondentes. Se não, deixar como está e avisar:
+> "Deixei o `marca/design-guide.md` em branco. Sempre que você definir uma identidade visual, edita lá — as skills de carrossel, proposta e slide leem esse arquivo antes de criar qualquer visual."
+
+### `AGENTS.md` + `CLAUDE.md`
+1. Garantir que a raiz tem `CLAUDE.md` com **apenas** uma linha: `@AGENTS.md` (ponteiro pro harness Claude Code). Não colocar regras de negócio no `CLAUDE.md`.
+2. Pegar o template do perfil (`templates/perfis/agents-<perfil>.md` — solopreneur | freelancer | agencia | empresa).
+3. Adaptar com o nome do negócio e pastas das respostas.
+4. **Anexar** o conteúdo adaptado na seção `## Perfil do negócio` no final do `AGENTS.md` da raiz. **Não** apagar o boot multi-harness acima dessa seção.
+
+---
+
+## Fase 4 — Resumo
+
+Mostrar pro usuário o que foi configurado:
+
+```
+✓ Perfil aplicado: [perfil]
+✓ Contexto do negócio: _memoria/empresa.md
+✓ Tom de voz: _memoria/preferencias.md
+✓ Foco atual: _memoria/estrategia.md
+✓ Marca: marca/design-guide.md  [preenchida | em branco — preencher depois]
+✓ AGENTS.md com perfil [perfil] · CLAUDE.md = @AGENTS.md
+```
+
+---
+
+## Fase 5 — Renomear pasta (se necessário)
+
+Se a pasta atual ainda tem nome genérico (detectado na Pré-checagem), gerar slug do nome da empresa (resposta da pergunta 1):
+- minúsculas
+- sem acentos
+- espaços viram hífen
+- caracteres especiais removidos
+
+Ex: "Acme Empresa Ltda" → `acme-empresa-ltda`
+
+Mostrar:
+
+> "Última coisa: a pasta ainda tá com nome genérico ('<nome-atual>').
+> Pra ter cara do seu negócio, recomendo renomear pra '<slug>'.
+>
+> Como fazer:
+> 1. Fecha o VS Code
+> 2. Renomeia a pasta no Finder (Mac) ou Explorer (Windows) — ou no
+>    terminal fora dela: `mv <nome-atual> <slug>`
+> 3. Abre o VS Code de novo na pasta renomeada
+>
+> Se preferir outro nome, me fala que eu ajusto a sugestão."
+
+Se a pasta já tem nome próprio (não genérico), pular essa fase.
+
+---
+
+## Fase 6 — Próximos passos
+
+> "Pronto. O INVOS já te conhece.
+>
+> No começo de cada sessão de trabalho, roda `/abrir` — eu carrego tudo
+> que combinamos aqui antes da primeira frase. Quando quiser fazer um
+> carrossel, plano de SEO, campanha ou qualquer outra coisa, é só
+> chamar a skill que cabe.
+>
+> Você mencionou que repete '<resposta da pergunta 8>' toda semana.
+> Quando quiser tirar isso das costas de vez, roda `/mapear-rotinas`
+> que eu transformo em skill própria."
+
+Se o usuário quiser publicar o trabalho no GitHub, mencionar `/salvar`.
+
+---
+
+## Regras
+
+- Não inventar dados — se a resposta for vaga, registrar do jeito que veio (ou deixar placeholder claro)
+- Não escrever "este arquivo será preenchido pelo /instalar" nos arquivos finais — esse aviso só existe nos placeholders, sai depois do /instalar
+- O setup deve durar 5-7 minutos no máximo. Se o usuário estiver enrolando numa pergunta, registra o que tem e segue
+- Não fazer perguntas extras além das listadas acima sem motivo claro

package/kit/.agents/skills/mapear-rotinas/SKILL.md

@@ -0,0 +1,75 @@
+---
+name: mapear-rotinas
+description: >
+  Mapeia tarefas repetitivas que o usuário faz no dia a dia e gera skills personalizadas pra
+  automatizá-las. Faz uma entrevista curta sobre o que o usuário repete toda semana, propõe
+  skills concretas e cria as aprovadas em `.agents/skills/` (+ symlink em `.claude/skills/`). Use quando o usuário pedir
+  "/mapear-rotinas", "criar skills personalizadas", "automatizar minhas tarefas" ou "o que dá pra automatizar".
+---
+
+# /mapear-rotinas — Mapeamento de tarefas repetitivas em skills
+
+Skill de descoberta + criação. O objetivo é transformar o que o usuário repete em automações ativas.
+
+## Workflow
+
+### Passo 1 — Entrevista de descoberta
+
+Fazer 3 perguntas, uma por vez:
+
+1. "Quais 3 tarefas você repete toda semana e gostaria de não ter que pensar mais? (ex: 'criar carrossel', 'mandar relatório pro cliente', 'fazer briefing')"
+2. "Pra cada uma delas, qual o input típico? (ex: 'um link de notícia', 'um arquivo de planilha', 'um nome de cliente')"
+3. "E o que você espera de output? (ex: '5 slides em PNG', 'um email pronto pra enviar', 'um PDF resumindo')"
+
+### Passo 2 — Conferir catálogo
+
+Listar `.agents/skills/` (canônico). Se já existir skill que cobre a tarefa, sugerir ela em vez de criar outra:
+
+> "A tarefa X já é resolvida pela skill `/<nome>` que vem nativa. Quer ativar ela em vez de criar uma nova?"
+
+### Passo 3 — Proposta de skills
+
+Pra cada tarefa que NÃO tem cobertura existente, propor uma skill no formato:
+
+```
+### /<nome-da-skill>
+**O que faz:** [uma frase]
+**Input:** [o que recebe]
+**Output:** [o que entrega]
+**Dependências:** [arquivos em `_memoria/`, `marca/`, ou ferramentas externas]
+```
+
+Mostrar todas as propostas juntas e perguntar:
+> "Quais skills dessa lista você quer que eu crie agora? (pode escolher todas, algumas, ou nenhuma — também pode pedir ajustes)"
+
+### Passo 4 — Criação das skills aprovadas
+
+Pra cada skill aprovada:
+
+1. Criar pasta `.agents/skills/<nome>/` e symlink `ln -s ../../.agents/skills/<nome> .claude/skills/<nome>`
+2. Criar `SKILL.md` com:
+   - Frontmatter: `name`, `description` (descreve quando deve ser invocada)
+   - Workflow estruturado em fases ou passos
+   - Lista de dependências (arquivos de contexto, ferramentas externas)
+   - Regras claras (o que sempre fazer, o que nunca fazer)
+3. Se a skill precisar de templates ou exemplos, criar dentro da pasta da skill
+4. Calibrar o tom e regras conforme `_memoria/preferencias.md` e `_memoria/empresa.md`
+
+### Passo 5 — Resumo
+
+```
+Criei [N] skills:
+✓ /<nome1> — em .agents/skills/<nome1>/SKILL.md (+ symlink .claude)
+✓ /<nome2> — em .agents/skills/<nome2>/SKILL.md (+ symlink .claude)
+...
+
+Pra usar: digita / e o nome da skill em qualquer sessão.
+Pra ajustar uma skill depois: edita o SKILL.md correspondente.
+```
+
+## Regras
+
+- Não criar skill pra tarefa que aconteceu uma vez só. Tem que ser repetível
+- Não criar mais de 5 skills por sessão de mapeamento (se o usuário pedir mais, dividir em rodadas)
+- Cada skill criada precisa ter um trigger claro (`description` precisa indicar quando invocar) — sem isso a skill nunca é encontrada
+- Se a skill depender de uma ferramenta que o usuário não tem (ex: API do Notion sem MCP configurado), avisar antes de criar e oferecer a versão simplificada

package/kit/.agents/skills/notion/SKILL.md

@@ -0,0 +1,134 @@
+---
+name: notion
+description: "Notion CLI/API for pages, Markdown content, data sources, files, comments, search, Workers, and raw API calls."
+homepage: https://developers.notion.com/cli/get-started/overview
+---
+
+# Notion
+
+**Opcional no INVOS.** Só use se o user já opera no Notion e pediu integração.  
+SOT do negócio continua `_memoria/` + pastas do repo — Notion não substitui isso.
+
+Prefer official `ntn` CLI. Use curl only when `ntn` is unavailable or a raw request is clearer.
+
+## Setup
+
+```bash
+curl -fsSL https://ntn.dev | bash
+ntn --version
+ntn login
+```
+
+Script/headless auth:
+
+```bash
+export NOTION_API_TOKEN=secret_or_ntn_token
+export NOTION_API_VERSION=2026-03-11
+```
+
+`ntn api` sets `Authorization` and `Notion-Version` automatically. It uses CLI login by default, or `NOTION_API_TOKEN` when set.
+
+## Inspect
+
+```bash
+ntn doctor
+ntn api ls
+ntn api ls --json
+ntn api v1/comments --help
+ntn api v1/comments --spec -X POST
+ntn api v1/comments --docs -X POST
+```
+
+## Pages
+
+Markdown-first helpers:
+
+```bash
+ntn pages get <page-id>
+ntn pages get <page-id> --json
+ntn pages create --parent page:<page-id> --content '# Title\n\nBody'
+ntn pages create --parent data-source:<data-source-id> < page.md
+ntn pages edit <page-id> --content '# Updated'
+ntn pages edit <page-id> < page.md
+ntn pages trash <page-id> --yes
+```
+
+Notes:
+
+- `pages get` prints Markdown with page properties as frontmatter.
+- Content input: `--content`, stdin, or editor in a TTY.
+- Parent refs: `page:<id>`, `database:<id>`, `data-source:<id>`.
+- For properties/templates/full Pages API, use `ntn api v1/pages`.
+
+## Data sources
+
+```bash
+ntn datasources resolve <database-id>
+ntn datasources resolve <database-id> --json
+ntn datasources query <data-source-id>
+ntn datasources query <data-source-id> --limit 50 --json
+ntn datasources query <data-source-id> --sort 'Date desc'
+ntn datasources query <data-source-id> --filter '{"property":"Done","checkbox":{"equals":true}}'
+```
+
+Use `resolve` when you have a database ID. Query needs a data source ID.
+
+## Raw API
+
+```bash
+ntn api v1/users/me
+ntn api v1/search -d '{"query":"roadmap","page_size":10}'
+ntn api v1/pages 'parent[data_source_id]='"$DS_ID" 'properties[Name][title][0][text][content]=New item'
+ntn api "v1/pages/$PAGE_ID" -X PATCH in_trash:=true
+ntn api "v1/blocks/$PAGE_ID/children" -X PATCH \
+  'children[0][type]=paragraph' \
+  'children[0][paragraph][rich_text][0][text][content]=Hello'
+```
+
+Input syntax:
+
+- `path=value`: string body field.
+- `path:=json`: typed JSON body field.
+- `name==value`: query parameter.
+- `Header:Value`: request header.
+- `-d '<json>'` or stdin JSON for larger bodies.
+- Only one body source per request.
+
+## Files
+
+```bash
+ntn files create < image.png
+ntn files create --filename photo.png --content-type image/png < /tmp/photo
+ntn files create --external-url https://example.com/photo.png
+ntn files get <upload-id>
+ntn files list
+```
+
+## Workers
+
+```bash
+ntn workers new
+ntn workers deploy
+ntn workers list --json
+ntn workers runs list --json
+ntn workers runs logs <run-id>
+```
+
+Workers may require Business/Enterprise plan and workspace enablement.
+
+## Curl fallback
+
+```bash
+curl -sS "https://api.notion.com/v1/users/me" \
+  -H "Authorization: Bearer $NOTION_API_TOKEN" \
+  -H "Notion-Version: 2026-03-11" \
+  -H "Content-Type: application/json"
+```
+
+## Version notes
+
+- Current latest API version: `2026-03-11`.
+- Use `in_trash`, not `archived`.
+- Append block positioning uses `position`, not flat `after`.
+- `transcription` block renamed to `meeting_notes`.
+- Databases can contain multiple data sources; page parents generally use `data_source_id`.

package/kit/.agents/skills/novo-projeto/SKILL.md

@@ -0,0 +1,94 @@
+---
+name: novo-projeto
+description: >
+  Cria uma pasta de projeto nova com `AGENTS.md` dedicado, depois de uma entrevista curta sobre
+  o projeto (cliente, objetivo, entregas previstas). Use quando o usuário disser "novo projeto",
+  "novo cliente", "/novo-projeto", "começar projeto pra X" ou pedir pra estruturar um trabalho novo.
+---
+
+# /novo-projeto — Pasta de projeto novo com contexto dedicado
+
+Quando o usuário começa um projeto novo (cliente, iniciativa, produto), cria uma pasta com `AGENTS.md` próprio que herda contexto da raiz e adiciona o que é específico do projeto.
+
+## Workflow
+
+### Passo 1 — Entrevista (4 perguntas)
+
+1. "Qual o nome do projeto ou cliente?"
+2. "É um cliente novo, projeto interno ou iniciativa pessoal?"
+3. "Qual o objetivo principal? (uma frase)"
+4. "Que tipo de entrega vai ter? (ex: ads, site, conteúdo, automação, proposta — pode ser mais de uma)"
+
+### Passo 2 — Decidir local
+
+Baseado na resposta 2:
+
+- **Cliente novo:** criar em `clientes/<Nome>/` (ou na pasta equivalente do perfil — ler `AGENTS.md` da raiz pra confirmar a convenção)
+- **Projeto interno:** criar em `projetos/<nome>/` (criar `projetos/` se não existir)
+- **Iniciativa pessoal:** perguntar onde o usuário prefere
+
+### Passo 3 — Estrutura básica
+
+Criar a pasta com:
+
+- `AGENTS.md` do projeto (instruções herdadas + específicas)
+- `CLAUDE.md` do projeto com apenas `@AGENTS.md` (ponteiro multi-harness)
+- `briefing.md` (com o que foi coletado na entrevista)
+- Subpastas conforme as entregas mencionadas (ex: se mencionou "ads e conteúdo", criar `ads/` e `conteudo/`)
+
+### Passo 4 — Conteúdo do `AGENTS.md` do projeto
+
+Template:
+
+```markdown
+# [Nome do projeto]
+
+> Projeto criado em [data]. Pasta dedicada — instruções aqui sobrescrevem as da raiz quando relevantes.
+
+## Sobre
+
+[Objetivo da resposta 3]
+
+## Tipo
+
+[Cliente novo / Projeto interno / Iniciativa pessoal]
+
+## Entregas previstas
+
+- [entrega 1 da resposta 4]
+- [entrega 2 da resposta 4]
+- ...
+
+## Onde salvar o que
+
+- Briefings e contexto: nessa pasta na raiz
+- Entregas: cada subpasta criada (ads/, conteudo/, site/, etc.)
+
+## Contexto que herda da raiz
+
+Esse projeto herda automaticamente o tom de voz, marca e contexto do negócio definidos em `_memoria/` e `marca/` da raiz. Não duplicar essas informações aqui.
+
+## Específico desse projeto
+
+[Vazio — preencher com regras que valem só pra esse projeto, conforme for descobrindo]
+```
+
+### Passo 5 — Resumo
+
+Responder pro usuário:
+
+```
+Pasta criada: [caminho]
+✓ AGENTS.md do projeto
+✓ CLAUDE.md → @AGENTS.md
+✓ briefing.md
+✓ Subpastas: [lista]
+
+Quando for trabalhar nesse projeto, abre o terminal já dentro da pasta — assim o harness carrega o AGENTS.md específico junto com o da raiz.
+```
+
+## Regras
+
+- Nome de pasta: usar o nome como o usuário falou, sem normalizar agressivamente (manter acentos, espaços viram hífen, mas o nome reconhecível)
+- Não criar subpastas que não foram pedidas ("pra organizar melhor"). Só o que foi mencionado nas entregas
+- Se o cliente/projeto já existe (pasta com mesmo nome), avisar e perguntar se é pra adicionar dentro ou criar com sufixo