dna-operacional

DNA Operacional 🧬

O sistema operacional da Ahoy Digital — do setup ao lançamento.

14 skills Claude Code pra criador, agência e inteligência competitiva BR. Instala em 2 comandos, funciona em qualquer projeto.

🚀 Instalação

/plugin marketplace add ahoydig/dna-operacional
/plugin install dna-operacional

Pronto. Digita /dna pra ver tudo que dá pra fazer.

O que tu ganha (14 skills)

Skill	O que faz
/setup-projeto	Configura qualquer projeto (teu ou cliente) em 17 seções
/voz	Cria/evolui/versiona a voz escrita do projeto
/humanizer	Remove cara de IA + aplica voz do projeto
/pesquisa-diaria	Radar matinal BR (X, Reddit, portais, GitHub)
/pesquisa-concorrentes	Mapeia concorrentes Instagram
/raio-x-ads-concorrentes	Briefing de ads competidores
/ideias-conteudo	10 frameworks de hook + multiplica ideias
/analisar-video	Eng. reversa de Reels/TikTok → adaptive_models
/roteiro-viral	Roteiros baseados em adaptive_models
/carrossel-instagram	Carrosséis Instagram via Playwright
/analista-conteudo	Análise SQL do teu feed (KPIs BR)
/auto-melhoria	Detecta padrões + propõe edits ao CLAUDE.md
/dna-melhoria	Auto-refino das skills do plugin (mantenedor)
/dna	Menu central + jornadas

---

🗄️ Storage Layer

Plugin abstrai persistência — tu escolhe onde guardar os dados das skills:

Backend	Pra quem	Setup
Supabase	Power user / agência / escala	Médio (criar projeto + rodar migration)
Google Sheets	Maioria dos casos	Fácil (copiar planilha + colar ID)
Markdown local	Iniciante / pessoal	Trivial (mkdir data/)

Sem lock-in. Trocar backend = passar pela skill /dna migrar-storage (v0.2+) ou migração manual.

Detalhes completos em lib/storage/ e templates/.

---

🎙 Voz Dinâmica

Plugin tem skill /voz que mantém a voz escrita do teu projeto. Cada projeto tem sua voz em reference/voz-<handle>.md.

Modos:

/voz                       → status da voz atual
/voz criar                 → entrevista guiada (cria v1)
/voz mostrar               → exibe voz completa
/voz evoluir <input>       → URL/arquivo/texto pra adicionar padrões
/voz versoes               → lista versões + rollback
/voz silenciar | ativar    → controla auto-observação

Auto-observação: quando você usa o plugin, ele detecta padrões de voz e sugere evoluções (com confirmação). Pra desligar: /voz silenciar.

Detalhes em lib/voz/SCHEMA.md e lib/voz/auto-observacao.md.

---

🔑 Antes de rodar: configure as APIs

Algumas skills precisam de chaves externas (Apify, Supabase, Modal). Zero hardcoded — cada aluno configura a sua.

Guia completo passo-a-passo:

cat ~/.claude/plugins/cache/dna-operacional-marketplace/dna-operacional/0.1.0/docs/APIS-EXTERNAS.md

Ou veja docs/APIS-EXTERNAS.md no repo.

Resumo:

API	Pra quê	Free tier
Apify	Scraping (pesquisas, video download)	$5/mês de créditos
Supabase	SQL analytics (/analista-conteudo) + storage	500MB DB grátis
Modal	Whisper transcrição (/analisar-video)	$30/mês crédito
Google Sheets	Storage backend alternativo	Grátis

Cada skill faz pré-check no início — se falta config, mostra passo-a-passo pra fix.

---

⏰ Agendamento /pesquisa-diaria

3 opções (user escolhe no APIS-EXTERNAS.md):

• /schedule Anthropic — zero infra, paga tokens. Medido: ~$18-36/mês com Sonnet (estimativa teórica; ver docs/SPIKE-TOKENS.md)
• GitHub Actions — grátis em repo público
• launchd (Mac) — grátis, só com Mac ligado

---

🧬 DNA-Melhoria (mantenedores)

Skill /dna-melhoria faz auto-refino das próprias skills do plugin. Pra mantenedores (não pro aluno final).

/dna-melhoria              → análise dry-run (default)
/dna-melhoria --diff       → mostra diff completo (copia/cola manual)

A skill é só dry-run + diff (alinhado com Spec §3.1). --apply com confirmação 1-a-1 fica como follow-up futuro.

Heurísticas: descriptions de auto-discovery, argument-hints, próximos passos, tool calls visíveis, sanitização. Detalhes em commands/dna-melhoria.md.

---

Começa por aqui

/setup-projeto

Ele te entrevista, monta teu CLAUDE.md, define público-alvo e delega a voz pro /voz. A partir daí, cada skill te orienta pro próximo passo.

Jornadas