stark-squad

KO | EN

gitlite — search

#hacktoberfest #typescript #android #linux #nodejs #macos #windows #cli #kubernetes #awesome-list #mcp #ios #openai #open-source

(★ 4)

Digital Marketing Squad para Meta Ads — instale com npx stark-squad

stark-squad Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ★ stark-squad

> 🌍 [English](docs/README.en.md) | **Português**

[![Versão NPM](https://img.shields.io/npm/v/stark-squad.svg)](https://www.npmjs.com/package/stark-squad)
[![Licença: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://raw.githubusercontent.com/eusouandersonluiz/stark-squad/master/LICENSE)
[![Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org/)
[![CI](https://github.com/eusouandersonluiz/stark-squad/actions/workflows/ci.yml/badge.svg)](https://github.com/eusouandersonluiz/stark-squad/actions/workflows/ci.yml)
[![Contributions Welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg)](https://raw.githubusercontent.com/eusouandersonluiz/stark-squad/master/CONTRIBUTING.md)

**Digital Marketing Squad para Meta Ads — gerenciado por IA (powered by AIOX)**

Instale e gerencie campanhas Meta Ads para múltiplos clientes com 6 agentes de IA especializados, rodando 24/7 via daemon.

---

## Instalação rápida (2 min)

```bash
# Em qualquer projeto Node.js:
npx stark-squad init

# Adicionar primeiro cliente:
npx stark-squad add-client meu-cliente
```

Isso instala o squad em `squads/digital-marketing/` com agentes, templates, scripts e daemon prontos para usar.

---

## Comandos CLI

```bash
npx stark-squad init                    # Instala o squad
npx stark-squad add-client <slug>       # Adiciona novo cliente
npx stark-squad list-clients            # Lista clientes ativos
npx stark-squad version                 # Versão instalada
npx stark-squad help                    # Ajuda
```

---

## Agentes

| Agente | Persona | Função |
|--------|---------|--------|
| `@dm-master` | Axis | Orquestrador — ponto de entrada |
| `@campaign-strategist` | Sage | Estratégia e planejamento |
| `@copy-writer` | Lyra | Textos e copies |
| `@creative-designer` | Nova | Briefing de criativos |
| `@traffic-manager` | Bolt | Configuração Meta Ads |
| `@performance-analyst` | Iris | Relatórios e KPIs |

### Ativar no Claude Code

```
@digital-marketing:agents:dm-master
```

### Comandos do orquestrador

```
*onboard-client     → Onboarding completo de novo cliente
*launch-campaign    → Lança campanha (todos os agentes em sequência)
*monthly-review     → Revisão mensal de resultados
*set-client <slug>  → Muda contexto para outro cliente
*status             → Status geral de todos os clientes
*help               → Todos os comandos
```

Ver lista completa de agentes e comandos: [AGENTS.md](AGENTS.md)

---

## Configuração

### 1. Credenciais globais

```bash
# Preencha após o init:
squads/digital-marketing/config/.env
```

```env
ANTHROPIC_API_KEY=sk-ant-...
META_ACCESS_TOKEN=...
META_APP_ID=...
META_APP_SECRET=...
```

### 2. Adicionar cliente

```bash
npx stark-squad add-client clinica-bella
```

Preencha:
- `data/clients/clinica-bella/config.env` — credenciais Meta do cliente
- `data/clients/clinica-bella/client.md` — dados do cliente
- `data/clients/clinica-bella/MEMORY.md` — package contratado

### 3. Daemon na VPS (24/7)

```bash
cd squads/digital-marketing
npm run daemon                           # Inicia com PM2
pm2 logs digital-marketing-squad         # Ver logs ao vivo
```

Guia completo: [VPS-SETUP.md](template/digital-marketing/VPS-SETUP.md)

---

## Automações do daemon

| Horário | Job | O que faz |
|---------|-----|-----------|
| 09h e 15h (dias úteis) | `check-alerts` | Detecta alertas de CPL/CTR/frequência |
| 00h (todo dia) | `update-memory` | Atualiza MEMORY.md com KPIs do dia |
| Dia 1, 08h | `generate-report` | Gera relatório mensal completo |

---

## Pacotes de serviço

| Pacote | O que inclui |
|--------|-------------|
| `boost` | Impulsionamento de posts existentes |
| `meta-starter` | Campanhas básicas ToFu |
| `meta-full` | Funil completo ToFu/MoFu/BoFu |
| `meta-full-creative` | Meta full + briefing de criativos |

---

## Adapters (outras IDEs)

O squad funciona em qualquer IDE ou via API direta:

| Plataforma | Arquivo |
|-----------|---------|
| Claude Code | `agents/*.md` (nativo) |
| Cursor | `adapters/cursor/rules/*.mdc` |
| Windsurf | `adapters/windsurf/.windsurfrules` |
| API / Codex | `adapters/prompts/system-*.md` |

---

## Estrutura instalada

```
squads/digital-marketing/
├── agents/              # 6 agentes AIOX completos
├── adapters/            # Cursor, Windsurf, API
├── config/              # .env, tech-stack, source-tree
├── data/
│   ├── clients/         # Um diretório por cliente (gitignored)
│   └── packages/        # Pacotes de serviço disponíveis
├── scripts/
│   ├── daemon.js        # Processo principal PM2
│   ├── jobs/            # check-alerts, update-memory, generate-report
│   └── lib/             # claude.js, meta-api.js, clients.js, memory.js
├── tasks/               # Tasks AIOX
├── templates/           # Templates de onboarding, memória e logs
├── ecosystem.config.cjs # Config PM2
└── package.json
```

---

## Contribuindo

Leia [CONTRIBUTING.md](CONTRIBUTING.md) para entender como contribuir.

**Conventional Commits obrigatório:**
- `feat:` → nova feature (minor bump)
- `fix:` → bug fix (patch bump)
- `docs:` → documentação
- `feat!:` → breaking change (major bump)

---

## Licença

stark-squad

stark-squad Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

stark-squad

stark-squad Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README