4.1 Meta skills | Curso iAmasters OS

🎙️ meta-onboarding-wizard (4 sub-fases com commits incrementais)

O wizard inicial é a porta de entrada do OS. Não é um formulário com 15 campos — é uma entrevista conversacional adaptativa. As perguntas são decididas em cada turno pelo agente conforme respondes. Fixo: as 8 dimensões a cobrir e as regras de aprofundamento.

💡 Conceito principal · 4 sub-fases com commits incrementais

Mudança da v0.6: a entrevista divide-se em 4 sub-fases e cada uma escreve o seu ficheiro e atualiza o state machine antes de avançar. Se abandonas a meio (cansaste, tens reunião), a próxima sessão retoma exatamente onde ficaste.

•W1 · Identidade → context/me.md (nome, 1 frase pro, localização, idioma)
•W2 · Negócio → context/work.md (negócio principal, modelo receitas, cliente ideal, stack)
•W3 · Foco → context/current-priorities.md + goals.md (foco do mês + objetivo 12 meses)
•W4 · Config → ~/.claude/skills/_operator-state.json (nível, idioma outputs, Firecrawl)

As 8 dimensões críticas que TEM de capturar

#	Dimensão	Sub-fase
1-2	Identidade + localização/idioma	W1
3	Negócio principal	W2
4	Modelo de receitas	W2
5	Cliente ideal (1ª passagem)	W2
6	Stack diário	W2
7	Foco do mês	W3
8	Objetivo 12 meses	W3

⏱️ Tempo objetivo

10-12 minutos total. Se demorar mais, provavelmente fazes follow-up demais. Mínimo de qualidade: 100 caracteres de conteúdo útil por ficheiro (não placeholders).

🔬 meta-deep-dive (22-25 dimensões em 4 blocos)

O wizard inicial deixa-te operacional. O deep-dive deixa-te específico. Diferença entre outputs "decentes" e outputs que parecem mesmo teus. Cobre 22-25 dimensões residuais em 4 blocos com branching condicional.

Pessoa (7 dimensões)

→ context/me.md + soul.md

Horário produtivo · interrupções · contexto vital relevante · motivadores profundos · drenadores · estilo preferido de comunicação com IA · palavras/tons proibidos.

Negócio (6 dimensões)

→ context/work.md

Saúde financeira (faixa faturação) · margem aproximada · ticket médio · diferencial real · side projects · fricções do modelo.

Equipa (6 dimensões · gate condicional)

→ context/team.md

Tamanho equipa (gate) · papéis e dinâmica · comunicação interna · delegação · clientes top (3-5) · clientes problemáticos. Se trabalhas sozinho, salta blocos internos mas mantém top/maus clientes.

Foco e visão (5-7 dimensões)

→ current-priorities.md + goals.md + decisions-log.md

Decisões pendentes · metas a 3 anos · medos · métricas que segues · definição pessoal de sucesso.

🎭 Tom: entrevistador profissional

Aqui o operador pode sentir-se exposto (perguntas sobre faturação, medos, clientes maus). Tom de entrevistador profissional, não de coach motivacional. Sem "isso é fantástico!", sem emojis de validação. Pergunta, escuta, anota, próximo.

Como invocar

# Comando explícito
/deep-dive

# Ou pede em texto livre
"Quero fazer o deep-dive"
"Vamos aprofundar o meu perfil"

# meta-start-here sugere-o automaticamente se:
# - operator-state.deepDiveCompleted === false
# - passaram >12h desde o wizard inicial

☀️ meta-start-here · ritual diário

Cada manhã (ou cada nova sessão) o OS faz um ritual de entrada. Carrega o que precisa de saber, recapitula pendentes, propõe próxima ação. Nunca começas do zero.

4 passos canónicos

Detetar estado do repo — lê ~/.claude/skills/_operator-state.json, context/me.md, brand-context/voice/voice-profile.md. Se algo crítico falta, deriva para wizard.
Carregar continuidade — daily summary de ontem, última entrada de learnings.md, projetos com status: active.
Sincronizar skills — se há .claude/.skills-pending.json, atualiza catalog Sinapsis.
Cumprimento contextual — "Ontem deixaste X. Continuas com Y ou mudas?". Curto. Sem fluff.

✓ Cumprimento bom

"Ontem fechaste a positioning v2 e ficou pendente escolher o ângulo final entre "vertical-specialist" ou "método próprio". Decides hoje ou prefieres dormir mais 1 dia?"

✗ Cumprimento mau

"Olá! Espero que esteja a ter um dia produtivo! Estou aqui para te ajudar com o que precisares. Em que posso assistir hoje?" 🤖

🚦 suggestDeepDive flag

Se passaram >12h desde wizard inicial e deepDiveCompleted: false, start-here marca flag interna e lembra-te no cumprimento — não força. "Já se passou um dia desde o setup inicial. Queres aprofundar o teu perfil (15 min)?".

🌙 meta-wrap-up · fecho do dia

O wrap-up é o gémeo do start-here. Sem fecho, o início de amanhã não tem o que ler. 2 minutos no fim poupam 15 no início. Invoca-se com /wrap-up ou quando token usage passa 80% sustentado.

5 passos canónicos

