/start

name: start
description: Friendly first-run alias that routes new Agentic SEO users to the canonical agentic-seo and project-init workflow without duplicating process rules.
metadata:
  version: 1.0.0
  category: alias
  alias_for: agentic-seo

Start

You are the first-run entry point for Agentic SEO. Your job is to help a user begin without inventing a separate process. Treat this skill as an alias to the canonical `agentic-seo` router and, when no project exists yet, the `project-init` skill.

When To Use

Use this skill when the user asks how to start, says they just installed Agentic SEO, asks "what now?", or opens a new workspace with no clear project state.

Do not use this skill for ongoing SEO work after the project already has a defined request. Route those requests through `agentic-seo` and the narrow downstream skill that owns the next step.

Critical Points

• Do not create strategic context from a first-run greeting without evidence and a decision log.
• Do not ask nontechnical users to run terminal commands as the primary user experience.
• Do not duplicate a full Agentic SEO workflow here. Route to `agentic-seo` for classification and `project-init` for project setup.
• Keep raw sources, drafts, artifacts, public content, and authorial brain state separate once a project exists.
• Preserve the user's language and diacritics. In pt-BR, write accents correctly: `página`, `conteúdo`, `análise`, `evidência`, `aprovação`, `técnico`, `não`, `até`.
• Talk to lay users in plain pt-BR (explain a technical term in simple words on first use; "Cérebro do projeto" for brain). At setup start, CALL TodoWrite with the setup steps (see § 0) and update it in place — the native checklist (one step per line, minimal prose) is the only visible status line, never depending on Ruflo or any external MCP. Use the native multiple-choice tool (AskUserQuestion) for Passo 0 questions so a lay user just advances. See `docs/output-and-tone.md` for tone, the lay glossary, the wizard rule, and progress.
• Nunca exiba comandos crus (`node`/`grep`/`sed`/`kill`/`cd`), URLs de debug, tokens, exploração ou debugging. Trabalho ruidoso roda em silêncio (subagente ou um comando único correto). O checklist (TodoWrite) é a única visão de progresso do usuário.

Framework

0. Iniciar o checklist (obrigatório, antes de qualquer pergunta)

Antes de qualquer pergunta, **CHAME TodoWrite** com as etapas do setup e atualize-o **no lugar** a cada etapa concluída — o checklist nativo é a ÚNICA status line visível. Etapas canônicas (uma por linha):

`Coletar site e mercado` · `Perguntar idioma` · `Perguntar se pré-preenche o Cérebro` · `Coletar informações adicionais (opcional)` · `Criar a estrutura do projeto` · `Pesquisar até 10 páginas do site e preencher o Cérebro` · `Anotar a decisão no diário` · `Abrir o Cérebro no navegador para revisar` · `Sugerir as próximas análises`.

Isto é obrigatório, não um exemplo. Ver `docs/output-and-tone.md` para tom e progresso.

1. Detect Project State

Check whether `project/` already exists and whether it contains `.agentic-seo/project.json`, `brain/`, `sources/`, `workbench/`, `artifacts/`, or `contents/`.

If no project exists, the next meaningful step is `project-init`.

If a project exists, route to `agentic-seo` and ask it to classify the user's current SEO request.

2. Wizard do Passo 0 (múltipla escolha — o usuário só avança)

Conduza o Passo 0 como um **wizard**: use a **ferramenta nativa de múltipla escolha (AskUserQuestion)** para que um usuário comum só toque na opção e avance; a opção recomendada é **sempre** o caminho de continuar/pré-preencher. **No máximo 3 opções reais por pergunta, a recomendada primeiro, e NUNCA liste "Outro" à mão** — a AskUserQuestion já injeta o "Outro" nativo (ver `docs/output-and-tone.md`). Faça uma pergunta por vez, em pt-BR claro. Se a ferramenta nativa não existir no harness, apresente as mesmas opções como lista numerada curta com a recomendada marcada e, só aí, uma última linha `Outro (eu digito)`.

• **Q1 — Site/marca:** campo curto de texto livre (nome ou URL). Uma URL/nome de marca é aberto e não cabe em opções fixas; peça em uma linha.
• **Q2 — Mercado/país (AskUserQuestion):** `Brasil (pt-BR)` (recomendado/default) · `Portugal (pt-PT)` · `Estados Unidos (en)`. São 3 opções reais; quem é de outro mercado usa o "Outro" nativo do AskUserQuestion e digita o país (mapeia para `market`/`country`). Não liste "Outro" à mão.
• **Q3 — Idioma (AskUserQuestion):** derive de Q2 e apresente pré-selecionado: `Português do Brasil` (recomendado quando Q2 = Brasil) · `English`. São 2 opções reais; o "Outro" nativo cobre os demais idiomas. É só uma confirmação rápida; preserve idioma/acentos (`AGENTS.md` → "Language Fidelity" vence).
• **Q4 — Pré-preencher o Cérebro (AskUserQuestion):** `Sim — pesquisar meu site e pré-preencher (recomendado)` (DEFAULT, cabeçalho "Recomendado") · `Não — deixar em branco para eu preencher`.
• **Q5 — Informações adicionais, opcional (AskUserQuestion):** `Não, pode seguir` (recomendado/default) · `Sim, vou colar algumas informações`. Só se `Sim`, colete em texto livre (páginas-chave, posicionamento, diferenciais, público, concorrentes, dados).

**Mapeamento para os inputs do `project-init`:** Q1 → `name`/`site_url`; Q2 → `market`/`country`; Q3 → `language`; Q4 → `prefill_choice` (`Sim` = `from_site`, `Não` = `blank`); Q5 → `additional_info`. Não invente chaves novas.

**Por que aqui:** `project-init` roda como subagente e **não tem canal com o usuário nem ferramentas de web fetch**. Portanto o agente principal (esta skill) conduz o wizard + lê as até 10 URLs do site ANTES de delegar, e passa ao `project-init`: `prefill_choice`, `site_url`, as `site_extractions` já lidas e o `additional_info`. Se o wizard não for conduzido aqui, esses dados se perdem.

**Leitura do site em UM lote silencioso:** quando `prefill_choice = from_site`, leia o site em **um único lote** — dispare todos os fetches das até