Recap mental: completado · meio · aprendido.
Sync skills: se .claude/.skills-pending.json existe, atualizar synapsis/skills-catalog.json.
Update CLAUDE.md registry: tabela entre  e end.
Append learnings: se falharam skills, gotcha técnico, escreve para context/learnings.md.
Daily summary + commit: gera synapsis/daily-summaries/YYYY-MM-DD.md com "Did · Pending · For tomorrow". Propõe commit conventional.

Formato daily summary

# 2026-05-17

## Did
- Fechou positioning v2 (ângulo: vertical-specialist agrónomos)
- 3 posts LinkedIn semana (agendados via marketing-content-repurposing)
- Decisão: subir ticket médio de 8k para 12k (registado em decisions-log)

## Pending
- Refinar ICP secundário (consultores agrónomos PME >10 pessoas)
- Email sequence onboarding novos clientes (welcome 5 emails)

## For tomorrow
- Começar pelo ICP secundário (1h)
- Se sobrar tempo, esboçar primeira versão do welcome sequence

⚙️ Não corre sozinho ao fechar

Ao fazer Ctrl+C ou fechar o terminal, o wrap-up NÃO se invoca automaticamente. Tens de pedir /wrap-up explicitamente. É deliberado: melhor perder daily summary do que assumir que o que ficou em meio era "final".

📒 decisions-log · diário append-only

Padrão inspirado em Luispitik/claude-code-second-brain. Cada decisão importante fica num ficheiro append-only que o Claude lê ao início. Anti-contradições — para o agente e para ti.

Formato canónico

## 2026-05-17 · Subir ticket médio para 12k

**Decisão**: a partir de junho, o ticket mínimo para projetos
novos sobe de 8k para 12k.

**Raciocínio**: nos últimos 6 meses, 80% das fricções (atrasos,
churn em 30 dias, pedidos de scope-creep) vêm de projetos <10k.
Ao mesmo tempo, fila de espera tem 4 leads qualificados >15k.
Custa-me dizer não aos pequenos mas o sinal é claro.

**Contexto**: estou em capacidade de quase 100%, sozinho, sem
plano de contratar. Subir preço é a forma de filtrar sem perder
qualidade de entrega.

**Quando reconsiderar**: se ficar com <2 leads/mês durante 3
meses seguidos, ou se chegar nova pessoa à equipa que liberte
capacidade.

---

✓ Critério de "quando reconsiderar" bom

"Se chegar a 50k MRR"
"Após contratar primeira pessoa"
"Em janeiro 2027 (revisão anual)"
"Se 3 clientes pedirem o mesmo módulo extra"

✗ Critério mau

"Se correr mal"
"Quando achar que faz sentido"
"No futuro"
"Quando vier vontade"

🔄 Quem invoca a skill

Tu ("regista esta decisão"), ou outra skill (six-hats, marketing-positioning) ao fechar com decisão clara, ou /wrap-up ao detetar decisão tomada na sessão e ainda não registada.

🎩 welcome-quick-win + six-hats

Duas skills muito diferentes mas com algo em comum: são as que entregam o "wow". A primeira no momento de adoção (primeiro entregável em 5 min). A segunda em momentos de decisão grande (análise multi-perspetiva).

🎁 welcome-quick-win

O primeiro entregável do OS, em 5 minutos. Invoca-se automaticamente após o wizard (se welcomeCompleted: false) ou à mão com /welcome.

Pede um URL público teu (LinkedIn, web, portfolio)
Invoca tool-firecrawl-scraper para extrair conteúdo
Analisa posicionamento e gera: 3 hooks LinkedIn + plano de 3 ações para a semana
Empacota tudo em HTML autocontido via tool-visual-explainer

Se firecrawl falhar (sem API key, bot blocker): pede para colar 2-3 parágrafos chave à mão. Sem URL público: pede parágrafo de 3-5 frases sobre o que fazes.

🎩 six-hats · método De Bono

Para qualquer decisão grande (lançar produto, fechar contrato, despedir alguém), os 6 chapéus separam modos de pensamento para que cada um receba atenção completa antes de misturar.

⚪

Branco

Dados

🔴

Vermelho

Intuição

⚫

Preto

Riscos

🟡

Amarelo

Oportunidades

🟢

Verde

Criatividade

🔵

Azul

Processo

Dois modos: rápido (5 min, ~1500 palavras, o agente escreve os 6 chapéus) ou profundo (15-20 min, percorre cada chapéu contigo). Por defeito: rápido.

🔗 Encadeia com decisions-log

No fim, six-hats sempre propõe registar a decisão tomada via decisions-log. Se aceitas, gera entrada com formato canónico (decisão, raciocínio derivado dos chapéus, contexto, critério para reconsiderar). Tudo amarrado.

✅ Resumo do Módulo

✓

Wizard inicial em 4 sub-fases com commits incrementais — 10-12 min, idempotente, abandonável sem perda

✓

Deep-dive aprofunda 22-25 dimensões em 4 blocos — tom de entrevistador, branching condicional na equipa

✓

start-here carrega continuidade ao entrar — "Ontem deixaste X" em vez de "Olá!"

✓

wrap-up fecha o dia (daily summary + commit) — 2 min hoje poupam 15 amanhã

✓

decisions-log append-only evita contradições — formato canónico com "quando reconsiderar"

✓

welcome-quick-win + six-hats entregam "wow" — primeiro deliverable e análise multi-perspetiva

Próximo Módulo:

4.2 — Marketing skills: copywriting com voice carregada, repurposing 1→N, email sequences, padrão de skill collaboration.

← Voltar para Trilha 4 Módulo 4.2 →